金蝶云星空与万里牛对接集成销售订单查询连通销售订单新增(万里牛销售订单-金蝶【销售订单】)

接通系统：万里牛

万里牛是一家SaaSERP服务商，提供一站式对接全球电商平台解决方案。万里牛系列产品是以ERP/WMS作为核心，并延展到智慧零售、商业智能（BI）、B2B分销及供应链等领域构成完整的SaaS产品矩阵，覆盖鞋服、百货、美妆、食品、家电、3C、快消等行业领域，累计服务30万+用户，以先进的云服务技术助力企业实现数智化转型。

目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

多系统对接方案配置

数据集成平台对应的配置万里牛与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据万里牛的接口参数要求记录在轻易云集成平台。第二步配置万里牛与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。

万里牛接口明细

接口：/erp/opentrade/list/trades
接口名称：销售订单查询
接口方法：POST

请求参数

字段名称类型 query_extend扩展查询字段object end_time查询结束时间long query_extend.order_olnitem_type线上明细int query_extend.query_split_only是否仅查询拆分出的订单（含母单）boolean modify_time单据修改时间long pay_time付款时间long query_extend.shop_type店铺类型Integer query_extend.query_relation_trade是否查询关联订单boolean storage_code仓库编码String send_goods_time发货时间long query_extend.trade_biz_type业务单据流转类型Integer mobile手机String bill_code单据编码String create_time单据创建时间long finish_time完成时间long trade_status订单状态String limit每页大小int query_extend.query_talent_info是否查询主播信息boolean query_extend.shop_nick店铺昵称String query_extend.extend_field扩展字段返回逗号隔离String query_extend.encry_address是否返回加密平台密文boolean is_split是否拆分组合商品Boolean page当前页码int query_extend.query_exchange_only是否仅查询售后下单的订单boolean

响应参数

字段名称类型描述 trade_extend定制扩展字段object定制扩展字段 trade_extend.platform_integral平台积分String目前支持小店返回是平台订单商品级别 trade_extend.buyer_account账号string账号 trade_extend.uid单据主键(唯一)string单据主键(唯一) trade_extend.buyer_mobile买家手机string买家手机 trade_extend.estimate_send_time平台返回预计发货时间datetime平台返回预计发货时间 trade_extend.buyer_msg留言string留言 trade_extend.sensitive_address加密平台密文信息object加密平台密文信息 trade_extend.sensitive_address.oaid淘系密文OAIDString淘系密文OAID trade_extend.sensitive_address.platform_trade_id密文对应的线上IDString密文对应的线上ID trade_extend.sensitive_address.receiver_address密文地址String密文地址 trade_extend.sensitive_address.receiver_address_mask地址脱敏值-以平台为准String地址脱敏值-以平台为准 trade_extend.sensitive_address.receiver_mobile手机号密文String手机号密文 trade_extend.sensitive_address.receiver_mobile_mask手机号脱敏数据String手机号脱敏数据 trade_extend.sensitive_address.receiver_name收件人密文String收件人密文 trade_extend.sensitive_address.receiver_name_mask收件人脱敏值String收件人脱敏值 trade_extend.sensitive_address.receiver_phone固话密文String固话密文 trade_extend.sensitive_address.receiver_phone_mask固话脱敏值String固话脱敏值 trade_extend.sensitive_address.province省string省 trade_extend.sensitive_address.city市string市 trade_extend.sensitive_address.district区string区 trade_extend.sensitive_address.create_time创建时间string创建时间 trade_extend.sensitive_address.currency_code原始货币种类string原始货币种类 trade_extend.sensitive_address.currency_sum原始货币金额string原始货币金额 trade_extend.sensitive_address.discount_fee优惠金额string优惠金额 trade_extend.sensitive_address.end_time完成时间：交易结束或交易成功的时间string完成时间：交易结束或交易成功的时间 trade_extend.sensitive_address.approve_time审核时间string审核时间 trade_extend.sensitive_address.express_code快递单号string快递单号 trade_extend.sensitive_address.flag旗子颜色0:无1：红2：黄3：绿4：蓝5：粉string旗子颜色0:无1：红2：黄3：绿4：蓝5：粉 trade_extend.sensitive_address.post_currency原币运费金额String原币运费金额 trade_extend.sensitive_address.sale_man_mobile业务员手机号String业务员手机号 trade_extend.sensitive_address.has_refund退款标记 0:否；1:是string退款标记 0:否；1:是 trade_extend.sensitive_address.extend_info扩展信息String扩展信息 trade_extend.sensitive_address.invoice发票array发票 trade_extend.sensitive_address.invoice.header发票抬头String发票抬头 trade_extend.sensitive_address.invoice.invoice_detail发票详情String发票详情 trade_extend.sensitive_address.invoice.invoice_tax_id税号String税号 trade_extend.sensitive_address.invoice.invoicing_type发票形式 0：纸质，1 ：电子int发票形式 0：纸质，1 ：电子 trade_extend.sensitive_address.invoice.type类型:1=普通发票，2=增值税普通发票, 3=电子增票int类型:1=普通发票，2=增值税普通发票, 3=电子增票 trade_extend.sensitive_address.invoice.invoice_bank发票开户行String发票开户行 trade_extend.sensitive_address.invoice.invoice_bank_account发票银行账户String发票银行账户 trade_extend.sensitive_address.invoice.invoice_mobile发票电话String发票电话 trade_extend.sensitive_address.invoice.invoice_remark发票备注String发票备注 trade_extend.sensitive_address.invoice.invoice_email发票emailString发票email trade_extend.sensitive_address.invoice.exchange_trade是否售后订单boolean是否售后订单 trade_extend.sensitive_address.invoice.error_id异常类型IDString异常类型ID trade_extend.sensitive_address.invoice.soln_order_list线上明细单号合集String线上明细单号合集 trade_extend.sensitive_address.invoice.error_name异常类型名称String异常类型名称 trade_extend.sensitive_address.invoice.is_exception_trade是否异常订单boolean是否异常订单 trade_extend.sensitive_address.invoice.is_pay是否已付款boolean是否已付款 trade_extend.sensitive_address.invoice.is_small_trade是否jit小单boolean是否jit小单 trade_extend.sensitive_address.invoice.jz_install_code安装服务商编码-- 淘系家装类订单字段String安装服务商编码-- 淘系家装类订单字段 trade_extend.sensitive_address.invoice.jz_install_name安装服务商名称-- 淘系家装类订单字段String安装服务商名称-- 淘系家装类订单字段 trade_extend.sensitive_address.invoice.jz_server_code物流服务商编码-- 淘家装类订单字段String物流服务商编码-- 淘家装类订单字段 trade_extend.sensitive_address.invoice.jz_server_name物流服务商名称-- 淘系家装类订单字段String物流服务商名称-- 淘系家装类订单字段 trade_extend.sensitive_address.invoice.logistic_code万里牛ERP快递公司代码，用户自定义代码String万里牛ERP快递公司代码，用户自定义代码 trade_extend.sensitive_address.invoice.mark订单标记,使用,隔开String订单标记,使用,隔开 trade_extend.sensitive_address.invoice.tp_logistics_type配送类型int0 快递 1 EMS 2 平邮 11 虚拟商品 121 自提 122 商家自送 125 同城限时达 -1 其它 trade_extend.sensitive_address.invoice.volume体积单位：立方米String体积单位：立方米 trade_extend.sensitive_address.invoice.weight重量单位：千克String重量单位：千克 trade_extend.sensitive_address.invoice.buyer_code客户编码String客户编码 trade_extend.sensitive_address.invoice.channel_name买家渠道昵称String买家渠道昵称 trade_extend.sensitive_address.invoice.identity_name身份证名称String身份证名称 trade_extend.sensitive_address.invoice.identity_num身份证信息String身份证信息 trade_extend.sensitive_address.invoice.platform_origin_discount平台原始优惠信息String平台原始优惠信息(KEY:VALUE形式,VALUE值为JSON格式) trade_extend.sensitive_address.invoice.post_cost快递成本String快递成本,数值可能会变动(如果设置了运费计算规则，订单审核后会根据商品估量和运费规则计算运费成本,称重后根据实际重量重新计算！页面也能直接修改) trade_extend.sensitive_address.invoice.modify_time修改时间String修改时间 trade_extend.sensitive_address.invoice.oln_order_list明细线上单号集合String明细线上单号集合 trade_extend.sensitive_address.invoice.oln_status线上状态😐String线上状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易 trade_extend.sensitive_address.invoice.orders明细集array明细集 trade_extend.sensitive_address.invoice.orders.currency_code原始货币种类String原始货币种类 trade_extend.sensitive_address.invoice.orders.currency_sum原始货币金额String原始货币金额 trade_extend.sensitive_address.invoice.orders.has_refund退款标记 0:否；1:是Integer退款标记 0:否；1:是 trade_extend.sensitive_address.invoice.orders.is_gift明细是否赠品 0/1,1为赠品Integer明细是否赠品 0/1,1为赠品 trade_extend.sensitive_address.invoice.orders.is_package是否组合商品boolean是否组合商品 trade_extend.sensitive_address.invoice.orders.item_name商品名称String商品名称 trade_extend.sensitive_address.invoice.orders.oln_item_id线上商品idString线上商品id trade_extend.sensitive_address.invoice.orders.oln_item_name线商品名称String线商品名称 trade_extend.sensitive_address.invoice.orders.oln_sku_id线上规格idString线上规格id trade_extend.sensitive_address.invoice.orders.oln_status线上状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易Integer线上状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易 trade_extend.sensitive_address.invoice.orders.order_id明细id，单据级唯一(is_split拆分后会相同)String明细id，单据级唯一(is_split拆分后会相同) trade_extend.sensitive_address.invoice.orders.payment应收款String应收款 trade_extend.sensitive_address.invoice.orders.price单价(商品标价)String单价(商品标价) trade_extend.sensitive_address.invoice.orders.receivable商品应收(原价)String商品应收(原价) trade_extend.sensitive_address.invoice.orders.remark明细备注String明细备注 trade_extend.sensitive_address.invoice.orders.size数量int数量 trade_extend.sensitive_address.invoice.orders.sku_code规格编码String规格编码 trade_extend.sensitive_address.invoice.orders.talent_id主播IDString主播ID trade_extend.sensitive_address.invoice.orders.talent_nick_name主播昵称String主播昵称 trade_extend.sensitive_address.invoice.orders.sys_goods_uid商品uidString商品uid trade_extend.sensitive_address.invoice.orders.sys_spec_uid规格uidString规格uid trade_extend.sensitive_address.invoice.orders.tax_rate开票商品税率number开票商品税率 trade_extend.sensitive_address.invoice.orders.sn_value序列号，此字段以不返回数据请使接口——/erp/sn/querysnbybillcode查询单据中的序列号String序列号，此字段以不返回数据请使接口——/erp/sn/querysnbybillcode查询单据中的序列号 trade_extend.sensitive_address.invoice.orders.status状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易int状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易 trade_extend.sensitive_address.invoice.orders.sub_order_no子订单号String子订单号 trade_extend.sensitive_address.invoice.orders.tp_oid线上明细IDString线上明细ID trade_extend.sensitive_address.invoice.orders.unit单位String单位 trade_extend.sensitive_address.invoice.orders.tp_tid线上单号String线上单号 trade_extend.sensitive_address.invoice.orders.tid_snapshot线上单号快照String线上单号_快照 trade_extend.sensitive_address.invoice.orders.order_total_discount商品总优惠=原价-销售金额String商品总优惠=原价-销售金额 trade_extend.sensitive_address.invoice.orders.gx_payment销售实付金额(淘供销结算)String销售实付金额(淘供销结算) trade_extend.sensitive_address.invoice.orders.extend_info扩展信息String扩展信息 trade_extend.sensitive_address.invoice.orders.paid_fee应收款String应收款 trade_extend.sensitive_address.invoice.orders.pay_no外部支付单号String外部支付单号 trade_extend.sensitive_address.invoice.orders.pay_time付款时间String付款时间 trade_extend.sensitive_address.invoice.orders.pay_type支付类型String支付类型 trade_extend.sensitive_address.invoice.orders.phone手机号，手机号为空的时候返回电话String手机号，手机号为空的时候返回电话 trade_extend.sensitive_address.invoice.orders.post_fee邮费String邮费 trade_extend.sensitive_address.invoice.orders.print_remark打印备注String打印备注 trade_extend.sensitive_address.invoice.orders.print_time打单时间String打单时间 trade_extend.sensitive_address.invoice.orders.process_status万里牛单据处理状态Integer万里牛单据处理状态: -3:分销商审核 -2:到账管理 -1:未付款 0:审核 1:打单配货 2:验货 3:称重 4:待发货 5：财审 8:已发货 9:成功 10:关闭 11:异常结束 12:异常处理 13:外部系统配货中 14:预售 15:打包 19:拣货 trade_extend.sensitive_address.invoice.orders.remark备注String备注 trade_extend.sensitive_address.invoice.orders.split_trade是否拆分订单boolean是否拆分订单 trade_extend.sensitive_address.invoice.orders.sale_man销售人员String trade_extend.sensitive_address.invoice.orders.seller_msg卖家留言址String卖家留言址 trade_extend.sensitive_address.invoice.orders.send_time发货时间String发货时间 trade_extend.sensitive_address.invoice.orders.service_fee服务费String服务费 trade_extend.sensitive_address.invoice.orders.shop_id店铺idString trade_extend.sensitive_address.invoice.orders.shop_name店铺名称(页面上显示)String店铺名称(页面上显示) trade_extend.sensitive_address.invoice.orders.shop_nick店铺昵称(店铺唯一)String店铺昵称(店铺唯一) trade_extend.sensitive_address.invoice.orders.shop_type店铺类型Int店铺类型 trade_extend.sensitive_address.invoice.orders.source_platform店铺来源Int店铺来源 trade_extend.sensitive_address.invoice.orders.status状态int状态：1：处理中 2：发货 3：完成 4: 关闭 5:其他 trade_extend.sensitive_address.invoice.orders.storage_code仓库编码String仓库编码 trade_extend.sensitive_address.invoice.orders.storage_name仓名称String仓名称 trade_extend.sensitive_address.invoice.orders.sum_sale总金额,包含优惠String总金额,包含优惠 trade_extend.sensitive_address.invoice.orders.tel电话String电话 trade_extend.sensitive_address.invoice.orders.tp_tid线上单号String线上单号,如果是线下订单，则是万里牛的单号，合单情况下会将单号合并，使用做分隔符 trade_extend.sensitive_address.invoice.orders.wave_no波次号String波次号 trade_extend.sensitive_address.invoice.orders.trade_no订单编码String订单编码 trade_extend.sensitive_address.invoice.orders.trade_type订单类型Integer订单类型 :1:普通线上订单 5：货到付款 6：分销 7：团购类型 9：天猫国际物流订单类型 50：普通线下订单 51：售后订单（一般换货创建的订单） trade_extend.sensitive_address.invoice.orders.zip邮编String邮编 trade_extend.sensitive_address.invoice.orders.logistic_name万里牛ERP快递公司名称String万里牛ERP快递公司名称

金蝶云星空接口明细

API：batchSave
NAME：销售订单新增
METHOD：POST

请求参数

接口字段名称预设值 FBillNo单据编号{{trade_no}} FSaleOrgId销售组织101 FDate日期{{create_time datetime}} FCustId客户{{shop_nick}} FSalerId销售员测试 FBillTypeID单据类型XSDD01_SYS FNote备注{{remark}} FLinkMan收货人姓名 FLinkPhone联系电话 FSaleOrderEntry订单明细 FSaleOrderEntry.FMaterialId物料编码{{orders.sku_code}} FSaleOrderEntry.FQty销售数量{{orders.size}} FSaleOrderEntry.FPrice单价 FSaleOrderEntry.FTaxPrice含税单价{{orders.price}} FSaleOrderEntry.FSettleOrgIds结算组织999 FSaleOrderEntry.FEntryNote备注 FSaleOrderEntry.FReceiptOrgId收款组织101 FSaleOrderEntry.FStockOrgId库存组织999 FSaleOrderEntry.FDiscount折扣额{{orders.order_total_discount}} FSaleOrderEntry.F_POIH_Text实际客户{{buyer_name}} FSaleOrderEntry.FSaleOrderFinance财务信息 FSaleOrderEntry.FSaleOrderFinance.FLocalCurrId本位币PRE001 FSaleOrderEntry.FSaleOrderFinance.FExchangeTypeId汇率类型HLTX01_SYS FSaleOrderEntry.FSaleOrderFinance.FSettleCurrId结算币别PRE001 FSaleOrderEntry.FSaleOrderFinance.FormId业务对象表单IdSAL_SaleOrder FSaleOrderEntry.FSaleOrderFinance.Operation执行的操作BatchSave FSaleOrderEntry.FSaleOrderFinance.IsAutoSubmitAndAudit提交并审核true FSaleOrderEntry.FSaleOrderFinance.IsVerifyBaseDataField验证基础资料false

数据对接效果

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通万里牛到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

金蝶云星空与万里牛对接集成销售订单查询连通销售订单新增(万里牛销售订单-金蝶【销售订单】)