Recursos para IA

Criar envios

A API de Envios do Mercado Pago permite gerenciar envios a partir de vendas geradas com Checkout API. Aproveitando a logística do Mercado Livre, você poderá cotar e criar envios, gerenciá-los e rastrear pacotes, oferecendo uma melhor experiência de compra aos seus clientes.

A criação de envios está disponível apenas para integradores autorizados pelo Mercado Pago. Caso ainda não tenha essa funcionalidade habilitada, revise a disponibilidade em sua conta Mercado Pago.

Conheça as opções de gerenciamento de envios e como integrá-las a seguir.

Cotar envios

É possível estimar o valor de um envio em função do volume do pacote e dos códigos postais dos pontos de origem e destino. Esta cotação retorna um option_id e um shipment_rate_id que você usará posteriormente para criar o envio.

Para cotar um envio, envie uma solicitação ao endpoint /shipping/v1/shipments-ratesPOST incluindo seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. e os parâmetros descritos na tabela a seguir.

É possível cotar o envio de um pacote por vez apenas. Para envios com múltiplos itens, você deve calcular as dimensões totais do pacote que os contém. Consulte a documentação de Dimensões de envios para conhecer as dimensões permitidas e as melhores práticas.

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	Descrição	Tipo	Obrigatoriedade
`packages`	Contém a informação do pacote para a cotação.	Array	Obrigatório
`packages.declared_value`	Valor do pacote a ser enviado. Não inclui o custo estimado de envio.	Number	Obrigatório
`packages.quantity`	Quantidade de pacotes. O único valor permitido é `1`.	Number	Obrigatório
`packages.dimensions`	Objeto que contém as dimensões do pacote. Os máximos permitidos são: - Cada lado deve ter máximo 150 cm. - O limite de dimensões totais não deve ultrapassar 330 cm. - O peso máximo é de 30 kg (real ou volumétrico).	Object	Obrigatório
`packages.dimensions.height`	Altura do pacote em centímetros.	Number	Obrigatório
`packages.dimensions.width`	Largura do pacote em centímetros.	Number	Obrigatório
`packages.dimensions.length`	Comprimento do pacote em centímetros.	Number	Obrigatório
`packages.dimensions.weight`	Peso do pacote em gramas.	Number	Obrigatório
`shipping_from.zip_code`	Código postal do endereço de origem. Se esse valor for fornecido, será usado para calcular a oferta. Caso contrário, serão aplicados os dados de Envios configurados no Mercado Pago.	String	Opcional
`shipping_to.zip_code`	Código postal do endereço de destino.	String	Obrigatório

Se a requisição for correta, a resposta retornará a cotação do envio, que pode conter mais de uma opção variável em preço e/ou prazo.

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	Descrição	Tipo
`shipment_rate_id`	Identificador da cotação. Use esse valor como `shipment_rate_id` ao criar o envio.	String
`rates`	Lista de cotações para o pacote em função do endereço fornecido.	Array
`options`	Lista de opções de cotações disponíveis.	Array
`id`	Identificador da opção de envio. Use esse valor como `option_id` ao criar o envio a partir da cotação.	String
`base_price`	Valor bruto do envio.	Number
`price`	Valor líquido do envio.	Number
`method`	Método de entrega. Atualmente as respostas podem ser: `standard`, para ofertas padrão, e `economic`, para ofertas mais baratas.	String
`pay_before`	Data esperada para garantir a promessa de envio gerada.	Date
`delivery_promise.shipping_from`	Data inicial da promessa de entrega.	String
`delivery_promise.shipping_to`	Data final da promessa de entrega.	String
`delivery_days.from`	Mínimo de dias úteis para a promessa de entrega.	Integer
`delivery_days.to`	Máximo de dias úteis para a promessa de entrega.	Integer
`packages.quantity`	Quantidade de pacotes cotados.	Number
`packages.dimensions`	Dimensões do pacote cotado.	Object
`shipping_to.zip_code`	Código postal do endereço de destino.	String
`shipping_to.city_id`	Identificador da cidade do endereço de destino.	String
`shipping_to.state_id`	Sigla do estado do endereço de destino.	String
`shipping_to.country_id`	Sigla do país do endereço de destino.	String

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Criar envios

Uma vez obtida a cotação, é possível criar um envio utilizando a informação que recebida na resposta de cotação. Caso a resposta tenha retornado múltiplas opções, escolha a que melhor se adapte às suas necessidades.

Para criar um envio, envie uma solicitação ao endpoint /shipping/v1/shipmentsPOST incluindo seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. e os parâmetros descritos na tabela abaixo, incluindo os identificadores da cotação.

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": "test@testuser.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	Descrição	Tipo	Obrigatoriedade
`X-Idempotency-Key`	Header. Chave para garantir que cada requisição seja única e evitar a criação duplicada de envios. Sugerimos o uso de UUID V4 ou strings aleatórias. Aceita valores entre 1 e 64 caracteres.	String	Obrigatório
`rates`	Informação da cotação para o pacote e o endereço informado.	Object	Obrigatório
`rates.shipment_rate_id`	Identificador da cotação, obtido na resposta dessa requisição.	String	Obrigatório
`rates.option_id`	Identificador da opção de cotação selecionada, obtido na resposta dessa requisição.	String	Obrigatório
`payment_intent_id`	Identificador do pagamento associado ao envio. Deve ser sempre informado. Se o pagamento for processado com o Mercado Pago, informe o ID do pagamento, aprovado ou recusado.	String	Obrigatório
`receiver`	Informação do destinatário (quem receberá o pacote).	Object	Obrigatório
`receiver.person`	Informação pessoal do destinatário.	Object	Obrigatório
`receiver.person.email`	Email do destinatário.	String	Obrigatório
`receiver.person.full_name`	Nome completo do destinatário.	String	Obrigatório
`receiver.person.identification`	Documento de identidade do destinatário.	String	Opcional
`receiver.person.phone`	Número de telefone do destinatário.	String	Obrigatório
`receiver.address`	Informação de endereço do destinatário.	Object	Obrigatório
`receiver.address.floor`	Andar do apartamento.	String	Opcional
`receiver.address.apartment`	Número do apartamento (interno).	String	Opcional
`receiver.address.street_number`	Número do endereço (externo).	String	Obrigatório
`receiver.address.street_name`	Rua do endereço.	String	Obrigatório
`receiver.address.zip_code`	Código postal do endereço.	String	Obrigatório
`receiver.address.neighborhood`	Bairro ou colônia do endereço.	String	Opcional
`receiver.address.references`	Detalhes ou complemento do endereço.	String	Opcional
`external_reference_id`	Informação na etiqueta para identificar uma referência externa.	String	Opcional
`items`	Informação sobre os itens a enviar.	Array	Obrigatório
`items.title`	Título do item.	String	Obrigatório
`items.quantity`	Quantidade de itens.	Number	Obrigatório
`items.unit_price`	Preço unitário do item.	Number	Obrigatório
`items.description`	Descrição do item.	String	Opcional
`items.fiscal_data`	Dados fiscais do produto.	Object	Obrigatório
`items.fiscal_data.sat`	Categoria SAT do item.	String	Obrigatório
`items.fiscal_data.sat_measurement_id`	Identificador único da unidade de medida do produto de acordo com as unidades SAT.	String	Obrigatório
`items.fiscal_data.measurement_unit`	Unidade de medida do produto.	String	Obrigatório
`items.fiscal_data.package_id`	Identificador do pacote.	String	Obrigatório
`items.fiscal_data.dangerous_material_id`	Identificador para produtos perigosos.	String	Opcional
`items.dimensions`	Tamanho do item. Consulte as melhores práticas de dimensionamento para conhecer os limites permitidos.	Object	Opcional
`items.dimensions.height`	Altura do item em centímetros. Consulte as melhores práticas de dimensionamento.	Number	Obrigatório
`items.dimensions.width`	Largura do item em centímetros. Consulte as melhores práticas de dimensionamento.	Number	Obrigatório
`items.dimensions.length`	Comprimento do item em centímetros. Consulte as melhores práticas de dimensionamento.	Number	Obrigatório
`items.dimensions.weight`	Peso do item em gramas. Consulte as melhores práticas de dimensionamento.	Number	Obrigatório
`items.dimensions.unit`	Unidade de medida. Consulte as melhores práticas de dimensionamento.	String	Obrigatório

Se a requisição for enviada corretamente, a resposta retornará os dados do envio criado.

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": "test@testuser.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	Descrição	Tipo
`shipments`	Informação dos envios criados.	Array
`shipments.id`	Identificador único do envio.	String
`shipments.tracking_url`	Link para que o comprador consulte o status do envio em tempo real.	String
`shipments.packages`	Pacotes incluídos no envio.	Array
`shipments.packages.id`	Identificador do pacote enviado. Use esse valor para gerar etiquetas e consultar envios.	String
`idempotency_key`	Chave de idempotência para evitar duplicatas.	String
`rates`	Informação da cotação utilizada.	Object
`rates.delivery_promise`	Promessa de entrega confirmada.	Object
`rates.delivery_promise.from`	Data inicial da promessa de entrega.	String
`rates.delivery_promise.to`	Data final da promessa de entrega.	String
`payment_intent_id`	Identificador do pagamento associado ao envio. Deve sempre ser informado quando processado com Mercado Pago.	String
`receiver`	Informação do destinatário do envio.	Object
`origin`	Informação do endereço de origem.	Object
`external_reference_id`	Referência externa fornecida na requisição.	String
`items`	Itens incluídos no envio.	Array

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Consultar envios

É possível consultar um envio e obter seus dados completos uma vez criado. Essa consulta permitirá que você acesse o identificador do pacote (packages.id) e o número de rastreamento (tracking_number), entre outros dados.

Para realizá-la, envie uma solicitação com seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. ao endpoint /shipping/v1/shipmentsGET com os parâmetros de consulta necessários.

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

Opcionalmente, você também pode enviar os seguintes parâmetros como query parameters para filtrar a consulta:

Parâmetro	Descrição	Tipo	Obrigatoriedade
`package_id`	Identificador do pacote a consultar.	String	Opcional
`external_reference_id`	Referência externa do envio.	String	Opcional
`payment_id`	Identificador do pagamento associado.	String	Opcional
`payment_intent_id`	Identificador da intenção de pagamento. Deve sempre ser informado quando processado com Mercado Pago.	String	Opcional

Se a requisição for correta, a resposta será como o exemplo a seguir.

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": "Produto",
                            "description": "Descrição do produto",
                            "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	Descrição	Tipo
`external_reference_id`	Referência externa do envio.	String
`shipment_id`	Identificador único do envio.	String
`shipment_status`	Estado atual do envio.	String
`active_phase`	Fase ativa do envio: `forward` (envio para o cliente) ou `reverse` (devolução).	String
`created_at`	Data e hora de criação do envio.	Date
`shipping_to`	Informação do endereço de destino com detalhes completos do destinatário.	Object
`shipping_from`	Informação do endereço de origem com detalhes do remetente.	Object
`tracking_url`	Link para que o comprador consulte o status do envio em tempo real.	String
`packages`	Pacotes incluídos no envio.	Array
`packages.id`	Identificador do pacote. Use esse valor para gerar etiquetas.	String
`packages.dimensions`	Dimensões do pacote (altura, comprimento, largura, peso e volume).	Object
`packages.items`	Artigos incluídos no pacote.	Array
`packages.price`	Informação de preço do pacote.	Object
`packages.tracking_info`	Informação de rastreamento do pacote.	Object
`packages.tracking_info.tracking_number`	Número de rastreamento do pacote. Use esse valor para rastrear o envio.	String
`packages.tracking_info.last_status`	Último estado registrado do pacote.	String
`dispatch_date`	Data estimada de despacho do envio.	Object

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Cancelar envios

Para cancelar um envio existente, envie uma solicitação ao endpoint /shipping/v1/shipments/{id}DELETE incluindo seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. e o identificador do envio a cancelar no path. Tenha em conta que é possível cancelar apenas envios que ainda não foram despachados ou que foram devolvidos ao vendedor após tentativa de entrega sem sucesso. Após 15 dias, todos os envios gerados e não despachados serão cancelados de forma automática e o custo será devolvido ao vendedor.

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

Se a requisição for correta, o envio será cancelado e a resposta retornará um estado 204 Sem conteúdo.

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Gerar etiquetas

Com a API de Etiquetas, é possível gerar as etiquetas que contêm todas as informações necessárias para despachar os pacotes de seus produtos vendidos. Você pode escolher se deseja que a etiqueta seja gerada em PDF, ZIP ou JSON. O valor zip gera uma etiqueta no formato ZPL.

Se ao consultar um envio, o parâmetro dispatch_date estiver presente, as etiquetas poderão ser geradas apenas 24 horas antes da data e hora definidas nesse campo.

Para gerar a etiqueta, envie uma solicitação com seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. e os parâmetros indicados na tabela a seguir ao 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	Descrição	Tipo	Obrigatoriedade
`shipment_id`	Path. Identificador do envio, que pode ser obtido consultando a informação do envio ou através da notificação Webhook.	String	Obrigatório
`package_id`	Path. Identificador do pacote, que pode ser obtido consultando a informação do envio ou através da notificação Webhook.	String	Obrigatório
`X-Content-Type`	Header. Formato de saída desejado para a etiqueta. Os formatos possíveis são: `pdf`, `zip`, `json`.	String	Obrigatório

A resposta pode variar de acordo com o formato de saída especificado na requisição, mas sempre conterá um identificador da etiqueta (id) e o conteúdo da mesma (label). Se foi solicitado que seja gerada em um arquivo PDF, ZIP ou ZPL, conterá o arquivo para download.

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

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Rastrear envios

É possível rastrear os pacotes despachados a partir de seu número de rastreamento. Para fazê-lo, envie uma solicitação ao endpoint /shipping/v1/shipments-tracking/{tracking_number}GET incluindo seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração. e o número de rastreamento do pacote (tracking_number) no path da requisição.

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

Se os dados enviados estiverem corretos, a resposta conterá a informação do pacote junto com os eventos do envio, como apresentado na resposta a seguir.

json
{
    "tracking_number": "343434ereer-3344e33rre3",
    "tracking_url": "https://www.mercadopago.com.mx/shipping-tracking?id=000038774013",
    "package": {
        "id": "1",
        "external_reference_id": "Referência externa",
        "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10,
            "weight": 10,
            "volume": 10
        },
        "items": [
            {
                "name": "Produto",
                "description": "Descrição do produto",
                "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	Descrição	Tipo
`tracking_number`	Código de rastreamento do envio do pacote.	String
`tracking_url`	Link para que o comprador consulte o status do envio em tempo real.	String
`package`	Dados do pacote.	Object
`package.id`	Identificador único do pacote enviado.	String
`package.external_reference_id`	Referência externa do pacote.	String
`package.dimensions`	Dimensões do pacote (altura, comprimento, largura, peso e volume).	Object
`package.items`	Informação dos itens incluídos no pacote.	Array
`package.price`	Dados do preço de envio do pacote.	Object
`package.price.amount`	Valor do envio.	Number
`package.price.currency`	Moeda utilizada.	String
`tracking`	Detalhes do historial do envio.	Array
`tracking.type`	Em qual direção o envio se move: `forward` quando o pacote está a caminho para o cliente; `reverse` quando o pacote está retornando ao endereço de origem.	String
`tracking.events`	Lista de eventos do envio.	Array
`tracking.events.status`	Estado do evento de envio. Consulte os status possíveis na seção a seguir.	String
`tracking.events.date`	Data de atualização do estado do evento.	String
`tracking.events.event_name`	Nome do evento (quando disponível).	String
`tracking.events.event_date`	Data do evento (quando disponível).	String

Para conhecer os erros que essa requisição pode retornar, acesse nossa Referência de APIAPI.

Status possíveis de um envio

A seguir, você pode consultar os status possíveis de um envio junto com sua descrição e associação à direção em que esse envio se move.

Status	Descrição	Fase
`created`	O envio foi criado após realizado o pagamento.	Forward / Reverse
`ready`	A etiqueta do envio já pode ser gerada. Quando `dispatch_date` estiver presente, você poderá gerar a etiqueta apenas 24 horas antes dessa data e hora.	Forward
`label_printed`	A etiqueta foi gerada.	Forward / Reverse
`shipped`	O pacote foi coletado e está a caminho de seu destino.	Forward / Reverse
`out_for_delivery`	O pacote saiu do local de origem rumo ao endereço de destino.	Forward
`soon_deliver`	O pacote está perto de seu destino.	Forward
`delivered`	O pacote foi entregue.	Forward
`not_delivered`	O pacote não foi entregue.	Forward / Reverse
`canceled`	O envio foi cancelado.	Forward
`in_hub`	O pacote está em um depósito.	Forward
`rejected_in_hub`	O pacote foi rejeitado no depósito.	Forward
`discarded`	O pacote foi descartado e não retornará ao remetente.	Reverse
`outbounded`	O pacote saiu do depósito.	Forward
`impassable_area`	A rota do envio tem uma zona intransitável.	Forward
`receiver_absent`	O destinatário do pacote está ausente.	Forward
`refused_delivery`	A entrega do pacote foi recusada.	Forward
`bad_address`	A transportadora não conseguiu encontrar o endereço de destino ou ele não era válido.	Forward / Reverse
`damaged`	O pacote foi danificado.	Forward / Reverse
`lost`	O pacote se perdeu.	Forward / Reverse
`stolen`	O pacote foi roubado.	Forward / Reverse
`delayed`	O pacote está atrasado.	Forward
`estimated_delivery_updated`	Data de entrega estimada atualizada.	Forward
`returned`	O pacote foi devolvido ao remetente.	Reverse
`on_route`	O pacote está a caminho.	Forward
`failed`	Falha na inicialização do envio.	-
`redirected`	O envio foi redirecionado (mudou de fase).	Reverse
`stuck`	O envio está impedido (falha na mudança de fase).	Forward / Reverse
`picked_up`	Pacote coletado.	Reverse
`carrier_logistic_center_inbound`	O pacote entrou em um depósito.	Forward / Reverse
`carrier_logistic_center_outbound`	O pacote saiu de um depósito.	Forward / Reverse
`sender_absent`	Vendedor ausente para coleta.	Reverse
`refused_pickup`	A coleta do pacote foi recusada.	Forward
`sender_not_visited`	Não foi possível realizar a coleta do pacote.	Forward

Para obter mais informações sobre as melhores práticas ao trabalhar com dimensões de envios, consulte a documentação Dimensões de envios.

AnteriorEnviosVeja como configurar envios, oferecendo entregas utilizando a logística do Mercado Livre.

PróximoBoas práticas para enviosCaso configure vendas com envios, veja quais são as boas práticas para o dimensionamento dos pacotes.