Consulta de información de Carta Porte por ruta del inbound desde México

Contenidos

La API de consulta de informaciones de Carta Porte por ruta del inbound tiene como objetivo servir datos de ruta y envíos a los carriers logisticos que forman parte del transporte y que quieren generar el documento fiscal para México (cfdi+carta-porte).

Dado un ID de ruta, esta API devuelve los datos correspondientes (lista de envíos del inbound) para la misma.

Request

GET https://api.mercadolibre.com/inbound/route/{route_id}/carta-porte-details?access_token={access_token}

¿Cómo obtener el ID de la ruta desde la herramienta de Logistics?

En la herramienta de Logistics Monitoreo, acceder con tu usuario y contraseña y buscar el ID cómo en el ejemplo de a continuación

El Id de la ruta también se puede obtener desde la pantalla de listado de la herramienta de Logistics Monitoreo cómo en el ejemplo de a continuación

Response

{
  "id": "route_id",
  "inbound_shipment": [
      {
          "id": "shipment_id",
          "url": "/inbound/shipment/{shipment_id}/carta-porte-details",
      },
      ...
  ],
  "registration_istmo": "",
  "origin_pole_location": "",
  "destination_pole_location": ""
}

La respuesta es una matriz por entidad / tipo. Si no se pueden encontrar los datos fiscales de una entidad específica, se retorna el error: "Route id not found", como en el ejemplo de la matriz anterior.

Ejemplos de status Codes

Si ocurre un error, la API devolverá un estado HTTP distinto de 200 con el error, el mensaje y la causa del mismo, y el content-type será application/json.

403 (NOT_OK)

Ocurre un error 403 por falta de acceso a esta API.

{
  "message": "Access revoked, consult staff to check your permissions",
  "error": "unexpected_error",
  "status": 403,
  "cause": ["error_getroute"]
}

404 (NOT_OK)

Ocurre un error 404 cuando se incluye una identificación de ruta incorrecta.

{
  "message": "An error occurred while trying to get inbound route details. Route not found",
  "error": "route_not_found",
  "status": 404,
  "cause": ["error_getroute"]
}

500 (INTERNAL_ERROR)

Ocurre un error 500 cuando se produce una falla interna a esta API.

{
  "message": "Error when try to obtain inbound route information",
  "error": "internal_server_error",
  "status": 500,
  "cause": ["INTERNAL_ERROR"]
}