简要描述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