Recursos para IA

Crear pago con envío

A través de la preferencia, es posible crear un pago con un envío asociado. De esta manera, podrás ofrecer a los clientes entregas a domicilio de los productos adquiridos aprovechando la logística de Mercado Libre y sin esfuerzos extra de parte del negocio.

La creación de pagos con envíos solo está disponible para integradores que cuenten con autorización de Mercado Pago. Si no cuentas con esta funcionalidad, puedes solicitarla a tu Asesor Comercial.

Para crear un pago con un envío asociado, crea una preferencia enviando un POST al endpoint /checkout/preferences, incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. y los nodos items y shipments como es indicado en la tabla a continuación.

curl
curl --location 'https://api.mercadopago.com/checkout/preferences' \
--header 'Authorization: Bearer [Access Token]' \
--header 'Content-Type: application/json' \
--data '{
"external_reference": "Referencia externa 123",
  "items": [
    {
      "title": "Producto 1",
      "description": "Descripción del producto 1",
      "picture_url": "image.jpg",
      "quantity": 1,
      "currency_id": "MXN",
      "unit_price": 100,
      "fiscal_data": {
        "sat": "23241500",
        "sat_measurement_id": "H87",
        "measurement_unit": "Pieza",
        "package_id": "4G",
        "dangerous_material_id": "M2340"
      },
      "dimensions": {
        "unit": "G",
        "height": 3,
        "width": 11,
        "length": 18,
        "weight": 100
      }
    }, 
    {  
      "title": "Producto 2",
      "description": "Descripción del producto 2",
      "picture_url": "image.jpg",
      "quantity": 1,
      "currency_id": "MXN",
      "unit_price": 110,
      "fiscal_data": {
        "sat": "23241500",
        "sat_measurement_id": "H87",
        "measurement_unit": "Pieza",
        "package_id": "4G",
        "dangerous_material_id": "M2340"
      },
      "dimensions": {
        "unit": "G",
        "height": 3,
        "width": 10,
        "length": 18,
        "weight": 90
      }
    },

  ],
   "shipments": {
    "dimensions": "21x15x6.5,360",
    "free_methods_types": [
            {
                "id": "standard"
            }
        ],
    "local_pickup": false,
    "mode": "me2",
    "stock_origin_id": "id",
    "receiver_address": {
         "zip_code": "06250",
         "street_name": "Ex-Hipódromo de Peralvillo",
         "street_number": null,
         "floor": "",
         "apartment": "",
         "neighborhood": Colonia,
         "city_name": Cuauhtémoc,
         "state_name": Ciudad de México,
         "country_name": México
        }
    }
}'

Campo	Descripción	Tipo	Obligatoriedad
`external_reference`	Referencia que puedes sincronizar con tu sistema de pagos para identificar el envío. Este campo debe tener un máximo de 64 caracteres y solo debe contener números, letras, guiones (-) y guiones bajos (_). No se permiten caracteres especiales como ([ ], (), '', @).	String	Opcional
`items`	Información sobre los ítems vendidos a ser enviados.	Array	Requerido
`items.title`	Título del ítem que se mostrará durante el proceso de pago, en el checkout, actividades y correos electrónicos.	String	Requerido
`items.description`	Descripción del ítem.	String	Opcional
`items.picture_url`	URL de la imagen del ítem.	String	Opcional
`items.quantity`	Cantidad de ítems. Esta propiedad se utiliza para calcular el costo total de la compra.	Number	Requerido
`items.currency_id`	Identificador único de la moneda involucrada en la transacción. El único valor posible es pesos mexicanos (MXN).	String	Opcional
`items.unit_price`	Precio unitario del ítem. Esta propiedad se usa junto con propiedad `quantity` para determinar el costo de la compra.	Number	Requerido
`items.fiscal_data`	Objeto que contiene los datos fiscales del producto.	Object	Requerido para crear envíos. Si lo ingresas, debes incluir también el atributo `shipments`.
`items.fiscal_data.sat`	Categoría SAT del ítem. Consulta los valores posibles accediendo al siguiente enlace.	String	Requerido
`items.fiscal_data.sat_measurement_id`	Identificador único de la unidad de medida del producto.	String	Requerido
`items.fiscal_data.measurement_unit`	Unidad de medida del producto de acuerdo con las SAT Units.	String	Requerido
`items.fiscal_data.package_id`	Identificador del tipo de embalaje del producto.	String	Requerido
`items.fiscal_data.dangerous_material_id`	Identificador para productos peligrosos.	String	Opcional
`items.dimensions`	Objeto que contiene la información sobre el tamaño del ítem.	Object	Opcional
`items.dimensions.unit`	Unidad de medida para el ítem. Debe ser `cm` (centímetros).	String	Requerido
`items.dimensions.height`	Alto del ítem en centímetros.	Number	Requerido
`items.dimensions.width`	Ancho del ítem en centímetros.	Number	Requerido
`items.dimensions.length`	Largo del ítem en centímetros.	Number	Requerido
`items.dimensions.weight`	Peso del ítem en gramos.	Number	Requerido
`shipments`	Información del envío.	Object	Obligatorio
`shipments.dimensions`	Tamaño del paquete, que se utilizará para definir el costo del envío. El formato debe ser `cm x cm x cm, g`. Si contiene más de un ítem, su tamaño debe calcularse considerando la suma de las dimensiones de todos los artículos, asegurando siempre que no se superen las dimensiones máximas permitidas por paquete. Consulta las buenas prácticas para el dimensionamiento accediendo a la documentación.	String	Requerido
`shipments.free_methods_type`	Identificador de método de envío. Solo debe enviarse en caso de ofrecer envío gratuito, con el valor `standard`. Este envío gratuito solo es posible cuando el valor de la venta es mayor que el costo de envío. En caso de que el costo del envío esté a cargo del comprador, el campo no debe enviarse.	String	Opcional
`shipments.local_pickup`	Indica si se quiere ofrecer recolección de paquetes en sucursal. Para esta solución, ingresa `false`.	Boolean	Requerido
`shipments.mode`	Modo de envío. Para esta solución, ingresa `me2`.	String	Requerido
`shipments.stock_origin_id`	Identificador de la dirección de origen del paquete, que debe ser solicitado al equipo de Mercado Pago. En caso de haber más de una dirección de recolección, deberá ser informado el `stock_origin_id` de la dirección de origen.	String	Opcional
`shipments.receiver_address`	Detalles de la dirección de destino. Su envío es recomendado para ofrecer la mejor experiencia de compra y, de ser necesario, los datos pueden ser reutilizados.	Object	Opcional
`shipments.receiver_address.zip_code`	Código postal de la dirección de destino.	String	Opcional
`shipments.receiver_address.street_name`	Nombre de la calle de destino.	String	Opcional
`shipments.receiver_address.street_number`	Número de la dirección de destino.	String	Opcional
`shipments.receiver_address.floor`	Piso del apartamento de destino.	String	Opcional
`shipments.receiver_address.apartment`	Número del apartamento de destino.	String	Opcional
`shipments.receiver_address.neighborhood`	Barrio de la dirección de destino.	String	Opcional
`shipments.receiver_address.city_name`	Ciudad de la dirección de destino.	String	Opcional
`shipments.receiver_address.state_name`	Estado de la dirección de destino.	String	Opcional
`shipments.receiver_address.country_name`	País de la dirección de destino.	String	Opcional

Si la solicitud se envió correctamente, el pago con envío habrá sido creado y la respuesta se verá como en el ejemplo a continuación.

json
{
    "additional_info": "",
    "auto_return": "",
    "back_urls": {
        "failure": "",
        "pending": "",
        "success": ""
    },
    "binary_mode": false,
    "client_id": "6607075136335166",
    "collector_id": 2681149695,
    "coupon_code": null,
    "coupon_labels": null,
    "date_created": "2025-10-15T15:30:39.775-04:00",
    "date_of_expiration": null,
    "expiration_date_from": null,
    "expiration_date_to": null,
    "expires": false,
    "external_reference": "Referencia externa 123",
    "id": "2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "init_point": "https://www.mercadopago.com.mx/checkout/v1/redirect?pref_id=2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "internal_metadata": null,
    "items": [
        {
            "id": "",
            "category_id": "",
            "currency_id": "MXN",
            "description": "Descripción del producto 1",
            "title": "Producto 1",
            "quantity": 1,
            "unit_price": 100,
            "fiscal_data": {
                "sat": "23241500",
                "sat_measurement_id": "H87",
                "measurement_unit": "Pieza",
                "package_id": "4G",
                "dangerous_material_id": "M2340"
            },
            "dimensions": {
                "unit": "G",
                "height": 3,
                "width": 11,
                "length": 18,
                "weight": 100
            }
        },
        {
            "id": "",
            "category_id": "",
            "currency_id": "MXN",
            "description": "Descripción del producto 2",
            "title": "Producto 2",
            "quantity": 1,
            "unit_price": 110,
            "fiscal_data": {
                "sat": "23241500",
                "sat_measurement_id": "H87",
                "measurement_unit": "Pieza",
                "package_id": "4G",
                "dangerous_material_id": "M2340"
            },
            "dimensions": {
                "unit": "G",
                "height": 3,
                "width": 10,
                "length": 18,
                "weight": 90
            }
        },
            ],
    "marketplace": "NONE",
    "marketplace_fee": 0,
    "metadata": {},
    "notification_url": null,
    "operation_type": "regular_payment",
    "payer": {
        "phone": {
            "area_code": "",
            "number": ""
        },
        "address": {
            "zip_code": "",
            "street_name": "",
            "street_number": null
        },
        "email": "",
        "identification": {
            "number": "",
            "type": ""
        },
        "name": "",
        "surname": "",
        "date_created": null,
        "last_purchase": null
    },
    "payment_methods": {
        "default_card_id": null,
        "default_payment_method_id": null,
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null,
        "default_installments": null
    },
    "processing_modes": null,
    "product_id": null,
    "preference_expired": false,
    "redirect_urls": {
        "failure": "",
        "pending": "",
        "success": ""
    },
    "sandbox_init_point": "https://sandbox.mercadopago.com.mx/checkout/v1/redirect?pref_id=2681149695-c464c4e0-1834-4e81-9956-25a3cc1e8db8",
    "site_id": "MLM",
    "shipments": {
        "mode": "me2",
        "local_pickup": false,
        "dimensions": "21x15x6.5,360",
        "free_methods": [],
        "free_methods_types": [
            {
                "id": "standard"
            }
        ],
        "default_shipping_method": null,
        "receiver_address": {
            "zip_code": "06250",
            "street_name": "Ex-Hipódromo de Peralvillo",
            "street_number": null,
            "floor": "",
            "apartment": "",
            "city_name": "Cuauhtémoc",
            "state_name": "Ciudad",
            "country_name": "México",
            "neighborhood": "Colonia"
        },
        "stock_origin_id": "id"
    },
    "total_amount": null,
    "last_updated": null,
    "financing_group": ""
}

En caso de ser necesario, puedes cancelar el envío creado. Para eso, deberás cancelar el pago al que está asociado en su totalidad.

Gestionar envíos

Si eliges crear pagos con envíos, puedes utilizar nuestras APIs de gestión de envíos, que te permitirán optimizar tu experiencia pre y posventa.

Cotización

Para cotizar un envío, envía un POST al endpoint /shipping/v1/shipments-rates incluyendo tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. y los parámetros descritos en la tabla a continuación. Ten en cuenta que solo es posible cotizar el envío de un paquete por vez.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-rates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [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	Requerido
`packages.declared_value`	Valor del paquete a ser enviado. No incluye el costo estimado de envío.	Number	Requerido
`packages.quantity`	Cantidad de paquetes. El único valor permitido es `1`.	Number	Requerido
`packages.dimensions`	Objeto que contiene las dimensiones del paquete. Los máximos permitidos son: - Cada lado debe tener un máximo de 150 cm. - El límite de dimensiones totales no debe superar los 330 cm. - El peso máximo es de 30 kg (real o volumétrico).	Object	Requerido
`packages.dimensions.height`	Alto del paquete en centímetros.	Number	Requerido
`packages.dimensions.width`	Ancho del paquete en centímetros.	Number	Requerido
`packages.dimensions.length`	Largo del paquete en centímetros.	Number	Requerido
`packages.dimensions.weight`	Peso del paquete en gramos.	Number	Requerido
`shipping_from.zip_code`	Código postal de la dirección de origen. Si se informa este valor, se usará para calcular la oferta. De lo contrario, se aplicará el dato de Envíos configurado en Mercado Pago.	String	Opcional
`shipping_to.zip_code`	Código postal de la dirección de destino.	String	Requerido

Si la solicitud es correcta, la respuesta devolverá la cotización del envío, que puede contener más de una opción variables 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 informada.	Array
`options`	Lista de las 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. La única respuesta posible a este campo es `standard`, para envíos gratuitos.	String
`pay_before`	Expectativa de fecha del pago para asegurar 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
`packages.dimensions.height`	Alto del paquete.	Number
`packages.dimensions.width`	Ancho del paquete.	Number
`packages.dimensions.length`	Largo del paquete.	Number
`packages.dimensions.weight`	Peso del paquete.	Number
`shipping_to.zip_code`	Código postal del domicilio 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 puede devolver esta solicitud, dirígete a nuestra Referencia de API.

Consulta de 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 tracking (tracking_number), entre otros datos.

Para realizarla, envía un GET con tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. al endpoint /shipping/v1/shipments/{shipment_id} incluyendo el identificador del envío (shipment_id) en el path de la solicitud.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments/e522fa4a-c3f8-4f34-a353-16f45a012345' \
--header 'Authorization: Bearer [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.	String	Opcional

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

json
{
    "data": [
        {
            "external_reference_id": "Referencia externa",
            "shipment_id": "e522fa4a-c3f8-4f34-a353-16f45a012345",
            "shipment_status": "ready",
            "active_phase": "forward",
            "created_at": "2025-07-03T18:46:03.645897682",
            "shipping_to": {
                "address": "Dirección del comprador",
                "city_locality": "Ciudad",
                "state_province": "Estado",
                "complement": "Detalle",
                "zip_code": "06250",
                "country_code": "MX"
            },
            "shipping_from": {
                "phone": "1234567890",
                "contact": "Nombre del vendedor",
                "address": "Dirección del vendedor",
                "city_locality": "Ciudad",
                "state_province": "MEX",
                "complement": "",
                "zip_code": "54963",
                "country_code": "MX"
            },
            "packages": [
                {
                    "id": "96b67f13-753e-4f23-b087-cb4d46383f4s6",
                    "dimensions": {
                        "height": 10,
                        "length": 10,
                        "width": 10,
                        "weight": 100,
                        "volume": null
                    },
                    "items": [
                        {
                            "title": "Producto",
                            "description": "Descripción del producto",
                            "unit_price": 100
                        }
                    ],
                    "price": {
                        "amount": "100",
                        "currency": "MXN"
                    },
                    "tracking_info": {
                        "tracking_number": "96b67f13-753e-4f23-b087-cb4d46381d1d",
                        "last_status": "ready",
                        "updated_at": "2025-07-03T18:46:07.136506537"
                    }
                }
            ],
            "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."
            },
            "dispatch_date": {
                "from": "2025-07-05T06:00:00Z"
            }
        }
    ]
}

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 al 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
`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 seguimiento del paquete.	Object
`packages.tracking_info.tracking_number`	Número de seguimiento del paquete. Usa este valor para rastrear el envío.	String
`packages.tracking_info.last_status`	Último estado registrado del paquete.	String
`origin`	Información de la dirección de origen.	Object
`dispatch_date`	Fecha estimada de despacho del envío.	Object

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. Podrás elegir si deseas que esta etiqueta sea generada en PDF, ZIP o ZPL, para su descarga, o en formato JSON.

Si al consultar por 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. Accede a Consulta de envíos para más información.

Para generar la etiqueta, envía un GET con tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba. y los parámetros indicados en la tabla a continuación al endpoint /shipping/v1/shipments/{id}/packages/{package_id}/label.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments/1371769672-9785ed21-f66d-4290-a628-434343434/packages/678029ce4265b922a299999/label' \
--header 'X-Content-Type: json' \
--header 'Authorization: Bearer [Access Token] '

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

La respuesta puede variar dependiendo del formato de salida especificado en la solicitud, pero siempre contendrá un identificador de la etiqueta (id) y el contenido de la misma (label). En caso de haber solicitado que sea generada en un archivo PDF, ZIP o ZPL, contendrá el descargable.

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

Para conocer los errores que puede devolver esta solicitud, dirígete a nuestra Referencia de API.

Seguimiento

Con la API de envíos puedes realizar el seguimiento de los paquetes despachados a partir de su número de seguimiento. Para hacerlo, envía un GET al endpoint /shipping/v1/shipments-tracking/{tracking_number}, incluyendo exclusivamente el número de seguimiento (tracking_number) del paquete en el path de la solicitud.

curl
curl --location 'https://api.mercadopago.com/shipping/v1/shipments-tracking/343434ereer-3344e33rre3' \
--header 'Authorization: Bearer [Access Token]'

Si el dato enviado es correcto, la respuesta contendrá la información del paquete junto con los eventos del envío, como se muestra en la respuesta a continuación.

json
{
    "tracking_number": "343434ereer-3344e33rre3",
    "package": {
        "id": "1",
        "external_reference_id": "Referencia externa",
        "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10,
            "weight": 10,
            "volume": 10
        },
        "items": [
            {
                "title": "Producto",
                "description": "Descripción del producto",
                "unit_price": 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 seguimiento del envío del paquete.	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.dimensions.height`	Alto del paquete.	Number
`package.dimensions.width`	Ancho del paquete.	Number
`package.dimensions.length`	Largo del paquete.	Number
`package.dimensions.weight`	Peso del paquete.	Number
`package.items`	Información de los ítems incluidos en el paquete.	Array
`package.items.title`	Título del ítem enviado en el paquete.	String
`package.items.description`	Descripción del ítem enviado en el paquete.	String
`package.items.unit_price`	Valor del ítem enviado en el paquete.	Number
`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 histórico del envío.	Array
`tracking.type`	En qué dirección se mueve el envío: `forward` cuando el paquete está en camino hacia el cliente; `reverse` cuando el paquete se dirige de vuelta 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 puede devolver esta solicitud, dirígete a nuestra Referencia de API.

Posibles estados de un envío

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

Estado	Descripción	Fase
`created`	El envío fue creado (una vez realizado el pago).	Forward / Reverse
`ready`	Ya puede generarse la etiqueta del envío. Cuando `dispatch-date` esté presente, solo podrás generar la etiqueta 24 horas antes de esta fecha y horario.	Forward
`label_printed`	La etiqueta fue generada.	Forward / Reverse
`shipped`	El paquete fue recolectado y está en camino a su destino.	Forward / Reverse
`out_for_delivery`	El paquete salió del lugar de origen a 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 se encuentra 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 se encuentra 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 fue perdido.	Forward / Reverse
`stolen`	El paquete fue robado.	Forward / Reverse
`delayed`	El paquete está demorado.	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`	Falló la inicialización del envío.	-
`redirected`	Se redirigió el envío (cambió de fase).	Reverse
`stuck`	El envío está impedido (falló 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 recolección.	Reverse
`refused_pickup`	Se rechazó la recolección del paquete.	Forward
`sender_not_visited`	No se pudo realizar la recolección del paquete.	Forward

Configurar notificaciones de envíos

Configura notificaciones Webhooks para recibir alertas sobre envíos y sus cambios de estado.

Para hacerlo, es necesario indicar las URLs a las que las mismas serán enviadas siguiendo el paso a paso a continuación:

Ingresa a Tus integraciones y selecciona la aplicación integrada con Checkout Pro para la que deseas activar las notificaciones.

Application

En el menú de la izquierda, selecciona Webhooks > Configurar notificaciones.

Webhooks

Selecciona la pestaña Modo productivo y proporciona una URL HTTPS para recibir notificaciones con tu integración productiva.

URL

Selecciona el evento Envíos (Mercado Pago) para recibir notificaciones, que serán enviadas en formato JSON a través de un HTTPS POST a la URL especificada anteriormente.

Envíos

Por último, haz clic en Guardar configuración. Esto generará una clave secreta exclusiva para la aplicación, que permitirá validar la autenticidad de las notificaciones recibidas, garantizando que hayan sido enviadas por Mercado Pago. Ten en cuenta que esta clave generada no tiene plazo de caducidad y su renovación periódica no es obligatoria, aunque sí recomendada. Para hacerlo, basta con cliquear en el botón Restablecer.

Si deseas obtener más información sobre cómo simular el envío de una notificación, validar su origen, o cuáles son las acciones necesarias luego de recibirlas, dirígete a Configurar notificaciones.

Excluir medios de pago

Aprende a configurar un medio de pago, excluir cualquier medio de pago no deseado o definir el número de cuotas.

Crear envíos

Configure envios a partir de vendas geradas com Checkout Pro e utilizando a logística de entregas do Mercado Livre.