Invoice Consolidations

Contenidos

¿Cómo conseguir mi Access Token?Formato Request Formato Response Ejemplos

¿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:

POST https://api.mercadolibre.com/consolidations/{consolidatedId}/documents/cbt_invoice 

--header 'Authorization: Bearer {accessToken}'

En el body se enviará un objeto JSON con los campos listados a continuación:

Nombre	Tipo	Descripción
last_mile_track_number	String	Número de seguimiento del envío.
shipments	Array de integers	IDs de envíos.

Formato Response

Se espera un body vacio y que se descargue el documento en formato PDF.

Status Codes

Status	HTTP Code	Descripción
SUCCESS	200	Se descargará el documento solicitado.
FAILED	422	Cuando la descarga no fue exitosa debido a alguna dependencia interna. Se espera que se retorne "error": "invoice_process_error" junto con el "mensaje" que describe el motivo del error.
FAILED	404	Cuando la descarga no fue exitosa porque no se encontró el código de consolidación. Se espera que se retorne "error": "invoice_not_found" junto con el "mensaje" que describe el motivo del error.
FAILED	404	Cuando la descarga no fue exitosa porque no se informó el código del shipment. Se espera que se retorne "error": "shipments_not_found" junto con el "mensaje" que describe el motivo del error.
FAILED	404	Cuando la descarga no fue exitosa porque no se encontró el código del servicio. Se espera que se retorne "error": "service_not_found" junto con el "mensaje" que describe el motivo del error.
FAILED	401	Cuando la descarga no fue exitosa porque no se encontró el código del transportista. Se espera que se retorne "error": "carrier_not_found" junto con el "mensaje" que describe el motivo del error.
ERROR	500	Cualquier error del lado del servidor

Ejemplos

Request:

POST https://api.mercadolibre.com/consolidations/{consolidatedId}/documents/cbt_invoice 

--header 'Authorization: Bearer xxxxxxxxx'

Body:

{    
    "last_mile_track_number": "LP00000000000000000000",
    "shipments": [
        123456789,
        987654321,
        1234567890
    ]
}

Response:

Successful (200 OK)

{

}

Failed (Error HTTP 4XX)

{
    "error": "invoice_process_error",
    "message": "Invoice of last_mile_track_number LP00000000000000000000 and consolidated id MELI00000000000000000000A process with error",
    "status": 422
}

{
    "error": "invoice_not_found",
    "message": "Invoice of last_mile_track_number 00001 and consolidated id 00001 not found",
    "status": 404
}

{
    "error": "shipments_not_found",
    "message": "shipments not found in request",
    "status": 404
}

{
    "error": "service_not_found",
    "message": "service not found in request",
    "status": 404
}

{
    "error": "carrier_not_found",
    "message": "carrier not found in request",
    "status": 401
}

Error (Error HTTP 5XX)

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