系统数据集成方案

用友U8与旺店通·企业奇门对接集成获取销售出库单列表连通创建原始订单(销售出库单查询)

来源系统:用友U8

接入系统：旺店通·企业奇门

数据接口配置方案

数据集成平台对应的配置用友U8与旺店通·企业奇门的对接只要三步就能完成两个系统之间的数据对接。第一步根据用友U8的接口参数要求记录在轻易云集成平台。第二步配置用友U8与旺店通·企业奇门之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

用友U8接口明细

• 接口：api/saleoutlist/batch_get
• 接口名称：获取销售出库单列表
• 接口方法：GET

请求参数

字段	名称	类型	描述
ds_sequence	数据源序号	string	数据源序号（默认取应用的第一个数据源）
FBillTypeID	单据类型	string	单据类型
warehousecode	仓库编码	string	仓库编码
warehousename	仓库名称关键字	string	仓库名称关键字
date_begin	起始单据日期	string	起始单据日期
date_end	结束单据日期	string	结束单据日期
auditdate_begin	起始审核日期	string	起始审核日期，格式:yyyy-MM-dd
auditdate_end	结束审核日期	string	结束审核日期，格式:yyyy-MM-dd
code_begin	起始收发单据号	string	起始收发单据号
code_end	结束收发单据号	string	结束收发单据号
departmentcode	部门编码	string	部门编码
departmentname	部门名称关键字	string	部门名称关键字
memory	备注关键字	string	备注关键字
maker	制单人关键字	string	制单人关键字
bredvouch	红蓝标识	string	红蓝标识
businesscode	对应业务单号	string	对应业务单号
timestamp_begin	起始时间戳	string	起始时间戳
timestamp_end	结束时间戳	string	结束时间戳
define1	自定义项1	string	自定义项1
define2	自定义项2	string	自定义项2
define3	自定义项3	string	自定义项3
define4_begin	起始自定义项4	string	起始自定义项4
define4_end	结束自定义项4	string	结束自定义项4
define5	自定义项5	string	自定义项5
define6_begin	起始自定义项6	string	起始自定义项6
define6_end	结束自定义项6	string	结束自定义项6
define7	自定义项7	string	自定义项7
define8	自定义项8	string	自定义项8
define9	自定义项9	string	自定义项9
define10	自定义项10	string	自定义项10
define11	自定义项11	string	自定义项11
define12	自定义项12	string	自定义项12
define13	自定义项13	string	自定义项13
define14	自定义项14	string	自定义项14
define15	自定义项15	string	自定义项15
define16	自定义项16	string	自定义项16

响应参数

字段	名称	类型	描述
businesstype	业务类型	string	业务类型
source	单据来源	string	单据来源
businesscode	对应业务单号	string	对应业务单号
warehousecode	仓库编码	string	仓库编码
warehousename	仓库名称	string	仓库名称
date	单据日期	string	单据日期
code	单据号	string	单据号
receivecode	收发类别编码	string	收发类别编码
receivename	收发类别名称	string	收发类别名称
departmentcode	部门编码	string	部门编码
departmentname	部门名称	string	部门名称
personcode	业务员编码	string	业务员编码
saletypecode	销售类型编码	string	销售类型编码
customercode	客户编码	string	客户编码
vendorcode	供应商编码	string	供应商编码
arrivedate	到货日期	string	到货日期
handler	审核人	string	审核人
memory	备注	string	备注
maker	制单人	string	制单人
define1	自定义项1	string	自定义项1
define2	自定义项2	string	自定义项2
define3	自定义项3	string	自定义项3
define4	自定义项4	string	自定义项4
define5	自定义项5	string	自定义项5
define6	自定义项6	string	自定义项6
define7	自定义项7	string	自定义项7
define8	自定义项8	string	自定义项8
define9	自定义项9	string	自定义项9
define10	自定义项10	string	自定义项10
define11	自定义项11	string	自定义项11
define12	自定义项12	string	自定义项12
define13	自定义项13	string	自定义项13
define14	自定义项14	string	自定义项14
define15	自定义项15	string	自定义项15
define16	自定义项16	string	自定义项16
auditdate	审核日期	string	审核日期
personname	业务员名称	string	业务员名称
saletypename	销售类型名称	string	销售类型名称
customername	客户名称	string	客户名称
timestamp	时间戳	string	时间戳
entry	分录	array	分录
entry.barcode	条形码	string	条形码
entry.inventorycode	存货编码	string	存货编码
entry.free1	存货自由项1	string	存货自由项1
entry.free2	存货自由项2	string	存货自由项2
entry.free3	存货自由项3	string	存货自由项3
entry.free4	存货自由项4	string	存货自由项4
entry.free5	存货自由项5	string	存货自由项5
entry.free6	存货自由项6	string	存货自由项6
entry.free7	存货自由项7	string	存货自由项7
entry.free8	存货自由项8	string	存货自由项8
entry.free9	存货自由项9	string	存货自由项9
entry.free10	存货自由项10	string	存货自由项10
entry.shouldquantity	应发数量	string	应发数量
entry.shouldnumber	应发件数	string	应发件数
entry.quantity	数量	string	数量
entry.cmassunitname	主计量单位	string	主计量单位
entry.assitantunit	库存单位码	string	库存单位码
entry.assitantunitname	库存单位	string	库存单位
entry.irate	换算率	string	换算率
entry.number	件数	string	件数
entry.price	单价	string	单价
entry.cost	金额	string	金额
entry.serial	批号	string	批号
entry.makedate	生产日期	string	生产日期
entry.validdate	失效日期	string	失效日期
entry.define22	表体自定义项1	string	表体自定义项1
entry.define23	表体自定义项2	string	表体自定义项2
entry.define24	表体自定义项3	string	表体自定义项3
entry.define25	表体自定义项4	string	表体自定义项4
entry.define26	表体自定义项5	string	表体自定义项5
entry.define27	表体自定义项6	string	表体自定义项6
entry.define28	表体自定义项7	string	表体自定义项7
entry.define29	表体自定义项8	string	表体自定义项8
entry.define30	表体自定义项9	string	表体自定义项9
entry.define31	表体自定义项10	string	表体自定义项10
entry.define32	表体自定义项11	string	表体自定义项11
entry.define33	表体自定义项12	string	表体自定义项12
entry.define34	表体自定义项13	string	表体自定义项13
entry.define35	表体自定义项14	string	表体自定义项14
entry.define36	表体自定义项15	string	表体自定义项15
entry.define37	表体自定义项16	string	表体自定义项16
entry.rowno	行号	string	行号
entry.subconsignmentcode	发货单号	string	发货单号
entry.ordercode	订单号	string	订单号

旺店通·企业奇门接口明细

• 接口：wdt.trade.push
• 接口名称：创建原始订单
• 接口方法：POST

请求参数

字段	名称	类型	描述
shop_no	店铺编号	string	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置，查看路径ERP→设置→基本设置→店铺→店铺列表），用于创建指定店铺单据信息，测试环境店铺编号信息同接口账号。ERP内shop_no对应的“店铺平台”必须为“自有”。正式环境店铺创建成功后ERP会自动授权，如果自动授权失败，在ERP店铺界面（路径ERP→设置→基本设置→店铺→店铺列表）选中授权失败的店铺，点击店铺界面提供的店铺授权按钮重新授权。
switch	模式	string	0:非严格模式,1:严格模式,默认1。
trade_list	订单列表节点	array	请求参数的1级数据节点，包含销售订单所有属性信息的数据节点，节点下数据字段详见下述“trade_list”
trade_list.tid	原始单号	string	指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。
trade_list.trade_status	平台状态	string	平台订单状态较多且涉及变更，详情介绍单击这里
trade_list.pay_status	支付状态	string	平台订单付款状态:0:未付款,1:部分付款,2:已付款
trade_list.delivery_term	发货条件	string	1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账
trade_list.trade_time	下单时间	string	平台订单创建时间,时间格式：yyyy-MM-dd HH:mm:ss
trade_list.pay_time	支付时间	string	平台订单付款时间,时间格式：yyyy-MM-dd HH:mm:ss，未付款订单为:0000-00-00 00:00:00
trade_list.fenxiao_type	分销类别	string	0非分销订单 1转供销 2代销 3经销
trade_list.purchase_id	采购单ID	string	转供销情况下，采购单ID
trade_list.fenxiao_nick	分销商id	string	分销订单的分销商id,或转供销时供应商id
trade_list.buyer_nick	客户网名	string	平台买家昵称，注意：一次推送网名相同的订单不能超过30
trade_list.buyer_email	买家email	string	买家email
trade_list.pay_id	支付单号	string	支付单号
trade_list.pay_account	支付账号	string	支付账号
trade_list.receiver_name	收件人	string	收件人姓名
trade_list.receiver_province	省份	string	收件人省份，需与旺店通地址库匹配，点击查看，如果不传省市区，则会尝试从详细地址解析省市区，必须是空格分隔的才能解析成功，需要注意直辖市的地址格式，举例“北京 北京市 海淀区 花园路xxxx”
trade_list.receiver_city	城市	string	收件人城市，需与旺店通地址库匹配，点击查看
trade_list.receiver_district	区县	string	收件人区县，需与旺店通地址库匹配，点击查看
trade_list.receiver_address	地址详情	string	收件人地址详情
trade_list.receiver_mobile	手机	string	手机号码
trade_list.receiver_telno	电话	string	电话号码
trade_list.receiver_zip	邮编	string	收件人邮编
trade_list.logistics_type	物流方式	string	不传本参数，输入值默认-1，表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里
trade_list.invoice_kind	发票类别	string	0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票
trade_list.invoice_title	发票抬头	string	发票抬头
trade_list.invoice_content	发票内容	string	常见内容：纳税人识别号、地址、电话、开户银行、银行账户，按照以下格式推送，系统开发票时可解析。
trade_list.remark_flag	客户备注标旗	string	客户备注标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0
trade_list.buyer_message	买家备注	string	买家下单时填写的订单备注
trade_list.seller_memo	客服备注	string	商家客服对订单进行的备注内容
trade_list.seller_flag	标旗	string	客服标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0
trade_list.post_amount	邮费	string	商家收取买家的物流或者快递费用
trade_list.cod_amount	货到付款金额	string	货到付款金额
trade_list.ext_cod_fee	货到付款买家费用	string	货到付款买家费用，扣除货到付款订单金额后，卖家仍需支付的货到付款其他金额。这个钱卖家收不回来，是快递公司直接收走，但在快递单里是要打印出来，否则快递收款就错了
trade_list.other_amount	其它收费	string	其它应从买家收取的服务费，其他费用
trade_list.paid	已付	string	订单已付金额，paid计算公式：paid = Σ(price * num + adjust_amount -discount – share_discount）+ post_amount+other_amount，所有金额相关字段推送处理办法，单击这里
trade_list.id_card_type	证件类型	string	1:身份证
trade_list.id_card	证件号码	string	证件号码
trade_list.is_auto_wms	自动流转模式	string	是否为自动流转模式（1：是 0：不是 不传默认0），非自动流转模式一定不要传值。自动流转模式处理办法，”自动流转模式处理办法详解”)单击这里
trade_list.wms_type	仓库类型	string	非自动流转模式一定不要传值
trade_list.warehouse_no	仓库编号	string	ERP内自定义的仓库编号，查看路径ERP→设置→基本设置→仓库→仓库列表，测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时，传哪个仓库的编号，ERP将为订单选择哪个仓库。
trade_list.order_list	订单货品明细节点	array	货品明细列表（子订单列表）节点
trade_list.order_list.oid	子订单编号	string	平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid（子订单编号）要保证唯一；如果oid重复,ERP生成系统单（递交）时会提示“订单货品数量不一致xxxxxx”
trade_list.order_list.num	数量	string	货品数量，订单推送成功以后本字段值不能更改
trade_list.order_list.price	单价	string	标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改
trade_list.order_list.status	状态	string	平台子订单状态，子订单状态可以和主订单不一样，比如其中一个子订单退款完成，其状态是80，但主订单仍然是待发货，可选值同trade_status
trade_list.order_list.refund_status	退款状态	string	0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候，根据不同的场景填写不同的值，eg：申请退款值为2，取消退款值为1……
trade_list.order_list.goods_id	平台货品ID	string	平台系统货品（SPU）的唯一标识。goods_id不能为空，SPU和SKU概念介绍，单击这里
trade_list.order_list.spec_id	平台规格ID	string	平台系统单品（SKU）的的唯一标识，尽量不为空，SPU和SKU概念介绍，单击这里
trade_list.order_list.goods_no	货品编码	string	平台货品SPU编码，对应ERP货品编号，尽量不为空
trade_list.order_list.spec_no	规格编码	string	平台货品SKU唯一码，对应ERP商家编码，goods_no和spec_no不能同时为空
trade_list.order_list.goods_name	货品名称	string	平台货品名称
trade_list.order_list.spec_name	规格名称	string	平台货品规格名称
trade_list.order_list.adjust_amount	调整	string	客服调整总金额(大于0加价，小于0减价，是折扣来源的一部分,没有传0)
trade_list.order_list.discount	优惠	string	下单总折扣，客户下单时折扣(比如促销打折，不包含客服调整、分摊折扣，没有传0)
trade_list.order_list.share_discount	分摊优惠	string	分摊总折扣，由总订单分摊而来，一般是付款时产生，如使用优惠券，没有传0。分摊优惠传值注意：例如三个商品，优惠10，分摊优惠可以是：3/3/4，或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算
trade_list.order_list.remark	备注	string	货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上
trade_list.order_list.cid	类目	string	平台货品所属类目

系统对接总览

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向用友U8、旺店通·企业奇门间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。

系统数据对接方案元数据代码