聚水潭订单上传(商家自有商城、跨境线下)接口

所属平台: 聚水潭
类型: WebAPI
作用: EXECUTE
接口版本: 1.0
适配器: \Adapter\Jushuitan\V2\JstExecuteAdapter
授权方式: OTHER
帮助链接: https://bbs.qeasy.cloud/d/846-ju-shui-tan-shuo-ming-zong-lan
文档链接: https://openweb.jushuitan.com/dev-doc?docType=4&docId=22
更新日期: 2022-11-18

订单上传(商家自有商城、跨境线下)

POST/open/jushuitan/orders/upload

加工厂

{
  "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 资产管理模块整理收纳，并随聚水潭版本更新同步更新。

需要对接这个接口？

轻易云已预置该接口的适配能力，联系我们即可开始配置数据集成。

联系我们