Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Obter pedido por ID de envio - Pedidos de entrega - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Consultar pedido por ID

GET

https://api.mercadopago.com/proximity-integration/v1/orders/{shipment_id}
Consulta as informações de um pedido através do shipment ID.
Parâmetros de requisição
PATH
shipment_id
string

OBRIGATÓRIO

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

OBRIGATÓRIO

Fuso horário dos horários mostrados no JSON. Por exemplo: GMT-3.
Parâmetros de resposta
id
string
Shipment ID do pedido.
type
string
Esse campo faz referência sobre a forma de como será entregue o 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 aparece na interface da aplicação de pedidos para o comprador.
createdAt
string
Hora de criação do pedido.
Erros

401Erro

401

Unauthorized - Access Token is invalid

403Erro

403

Forbidden - User cannot access this resource

404Erro

404

Not Found - Failed to search shipment

424Erro

424

Not Found - Failed to get some information of the order

500Erro

500

Internal server error

Requisição
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*********' \
    
Resposta de exemplo
{
  "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
      }
    ]
  }
}