旺店通·企业奇门创建原始订单_v1 API

Platform: 旺店通·企业奇门
Type: WebAPI
Effect: EXECUTE
API Version: 0.1
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: 2021-07-21

创建原始订单_v1

POSTwdt.trade.push

Factory

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

Request Parameters

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

Response Parameters

No parameter reference available

The 创建原始订单_v1 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.