万里牛对接打通金蝶云星空销售订单查询接口与销售订单新增接口

源系统:万里牛

万里牛是一家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

请求参数

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

响应参数

字段字段名称类型配置值 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 trade_extend.sensitive_address.platform_trade_id密文对应的线上IDString 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 trade_extend.sensitive_address.post_currency原币运费金额String trade_extend.sensitive_address.sale_man_mobile业务员手机号String trade_extend.sensitive_address.has_refund退款标记 0:否；1:是string 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 trade_extend.sensitive_address.invoice.type类型:1=普通发票，2=增值税普通发票, 3=电子增票int 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 trade_extend.sensitive_address.invoice.exchange_trade是否售后订单boolean trade_extend.sensitive_address.invoice.error_id异常类型IDString 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 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 trade_extend.sensitive_address.invoice.mark订单标记,使用,隔开String trade_extend.sensitive_address.invoice.tp_logistics_type配送类型int 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 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 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 trade_extend.sensitive_address.invoice.orders.is_gift明细是否赠品 0/1,1为赠品Integer 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 trade_extend.sensitive_address.invoice.orders.oln_item_name线商品名称String trade_extend.sensitive_address.invoice.orders.oln_sku_id线上规格idString trade_extend.sensitive_address.invoice.orders.oln_status线上状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易Integer trade_extend.sensitive_address.invoice.orders.order_id明细id，单据级唯一(is_split拆分后会相同)String 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 trade_extend.sensitive_address.invoice.orders.talent_nick_name主播昵称String trade_extend.sensitive_address.invoice.orders.sys_goods_uid商品uidString trade_extend.sensitive_address.invoice.orders.sys_spec_uid规格uidString trade_extend.sensitive_address.invoice.orders.tax_rate开票商品税率number trade_extend.sensitive_address.invoice.orders.sn_value序列号，此字段以不返回数据请使接口——/erp/sn/querysnbybillcode查询单据中的序列号String trade_extend.sensitive_address.invoice.orders.status状态:1:等待付款 2:等待发货 ,部分发货 3:已完成 4:已关闭 5: 等待确认 6:已签收 0: 未建交易int trade_extend.sensitive_address.invoice.orders.sub_order_no子订单号String trade_extend.sensitive_address.invoice.orders.tp_oid线上明细IDString 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 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 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 trade_extend.sensitive_address.invoice.orders.zip邮编String trade_extend.sensitive_address.invoice.orders.logistic_name万里牛ERP快递公司名称String

金蝶云星空接口明细

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必须填写金蝶的表单ID如😛UR_PurchaseOrder FSaleOrderEntry.FSaleOrderFinance.Operation执行的操作BatchSave FSaleOrderEntry.FSaleOrderFinance.IsAutoSubmitAndAudit提交并审核true FSaleOrderEntry.FSaleOrderFinance.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统集成总览

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接万里牛和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。