Inicio
Documentación
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Obtener orden por ID de envío - Órdenes de entrega - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Consultar pedido por ID

GET

https://api.mercadopago.com/proximity-integration/v1/orders/{shipment_id}
Consulta las informaciones de un pedido por su shipment ID.
Parámetros para la solicitud
PATH
shipment_id
string

REQUERIDO

Shipment ID del pedido.
HEADER
x-time-zone
string

REQUERIDO

Zona horaria de las horas que se muestran en el JSON. Por ejemplo: GMT-3.
Parámetros de respuesta
id
string
Shipment ID del pedido.
type
string
Este campo hace referencia a la forma en que se entregará el pedido.
DELIVERY: the restaurant will be responsible for delivering the order.
TAKEOUT: the buyer will pick up the order from the restaurant.
displayId
string
ID de pedido que se muestra en la interfaz de la aplicación de pedidos para el comprador.
createdAt
string
Hora de creación del pedido.
Errores

401Error

401

Unauthorized - Access Token is invalid

403Error

403

Forbidden - User cannot access this resource

404Error

404

Not Found - Failed to search shipment

424Error

424

Not Found - Failed to get some information of the order

500Error

500

Internal server error

Solicitud
curl -X GET \
    'https://api.mercadopago.com/proximity-integration/v1/orders/{shipment_id}'\
    -H 'Content-Type: application/json' \
       -H 'x-time-zone: GMT-3' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    
Respuesta de ejemplo
{
  "id": "41034141533",
  "type": "DELIVERY",
  "displayId": "9129",
  "createdAt": "2022-02-16T21:20:15.227Z",
  "orderTiming": "INSTANT",
  "preparationStartDateTime": "2022-02-16T21:20:47.755Z",
  "merchant": {
    "id": "1070421029",
    "name": "Doc's Store"
  },
  "items": [
    {
      "id": "MLA1122759502",
      "name": "Burrito Combo Refrigerante",
      "externalCode": "1215451",
      "unit": "UNIT",
      "quantity": 2,
      "specialInstructions": "No quiero cebolla.",
      "options": [
        {
          "id": "MLA1122707065",
          "name": "Soda",
          "externalCode": "151545",
          "unit": "UNIT",
          "quantity": 2,
          "unitPrice": {
            "value": 100,
            "currency": "ARS"
          },
          "totalPrice": {
            "value": 200,
            "currency": "ARS"
          },
          "extension": {
            "group": "Combo with soda"
          }
        }
      ],
      "unitPrice": {
        "value": 300,
        "currency": "ARS"
      },
      "optionsPrice": {
        "value": 200,
        "currency": "ARS"
      },
      "totalPrice": {
        "value": 1000,
        "currency": "ARS"
      },
      "extension": {
        "unitNetPrice": {
          "value": 1000,
          "currency": "ARS"
        }
      }
    }
  ],
  "otherFees": [
    {
      "name": "Name of the Fee",
      "type": "DELIVERY_FEE",
      "receivedBy": "MERCHANT",
      "receiverDocument": "3124123141",
      "price": {
        "value": 119,
        "currency": "ARS"
      }
    }
  ],
  "discounts": [
    {
      "amount": {
        "value": 119,
        "currency": "ARS"
      },
      "target": "ITEM",
      "targetId": "MLA1122759502",
      "sponsorshipValues": [
        {
          "name": "MARKETPLACE",
          "amount": {
            "value": 119,
            "currency": "ARS"
          }
        }
      ],
      "extension": {
        "id": "21515164-001",
        "name": "coupon_off"
      }
    }
  ],
  "total": {
    "itemsPrice": {
      "value": 1000,
      "currency": "ARS"
    },
    "otherFees": {
      "value": 119,
      "currency": "ARS"
    },
    "discount": {
      "value": 0,
      "currency": "ARS"
    },
    "orderAmount": {
      "value": 1119,
      "currency": "ARS"
    }
  },
  "payments": {
    "prepaid": 1119,
    "pending": 0,
    "methods": [
      {
        "currency": "ARS",
        "type": "PREPAID",
        "method": "DIGITAL_WALLET"
      }
    ]
  },
  "customer": {
    "id": "1071059933",
    "name": "Test User",
    "phone": {
      "number": "011 123456789"
    },
    "documentNumber": "2731234567894"
  },
  "delivery": {
    "deliveredBy": "MERCHANT",
    "deliveryAddress": {
      "country": "Argetina",
      "state": "Capital Federal",
      "city": "Santos Lugares",
      "street": "Calle 01",
      "number": "1523",
      "complement": "APTO 58",
      "reference": "Referencia: Next to bakery",
      "formattedAddress": "Calle 01 1523",
      "postalCode": "1428",
      "coordinates": {
        "latitude": -34.55864,
        "longitude": -58.457982
      }
    },
    "estimatedDeliveryDateTime": "2022-02-21T21:49:55Z",
    "deliveryDateTime": "2022-02-21T21:52:55Z"
  },
  "extension": {
    "status": "ready_to_ship",
    "substatus": "printed",
    "store": {
      "id": "44905357",
      "externalCode": "UNID01",
      "brandId": 2641,
      "brandName": "Brand Name"
    },
    "qr": {
      "id": "41382089428",
      "sender_id": 1068595961,
      "hash_code": "v3Xtt15eewkj3Eu2lZt+cJQgDj3H6AHb04y1cMO4nPI=",
      "security_digit": "0"
    },
    "estimatedPickupDate": "2022-02-21T22:00:55Z",
    "paymentsInfo": [
      {
        "id": 58096990331,
        "entity": "ORDER",
        "entityId": 2000005654919550
      }
    ]
  }
}