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

Platform: 聚水潭
Type: WebAPI
Effect: EXECUTE
API Version: 1.0
Adapter: \Adapter\Jushuitan\V2\JstExecuteAdapter
Auth Mode: OTHER
Help Link: https://bbs.qeasy.cloud/d/846-ju-shui-tan-shuo-ming-zong-lan
Doc Link: https://openweb.jushuitan.com/dev-doc?docType=4&docId=22
Updated At: 2022-11-18

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

POST/open/jushuitan/orders/upload

Factory

{
  "operation": {
    "method": "none"
  }
}

Request Parameters

No.	Field	Name	Type	Default	Required	Description
1	shop_id	店铺编码	string	—	Optional	店铺编号（店铺设置界面的编号字段）：仅支持创建到商家自有商城站点、跨境线下平台、线下店铺站点、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	—	Optional	自研商城系统订单号,长度<=50，自有商城店铺中唯一值不允许重复单号上传
3	order_date	订单日期	string	—	Optional	订单日期（不能传订单归档日期前的日期）
4	shop_status	订单	string	—	Optional	自研商城系统订单状态：等待买家付款=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	—	Optional	买家帐号，长度<=50
6	receiver_state	收货省份	string	—	Optional	收货省份，长度<=50；发货前可更新
7	receiver_city	收货市	string	—	Optional	收货市，长度<=50；发货前可更新
8	receiver_district	收货区	string	—	Optional	收货区/街道，长度<=50；发货前可更新
9	receiver_address	收货地址	string	—	Optional	收货地址，长度<=200；发货前可更新
10	receiver_name	收件人	string	—	Optional	收件人，长度<=50；发货前可更新
11	receiver_phone	联系电话	string	—	Optional	联系电话，长度<=50；发货前可更新
12	receiver_mobile	手机	string	—	Optional	手机，长度<=50；发货前可更新
13	pay_amount	应付金额	string	—	Optional	应付金额，保留两位小数，单位元）
14	freight	运费	string	—	Optional	运费
15	buyer_message	买家留言	string	—	Optional	买家留言，长度<=400；可更新
16	remark	卖家备注	string	—	Optional	卖家备注，长度<=150；可更新
17	l_id	快递单号	string	—	Optional	快递单号
18	logistics_company	快递公司名称	string	—	Optional	快递公司名称，需要先在系统【物流(快递)公司及打印模板】页面中配置对应的物流公司及编码，如选择现场取货收件人信息非必填手机和电话必填一项即可
19	lc_id	快递公司id	string	—	Optional	快递公司编码，需要先在系统【物流(快递)公司及打印模板】页面中配置对应的物流公司及编码
20	node	线下备注	string	—	Optional	线下备注
21	items	商品列表	array	—	Optional	商品列表
21.1	remark	订单明细备注	string	—	Optional	订单明细备注
21.2	shop_sku_id	店铺商品编码	string	—	Optional	店铺商品编码，对应店铺商品管理页面的平台店铺商品编码，店铺商品编码长度<=128，店铺商品资料未维护可自定义值上传
21.3	i_id	ERP内款号	string	—	Optional	ERP内款号/货号长度<=40
21.4	pic	图片地址	string	—	Optional	图片地址
21.5	base_price	原价	string	—	Optional	原价，保留两位小数，单位（元）
21.6	qty	数量	string	—	Optional	数量
21.7	refund_status	PS	string	—	Optional	PS：值存在，会自动将订单转异常,success状态的，发货将不发该商品，不支持单商品发部分;退款状态:可选退款中=waiting;退款成功=success（订单的全部商品传此状态，订单会被取消）,closed=退款关闭:发货前可更新
21.8	outer_oi_id	商家系统订单商品明细主键	string	—	Optional	商家系统订单商品明细主键,为了拆单合单时溯源，最长不超过50,保持订单内唯一，支持自定义
21.9	amount	金额	string	—	Optional	成交总额，保留两位小数，单位（元）；备注：可能存在人工改价
21.10	name	商品名称	string	—	Optional	商品名称长度<=100
22	sku_id	ERP内商品编码	string	—	Optional	商品编码，对应普通商品资料页面商品编码，ERP内商品编码长度<=40PS:设置预售标识订单，修改商品编码=商品编码+预售（或==）+预计发货日期（可选）比如:"A321232"修改为"A321232预售2015-12-12"或者"A321232"修改为"A321232==2015-12-12"当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码
23	properties_value	商品属性	string	—	Optional	商品属性；长度<=100
24	pay	shop_status	array	—	Optional	shop_status
24.1	amount	支付总金额	string	—	Optional	支付总额
24.2	outer_pay_id	外部支付单号	string	—	Optional	外部支付单号
24.3	pay_date	支付日期	string	—	Optional	支付日期
24.4	payment	支付方式	string	—	Optional	payment
24.5	seller_account	卖家支付账号	string	—	Optional	卖家支付账号
24.6	buyer_account	买家支付账号	string	—	Optional	买家支付账号

Response Parameters

No parameter reference available

The 订单上传(商家自有商城、跨境线下) API (/open/jushuitan/orders/upload) of 聚水潭 is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 聚水潭 version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.