v2.logistics.batch_update_tpf_warehouse_tracking_status

For CB orders that fulfilled by 3PF, support 3PF Warehouse Vendors to update the tpf_tracking_status when 3PF warehouse receive the order and complete the outbound of the package. CB orders that fulfilled by 3PF： v2.shop.get_shop_info - shop_fulfillment_flag in {Pure - 3PF Shop,PFF - 3PF Shop,LFF Hybrid Shop} And v2.order.get_order_detail - fulfillment_flag = fulfilled_by_local_seller

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"tpf_name": "Shopee 3PF",
	"tpf_tracking_status": "3pf_warehouse_outbound_done",
	"package_list": [
		{
			"order_sn": "2003160SXK2A3T",
			"package_number": "OFG38027870177402",
			"update_time": 1610000000
		},
		{
			"order_sn": "201214JASXYXY6",
			"package_number": "OFG134731496217591",
			"update_time": 1610000000
		}
	]
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/logistics/batch_update_tpf_warehouse_tracking_status?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"package_list\": [
      {
         \"order_sn\": \"2003160SXK2A3T\",
         \"package_number\": \"OFG38027870177402\",
         \"update_time\": 1610000000
      },
      {
         \"order_sn\": \"201214JASXYXY6\",
         \"package_number\": \"OFG134731496217591\",
         \"update_time\": 1610000000
      }
   ],
   \"tpf_name\": \"Shopee 3PF\",
   \"tpf_tracking_status\": \"3pf_warehouse_outbound_done\"
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/logistics/batch_update_tpf_warehouse_tracking_status?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "package_list": [
        {
            "order_sn": "2003160SXK2A3T",
            "package_number": "OFG38027870177402",
            "update_time": 1610000000
        },
        {
            "order_sn": "201214JASXYXY6",
            "package_number": "OFG134731496217591",
            "update_time": 1610000000
        }
    ],
    "tpf_name": "Shopee 3PF",
    "tpf_tracking_status": "3pf_warehouse_outbound_done"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

cURL

curl --location --request POST 'https://partner.shopeemobile.com/api/v2/logistics/batch_update_tpf_warehouse_tracking_status?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
   "package_list": [
      {
         "order_sn": "2003160SXK2A3T",
         "package_number": "OFG38027870177402",
         "update_time": 1610000000
      },
      {
         "order_sn": "201214JASXYXY6",
         "package_number": "OFG134731496217591",
         "update_time": 1610000000
      }
   ],
   "tpf_name": "Shopee 3PF",
   "tpf_tracking_status": "3pf_warehouse_outbound_done"
}'

Python

import requests
import json

url = "https://partner.shopeemobile.com/api/v2/logistics/batch_update_tpf_warehouse_tracking_status?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp"

payload=json.dumps({
  "package_list": [
    {
      "order_sn": "2003160SXK2A3T",
      "package_number": "OFG38027870177402",
      "update_time": 1610000000
    },
    {
      "order_sn": "201214JASXYXY6",
      "package_number": "OFG134731496217591",
      "update_time": 1610000000
    }
  ],
  "tpf_name": "Shopee 3PF",
  "tpf_tracking_status": "3pf_warehouse_outbound_done"
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

Response sample

JSON

{
	"request_id": "e3e3e7f32b90e1a2b73dc8ca69586501",
	"error": "-",
	"message": "success",
	"response": [
		{
			"success_list": [
				{
					"order_sn": "2003160SXK2A3T",
					"package_number": "OFG38027870177402"
				}
			],
			"fail_list": [
				{
					"order_sn": "201214JASXYXY6",
					"package_number": "OFG134731496217591",
					"fail_error": "common.error_server",
					"fail_message": "Something wrong. Please try later."
				}
			]
		}
	]
}

Errors

Common errors

Update log