聚水潭订单上传(商家自有商城、跨境线下)API接口文档
所属平台：
聚水潭
类型：
WebAPI
作用：
EXECUTE
接口版本：
1.0
适配器：
\Adapter\Jushuitan\V2\JstExecuteAdapter
描述：
更新日期：
2022-11-18 18:09:13
订单上传(商家自有商城、跨境线下)
接口地址：/open/jushuitan/orders/upload
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | shop_id | 店铺编码 | string | 店铺编号（店铺设置界面的编号字段）：仅支持创建到商家自有商城站点、跨境线下平台、线下店铺站点、B2B站点 ； 可通过店铺查询接口获取：https://openweb.jushuitan.com/dev-doc?docType=1&docId=1。关于【商家自有商城】的店铺如何创建，可查看操作 http://www.erp321.com/app/support/document.html#page=1865 | 否 | |
| 2 | so_id | 线上单号 | string | 自研商城系统订单号,长度<=50，自有商城店铺中唯一值不允许重复单号上传 | 否 | |
| 3 | order_date | 订单日期 | string | 订单日期（不能传订单归档日期前的日期） | 否 | |
| 4 | shop_status | 订单 | string | 自研商城系统订单状态：等待买家付款=WAIT_BUYER_PAY，等待卖家发货=WAIT_SELLER_SEND_GOODS（传此状态时实际支付金额即pay节点支付金额=应付金额ERP才会显示已付款待审核）,等待买家确认收货=WAIT_BUYER_CONFIRM_GOODS,交易成功=TRADE_FINISHED,付款后交易关闭=TRADE_CLOSED,付款前交易关闭=TRADE_CLOSED_BY_TAOBAO；发货前可更新 | 否 | |
| 5 | shop_buyer_id | 买家账号 | string | 买家帐号，长度<=50 | 否 | |
| 6 | receiver_state | 收货省份 | string | 收货省份，长度<=50；发货前可更新 | 否 | |
| 7 | receiver_city | 收货市 | string | 收货市，长度<=50；发货前可更新 | 否 | |
| 8 | receiver_district | 收货区 | string | 收货区/街道，长度<=50；发货前可更新 | 否 | |
| 9 | receiver_address | 收货地址 | string | 收货地址，长度<=200；发货前可更新 | 否 | |
| 10 | receiver_name | 收件人 | string | 收件人，长度<=50；发货前可更新 | 否 | |
| 11 | receiver_phone | 联系电话 | string | 联系电话，长度<=50；发货前可更新 | 否 | |
| 12 | receiver_mobile | 手机 | string | 手机，长度<=50；发货前可更新 | 否 | |
| 13 | pay_amount | 应付金额 | string | 应付金额，保留两位小数，单位元） | 否 | |
| 14 | freight | 运费 | string | 运费 | 否 | |
| 15 | buyer_message | 买家留言 | string | 买家留言，长度<=400；可更新 | 否 | |
| 16 | remark | 卖家备注 | string | 卖家备注，长度<=150；可更新 | 否 | |
| 17 | l_id | 快递单号 | string | 快递单号 | 否 | |
| 18 | logistics_company | 快递公司名称 | string | 快递公司名称，需要先在系统【物流(快递)公司及打印模板】页面中配置对应的物流公司及编码，如选择现场取货收件人信息非必填手机和电话必填一项即可 | 否 | |
| 19 | lc_id | 快递公司id | string | 快递公司编码，需要先在系统【物流(快递)公司及打印模板】页面中配置对应的物流公司及编码 | 否 | |
| 20 | node | 线下备注 | string | 线下备注 | 否 | |
| 21 | items | 商品列表 | array | 商品列表 | 否 | |
| 21.1 | remark | 订单明细备注 | string | 订单明细备注 | 否 | |
| 21.2 | shop_sku_id | 店铺商品编码 | string | 店铺商品编码，对应店铺商品管理页面的平台店铺商品编码，店铺商品编码长度<=128，店铺商品资料未维护可自定义值上传 | 否 | |
| 21.3 | i_id | ERP内款号 | string | ERP内款号/货号长度<=40 | 否 | |
| 21.4 | pic | 图片地址 | string | 图片地址 | 否 | |
| 21.5 | base_price | 原价 | string | 原价，保留两位小数，单位（元） | 否 | |
| 21.6 | qty | 数量 | string | 数量 | 否 | |
| 21.7 | refund_status | PS | string | PS：值存在，会自动将订单转异常,success状态的，发货将不发该商品，不支持单商品发部分;退款状态:可选退款中=waiting;退款成功=success（订单的全部商品传此状态，订单会被取消）,closed=退款关闭:发货前可更新 | 否 | |
| 21.8 | outer_oi_id | 商家系统订单商品明细主键 | string | 商家系统订单商品明细主键,为了拆单合单时溯源，最长不超过50,保持订单内唯一，支持自定义 | 否 | |
| 21.9 | amount | 金额 | string | 成交总额，保留两位小数，单位（元）；备注：可能存在人工改价 | 否 | |
| 21.10 | name | 商品名称 | string | 商品名称长度<=100 | 否 | |
| 22 | sku_id | ERP内商品编码 | string | 商品编码，对应普通商品资料页面商品编码，ERP内商品编码长度<=40PS:设置预售标识订单，修改商品编码=商品编码+预售（或==）+预计发货日期（可选）比如:"A321232"修改为"A321232预售2015-12-12"或者"A321232"修改为"A321232==2015-12-12"当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码 | 否 | |
| 23 | properties_value | 商品属性 | string | 商品属性；长度<=100 | 否 | |
| 24 | pay | shop_status | array | shop_status | 否 | |
| 24.1 | amount | 支付总金额 | string | 支付总额 | 否 | |
| 24.2 | outer_pay_id | 外部支付单号 | string | 外部支付单号 | 否 | |
| 24.3 | pay_date | 支付日期 | string | 支付日期 | 否 | |
| 24.4 | payment | 支付方式 | string | payment | 否 | |
| 24.5 | seller_account | 卖家支付账号 | string | 卖家支付账号 | 否 | |
| 24.6 | buyer_account | 买家支付账号 | string | 买家支付账号 | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|
聚水潭的接口：订单上传(商家自有商城、跨境线下)（/open/jushuitan/orders/upload），由轻易云数据集成平台API资产管理模块整理收纳，并且根据聚水潭版本更新同步实时更新。API资产管理平台提供了API文档的自动生成和发布功能，帮助开发者快速理解API的功能和使用方法，提高开发效率和质量。
