v2.first_mile.generate_and_bind_first_mile_tracking_number

Use this api to generate first mile tracking number for courier delivery method.

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"shipment_method": "courier_delivery",
	"region": "CN",
	"order_list": [
		{
			"order_sn": "2410106R7TSAJR"
		},
		{
			"order_sn": "2004239MRBBFPJ"
		}
	],
	"courier_delivery_info": {
		"address_id": 11222,
		"warehouse_id": "ECP04",
		"logistics_product_id": 1010004,
		"prepaid_account_id": 21,
		"courier_service_id": "LCN70002"
	}
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/first_mile/generate_and_bind_first_mile_tracking_number?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"courier_delivery_info\": {
      \"address_id\": 11222,
      \"courier_service_id\": \"LCN70002\",
      \"logistics_product_id\": 1010004,
      \"prepaid_account_id\": 21,
      \"warehouse_id\": \"ECP04\"
   },
   \"order_list\": [
      {
         \"order_sn\": \"2410106R7TSAJR\"
      },
      {
         \"order_sn\": \"2004239MRBBFPJ\"
      }
   ],
   \"region\": \"CN\",
   \"shipment_method\": \"courier_delivery\"
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/first_mile/generate_and_bind_first_mile_tracking_number?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 => '{
    "courier_delivery_info": {
        "address_id": 11222,
        "courier_service_id": "LCN70002",
        "logistics_product_id": 1010004,
        "prepaid_account_id": 21,
        "warehouse_id": "ECP04"
    },
    "order_list": [
        {
            "order_sn": "2410106R7TSAJR"
        },
        {
            "order_sn": "2004239MRBBFPJ"
        }
    ],
    "region": "CN",
    "shipment_method": "courier_delivery"
}',
  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/first_mile/generate_and_bind_first_mile_tracking_number?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
   "courier_delivery_info": {
      "address_id": 11222,
      "courier_service_id": "LCN70002",
      "logistics_product_id": 1010004,
      "prepaid_account_id": 21,
      "warehouse_id": "ECP04"
   },
   "order_list": [
      {
         "order_sn": "2410106R7TSAJR"
      },
      {
         "order_sn": "2004239MRBBFPJ"
      }
   ],
   "region": "CN",
   "shipment_method": "courier_delivery"
}'

Python

import requests
import json

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

payload=json.dumps({
  "courier_delivery_info": {
    "address_id": 11222,
    "courier_service_id": "LCN70002",
    "logistics_product_id": 1010004,
    "prepaid_account_id": 21,
    "warehouse_id": "ECP04"
  },
  "order_list": [
    {
      "order_sn": "2410106R7TSAJR"
    },
    {
      "order_sn": "2004239MRBBFPJ"
    }
  ],
  "region": "CN",
  "shipment_method": "courier_delivery"
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

Response sample

JSON

{
    "error": "",
    "message": "",
    "request_id": "317a860d24a78058b47d1a5ae67ff700:040000d06621af77:0300021f9befdc9c",
    "response": {
        "binding_id": "DCN241681623620GU",
        "success_list": [
            {
                "order_sn": "2410106R7TSAJR",
                "package_number": null
            }
        ]
        "fail_list": [
            {
                "order_sn": "2004239MRBBFPJ",
                "package_number": "",
                "fail_error": "firstmile.package_has_bind",
                "fail_message": "Package (order_sn: 2004239MRBBFPJ, package_number: ) has been bind to first mile code."
            }
        ]
    }
}

Errors

Common errors

Update log