Lingxing
切换旧版

亚马逊订单提交标发

POST/pb/mp/order/submitFulfillment

当前接口为提交亚马逊订单标发任务，单个订单标发结果非当前接口同步返回

亚马逊订单标发为异步任务，请在提交标发后使用【task_id】通过接口查询亚马逊标发结果获取已提交任务的标发结果

接口信息

API Path请求协议请求方式令牌桶容量
/pb/mp/order/submitFulfillmentHTTPSPOST10

请求参数

regionstring必填
店铺注册所属区域：仅支持 NA、EU、FE
【对应区域值支持国家见附加说明】
seller_idstring必填
亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】
marketplace_idstring必填
市场id
order_listarray<object>必填
提交标发数据列表
隐藏子属性
idinteger必填
标发记录id【20位以内的正整数，对应标发结果中的message_id】
platform_order_nostring必填
平台单号
tracking_nostring必填
物流追踪号
carrier_codestring必填
承运商code
carrier_namestring必填
承运商名称
shipping_servicestring必填
配送服务，没有可以传空字符串
order_itemarray<object>必填
商品信息
隐藏子属性
order_item_nostring必填
亚马逊商品行id
quantityinteger必填
商品数量

请求示例

{
    "region": "fe",
    "seller_id": "A4IBC1X76HVPJ",
    "marketplace_id": "A39IBJ37TRP1C6",
    "order_list": [
        {
            "id": "103313699178382336",
            "platform_order_no": "250-8182459-1815841",
            "tracking_no": "GMQ6012738",
            "carrier_code": "",
            "carrier_name": "Australia Post",
            "shipping_service": "",
            "order_item": [
                {
                    "order_item_no": "33051859",
                    "quantity": 1
                }
            ]
        }
    ]
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 操作成功
request_idstring必填
请求链路id
示例 0a618db6bfe24f25ae13f5b217b8a340.1676370043019
response_timestring必填
响应时间
示例 2023-02-15 13:01:08
dataobject必填
响应数据
隐藏子属性
task_idstring必填
任务id
示例 1003117
task_statusstring必填
任务状态
示例 in_process
failure_reasonstring必填
提交失败原因
示例 null

返回成功示例


{
    "code": 0,
    "message": "操作成功",
    "request_id": "fe51fee0ff7e4e8797abfb549d3a63a8.159.16843756058584983",
    "response_time": "2023-02-14 18:20:44",    
    "data": {
        "task_id": "1003094",
        "task_status": "in_process",
        "failure_reason": null
    }
}

返回失败示例

{
    "code": 102,
    "message": "orderList[0].carrierCode承运商code不能为空",
    "request_id": "9ce3945f8a1f4ca4907b5d3413c11bab.157.16758503506230001",
    "response_time": "2023-02-14 18:10:04",
    "data": null
}

附加说明

region 说明如下： 1. NA【North America】：包括国家为 CA、US、MX、BR 2. EU【Europe】：包括国家为 ES、UK、FR、BE、NL、DE、IT、SE、ZA、PL、EG、TR、SA、AE、IN 3. FE【Far East】：包括国家为 SG、AU、JP

task_status 说明如下： 1. pending：feed任务刚创建时的状态，此时任务在排队等待发起状态； 2. in_process：feed任务已经被消费者调度执行，处于该状态时将开始与亚马逊进行交互，此时会出现如下三个阶段：
submit_feed【提交feed阶段】、listen_notification【监听阶段】、get_feed_result【获取结果阶段】 3. fatal：feed任务最终执行失败； 4. done：feed任务最终执行成功； 5. cancelled：feed服务的feed任务被取消；