Taobao / Tmall Message Type

The order of messages cannot be ensured. Therefore, you need to call the View order details API before any further processing.

Preface

Message delivery mode: Send message by POST form (non-JSON)
Param：

message：String

_dj_signature：String // HmacSHA1

example：

Order status update

Message type: message_type=3

Scenario: The status of the purchase order on Taobao Global Distribution Platform is updated, which can be Pending Payment, Pending Delivery, Dispatched, or Closed.

Sample message:

    "seller_id": "2100000927014",
    "message_type": 3,
    "data":
    {
        "business_time": 1650939687564,
        "outer_purchase_id": "FY20220426002",
        "purchase_id": 200002638011,
        "seller_id": 2100000927014,
        "sku_list":
        [
            {
                "item_id": 600123256363335000,
                "logistic_company_name": "顺丰速运",
                "logistic_number": "SF4548527307631",
                "order_line_no": "1",
                "sku_id": 4808332513272,
                "status": "WAIT_BUYER_CONFIRM_GOODS"
            }
        ],
        "status": "WAIT_SELLER_SEND_GOODS"
    },
    "timestamp": 1650939687,
    "site": "taobao_hk"
}

Field description

Field	Type	Description
business_time	Number	Status update time.1650939687564
outer_purchase_id	String	The purchase order number of the ISV.FY20220426002
purchase_id	Number	The ID of the purchase order on Taobao Global Distribution Platform.200002638011
seller_id	Number	Distributor ID.2100000927014
sku_list	Object[]	"logistic_company_name": logistics company name; "logistic_number": tracking number; "order_line_no": the purchase sub-order number of the ISV; "sku_id": the ID of the product on Taobao Global Distribution Platform; "status": the status of the purchase sub-order; the list of products in the sub-order.
status	String	BULIDING-Creating，WAIT_BUYER_P-Pending Payment，WAIT_SELLER_SEND_GOODS-Pending Delivery，WAIT_BUYER_CONFIRM_GOODS-Dispatched，TRADE_CLOSED-Closed

Order price modification

Message type: message_type=8

Scenario: After an order is created, the customer contacts the Taobao seller for price modification. After the price is modified successfully, a message will be sent to the distributor.

Note that the price cannot be modified if the payment has been made.

Sample message:

    "seller_id": "2100000927014",
    "message_type": 8,
    "data":
    {
        "features":
        {},
        "salesOrderId": "500000-GSP2021031415594",
        "salesSellerId": 2100000927014,
        "purchaseMarket": "PANAMA",
        "purchaseOrderId": 200002372069,
        "purchaseOrderPriceDTO":
        {
            "purchaseCurrency": "CNY",
            "purchaseTotalFee": 1,
            "purchaseProductFee": 1,
            "purchaseShippingFee": 0
        },
        "purchaseOrderLinePriceChangeMessageDTOList":
        [
            {
                "features":
                {},
                "salesOrderLineIdList":
                [
                    "1"
                ],
                "purchaseOrderLineId": 200002372070,
                "purchaseOrderItemPriceDTO":
                {
                    "purchaseCurrency": "CNY",
                    "purchaseTotalFee": 1,
                    "purchaseProductFee": 1,
                    "purchaseProductUnitFee": 1,
                    "purchaseShippingFee": 0
                },
                "bizFeatures":
                {}
            }
        ],
        "actionTime": 1647306796326,
        "bizFeatures":
        {
            "appKey": "500000",
            "orderSource": "taobao",
            "purchase_warehouse_address": "{\"city\":\"广州市\",\"country\":\"中国\",\"detailAddress\":\"落潭镇长腰岭村第三经济合作社长兴工业路3号派亚物流\",\"district\":\"白云区\",\"divisionId\":\"440111108\",\"mobile\":\"18500176747\",\"name\":\"李澳洲\",\"phone\":\"\",\"state\":\"广东省\"}",
            "sellerOrderNumber": "-"
        }
    },
    "timestamp": 1647306796,
    "site": "taobao_hk"
}

Field description

Field	Type	Description
salesOrderId	String	The purchase order number of the ISV.500000-GSP2021031415594
salesSellerId	Number	Distributor ID.FY20220426002
purchaseOrderId	Number	The ID of the purchase order on Taobao Global Distribution Platform.200002372069
purchaseOrderLineId	Number	The ID of the purchase sub-order on Taobao Global Distribution Platform.200002372070

Notes on price modification:

You can apply for a price modification after creating an order but cannot do so if the payment has been made.

Not all products support price modification.

Some orders on Taobao Global Distribution Platform are closed within a short period of time, for example, 30 minutes. If such an order is not paid before it is closed, a new order will be generated, and you need to apply for price modification for the new order, as the previous order for which the price has been modified is closed. If you have any questions, contact the technical personnel.

Preface#

Order status update#

Preface

Order status update