v2.returns.upload_shipping_proof

Use this API to upload shipping proof (Only for TW and BR returns with is_seller_arrange = true). This is not to upload evidence for disputes.

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"return_sn": "-",
	"reverse_logistics_carrier_id": 0,
	"reverse_logistics_carrier_name": "-",
	"tracking_number": "-",
	"image_id_list": [
		{
			"image_id": "-"
		}
	],
	"remarks": "-"
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/returns/upload_shipping_proof?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"image_id_list\": [
      {
         \"image_id\": \"-\"
      }
   ],
   \"remarks\": \"-\",
   \"return_sn\": \"-\",
   \"reverse_logistics_carrier_id\": 0,
   \"reverse_logistics_carrier_name\": \"-\",
   \"tracking_number\": \"-\"
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/returns/upload_shipping_proof?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 => '{
    "image_id_list": [
        {
            "image_id": "-"
        }
    ],
    "remarks": "-",
    "return_sn": "-",
    "reverse_logistics_carrier_id": 0,
    "reverse_logistics_carrier_name": "-",
    "tracking_number": "-"
}',
  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/returns/upload_shipping_proof?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
   "image_id_list": [
      {
         "image_id": "-"
      }
   ],
   "remarks": "-",
   "return_sn": "-",
   "reverse_logistics_carrier_id": 0,
   "reverse_logistics_carrier_name": "-",
   "tracking_number": "-"
}'

Python

import requests
import json

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

payload=json.dumps({
  "image_id_list": [
    {
      "image_id": "-"
    }
  ],
  "remarks": "-",
  "return_sn": "-",
  "reverse_logistics_carrier_id": 0,
  "reverse_logistics_carrier_name": "-",
  "tracking_number": "-"
})
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": "200203171852695",
	"response": {}
}

Error example

JSON

{
    "error": "returns.missing_tracking_no",
    "message": "Tracking Number is a required parameter",
    "request_id": "e3e3e7f33de01a208d40117ca55aa301"
}

Errors

Common errors

Update log