聚水潭订单上传_v1API接口文档
所属平台：
聚水潭
类型：
WebAPI
作用：
EXECUTE
接口版本：
0.1
适配器：
\Adapter\Jushuitan\JushuitanExecuteAdapter
描述：
更新日期：
2022-03-08 15:21:33
订单上传_v1
接口地址：jushuitan.orders.upload
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | shop_id | shop_id | string | 1 | 店铺编号 | 是 |
| 2 | so_id | so_id | string | 1 | 线上订单号, 长度 <= 50 | 是 |
| 3 | order_date | order_date | string | 1 | 订单日期 | 是 |
| 4 | shop_status | shop_status | string | 1 | 订单： 等待买家付款=WAIT_BUYER_PAY， 等待卖家发货=WAIT_SELLER_SEND_GOODS,等待买家确认收货=WAIT_BUYER_CONFIRM_GOODS, 交易成功=TRADE_FINISHED, 付款后交易关闭=TRADE_CLOSED,付款前交易关闭=TRADE_CLOSED_BY_TAOBAO；发货前可更新 | 是 |
| 5 | shop_buyer_id | shop_buyer_id | string | 1 | 买家帐号 长度 <= 50 | 是 |
| 6 | receiver_state | receiver_state | string | 1 | 收货省份 长度 <= 50；发货前可更新 | 是 |
| 7 | receiver_city | receiver_city | string | 1 | 收货市 长度<=50；发货前可更新 | 是 |
| 8 | receiver_district | receiver_district | string | 1 | 收货区 长度<=50；发货前可更新 | 是 |
| 9 | receiver_address | receiver_address | string | 1 | 收货地址 长度<=200；发货前可更新 | 是 |
| 10 | receiver_name | receiver_name | string | 1 | 收件人 长度<=50；发货前可更新 | 是 |
| 11 | receiver_phone | receiver_phone | string | 1 | 联系电话 长度<=50；发货前可更新 | 是 |
| 12 | receiver_mobile | receiver_mobile | string | 1 | 手机 长度<=50；发货前可更新 | 否 |
| 13 | pay_amount | pay_amount | string | 1 | 应付金额，保留两位小数，单位元） | 是 |
| 14 | freight | freight | string | 1 | 运费 | 是 |
| 15 | buyer_message | buyer_message | string | 1 | 买家留言 长度<=400；可更新 | 否 |
| 16 | remark | remark | string | 1 | 卖家备注 长度<=150；可更新 | 否 |
| 17 | is_cod | is_cod | string | 1 | 是否货到付款 | 否 |
| 18 | shop_modified | shop_modified | string | 1 | 订单修改日期 | 是 |
| 19 | l_id | l_id | string | 1 | 快递单号 | 否 |
| 20 | logistics_company | logistics_company | string | 1 | 快递公司名称 | 否 |
| 21 | question_desc | question_desc | string | 1 | 订单异常描述 | 否 |
| 22 | seller_flag | seller_flag | string | 1 | 卖家标签（旗帜），可选1:red, 2:yellow, 3:green, 4:blue, 5:purple | 否 |
| 23 | items | items | array | 1 | 商品明细 | 是 |
| 24 | sku_id | sku_id | string | 1 | ERP内商品编码 长度 <=40 PS: 设置预售标识订单，修改商品编码=商品编码+预售（或==）+预计交货日期（可选） 比如: "A321232" 修改为 "A321232预售2015-12-12" 或者 "A321232" 修改为 "A321232==2015-12-12" 当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码 | 是 |
| 25 | shop_sku_id | shop_sku_id | string | 1 | 店铺商品编码 长度<=128 | 是 |
| 26 | i_id | i_id | string | 1 | ERP内款号/货号 长度<=40 | 否 |
| 27 | pic | pic | string | 1 | 图片地址 长度<=300 | 否 |
| 28 | properties_value | properties_value | string | 1 | 商品属性；长度<=100 | 否 |
| 29 | amount | amount | string | 1 | 成交总额，保留两位小数，单位（元）；备注：可能存在人工改价 | 是 |
| 30 | base_price | base_price | string | 1 | 原价，保留两位小数，单位（元） | 是 |
| 31 | qty | qty | string | 1 | 数量 | 是 |
| 32 | name | name | string | 1 | 商品名称 长度<=100 | 是 |
| 33 | refund_status | refund_status | string | 1 | PS：值存在，会自动将订单转异常,success 状态的，发货将不发该商品，不支持单商品发部分; 退款状态:可选 退款中=waiting; 退款成功=success,closed=退款关闭:发货前可更新 | 否 |
| 34 | outer_oi_id | outer_oi_id | string | 1 | 商家系统订单商品明细主键,为了拆单合单时溯源，最长不超过 50,保持唯一 | 是 |
| 35 | remark | remark | string | 1 | 订单明细备注 | 否 |
| 36 | pay | pay | array | 1 | shop_status=WAIT_BUYER_PAY 的时候可不给 | 否 |
| 37 | outer_pay_id | outer_pay_id | string | 1 | 外部支付单号，最大50 | 是 |
| 38 | pay_date | pay_date | string | 1 | 支付日期 | 是 |
| 39 | payment | payment | string | 1 | 支付方式，最大20 | 是 |
| 40 | seller_account | seller_account | string | 1 | 卖家支付账号，最大 50 | 是 |
| 41 | buyer_account | buyer_account | string | 1 | 买家支付账号，最大 200 | 是 |
| 42 | amount | amount | string | 1 | 支付总额 | 是 |
| 43 | card | card | array | 1 | 身份证信息；非必填节点 | 否 |
| 44 | name | name | string | 1 | 姓名；可更新，card节点存在必填 | 是 |
| 45 | card_id | card_id | string | 1 | 证件号；可更新，card节点存在必填 | 是 |
| 46 | send_date | send_date | string | 1 | 发货日期 | 否 |
| 47 | labels | labels | string | 1 | 订单多标签 长度<=200 以逗号分隔，单个标签不能超过十个字符 | 否 |
| 48 | lc_id | lc_id | string | 1 | 快递公司编码 | 否 |
| 49 | receiver_country | receiver_country | string | 1 | 收货国家 仅支持二字码 | 否 |
| 50 | receiver_zip | receiver_zip | string | 1 | 邮政编码 | 否 |
| 51 | currency | currency | string | 1 | 货币代码，跨境自有平台可使用 | 否 |
| 52 | invoice_type | invoice_type | string | 1 | 发票类型：个人电子普通;单位电子普通;个人纸质普通;单位纸质普通;个人电子增值税;单位电子增值税;个人纸质增值税;单位纸质增值税 | 否 |
| 53 | invoice_title | invoice_title | string | 1 | 发票抬头 | 否 |
| 54 | buyer_tax_no | buyer_tax_no | string | 1 | 发票税号 | 否 |
| 55 | invoice | invoice | array | 1 | 专票信息 | 否 |
| 56 | address | address | string | 1 | 专票地址 | 否 |
| 57 | bank | bank | string | 1 | 专票银行 | 否 |
| 58 | phone | phone | string | 1 | 专票电话 | 否 |
| 59 | account | account | string | 1 | 专票账户 | 否 |
| 60 | string | 1 | 专票邮箱 | 否 | ||
| 61 | userName | userName | string | 1 | 专票人姓名 | 否 |
| 62 | userPhone | userPhone | string | 1 | 专票人电话 | 否 |
| 63 | userAddress | userAddress | string | 1 | 专票人地址 | 否 |
| 64 | node | node | string | 1 | 线下备注 | 否 |
| 65 | receiver_town | receiver_town | string | 1 | 收货街道 | 否 |
| 66 | receiver_email | receiver_email | string | 1 | 收获邮箱（需符合邮箱格式否则忽略上传，不可更新） | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|
聚水潭的接口：订单上传_v1（jushuitan.orders.upload），由轻易云数据集成平台API资产管理模块整理收纳，并且根据聚水潭版本更新同步实时更新。API资产管理平台提供了丰富的API开发和测试工具，支持API的快速迭代和创新，加速产品的上市速度，提升企业的市场竞争力。
