Este endpoint permite crear nuevos envíos para el usuario basándose en la opción de cotización seleccionada. Requiere una clave de idempotencia para evitar la creación duplicada de envíos. El endpoint procesa la creación del envío y devuelve el ID de envío e los IDs de paquete creados. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
bad_request
Se enviaron datos inválidos en el body de la solicitud. Vuelve a intentar enviar la solicitud, validando todos los campos.
401No autorizado. Credenciales inválidas o faltantes.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
404No encontrado. El recurso solicitado no existe.
not_found
El recurso solicitado no fue encontrado o el valor enviado para identificarlo es inexistente. Valida la información enviada en los parámetros y vuelve a intentarlo.
417Expectativa fallida.
expectation_failed
No se pudo cumplir con la expectativa especificada en el header "Expect". Valida la información enviada y vuelve a intentarlo.
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: a74e64e5-cad6-4e0f-9b0a-5a2b2aea8cca' \
-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
}
]
}