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

Platform: 旺店通·企业奇门
Type: EXECUTE
Effect: EXECUTE
API Version: 1.0
Adapter: \Adapter\Wdt\WdtQMExecuteAdapter
Auth Mode: OTHER
Help Link: https://open.wangdian.cn/qyb/open/apidoc/doc?path=trade_push.php
Doc Link: https://open.wangdian.cn/qyb/open/apidoc/doc?path=trade_push.php
Updated At: 2023-05-31

创建原始订单（奇门）V3.0

POSTwdt.trade.push

Factory

{
  "operation": {
    "method": "none"
  }
}

Request Parameters

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

Response Parameters

No.	Field	Name	Type	Default	Required	Description
1	primaryWriteback	primaryWriteback	object	—	Optional	primaryWriteback
1.1	errorcode	Id	string	{{errorcode}}	Optional	Id
2	callBackStrategy	回写方案	object	—	Optional	回写方案
2.1	strategyId	方案ID	string	40ae579d-f55c-39d1-8abd-b3e2cd665b88	Required	方案ID
2.2	FBillNo	单据编号	string	{{FBillNo}}	Optional	单据编号
2.3	FID	单据编号	string	{{FID}}	Optional	单据编号

The 创建原始订单（奇门）V3.0 API (wdt.trade.push) of 旺店通·企业奇门 is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 旺店通·企业奇门 version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.