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