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