旺店通·企业奇门创建原始订单（奇门）V3.0API接口文档

所属平台： 旺店通·企业奇门
类型： EXECUTE
作用： EXECUTE
接口版本： 1.0
适配器： \Adapter\Wdt\WdtQMExecuteAdapter
帮助链接： https://open.wangdian.cn/qyb/open/apidoc/doc?path=trade_push.php
描述：
更新日期： 2023-05-31 19:08:52
创建原始订单（奇门）V3.0

接口地址：wdt.trade.push

请求方法： POST

加工厂： {"operation":{"method":"none"}}

接口请求参数
序号 字段 名称 类型 默认值 描述 是否必要
1 tid 原始单号 string {{details_list.F_VTRK_Text}}-{{details_list.FEntity_FENTRYID}}_{{FID}} 指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。 否
2 trade_status 平台状态 string 30 平台订单状态较多且涉及变更，详情介绍单击这里 否
3 pay_status 支付状态 string 2 平台订单付款状态:0:未付款,1:部分付款,2:已付款 否
4 delivery_term 发货条件 string 1 1:款到发货,2:货到付款(包含部分货到付款),3:分期付款,4:挂账 否
5 trade_time 下单时间 string {{FDate}} 平台订单创建时间,时间格式：yyyy-MM-dd HH:mm:ss 否
6 pay_time 支付时间 string {{FDate}} 平台订单付款时间,时间格式：yyyy-MM-dd HH:mm:ss，未付款订单为:0000-00-00 00:00:00 否
7 fenxiao_type 分销类别 string 0 0非分销订单 1转供销 2代销 3经销 否
8 purchase_id 采购单ID string 转供销情况下，采购单ID 否
9 fenxiao_nick 分销商id string 分销订单的分销商id,或转供销时供应商id 否
10 buyer_nick 客户网名 string {{FCustomerID_FName}} 平台买家昵称，注意：一次推送网名相同的订单不能超过30 否
11 buyer_email 买家email string 买家email 否
12 pay_id 支付单号 string 支付单号 否
13 pay_account 支付账号 string 支付账号 否
14 receiver_name 收件人 string {{details_list.F_VTRK_Text1}} 收件人姓名 否
15 receiver_address 地址详情 string {{details_list.F_VTRK_Text3}} 收件人地址详情 否
16 receiver_province 省份 string {{details_list.F_VTRK_Text11}} 收件人省份 否
17 receiver_city 城市 string {{details_list.F_VTRK_Text12}} 收件人城市 否
18 receiver_district 区县 string {{details_list.F_VTRK_Text13}} 收件人区县 否
19 receiver_mobile 手机 string {{details_list.F_VTRK_Text2}} 手机号码 否
20 receiver_telno 电话 string {{FLINKPHONE}} 电话号码 否
21 receiver_zip 邮编 string 收件人邮编 否
22 logistics_type 物流方式 string -1 不传本参数，输入值默认-1，表示由ERP系统策略选择。平台指定订单发货物流可选输入值单击这里 否
23 invoice_kind 发票类别 string 0 0:不需要,1:普通发票,2:增值税普通发票电子,3:增值税普通发票纸质,4:增值税专用发票 否
24 invoice_title 发票抬头 string 发票抬头 否
25 invoice_content 发票内容 string 常见内容：纳税人识别号、地址、电话、开户银行、银行账户，按照以下格式推送，系统开发票时可解析。 否
26 remark_flag 客户备注标旗 string 客户备注标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 否
27 buyer_message 买家备注 string 买家下单时填写的订单备注 否
28 seller_memo 客服备注 string 金蝶云星空上传单据 商家客服对订单进行的备注内容 否
29 seller_flag 标旗 string 0 客服标旗，取值0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫，不传默认0 否
30 post_amount 邮费 string 0 商家收取买家的物流或者快递费用 否
31 cod_amount 货到付款金额 string 0 货到付款金额 否
32 ext_cod_fee 货到付款买家费用 string 0 货到付款买家费用，扣除货到付款订单金额后，卖家仍需支付的货到付款其他金额。这个钱卖家收不回来，是快递公司直接收走，但在快递单里是要打印出来，否则快递收款就错了 否
33 other_amount 其它收费 string 0 其它应从买家收取的服务费，其他费用 否
34 paid 已付 string 0 订单已付金额，paid计算公式：paid = Σ(price * num + adjust_amount -discount – share_discount）+ post_amount+other_amount，所有金额相关字段推送处理办法，单击这里 否
35 is_auto_wms 自动流转模式 string 0 是否为自动流转模式（1：是 0：不是 不传默认0），非自动流转模式一定不要传值。自动流转模式处理办法，”自动流转模式处理办法详解”)单击这里 否
36 warehouse_no 仓库编号 string {{details_list.FStockID_FNumber}} ERP内自定义的仓库编号，查看路径ERP→设置→基本设置→仓库→仓库列表，测试环境仓库编号查看测试环境分配邮件。平台订单需指定ERP内仓库时，传哪个仓库的编号，ERP将为订单选择哪个仓库。 否
37 order_list 订单货品明细节点 array details_list 货品明细列表（子订单列表）节点 否
37.1 oid 子订单编号 string {{details_list.bfn_id}}{{FBillNo}} 平台订单货品表主键,子订单唯一标识,同一个sid下通过本接口新增订单的oid（子订单编号）要保证唯一；如果oid重复,ERP生成系统单（递交）时会提示“订单货品数量不一致xxxxxx” 否
37.2 num 数量 string {{details_list.FEntry_FRealQty}} 货品数量，订单推送成功以后本字段值不能更改 否
37.3 price 单价 string 0 标价,折扣前的价格,可以推送价格为0的商品。订单推送成功以后本字段值不能更改 否
37.4 status 状态 string 30 平台子订单状态，子订单状态可以和主订单不一样，比如其中一个子订单退款完成，其状态是80，但主订单仍然是待发货，可选值同trade_status 否
37.5 refund_status 退款状态 string 0 0:无退款,1:取消退款,2:已申请退款,3:等待退货,4:等待收货,5:退款成功。本字段在售前退款的时候，根据不同的场景填写不同的值，eg：申请退款值为2，取消退款值为1…… 否
37.6 goods_id 平台货品ID string {{details_list.FEntry_FMaterialID_FNumber}} 平台系统货品（SPU）的唯一标识。goods_id不能为空，SPU和SKU概念介绍，单击这里 否
37.7 spec_id 平台规格ID string {{details_list.FEntry_FMaterialID_FNumber}} 平台系统单品（SKU）的的唯一标识，尽量不为空，SPU和SKU概念介绍，单击这里 否
37.8 goods_no 货品编码 string {{details_list.FEntry_FMaterialID_FNumber}} 平台货品SPU编码，对应ERP货品编号，尽量不为空 否
37.9 spec_no 规格编码 string {{details_list.FEntry_FMaterialID_FNumber}} 平台货品SKU唯一码，对应ERP商家编码，goods_no和spec_no不能同时为空 否
37.10 goods_name 货品名称 string {{details_list.FEntry_FMaterialName}} 平台货品名称 否
37.11 spec_name 规格名称 string 平台货品规格名称 否
37.12 adjust_amount 调整 string 0 客服调整总金额(大于0加价，小于0减价，是折扣来源的一部分,没有传0) 否
37.13 discount 优惠 string 0 下单总折扣，客户下单时折扣(比如促销打折，不包含客服调整、分摊折扣，没有传0) 否
37.14 share_discount 分摊优惠 string 0 分摊总折扣，由总订单分摊而来，一般是付款时产生，如使用优惠券，没有传0。分摊优惠传值注意：例如三个商品，优惠10，分摊优惠可以是：3/3/4，或者3.33/3.33/3.34.即最后一个商品的分摊优惠使用减法计算 否
37.15 remark 备注 string 货品明细备注推送此字段ERP客户端需升级至V2.3.9.2及以上 否
37.16 cid 类目 string 平台货品所属类目 否
接口响应参数
序号 字段 名称 类型 默认值 描述 是否必要
1 primaryWriteback primaryWriteback object primaryWriteback 否
1.1 errorcode Id string {{errorcode}} Id 否
2 callBackStrategy 回写方案 object 回写方案 否
2.1 strategyId 方案ID string 40ae579d-f55c-39d1-8abd-b3e2cd665b88 方案ID 是
2.2 FBillNo 单据编号 string {{FBillNo}} 单据编号 否
2.3 FID 单据编号 string {{FID}} 单据编号 否
旺店通·企业奇门的接口：创建原始订单（奇门）V3.0（wdt.trade.push），由轻易云数据集成平台API资产管理模块整理收纳，并且根据旺店通·企业奇门版本更新同步实时更新。通过API资产管理，企业能够实现API的集中监控和分析，及时发现并解决潜在的性能瓶颈和安全风险，保障业务的连续性和稳定性。
联系轻易云集成专家
联系系统对接开发人员胡秀丛

胡秀丛 加微信

15813570600

项目总监 她以卓越的数据集成专长，精通ERP、MES系统，以及数据中台的构建与优化。通过创新的一站式解决方案，她助力企业实现数据的无缝对接，提升业务流程效率，确保信息流通无障碍，为企业的数字化转型提供强有力的支持。

旺店通金蝶对接业财一体化数据集成方案包全业务流程图下载
更多系统对接方案