Recursos para IA

Crear envíos

La API de Envíos de Mercado Pago te permite gestionar envíos a partir de ventas generadas con Checkout Pro. Aprovechando la logística de Mercado Libre, podrás cotizar y crear envíos, gestionarlos y realizar un seguimiento de los paquetes, ofreciendo una mejor experiencia de compra a tus clientes.

La creación de envíos está disponible solo para integradores autorizados por Mercado Pago. Si aún no tienes habilitada esta funcionalidad, revisa su disponibilidad en tu cuenta de Mercado Pago.

Conoce las opciones de gestión de envíos y cómo integrarlas a continuación.

Cotizar envíos

Es posible estimar el valor de un envío en función del volumen del paquete y los códigos postales de los puntos de origen y destino. Esta cotización devuelve un option_id y un shipment_rate_id que luego utilizarás para crear el envío.

Para cotizar un envío, envía una solicitud al endpoint /shipping/v1/shipments-ratesPOST incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. y los parámetros descritos en la tabla a continuación.

Solo es posible cotizar el envío de un paquete por vez. Para envíos con múltiples ítems, debes calcular las dimensiones totales del paquete que los contiene. Consulta la documentación de Dimensiones de envíos para conocer las dimensiones permitidas y las mejores prácticas.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-rates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--data '{
    "packages": [
        {
	     "declared_value": 1500,
            "quantity": 1,
            "dimensions": {
                "weight": 500,
                "width": 30,
                "height": 30,
                "length": 30
            }
        }
    ],
    "shipping_from": {
        "zip_code": "06760"
    },
    "shipping_to": {
        "zip_code": "06720"
    }
}'

Campo	Descripción	Tipo	Obligatoriedad
`packages`	Contiene la información del paquete para la cotización.	Array	Obligatorio
`packages.declared_value`	Valor del paquete a ser enviado. No incluye el costo estimado de envío.	Number	Obligatorio
`packages.quantity`	Cantidad de paquetes. El único valor permitido es `1`.	Number	Obligatorio
`packages.dimensions`	Objeto que contiene las dimensiones del paquete. Los máximos permitidos son: - Cada lado debe tener máximo 150 cm. - El límite de dimensiones totales no debe superar 330 cm. - El peso máximo es de 30 kg (real o volumétrico).	Object	Obligatorio
`packages.dimensions.height`	Altura del paquete en centímetros.	Number	Obligatorio
`packages.dimensions.width`	Ancho del paquete en centímetros.	Number	Obligatorio
`packages.dimensions.length`	Largo del paquete en centímetros.	Number	Obligatorio
`packages.dimensions.weight`	Peso del paquete en gramos.	Number	Obligatorio
`shipping_from.zip_code`	Código postal de la dirección de origen. Si este valor se proporciona, se usará para calcular la oferta. De lo contrario, se aplicarán los datos de Envíos configurados en Mercado Pago.	String	Opcional
`shipping_to.zip_code`	Código postal de la dirección de destino.	String	Obligatorio

Si la solicitud es correcta, la respuesta retornará la cotización del envío, que puede contener más de una opción variable en precio y/o plazo.

json
{
    "shipment_rate_id": "be9fae0d-1079-471e-887d-55861965d10e",
    "rates": [
        {
            "options": [
                {
                    "id": "3c86ea36-fef7-4a9e-9092-d4eb6e744834",
                    "pricing": {
                        "base_price": "87",
                        "price": "87",
                        "discounts": []
                    },
                    "method": "standard",
                    "pay_before": "2025-10-27T00:00:00-06:00",
                    "delivery_promise": {
                        "shipping_from": "2025-10-28T12:00:00-06:00",
                        "shipping_to": "2025-10-30T12:00:00-06:00"
                    },
                    "delivery_days": {
                        "from": 3,
                        "to": 5
                    }
                }
            ],
            "packages": [
                {
                    "quantity": 1,
                    "dimensions": {
                        "weight": "500",
                        "width": "30",
                        "height": "30",
                        "length": "30"
                    }
                }
            ]
        }
    ],
    "shipping_to": {
        "zip_code": "06720",
        "country_id": "MX",
        "city_id": "TUxNQ0NVQTczMTI",
        "state_id": "MX-DIF"
    }
}

Campo	Descripción	Tipo
`shipment_rate_id`	Identificador de la cotización. Usa este valor como `shipment_rate_id` al crear el envío.	String
`rates`	Lista de cotizaciones para el paquete en función de la dirección proporcionada.	Array
`options`	Lista de opciones de cotizaciones disponibles.	Array
`id`	Identificador de la opción de envío. Usa este valor como `option_id` al crear el envío a partir de la cotización.	String
`base_price`	Valor bruto del envío.	Number
`price`	Valor neto del envío.	Number
`method`	Método de entrega. Actualmente las respuestas pueden ser: `standard`, para ofertas estándar, y `economic`, para ofertas más baratas.	String
`pay_before`	Fecha esperada para garantizar la promesa de envío generada.	Date
`delivery_promise.shipping_from`	Fecha inicial de la promesa de entrega.	String
`delivery_promise.shipping_to`	Fecha final de la promesa de entrega.	String
`delivery_days.from`	Mínimo de días hábiles para la promesa de entrega.	Integer
`delivery_days.to`	Máximo de días hábiles para la promesa de entrega.	Integer
`packages.quantity`	Cantidad de paquetes cotizados.	Number
`packages.dimensions`	Dimensiones del paquete cotizado.	Object
`shipping_to.zip_code`	Código postal de la dirección de destino.	String
`shipping_to.city_id`	Identificador de la ciudad de la dirección de destino.	String
`shipping_to.state_id`	Sigla del estado de la dirección de destino.	String
`shipping_to.country_id`	Sigla del país de la dirección de destino.	String

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Crear envíos

Una vez que obtengas una cotización, puedes crear un envío usando la información que recibiste en la respuesta de cotización. En caso de que la respuesta haya devuelto múltiples opciones, elige la que mejor se adapte a tus necesidades.

Para crear un envío, envía una solicitud al endpoint /shipping/v1/shipmentsPOST incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. y los parámetros descritos en la tabla debajo, incluyendo los identificadores de la cotización.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--data '{
    "rates": {
        "shipment_rate_id": "be9fae0d-1079-471e-887d-55861965d10e",
        "option_id": "d7f61877-4a39-4f94-b6fb-d80a6351c714"
    },
    "payment_intent_id": "131245840212",
    "receiver": {
        "person": {
            "email": "john.doe@example.com",
            "full_name": "John Doe",
            "identification": "12345678901",
            "phone": "+5511999999999"
        },
        "address": {
            "floor": "2",
            "apartment": "201",
            "street_number": "123",
            "street_name": "Calle de las Flores",
            "zip_code": "01234567",
            "neighborhood": "Centro",
            "references": "cerca del mercado"
        }
    },
    "external_reference_id": "ext-ref-12345",
    "items": [
        {
            "title": "Smartphone Samsung Galaxy",
            "quantity": 1,
            "unit_price": 7999,
            "description": "White",
            "fiscal_data": {
                "sat": "12345678",
                "sat_measurement_id": "SAT001",
                "measurement_unit": "UN",
                "package_id": "PKG001",
                "dangerous_material_id": "DM000"
            },
            "dimensions": {
                "unit": "G",
                "height": 15,
                "width": 8,
                "length": 1,
                "weight": 200
            }
        }
    ]
}'

Campo	Descripción	Tipo	Obligatoriedad
`X-Idempotency-Key`	Header. Clave para garantizar que cada solicitud sea única y evitar la creación duplicada de envíos. Se sugiere usar UUID V4 o strings aleatorias. Acepta valores entre 1 y 64 caracteres.	String	Obligatorio
`rates`	Información de la cotización para el paquete y la dirección informada.	Object	Obligatorio
`rates.shipment_rate_id`	Identificador de la cotización, obtenido en la respuesta a esa solicitud.	String	Obligatorio
`rates.option_id`	Identificador de la opción de cotización seleccionada, obtenido en la respuesta a esa solicitud.	String	Obligatorio
`payment_intent_id`	Identificador del pago asociado al envío. Debe informarse siempre. Si el pago se procesa con Mercado Pago, informa el ID del pago, aprobado o rechazado.	String	Obligatorio
`receiver`	Información del destinatario (quién recibirá el paquete).	Object	Obligatorio
`receiver.person`	Información personal del destinatario.	Object	Obligatorio
`receiver.person.email`	Correo electrónico del destinatario.	String	Obligatorio
`receiver.person.full_name`	Nombre completo del destinatario.	String	Obligatorio
`receiver.person.identification`	Documento de identidad del destinatario.	String	Opcional
`receiver.person.phone`	Número de teléfono del destinatario.	String	Obligatorio
`receiver.address`	Información de dirección del destinatario.	Object	Obligatorio
`receiver.address.floor`	Piso del departamento.	String	Opcional
`receiver.address.apartment`	Número del departamento (interno).	String	Opcional
`receiver.address.street_number`	Número de la dirección (externo).	String	Obligatorio
`receiver.address.street_name`	Calle de la dirección.	String	Obligatorio
`receiver.address.zip_code`	Código postal de la dirección.	String	Obligatorio
`receiver.address.neighborhood`	Barrio o colonia de la dirección.	String	Opcional
`receiver.address.references`	Detalles o complemento de la dirección.	String	Opcional
`external_reference_id`	Información en la etiqueta para identificar una referencia externa.	String	Opcional
`items`	Información sobre los ítems a enviar.	Array	Obligatorio
`items.title`	Título del ítem.	String	Obligatorio
`items.quantity`	Cantidad de ítems.	Number	Obligatorio
`items.unit_price`	Precio unitario del ítem.	Number	Obligatorio
`items.description`	Descripción del ítem.	String	Opcional
`items.fiscal_data`	Datos fiscales del producto.	Object	Obligatorio
`items.fiscal_data.sat`	Categoría SAT del ítem.	String	Obligatorio
`items.fiscal_data.sat_measurement_id`	Identificador único de la unidad de medida del producto según las unidades SAT.	String	Obligatorio
`items.fiscal_data.measurement_unit`	Unidad de medida del producto.	String	Obligatorio
`items.fiscal_data.package_id`	Identificador del paquete.	String	Obligatorio
`items.fiscal_data.dangerous_material_id`	Identificador para productos peligrosos.	String	Opcional
`items.dimensions`	Tamaño del ítem. Consulta las buenas prácticas de dimensionamiento para conocer los límites permitidos.	Object	Opcional
`items.dimensions.height`	Alto del item en centímetros. Consulta las buenas prácticas de dimensionamiento.	Number	Obligatorio
`items.dimensions.width`	Ancho del item en centímetros. Consulta las buenas prácticas de dimensionamiento.	Number	Obligatorio
`items.dimensions.length`	Largo del item en centímetros. Consulta las buenas prácticas de dimensionamiento.	Number	Obligatorio
`items.dimensions.weight`	Peso del item en gramos. Consulta las buenas prácticas de dimensionamiento.	Number	Obligatorio
`items.dimensions.unit`	Unidad de medida. Consulta las buenas prácticas de dimensionamiento.	String	Obligatorio

Si la solicitud se envía correctamente, la respuesta retornará los datos del envío creado.

json
{
    "shipments": [
        {
            "id": "7311edef-a46e-4a42-a8e1-6a142fa7ee48",
            "tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
            "packages": [
                {
                    "id": "f0c6e696-becb-4c9a-92c4-40422052583b"
                }
            ]
        }
    ],
    "idempotency_key": "unique-key-12345",
    "rates": {
        "shipment_rate_id": "52194ade-d6a9-4e9e-a582-c0897343849a",
        "option_id": "741e1150-5493-47e4-9720-ceca12d30af9",
        "delivery_promise": {
            "from": "2025-10-28T12:00:00-06:00",
            "to": "2025-10-30T12:00:00-06:00"
        }
    },
    "payment_intent_id": "131245840212",
    "receiver": {
        "person": {
            "email": "john.doe@example.com",
            "full_name": "John Doe",
            "identification": "12345678901",
            "phone": "+5511999999999"
        },
        "address": {
            "floor": "2",
            "apartment": "201",
            "street_number": "123",
            "street_name": "Calle de las Flores",
            "zip_code": "01234567",
            "neighborhood": "Centro",
            "references": "cerca del mercado"
        }
    },
    "origin": {
        "zip_code": "45601",
        "city": "Tlaquepaque",
        "state": "Jalisco",
        "country": "Mexico",
        "neighborhood": "La Calerilla",
        "address_line": "Calz de Guadalupe 432",
        "references": "200 Referencia: Casa blanca y azul."
    },
    "external_reference_id": "ext-ref-12345",
    "items": [
        {
            "title": "Smartphone Samsung Galaxy",
            "quantity": 1,
            "unit_price": 7999,
            "description": "White",
            "fiscal_data": {
                "sat": "12345678",
                "sat_measurement_id": "SAT001",
                "measurement_unit": "UN",
                "package_id": "PKG001",
                "dangerous_material_id": "DM000"
            },
            "dimensions": {
                "unit": "G",
                "height": 15,
                "width": 8,
                "length": 1,
                "weight": 200
            }
        }
    ]
}

Campo	Descripción	Tipo
`shipments`	Información de los envíos creados.	Array
`shipments.id`	Identificador único del envío.	String
`shipments.tracking_url`	Enlace para que el comprador consulte el estado de su envío en tiempo real.	String
`shipments.packages`	Paquetes incluidos en el envío.	Array
`shipments.packages.id`	Identificador del paquete enviado. Usa este valor para generar etiquetas y consultar envíos.	String
`idempotency_key`	Clave de idempotencia para evitar duplicados.	String
`rates`	Información de la cotización utilizada.	Object
`rates.delivery_promise`	Promesa de entrega confirmada.	Object
`rates.delivery_promise.from`	Fecha inicial de la promesa de entrega.	String
`rates.delivery_promise.to`	Fecha final de la promesa de entrega.	String
`payment_intent_id`	Identificador del pago asociado al envío. Debe siempre ser informado cuando procesado con Mercado Pago.	String
`receiver`	Información del destinatario del envío.	Object
`origin`	Información de la dirección de origen.	Object
`external_reference_id`	Referencia externa proporcionada en la solicitud.	String
`items`	Ítems incluidos en el envío.	Array

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Consultar envíos

Es posible consultar un envío y obtener sus datos completos una vez creado. Esta consulta te permitirá acceder al identificador del paquete (packages.id) y el número de rastreo (tracking_number), entre otros datos.

Para realizarla, envía una solicitud con tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. al endpoint /shipping/v1/shipmentsGET con los parámetros de consulta necesarios.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments?package_id=1c5dce04-dc5e-4fed-b7f1-08c192977c70' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

Opcionalmente, también puedes enviar los siguientes parámetros como query parameters para filtrar la consulta:

Parámetro	Descripción	Tipo	Obligatoriedad
`package_id`	Identificador del paquete a consultar.	String	Opcional
`external_reference_id`	Referencia externa del envío.	String	Opcional
`payment_id`	Identificador del pago asociado.	String	Opcional
`payment_intent_id`	Identificador de la intención de pago. Debe siempre ser informado cuando procesado con Mercado Pago.	String	Opcional

Si la solicitud es correcta, la respuesta será como el ejemplo a continuación.

json
{
    "data": [
        {
            "external_reference_id": "ext-ref-12345",
            "shipment_id": "7311edef-a46e-4a42-a8e1-6a142fa7ee48",
            "shipment_status": "ready",
            "active_phase": "forward",
            "created_at": "2026-02-09T20:17:16.637Z",
            "shipping_to": {
                "address": "Calle 789",
                "city_locality": "Ciudad de México",
                "state_province": "MX",
                "complement": "calle sin salida",
                "zip_code": "07000-000",
                "country_code": "MX"
            },
            "shipping_from": {
                "phone": "5513997343432",
                "contact": "Nicolas",
                "address": "Calle 123, 100",
                "city_locality": "Ciudad de México",
                "state_province": "MX",
                "complement": "calle sin salida",
                "zip_code": "11520",
                "country_code": "MX"
            },
            "tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
            "packages": [
                {
                    "id": "1c5dce04-dc5e-4fed-b7f1-08c192977c70",
                    "dimensions": {
                        "height": 50,
                        "length": 12,
                        "width": 50,
                        "weight": 30,
                        "volume": 2
                    },
                    "items": [
                        {
                            "title": "Producto",
                            "description": "Descripción del producto",
                            "unit_price": 100
                        }
                    ],
                    "price": {
                        "amount": "12.0",
                        "currency": "MXN"
                    },
                    "tracking_info": {
                        "tracking_number": "1c5dce04-dc5e-4fed-b7f1-08c192977c70",
                        "last_status": "ready",
                        "updated_at": "2026-02-09T20:17:16.637Z"
                    }
                }
            ],
            "dispatch_date": {
                "from": "2025-06-10T09:30:00.073890622Z"
            }
        }
    ]
}

Campo	Descripción	Tipo
`external_reference_id`	Referencia externa del envío.	String
`shipment_id`	Identificador único del envío.	String
`shipment_status`	Estado actual del envío.	String
`active_phase`	Fase activa del envío: `forward` (envío hacia el cliente) o `reverse` (devolución).	String
`created_at`	Fecha y hora de creación del envío.	Date
`shipping_to`	Información de la dirección de destino con detalles completos del destinatario.	Object
`shipping_from`	Información de la dirección de origen con detalles del remitente.	Object
`tracking_url`	Enlace para que el comprador consulte el estado de su envío en tiempo real.	String
`packages`	Paquetes incluidos en el envío.	Array
`packages.id`	Identificador del paquete. Usa este valor para generar etiquetas.	String
`packages.dimensions`	Dimensiones del paquete (alto, largo, ancho, peso y volumen).	Object
`packages.items`	Artículos incluidos en el paquete.	Array
`packages.price`	Información de precio del paquete.	Object
`packages.tracking_info`	Información de rastreo del paquete.	Object
`packages.tracking_info.tracking_number`	Número de rastreo del paquete. Usa este valor para rastrear el envío.	String
`packages.tracking_info.last_status`	Último estado registrado del paquete.	String
`dispatch_date`	Fecha estimada de despacho del envío.	Object

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Cancelar envíos

Para cancelar un envío existente, envía una solicitud al endpoint /shipping/v1/shipments/{id}DELETE incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. y el identificador del envío a cancelar en el path.

Solo es posible cancelar envíos creados independientemente de un pago, que todavía no hayan sido despachados o que hayan sido devueltos al vendedor tras tentativa de entrega sin éxito. Después de 15 días, todos los envíos generados y que no hayan sido despachados serán cancelados de forma automática y el costo será devuelto al vendedor. Si deseas cancelar un envío asociado a un pago, creado a partir de una preferencia, utiliza el endpoint /v1/payments/{id}PUT.

curl
curl --location --request DELETE 'https://api.mercadopago.com/shipping/v1/shipments/e522fa4a-c3f8-4f34-a353-16f45a012345' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

Si la solicitud es correcta, el envío será cancelado y la respuesta retornará un estado 204 Sin contenido.

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Generar etiquetas

Con la API de Etiquetas, podrás generar las etiquetas que contienen toda la información necesaria para despachar los paquetes de tus productos vendidos. Puedes elegir si deseas que la etiqueta sea generada en PDF, ZIP o JSON. El valor zip genera una etiqueta en formato ZPL.

Si al consultar un envío, el parámetro dispatch_date está presente, las etiquetas solo podrán ser generadas 24 horas antes de la fecha y hora definidas en ese campo.

Para generar la etiqueta, envía una solicitud con tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. y los parámetros indicados en la tabla siguiente al endpoint /shipping/v1/shipments/{id}/packages/{packageId}/labelGET.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments/{shipment_id}/packages/{package_id}/label' \
--header 'X-Content-Type: json' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

Campo	Descripción	Tipo	Obligatoriedad
`shipment_id`	Path. Identificador del envío, que puede ser obtenido consultando la información del envío o a través de la notificación Webhook.	String	Obligatorio
`package_id`	Path. Identificador del paquete, que puede ser obtenido consultando la información del envío o a través de la notificación Webhook.	String	Obligatorio
`X-Content-Type`	Header. Formato de salida deseado para la etiqueta. Los formatos posibles son: `pdf`, `zip`, `json`.	String	Obligatorio

La respuesta puede variar según el formato de salida especificado en la solicitud, pero siempre contendrá un identificador de la etiqueta (id) y el contenido de la misma (label). Si se ha solicitado que sea generada en un archivo PDF, ZIP o ZPL, contendrá el archivo para descarga.

json
[
    {
        "id": 43539204818,
        "label": "String"
    }
]

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Rastrear envíos

Puedes rastrear los paquetes despachados a partir de su número de rastreo. Para hacerlo, envía una solicitud al endpoint /shipping/v1/shipments-tracking/{tracking_number}GET incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración. y el número de rastreo del paquete (tracking_number) en el path de la solicitud.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-tracking/{tracking_number}' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

Si los datos enviados son correctos, la respuesta contendrá la información del paquete junto con los eventos del envío, como se presenta en la respuesta a contuación.

json
{
    "tracking_number": "343434ereer-3344e33rre3",
    "tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
    "package": {
        "id": "1",
        "external_reference_id": "Referencia externa",
        "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10,
            "weight": 10,
            "volume": 10
        },
        "items": [
            {
                "name": "Producto",
                "description": "Descripción del producto",
                "value": 2007.66
            }
        ],
        "price": {
            "amount": 2007.66,
            "currency": "MXN"
        }
    },
    "tracking": [
        {
            "type": "forward",
            "events": [
                {
                    "status": "created",
                    "date": "2024-08-22T13:40:00.095Z"
                },
                {
                    "event_name": "ready",
                    "event_date": "2025-06-09T18:40:24.749252964Z"
                },
                {
                    "status": "shipped",
                    "date": "2024-08-23T10:40:00.095Z"
                },
                {
                    "status": "in_hub",
                    "date": "2024-08-23T11:40:00.095Z"
                },
                {
                    "status": "outbounded",
                    "date": "2024-08-23T13:40:00.095Z"
                },
                {
                    "status": "out_for_delivery",
                    "date": "2024-08-23T13:45:00.095Z"
                },
                {
                    "status": "delivered",
                    "date": "2024-08-23T14:45:00.095Z"
                }
            ]
        }
    ]
}

Campo	Descripción	Tipo
`tracking_number`	Código de rastreo del envío del paquete.	String
`tracking_url`	Enlace para que el comprador consulte el estado de su envío en tiempo real.	String
`package`	Datos del paquete.	Object
`package.id`	Identificador único del paquete enviado.	String
`package.external_reference_id`	Referencia externa del paquete.	String
`package.dimensions`	Dimensiones del paquete (alto, largo, ancho, peso y volumen).	Object
`package.items`	Información de los ítems incluidos en el paquete.	Array
`package.price`	Datos del precio de envío del paquete.	Object
`package.price.amount`	Valor del envío.	Number
`package.price.currency`	Moneda utilizada.	String
`tracking`	Detalles del historial del envío.	Array
`tracking.type`	En qué dirección se mueve el envío: `forward` cuando el paquete está en camino al cliente; `reverse` cuando el paquete está retornando a la dirección de origen.	String
`tracking.events`	Lista de eventos del envío.	Array
`tracking.events.status`	Estado del evento de envío. Consulta los estados posibles en la sección a continuación.	String
`tracking.events.date`	Fecha de actualización del estado del evento.	String
`tracking.events.event_name`	Nombre del evento (cuando está disponible).	String
`tracking.events.event_date`	Fecha del evento (cuando está disponible).	String

Para conocer los errores que esta solicitud puede devolver, accede a nuestra Referencia de APIAPI.

Estados posibles de un envío

A continuación, puedes consultar los estados posibles de un envío junto con su descripción y asociación a la dirección en que este envío se mueve.

Estado	Descripción	Fase
`created`	El envío fue creado luego de realizado el pago.	Forward / Reverse
`ready`	La etiqueta del envío ya puede ser generada. Cuando `dispatch_date` esté presente, solo podrás generar la etiqueta 24 horas antes de esta fecha y hora.	Forward
`label_printed`	La etiqueta fue generada.	Forward / Reverse
`shipped`	El paquete fue recogido y está en camino a su destino.	Forward / Reverse
`out_for_delivery`	El paquete salió del lugar de origen hacia la dirección de destino.	Forward
`soon_deliver`	El paquete está cerca de su destino.	Forward
`delivered`	El paquete fue entregado.	Forward
`not_delivered`	El paquete no fue entregado.	Forward / Reverse
`canceled`	El envío fue cancelado.	Forward
`in_hub`	El paquete está en un depósito.	Forward
`rejected_in_hub`	El paquete fue rechazado en el depósito.	Forward
`discarded`	El paquete fue descartado y no retornará al remitente.	Reverse
`outbounded`	El paquete salió del depósito.	Forward
`impassable_area`	La ruta del envío tiene una zona intransitable.	Forward
`receiver_absent`	El destinatario del paquete está ausente.	Forward
`refused_delivery`	La entrega del paquete fue rechazada.	Forward
`bad_address`	El transportista no pudo encontrar la dirección de destino o no era válida.	Forward / Reverse
`damaged`	El paquete fue dañado.	Forward / Reverse
`lost`	El paquete se perdió.	Forward / Reverse
`stolen`	El paquete fue robado.	Forward / Reverse
`delayed`	El paquete está retrasado.	Forward
`estimated_delivery_updated`	Fecha de entrega estimada actualizada.	Forward
`returned`	El paquete fue devuelto al remitente.	Reverse
`on_route`	El paquete está en camino.	Forward
`failed`	Fallo en la inicialización del envío.	-
`redirected`	El envío fue redirigido (cambió de fase).	Reverse
`stuck`	El envío está impedido (fallo en el cambio de fase).	Forward / Reverse
`picked_up`	Paquete recogido.	Reverse
`carrier_logistic_center_inbound`	El paquete entró en un depósito.	Forward / Reverse
`carrier_logistic_center_outbound`	El paquete salió de un depósito.	Forward / Reverse
`sender_absent`	Vendedor ausente para la recogida.	Reverse
`refused_pickup`	La recogida del paquete fue rechazada.	Forward
`sender_not_visited`	No fue posible realizar la recogida del paquete.	Forward

Para obtener más información sobre las mejores prácticas al trabajar con dimensiones de envíos, consulta la documentación Dimensiones de envíos.

AnteriorEnvíosAprende a configurar los envíos y ofrecer entregas con la logística de Mercado Libre.

PróximoCrear pago con envíoAprende cómo crear un pago con un envío asociado, ofreciendo entregas utilizando la logística de Mercado Libre.