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

Contenidos

Introducción Request Response Ejemplos de status Codes

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

Dado un ID de envío, esta API devuelve los datos (origen, destino y lista de inventarios) del mismo.

Importante:

Asegúrese de que ya tiene aplicación y token válidos, y que está autorizado para usar este endpoint
Para seguridad se utilizará OAuth

Request

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

Parámetro	Tipo	Descripción
shipment_id	String	Id del envío
access_token	String	Token de acceso

Response

{
      "recipient": {
          "full_name": "string",
          "rfc": "string"
      },
      "origin": {
          "fiscal_information": {
              "full_name": "string",
              "rfc": "string",
              "fiscal_residence": "string"
          },
          "address": {
              "address_line": "string",
              "street_name": "string",
              "street_number": "string",
              "intersection": "string",
              "zip_code": "string",
              "city": {
                  "id": "string",
                  "name": "string"
              },
              "state": {
                  "id": "string",
                  "name": "string"
              },
              "country": {
                  "id": "string",
                  "name": "string"
              },
              "neighborhood": {
                  "id": "string",
                  "name": "string"
              },
              "municipality": {
                  "id": "string",
                  "name": "string"
              }
          }
      },
      "destination": {
          "fiscal_information": {
              "full_name": "string",
              "rfc": "string",
              "fiscal_residence": "string"
          },
          "address": {
              "address_line": "string",
              "street_name": "string",
              "street_number": "string",
              "intersection": "string",
              "zip_code": "string",
              "city": {
                  "id": "string",
                  "name": "string"
              },
              "state": {
                  "id": "string",
                  "name": "string"
              },
              "country": {
                  "id": "string",
                  "name": "string"
              },
              "neighborhood": {
                  "id": "string",
                  "name": "string"
              },
              "municipality": {
                  "id": "string",
                  "name": "string"
              }
          },
          "inventories": [
              {
                   "entity_id": "string",
                   "inventory_url": "string",
                   "quantity": int
              },
          ]
      }
      "return_reverse_logistics_collection": ""
  }

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: "Shipment id not found", como en el ejemplo de la matriz anterior.

Parámetro	Tipo	Descripción
recipient	Object	Datos del receptor
recipient.rfc	String	RFC del receptor
recipient.full_name	String	Nombre del receptor
origin	Object	Origen del envío
origin.fiscal_information	Object	Información fiscal de origen
origin.fiscal_information.full_name	String	Nombre de responsable de origen
origin.fiscal_information.fiscal_residence	String	Atributo condicional para registrar la clave del país de residencia para efectos fiscales del operador del autotransporte de carga federal en el que se trasladan los bienes o mercancías, conforme con el catálogo c_Pais publicado en el portal del SAT en Internet, que está basado en la especificación ISO 3166-1.
origin.fiscal_information.rfc	String	RFC de responsable de origen
origin.address	Object	Ubicación de origen
origin.address.address_line	String	Campo compuesto por los campos street_name y street_number del origen
origin.address.street_name	String	Nombre de la calle de origen.
origin.address.street_number	String	Número de la calle de origen.
origin.address.intersection	String	Calle secundaria.
origin.address.zip_code	String	Código postal del origen
origin.address.city	Object	Ciudad de origen
origin.address.city.id	String	Identificador único que le da Mercado Libre a la ciudad
origin.address.city.name	String	Nombre de la ciudad
origin.address.state	Object	Estado, departamento o provincia de origen
origin.address.state.id	String	Identificador único que le da Mercado Libre al estado en Formato ISO 3166.
origin.address.state.name	String	Nombre del estado
origin.address.country	Object	País de origen
origin.address.country.id	String	Identificador único que le da Mercado Libre al país en Formato ISO 3166
origin.address.country.name	String	Nombre del país
origin.address.neighborhood	Object	Barrio de origen
origin.address.neighborhood.id	String	Identificador único del vecindario
origin.address.neighborhood.name	String	Nombre del vecindario
origin.address.municipality	Object	Municipalidad de origen
origin.address.municipality.id	String	Identificador único que le da Mercado Libre al municipio
origin.address.municipality.name	String	Nombre del municipio
destination	Object	Destino del envío
destination.fiscal_information	Object	Información fiscal de destino
destination.fiscal_information.full_name	String	Nombre de responsable de destino
destination.fiscal_information.rfc	String	RFC de responsable de destino
destination.fiscal_information.fiscal_residence	String	Atributo condicional para registrar la clave del país de residencia para efectos fiscales del operador del autotransporte de carga federal en el que se trasladan los bienes o mercancías, conforme con el catálogo c_Pais publicado en el portal del SAT en Internet que está basado en la especificación ISO 3166-1.
destination.address	Object	Ubicación de destino
destination.address.address_line	String	Campo compuesto por los campos street_name y street_number del destino
destination.address.street_name	String	Nombre de la calle de destino.
destination.address.street_number	String	Número de la calle de destino.
destination.address.intersection	String	Calle secundaria.
destination.address.zip_code	String	Código postal del destino
destination.address.city	Object	Ciudad de destino
destination.address.city.id	String	Identificador único que le da Mercado Libre a la ciudad
destination.address.city.name	String	Nombre de la ciudad
destination.address.state	Object	Estado, departamento o provincia de destino
destination.address.state.id	String	Identificador único que le da Mercado Libre al estado en Formato ISO 3166.
destination.address.state.name	String	Nombre del estado
destination.address.country	Object	País de destino
destination.address.country.id	String	Identificador único que le da Mercado Libre al país en Formato ISO 3166
destination.address.country.name	String	Nombre del país
destination.address.neighborhood	Object	Barrio de destino
destination.address.neighborhood.id	String	Identificador único del vecindario
destination.address.neighborhood.name	String	Nombre del vecindario
destination.address.municipality	Object	Municipalidad de destino
destination.address.municipality.id	String	Identificador único que le da Mercado Libre al municipio
destination.address.municipality.name	String	Nombre del municipio
inventories	List	Inventario del envío
inventories.quantity	Int	Cantidad de inventario
inventories.entity_id	String	ID de inventario
inventories.inventory_url	String	URL para obtener detalles del inventario
return_reverse_logistics_collection	String	Expresa el uso de alguno de los servicios de logística inversa, recolección o devolución para el traslado de los bienes y/o mercancías. Valores: Sí o "" (string vacía)

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": [""]
                  }

404 (NOT_OK)

Ocurre un error 404 cuando se brinda una identificación de envío incorrecta.

{
                    "message": "Error when try to obtain inbound shipment information",
                    "error": "shipment_not_found",
                    "status": 404,
                    "cause": [""]
                  }

500 (INTERNAL_ERROR)

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

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

Código HTTP	Content type	Response body	Descripción
200	application/json	JSON (ejemplo de arriba)	Cuando se obtienen los datos del envío correctamente.
403	application/json	{"message": "Access revoked, consult staff to check your permissions"}	Cuando falta acceso a esta API.
404	application/json	{"message": "Error when try to obtain inbound shipment information"}	Al pasar una identificación de envío incorrecta.
500	application/json	{"message": "Error when try to obtain inbound shipment information"}	Cuando ocurre una falla interna a esta API.