wdt.trade.push{
"operation": {
"method": "none"
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | tid | tid | string | 1 | 可选 | 指商城、官网等平台的订单编号，ERP称之为原始单号，同一个sid下通过本接口新增订单的tid保证唯一。 |
| 2 | shop_no | shop_no | string | 1 | 可选 | 代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置，查看路径ERP→设置→基本设置→店铺→店铺列表），用于创建指定店铺单据信息，测试环境店铺编号信息同接口账号。ERP内shop_no对应的“店铺平台”必须为“自有”。正式环境店铺创建成功后ERP会自动授权，如果自动授权失败，在ERP店铺界面（路径ERP→设置→基本设置→店铺→店铺列表）选中授权失败的店铺，点击店铺界面提供的店铺授权按钮重新授权。 |
| 3 | trade_status | trade_status | string | 1 | 可选 | 平台订单状态较多且涉及变更，详情介绍单击这里 |
| 4 | switch | switch | string | 1 | 可选 | 0:非严格模式,1:严格模式,默认1。 |
| 5 | trade_list | trade_list | array | 1 | 可选 | 请求参数的1级数据节点，包含销售订单所有属性信息的数据节点，节点下数据字段详见下述“trade_list” |
| 6 | pay_status | pay_status | string | 1 | 可选 | 平台订单付款状态:0:未付款,1:部分付款,2:已付款 |
| 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 资产管理模块整理收纳，并随旺店通·企业奇门版本更新同步更新。