简要描述Description
- 物流下单:下单并支付获取物流面单 make a shipping order for your products or shared products, but all products should be at same store
- 支持分销商品的下单 2024-07更新. updated at 20224-07, support user make a order for shared products
请求URL
/wms_api/order/create
请求方式Method
POST
请求参数(部分)Request(part), all see below
字段params | 类型Type | 是否必须Required | 说明Description |
---|---|---|---|
code | string | 否No | 发货方式 默认agent:一件代发; Default agent, means dropping service |
box_no | int | 是Yes | 货物多少箱子,默认1箱 |
shipped_id | int | 否 No | 发货方式 6:(USPS 1stClass,限重453g) 5:(USPS Priority) 12:(DHL Parcel Expedited) 13:(DHL Parcel Plus Expedited) 20:(USPS Ground Advantage) 8:(FBA自提) 22:(Amazon Home Delivery) 23:(UPS MI) 等等 默认最低价格; 更多从物流服务接口获取。 carrier service id, fetch by CarrierList API, see menu. If you did’t choose, we will choose cheapest one for you. |
sign | string | 是Yes | MD5, check left menu, how to get sign string, we product coding like js, php, java example |
请求示例, 未注释都必需
{
"timestamp": {{timestamp}},
"sign": "{{sign}}",
"sender": "Online Sellser", //optional可选,发货人
"country": "us", //required
"receiver": "MayraGonsalez",//required
"zip": "90201", //required
"state": "CA", //required请尽量用简写,如果全称系统无法匹配到,会出单失败, please use two character code if possible
"street1": "6029FrySt", //required
"street2": "", //可选optional
"phone": "3234806611", //可选optional,系统会默认00000000
"store_id": "1", //可选optional,自动判断,使用zone最小的仓库发货
"city": "BellGardens", //required
"order_no": "TEST2023040301", //required
"remark": "test", //optional可选
"goods": [ //unpack类订单可以传空
{
"sku": "SN-Cream", //required当前商品测试环境有库存, 可填自有商品SKU,公开分销的商品SKU
"num": 1, //required
}
],
"package": { //unpack类订单必传
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "cm",
"weight": 240,
"weight_unit": "g"
},
"code": "agent", //可选,系统默认agent:一件代发; optional, default agent;unpack落地拆包,国内发货,不会检查库存,但请先创建商品信息
"box_no": 1, //required
"shipped_id": 6, //可选,系统默认除FBA外最低价格;如果FBA请登录页面下单 optional, default cheapest carrier service id, except FBA
"is_lading": 1, //FBA自提,默认0,如果设置1,shipped_id的物流设置会被忽略,系统自动切换到自提物流. default 0, if you choose FBA, please set 1
"lading": [
{"name": "tiktok_label.pdf", "url": "https://seller-us.tiktok.com/wsos_v2/oec_fulfillment_doc_tts/object/wsos6604d901044e0b2a?expire=1711680157&skipCookie=true&timeStamp=1711593757&sign=a8559a4173dc4787a79ad3896da691a1f373665399de0bdd4d977d17749b9ac8"}
], //自提面单文件, if FBA, please upload you label
"tracking_no": "" //如果自提,单号,选填, if FBA, please provide
}
返回示例
{
"code": 200,
"msg": "success",
"data": {
"id": 305332,
"order_no": "TEST2023040306",
"resale_price": "14.00", //代销商品下单采购费 purchase fee if product belong to other sellers
"shipped_fee": "4.50", //物流费
"total_fee": "18.50", //总费用
"balance": "" //用户下单后账户余额 your account balance
"zone": 1,
"status": 3, //1是未支付 2已支付 3已发货 4 取消 1unpaid, 2paid, 3shipped, 4canced
"created_at": "2023-05-05 11:34:35",
"paid_at": "2023-05-05 11:34:35",
"shipped_at": "2023-05-05 11:34:37",
"tracking_no": "9400111206214369636730",
"label_url": "https://oss.fbbship.com/label/0fd0fbdd-7243-4b2a-be89-adef6104f352.pdf", //optional, beause we need it pack your package
"label_status": "",
"barcode": "https://xffbbhangzhou.oss-accelerate.aliyuncs.com/barcode/3ME5HE1MJ88E7RHYKWW3S7XTZ1.pdf" //optional, 国内发货,落地拆包服务,返回货单信息,请用标签纸打印贴在包裹上
}
}
注意
1、 如果订单未支付,可重复下单,会修改订单。order_no请保持唯一。
2、 如果订单已支付,如果tracking_no未出,可定时使用当前接口再次获取,或者使用订单详情接口获取。系统保证当天一定会出单和发货。如果库存不足,订单会被取消和退款,请联系客户经理。
3、 暂时没有webhook通知接口,后续支持。
作者:admin 创建时间:2024-01-30 12:06
最后编辑:admin 更新时间:2025-05-07 15:31
最后编辑:admin 更新时间:2025-05-07 15:31