Este endpoint permite criar novos envios para o usuário com base na opção de cotação selecionada. Requer uma chave de idempotência para evitar a criação duplicada de envios. O endpoint processa a criação do envio e retorna o ID de envio e os IDs de pacote criados. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
bad_request
Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.
401Não autorizado. Credenciais inválidas ou ausentes.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
403Proibido. Não tem permissões para acessar este recurso.
forbidden
Sem permissão para acessar o recurso.
404Não encontrado. O recurso solicitado não existe.
not_found
O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.
417Expectativa falhou.
expectation_failed
Não foi possível atender à expectativa especificada no header "Expect". Valide as informações enviadas e tente enviar a requisição novamente.
curl -X POST \
'https://api.mercadopago.com/shipping/v1/shipments'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Idempotency-Key: dd7180c1-109d-47ba-8419-d815716ef44e' \
-d '{
"rates": {
"shipment_rate_id": "be9fae0d-1079-471e-887d-55861965d10e",
"option_id": "d7f61877-4a39-4f94-b6fb-d80a6351c714"
},
"payment_intent_id": "1378330711-d13353c3-525c-442e-b101-27b892b2746d",
"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": "06760",
"neighborhood": "Centro",
"references": "cerca del mercado"
}
},
"external_reference_id": "REF-123456",
"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
}
}
]
}'{
"shipments": [
{
"id": "7311edef-a46e-4a42-a8e1-6a142fa7ee48",
"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": "1378330711-d13353c3-525c-442e-b101-27b892b2746d",
"receiver": {},
"origin": {
"zip_code": "06760",
"city": "Tlaquepaque",
"state": "Jalisco",
"country": "Mexico",
"neighborhood": "La Calerilla",
"address_line": "Calz de Guadalupe 432",
"references": "Casa blanca y azul."
},
"external_reference_id": "REF-123456",
"items": [
{
"title": "Producto",
"description": "Descripción del producto",
"unit_price": 100
}
]
}