GET /orders/{id} para obter os dados completos necessários para processamento:curl -X GET "https://merchant-api.ifood.com.br/order/v1.0/orders/{id}" \
-H "Authorization: Bearer {token}"200 OK com estrutura completa: informações gerais, loja, cliente, itens, complementos, cupons, taxas, total, pagamento, separação, entrega, retirada, consumo local e agendamento.| Campo | Tipo | Descrição |
|---|---|---|
id | uuid | Identificador único |
displayId | string | ID amigável para exibição |
orderType | enum | DELIVERY, TAKEOUT, DINE_IN |
orderTiming | enum | IMMEDIATE ou SCHEDULED |
salesChannel | string | IFOOD, DIGITAL_CATALOG, POS, TOTEM, IFOOD_SHOP, GROCERY_WHITELABEL |
category | string | FOOD, GROCERY, ANOTAI, FOOD_SELF_SERVICE |
createdAt | date | Data/hora de criação |
preparationStartDateTime | date | Horário recomendado para início |
isTest | boolean | Pedido de teste |
extraInfo | string | Informações adicionais |
{
"id": "32c15e00-9861-4548-b5f0-15580defc999",
"displayId": "fc999",
"orderType": "DELIVERY / INDOOR / TAKEOUT / DINE_IN",
"orderTiming": "IMMEDIATE/SCHEDULED",
"salesChannel": "IFOOD / DIGITAL_CATALOG / POS / TOTEM / IFOOD_SHOP / GROCERY_WHITELABEL",
"category": "FOOD / GROCERY / ANOTAI / FOOD_SELF_SERVICE",
"createdAt": "2020-01-01T00:00:00.000Z",
"preparationStartDateTime": "2020-01-01T00:00:00.000Z",
"isTest": false,
"extraInfo": "Pago Online. NÃO LEVAR MÁQUINA",
...
}| Campo | Tipo | Descrição |
|---|---|---|
id | uuid | Identificador único da loja |
name | string | Nome da loja |
{
"merchant": {
"id": "50647eee-5eb6-41a2-b2d8-999998ed677f",
"name": "Nome da Loja"
}
}| Campo | Tipo | Descrição |
|---|---|---|
id | uuid | Identificador único do cliente |
name | string | Nome do cliente |
documentNumber | string | Número do documento do cliente. Opcional; use apenas para NF. |
documentType | string | Tipo: CPF ou idEstrangeiro (a partir de 15/03/2026) |
ordersCountOnMerchant | integer | Pedidos anteriores nesta loja (últimos 5 anos, opcional) |
phone.number | string | Telefone do cliente ou 0800 iFood |
phone.localizer | string | Código para contactar via 0800 |
phone.localizerExpiration | date | Expiração do localizador |
segmentation | string | Super-Segmentação: Explorer, Bronze, Silver, Gold, Platinum (opcional) |
{
"customer": {
"id": "50647eee-5eb6-41a2-b2d8-999998ed677f",
"name": "Nome do Cliente",
"documentNumber": "07544829999",
"documentType": "CPF",
"ordersCountOnMerchant": 8,
"phone": {
"number": "0800 XXX XXXX",
"localizer": "27534642",
"localizerExpiration": "2020-01-01T00:00:00.000Z"
},
"segmentation": "Platinum"
}
}phone é opcional
O campo phone é opcional e deixa de ser enviado 3 horas após a data de entrega do pedido. Mesmo durante esse período, alguns pedidos podem não incluir o telefone. Para contatar o cliente, utilize o chat.| Campo | Tipo | Descrição |
|---|---|---|
index | integer | Posição/ordem do item |
id | uuid | ID único no catálogo |
uniqueId | uuid | ID único no pedido (pode repetir no pedido) |
imageUrl | string | URL da imagem (qualidade high por padrão — customize com low, medium) |
externalCode | string | Código PDV (opcional) |
ean | string | Código de barras |
name | string | Nome do item |
type | string | Tipo/categoria |
quantity | double | Quantidade |
unit | string | Unidade: UN, g, kg, ml, L |
unitPrice | double | Preço unitário |
price | double | Preço = quantidade × (preço unitário + adição) |
scalePrices | object | Quantidades e preços atacado |
optionsPrice | double | Preço dos complementos |
customizationPrice | double | Preço das customizações |
totalPrice | double | Preço total (item + complementos) |
observations | string | Observações (máx 1024 caracteres) |
options | object | Lista de complementos |
t_<qualidade> na URL:low — Baixa qualidade. Ideal para visualizações rápidas ou quando a largura de banda é uma preocupação.medium — Equilíbrio entre qualidade e tamanho de arquivo.high — Melhor qualidade disponível. Recomendada para detalhes precisos.https://static-images.ifood.com.br/image/upload/t_low/pratos/4c714577-fe5d-4d31-9531-f9ebb7f89249/202104071957_0mfD_.jpeghttps://static-images.ifood.com.br/image/upload/t_medium/pratos/4c714577-fe5d-4d31-9531-f9ebb7f89249/202104071957_0mfD_.jpeghttps://static-images.ifood.com.br/image/upload/t_high/pratos/4c714577-fe5d-4d31-9531-f9ebb7f89249/202104071957_0mfD_.jpeg{
"items": [
{
"index": 1,
"id": "1bd9cbac-a4a6-497e-953d-e6d0661180d5",
"uniqueId": "092ce140-b809-4a13-b776-31d9792eee99",
"name": "Nome do Produto",
"type": "Tipo do Produto",
"imageUrl": "https://static-images.ifood.com.br/image/upload/t_high/pratos/4c714577-fe5d-4d31-9531-f9ebb7f89249/202104071957_0mfD_.jpeg",
"externalCode": "2331",
"ean": "7898903529999",
"quantity": 2,
"unit": "UN/G/KG/L/ML",
"unitPrice": 10,
"price": 20,
"scalePrices": {
...
},
"optionsPrice": 4,
"customizationPrice": 3,
"totalPrice": 24,
"observations": "Retirar cebola",
"options": [
...
]
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
index | integer | Posição/ordem |
id | uuid | ID único do complemento |
name | string | Nome |
groupName | string | Grupo |
type | string | Tipo |
externalCode | string | Código PDV (opcional) |
quantity | double | Quantidade |
unit | string | Unidade: UN, g, kg, ml, L |
unitPrice | double | Preço unitário |
addition | double | Valor adicional (ex: diferença em pizza multi-sabor) |
price | double | Preço = quantidade × (unitário + adição) |
customization | array | Customizações (terceiro nível) |
{
"options": [
{
"index": 1,
"id": "3dc09021-be6b-4be6-92a1-15a07b464141",
"name": "Nome do Complemento",
"groupName": "Nome Grupo do Complemento",
"type": "Tipo do Complemento",
"externalCode": "ABC123",
"quantity": 2,
"unit": "UN/G/KG/L/ML",
"unitPrice": 2,
"addition": 1,
"price": 6,
"customization": [
...
]
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
id | uuid | ID único |
name | string | Nome |
groupName | string | Grupo |
externalCode | string | Código PDV (opcional) |
type | string | Tipo |
quantity | integer | Quantidade |
unitPrice | double | Preço unitário |
addition | double | Valor adicional (ex: diferença em pizza multi-sabor) |
price | double | Preço = quantidade × (unitário + adição) |
{
"customizations": [
{
"id": "acea6ac1-f595-4a6b-af00-cc2f1fa0886a",
"groupName": "Example GroupName",
"externalCode": "ABC123",
"type": "Example Type",
"name": "Example name",
"quantity": 2,
"unitPrice": 2,
"addition": 1,
"price": 6
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
defaultPrice | double | Preço padrão sem alteração |
scales | array | Quantidades e preços para venda em atacado |
{
"scalePrices": {
"defaultPrice": 20,
"scales": [
...
]
}
}| Campo | Tipo | Descrição |
|---|---|---|
price | double | Preço com desconto atacado |
minQuantity | integer | Quantidade mínima para aplicar |
{
"scales": [
{
"price": 15,
"minQuantity": 5
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
value | double | Valor do desconto/incentivo |
target | string | Onde o desconto é aplicado |
targetId | string | Índice do item (items.index) ao qual o desconto se aplica. Apenas para target do tipo ITEM ou PROGRESSIVE_DISCOUNT_ITEM |
sponsorshipValues.name | string | Nome do patrocinador do benefício |
sponsorshipValues.value | double | Valor subsidiado pelo patrocinador |
sponsorshipValues.description | double | Descrição do patrocinador para exibição no app ou comanda impressa |
campaign.id | uuid | ID único da campanha |
campaign.name | string | Nome da campanha |
campaign.description | string | Descrição da campanha |
| target | Descrição |
|---|---|
CART | Desconto aplicado sobre o subtotal do carrinho (somatório dos itens). |
DELIVERY_FEE | Desconto aplicado sobre a taxa de entrega. |
ITEM | Desconto aplicado sobre um item específico. O campo targetId indica qual item recebeu o desconto. |
PROGRESSIVE_DISCOUNT_ITEM | Desconto progressivo em itens iguais do pedido, formando um combo. |
| sponsorship | Tratamento |
|---|---|
IFOOD | Trate o valor do cupom como pagamento — o iFood repassa esse valor para a loja. |
EXTERNAL | Trate o valor do cupom como pagamento — o iFood repassa o valor subsidiado pelo parceiro externo para a loja. |
MERCHANT | Trate o valor do cupom como desconto — o subsídio é de responsabilidade do merchant (loja). |
CHAIN | Trate o valor do cupom como pagamento — o subsídio é responsabilidade da rede (grupo de lojas), e o iFood realiza a cobrança ao parceiro na conciliação. |
{
"benefits": [
{
"value": 10,
"target": "CART",
"sponsorshipValues": [
{
"name": "IFOOD",
"value": 0,
"description": "Incentivo do iFood"
},
{
"name": "MERCHANT",
"value": 10,
"description": "Incentivo da Loja"
}
],
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name",
"description": "my campaign description"
}
},
{
"value": 4.99,
"target": "DELIVERY_FEE",
"sponsorshipValues": [
{
"name": "EXTERNAL",
"value": 4.99,
"description": "Incentivo da Indústria"
},
{
"name": "MERCHANT",
"value": 0,
"description": "Incentivo da Loja"
}
],
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name"
}
},
{
"value": 4.99,
"target": "ITEM",
"targetId": "1",
"sponsorshipValues": [
{
"name": "IFOOD",
"value": 4.99,
"description": "Incentivo do iFood"
},
{
"name": "MERCHANT",
"value": 0,
"description": "Incentivo da Loja"
}
],
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name"
}
}
]
}liabilities.name identifica o responsável pelo pagamento.| Campo | Tipo | Descrição |
|---|---|---|
type | string | Tipo de taxa (novos tipos podem ser adicionados — trate como string) |
description | string | Descrição da taxa para exibição no app ou comanda impressa |
fullDescription | string | Descrição completa da taxa |
value | double | Valor da taxa |
liabilities | array | Responsáveis pela taxa e respectivas porcentagens |
liabilities.name | string | Responsável por pagar a taxa |
liabilities.percentage | double | Porcentagem que o responsável deve pagar |
{
"additionalFees": [
{
"type": "SMALL_ORDER_FEE",
"description": "Taxa de Serviço",
"fullDescription": "Taxa de serviço cobrada quando o valor do pedido é inferior ao pedido mínimo.",
"value": 1.0,
"liabilities": [
{
"name": "IFOOD",
"percentage": 100
}
]
}
]
}| type | Descrição |
|---|---|
SMALL_ORDER_FEE | Taxa de serviço para pedidos abaixo do valor mínimo |
| Campo | Tipo | Descrição |
|---|---|---|
subTotal | double | Somatório do valor dos itens |
deliveryFee | double | Valor da taxa de entrega |
benefits | double | Somatório dos benefits (cupons de desconto) |
additionalFees | double | Somatório das taxas adicionais |
orderAmount | double | Valor total do pedido (orderAmount = subTotal + deliveryFee + additionalFees - benefits) |
{
"total": {
"subTotal": 50,
"deliveryFee": 10,
"additionalFees": 2,
"benefits": 5,
"orderAmount": 57
}
}| Campo | Tipo | Descrição |
|---|---|---|
prepaid | double | Valor já pago (ONLINE) |
pending | double | Valor pendente a cobrar na entrega (OFFLINE) |
methods.value | double | Valor do pagamento |
methods.currency | string | Moeda |
methods.type | string | Tipo: ONLINE (pagamento já feito pelo app — não cobrar na entrega) ou OFFLINE (cobrar no ato da entrega) |
methods.method | string | Método: CASH, CREDIT, DEBIT, MEAL_VOUCHER, FOOD_VOUCHER, GIFT_CARD, DIGITAL_WALLET, PIX, OTHER |
methods.wallet.name | string | Nome da carteira digital (apenas para DIGITAL_WALLET) |
methods.card.brand | string | Bandeira do cartão |
methods.cash.changeFor | double | Valor do troco |
methods.transaction.authorizationCode | string | Código de autorização da operação de cartão (campo cAut da NFe) |
methods.transaction.acquirerDocument | string | CNPJ do intermediador da transação (marketplace, plataforma de delivery) |
{
"payments": {
"prepaid": 20,
"pending": 45,
"methods": [
{
"value": 10,
"currency": "BRL",
"type": "ONLINE",
"method": "CREDIT / DEBIT / MEAL_VOUCHER / FOOD_VOUCHER",
"card": {
"brand": "Nome da Bandeira"
},
"transaction": {
"authorizationCode": "6982354",
"acquirerDocument": "12345678901234"
}
},
{
"value": 10,
"currency": "BRL",
"type": "ONLINE",
"method": "DIGITAL_WALLET",
"wallet": {
"name": "APPLE_PAY/GOOGLE_PAY/SAMSUNG_PAY"
},
"card": {
"brand": "Nome da Bandeira"
}
},
{
"value": 0.01,
"currency": "BRL",
"method": "PIX",
"type": "ONLINE",
"card": {
"brand": "PIX"
}
},
{
"value": 45,
"currency": "BRL",
"type": "OFFLINE",
"method": "CASH ",
"cash": {
"changeFor": 50
}
}
]
}
}| Campo | Tipo | Descrição |
|---|---|---|
picker | string | Responsável pela separação dos itens (ex: DRIVER_SHOPPER). Quando ausente, o próprio merchant separa e prepara o pedido. |
replacementOptions | string | Opções para substituir um item em ruptura: STORE_CHOOSE_OTHER_ITEMS, STORE_CONTACT_CUSTOMER, STORE_CANCEL_ORDER, STORE_REMOVE_ITEMS |
{
"picking": {
"picker": "DRIVER_SHOPPER",
"replacementOptions": "STORE_CHOOSE_OTHER_ITEMS / STORE_CONTACT_CUSTOMER / STORE_CANCEL_ORDER / STORE_REMOVE_ITEMS"
}
}| Campo | Tipo | Descrição |
|---|---|---|
mode | string | Códigos para controles internos do iFood (novos códigos podem ser adicionados). Valores: DEFAULT, EXPRESS, HIGH_DENSITY, TURBO, PRIORITY, FAST_DELIVERY, ECONOMIC |
description | string | Tipo de entrega solicitado pelo cliente: Padrão, Rápida, Turbo. Padrão: Entrega padrão do iFood; Rápida: 20% mais rápida que a Padrão, com custo variável. Sem exigência de preparo antecipado. Turbo: Entrega em até 20 minutos, com custo fixo. Requer preparo em até 7 minutos. |
deliveredBy | string | Responsável pela entrega: IFOOD (logística iFood) ou MERCHANT (entrega própria) |
pickupCode | string | Código de segurança para conferir com o entregador na coleta do pedido |
deliveryDateTime | date | Data e horário da entrega |
observations | string | Observações sobre a entrega |
deliveryAddress | -- | Endereço de entrega do pedido |
{
"delivery": {
"mode": "DEFAULT / EXPRESS / HIGH_DENSITY / TURBO / PRIORITY / FAST_DELIVERY / ECONOMIC",
"description": "Padrão / Rápida / Turbo",
"deliveredBy": "IFOOD / MERCHANT",
"deliveryDateTime": "2020-01-01T00:00:00.000Z",
"observations": "Deixar na portaria",
"deliveryAddress": {...},
"pickupCode": "1234"
}
}| Campo | Tipo | Descrição |
|---|---|---|
streetName | string | Nome da rua ou avenida |
streetNumber | string | Número (pode conter letras) |
formattedAddress | string | Endereço formatado (rua + número) |
neighborhood | string | Bairro ou setor |
complement | string | Complemento (ex: apartamento, quadra, lote) |
reference | string | Ponto de referência |
postalCode | string | Código postal (CEP). Opcional — pode ser enviado zerado |
city | string | Cidade |
state | string | Estado |
country | string | País |
coordinates.latitude | double | Latitude |
coordinates.longitude | double | Longitude |
{
"deliveryAddress": {
"streetName": "RUA X",
"streetNumber": "20A",
"formattedAddress": "RUA X, 20A",
"neighborhood": "Bairro / Setor",
"complement": "Apto 101",
"reference": "perto da praça",
"postalCode": "99999999",
"city": "SAO PAULO",
"state": "SP",
"country": "BR",
"coordinates": {
"latitude": -26.999999,
"longitude": -48.999999
}
}
}| Campo | Tipo | Descrição |
|---|---|---|
mode | string | Modo de retirada: DEFAULT (cliente retira no balcão) ou PICKUP_AREA (cliente espera em vaga especial do estacionamento) |
takeoutDateTime | date | Data e hora da retirada |
observations | string | Observações sobre a retirada |
{
"takeout": {
"mode": "DEFAULT / PICKUP_AREA:",
"takeoutDateTime": "2020-01-01T00:00:00.000Z",
"observations": "Observações sobre a retirada"
}
}| Campo | Tipo | Descrição |
|---|---|---|
deliveryDateTime | date | Data e hora da entrega ou retirada |
{
"dineIn": {
"deliveryDateTime": "2024-09-17T00:00:00.000Z"
}
}| Campo | Tipo | Descrição |
|---|---|---|
mode | string | Modo de retirada: DEFAULT (cliente retira no balcão) ou TABLE (cliente espera na mesa) |
table | string | Número ou código da mesa (apenas quando mode = TABLE) |
deliveryDateTime | date | Data e hora da entrega ou retirada |
observations | string | Observações sobre a retirada |
{
"indoor": {
"mode": "DEFAULT / TABLE:",
"table": "01",
"deliveryDateTime": "2020-01-01T00:00:00.000Z",
"observations": "Observações sobre a entrega ou retirada"
}
}| Campo | Tipo | Descrição |
|---|---|---|
schedule.deliveryDateTimeStart | date | Início do intervalo agendado |
schedule.deliveryDateTimeEnd | date | Fim do intervalo agendado |
{
"schedule": {
"deliveryDateTimeStart": "2020-01-01T00:20:00.000Z",
"deliveryDateTimeEnd": "2020-01-01T01:20:00.000Z"
}
}| Campo | Tipo | Descrição |
|---|---|---|
metadata | map<string,string> | Campo chave-valor que permite ao merchant incluir informações de interesse próprio no pedido |
salesChannel=POS){
"additionalInfo": {
"metadata": {
"codigoInternoPdv": "18bf73f64715",
"nomeVendedor": "João"
}
}
}{
"id": "63895716-37c3-4372-afd0-3240bfef708d",
"orderTiming": "IMMEDIATE",
"orderType": "DELIVERY",
"salesChannel": "IFOOD",
"category": "FOOD",
"delivery": {
"mode": "DEFAULT",
"description": "Padrão",
"deliveredBy": "IFOOD",
"deliveryDateTime": "2021-02-09T18:10:32Z",
"deliveryAddress": {
"streetName": "Example",
"streetNumber": "1234",
"formattedAddress": "Example St., 1234, Apt. 1234",
"neighborhood": "Examplehood",
"complement": "Apt. 1234",
"reference": "perto da praça",
"postalCode": "12345678",
"city": "Example City",
"state": "Example State",
"country": "BR",
"coordinates": {
"latitude": -2.1059418202311173e141,
"longitude": -49545.71
}
},
"pickupCode": "1234"
},
"displayId": "XPTO",
"createdAt": "2021-02-16T18:10:27Z",
"preparationStartDateTime": "2021-02-09T20:15:13Z",
"merchant": {
"id": "c54bb20a-bce0-4e38-bd4a-fe5f0a7b6b5a",
"name": "Example Merchant"
},
"customer": {
"id": "22587f70-60b4-423c-8cd2-27d288f47f99",
"name": "Example Customer",
"documentNumber": "123456789",
"phone": {
"number": "123456789",
"localizer": "12345678",
"localizerExpiration": "2021-02-09T18:11:07Z"
},
"ordersCountOnMerchant": 1234,
"segmentation": "Gold"
},
"items": [
{
"index": 0,
"id": "f1e48636-4bf0-4656-bce8-0e2214fcd3d4",
"uniqueId": "092ce140-b809-4a13-b776-31d9792eee99",
"name": "Example Item",
"imageUrl": "https://static-images.ifood.com.br/image/upload/t_high/pratos/4c714577-fe5d-4d31-9531-f9ebb7f89249/202104071957_0mfD_.jpeg",
"externalCode": "ex01",
"ean": "12345678910",
"unit": "G",
"quantity": 12,
"unitPrice": 0.12,
"price": 1.44,
"optionsPrice": 1.69,
"totalPrice": 3.13,
"observations": "This is an example item.",
"options": [
{
"index": 0,
"id": "acea6ac1-f595-4a6b-af00-cc2f1fa0886a",
"name": "Example Option",
"externalCode": "ex02",
"ean": "12345678911",
"unit": "UN",
"quantity": 13,
"unitPrice": 0.13,
"addition": 0,
"price": 1.69
}
]
}
],
"benefits": [
{
"value": 1.0,
"sponsorshipValues": [
{
"name": "IFOOD",
"value": 0.5
},
{
"name": "MERCHANT",
"value": 0.5
}
],
"target": "CART",
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name"
}
},
{
"value": 0.5,
"sponsorshipValues": [
{
"name": "IFOOD",
"value": 0.5
},
{
"name": "MERCHANT",
"value": 0
}
],
"target": "ITEM",
"targetId": "1",
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name"
}
},
{
"value": 0.49,
"sponsorshipValues": [
{
"name": "IFOOD",
"value": 0
},
{
"name": "MERCHANT",
"value": 0.49
}
],
"target": "DELIVERY_FEE",
"campaign": {
"id": "42cea1aa-1e23-4741-b48a-300716de08de",
"name": "my campaign name"
}
}
],
"additionalFees": [
{
"type": "SMALL_ORDER_FEE",
"value": 1.0
}
],
"total": {
"subTotal": 3.13,
"deliveryFee": 5.99,
"additionalFees": 1,
"benefits": 1.99,
"orderAmount": 8.13
},
"payments": {
"prepaid": 2.13,
"pending": 5,
"methods": [
{
"value": 5,
"currency": "BRL",
"method": "CASH",
"type": "OFFLINE",
"prepaid": false
},
{
"value": 2.13,
"currency": "BRL",
"method": "CREDIT",
"type": "ONLINE",
"prepaid": true,
"card": {
"brand": "VISA"
},
"transaction": {
"authorizationCode": "6982354",
"acquirerDocument": "12345678901234"
}
}
]
},
"picking": {
"picker": "DRIVER_SHOPPER",
"replacementOptions": "STORE_REMOVE_ITEMS"
},
"test": false,
"additionalInfo": {
"metadata": {
"codigoInternoPdv": "18bf73f64715",
"nomeVendedor": "João"
}
}
}