Return Address

Contenidos


¿Cómo conseguir mi Access Token?

Para generar su token de acceso, siga los pasos que se muestran en cómo conseguir mi Access Token

Formato Request

Se enviará una petición con el siguiente formato:

GET https://api.mercadolibre.com/shipments/{shipment_id}/seller/return_address  

--header 'Authorization: Bearer {accessToken}'

Formato Response

Se espera un body con las informaciones de la dirección de retorno del vendedor.

Status Codes

StatusHTTP CodeDescripción
SUCCESS200Regresa un response con las informaciones de la dirección.
FAILED4XXSe espera que se devuelva "error" junto con el "message" que describe el motivo del error.
ERROR500Cualquier error del lado del servidor


Ejemplos

Request:

GET https://api.mercadolibre.com/shipments/123456789/seller/return_address 

--header 'Authorization: Bearer xxxxxxxxx'

Response:

Successful (200 OK)

{
    "address_line": "广东省中山市三角镇金三大道西1号金利达宝大仓",
    "zip_code": "12345",
    "phone": "132457680",
    "additional_info": null,
    "city": {
        "id": "Q04tR0RaaG9uZ3NoYW4",
        "name": "Zhongshan"
    },
    "state": {
        "id": "CN-GD",
        "name": "Guangdong"
    },
    "country": {
        "id": "CN",
        "name": "China"
    }
}

Failed (Error HTTP 4XX)

{
	"error": "shipment_not_found",
	"message": "Shipment not found",
	"status": 404
}
{
	"error": "dispatch_info_not_found",
	"message": "Dispatch info not found",
	"status": 404
}
{
	"error": "shipment_bad_request",
	"message": "the address is not available for shipping provided",
	"status": 400
}

Error (Error HTTP 5XX)

{
    "error": "internal_error",
    "message": "Internal Server Error",
    "status": 500  
}