Buscar na documentação

Módulos

Authentication

Merchant

Catalog

Order

Events

Logistics

Shipping

Review

Financial

Soluções

Operações

Operações definem como sua loja atende pedidos. Configure operações diferentes para delivery, retirada ou consumo no local, cada uma com seus próprios horários, catálogos e regras.

Tipos de operação

Operação	Descrição	Disponibilidade
`DELIVERY`	Entrega no endereço do cliente	Disponível
`TAKEOUT`	Retirada pelo cliente na loja	Disponível
`INDOOR`	Consumo no local	(Em breve)

Recomendação: Use DELIVERY para entregas residenciais e TAKEOUT para retiradas na loja.

Operação vs. Tipo de pedidoOperação é a configuração da loja (como ela atende). Tipo de pedido é como cada pedido individual será processado. Uma loja com operação DELIVERY pode receber pedidos com diferentes tipos de entrega (própria, iFood, agendada).Veja mais em Tipos de pedido.

Canais de aquisição

Canais são as interfaces onde clientes fazem pedidos. Cada operação pode receber pedidos de múltiplos canais.

Canal	Descrição
`MARKETPLACE`	App e site do iFood
`WHATSAPP`	Pedidos via WhatsApp Business
`DIGITAL_CATALOG`	Cardápio digital próprio da loja
`TOTEM`	Terminais de autoatendimento na loja

Cada canal pode ter horários e configurações independentes dentro de uma mesma operação.

Combinando operações e canais

Uma operação pode aceitar pedidos de vários canais. Configure cada combinação de forma independente:

Operação	Canal	Exemplo de configuração
`DELIVERY`	`MARKETPLACE`	Entregas via app iFood, horário comercial
`DELIVERY`	`WHATSAPP`	Entregas via WhatsApp, horário estendido
`TAKEOUT`	`DIGITAL_CATALOG`	Retirada com cardápio próprio
`TAKEOUT`	`TOTEM`	Retirada via autoatendimento

Exemplo: Uma loja pode ter DELIVERY via MARKETPLACE de 11h-23h, mas via WHATSAPP de 8h-23h.

Configurações por operação

Cada combinação operação + canal permite configurações independentes:

Configuração	Descrição
Horário de funcionamento	Defina horários diferentes para cada operação
Catálogo	Use cardápios distintos (ex: menu reduzido para delivery)
Área de entrega	Configure raios diferentes por canal (apenas `DELIVERY`)
Tempo de preparo	Ajuste estimativas conforme a operação

Exemplo: configuração flexível

Uma pizzaria pode configurar:

Operação	Canal	Horário	Catálogo
`DELIVERY`	`MARKETPLACE`	18h - 23h	Menu completo
`TAKEOUT`	`DIGITAL_CATALOG`	11h - 23h	Menu completo
`TAKEOUT`	`TOTEM`	11h - 15h	Menu almoço

Esta configuração permite maior flexibilidade:

Delivery apenas no período noturno via MARKETPLACE
Takeout disponível o dia todo
Menu reduzido ao meio-dia via TOTEM (autoatendimento)

Recuperar operações

Para consultar as operações configuradas de uma loja, use:

curl --location 'https://merchant-api.ifood.com.br/merchant/v1.0/merchants/550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer TOKEN'

Endpoint: GET /merchants/{merchantId}Response 200:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Pizzaria Central",
  "corporateName": "Pizzaria Central LTDA",
  "description": "Pizzaria especializada em pizza napoletana",
  "averageTicket": 85.50,
  "exclusive": false,
  "type": "RESTAURANT",
  "status": "AVAILABLE",
  "createdAt": "2024-01-15T10:30:00",
  "operations": [
    {
      "name": "DELIVERY",
      "salesChannels": [
        {
          "name": "MARKETPLACE",
          "enabled": true
        },
        {
          "name": "WHATSAPP",
          "enabled": false
        }
      ]
    },
    {
      "name": "TAKEOUT",
      "salesChannels": [
        {
          "name": "DIGITAL_CATALOG",
          "enabled": true
        }
      ]
    }
  ]
}

Estrutura de resposta:

Campo	Tipo	Descrição
`operations[]`	array	Lista de operações
`operations[].name`	string	Nome da operação
`operations[].salesChannels`	array	Canais ativos
`operations[].salesChannels[].name`	string	Nome do canal
`operations[].salesChannels[].enabled`	boolean	Status de habilitação

Status de operações

Para verificar o estado de uma operação específica, use a API de Status:

curl --location 'https://merchant-api.ifood.com.br/merchant/v1.0/merchants/550e8400-e29b-41d4-a716-446655440000/status/DELIVERY' \
  --header 'Authorization: Bearer TOKEN'

Endpoint: GET /merchants/{merchantId}/status/{operation}Response 200:

[
  {
    "operation": "DELIVERY",
    "salesChannel": "MARKETPLACE",
    "available": true,
    "state": "OK",
    "validations": [
      {
        "id": "val-001",
        "code": "is-connected",
        "state": "OK",
        "message": {
          "title": "Conectado",
          "subtitle": "Loja está respondendo",
          "description": "Polling recebido nos últimos 30 segundos"
        }
      },
      {
        "id": "val-002",
        "code": "opening-hours",
        "state": "OK",
        "message": {
          "title": "Horário válido",
          "subtitle": "Dentro do horário de funcionamento",
          "description": "Loja está dentro do horário configurado"
        }
      }
    ],
    "message": {
      "title": "Operação Online",
      "subtitle": "Pronta para receber pedidos",
      "description": "Todas as validações passaram com sucesso"
    }
  }
]

Validações por tipo de operação

`DELIVERY`

Validações principais:

is-connected — Polling nos últimos 30s
opening-hours — Dentro do horário
catalog-enabled — Catálogo habilitado
delivery-area — Zona configurada
unavailabilities — Sem interrupções

Restrições:

Zona de entrega obrigatória
Catálogo habilitado
Polling a cada 30s

`TAKEOUT`

Validações principais:

is-connected — Polling nos últimos 30s
opening-hours — Dentro do horário
catalog-enabled — Catálogo habilitado
unavailabilities — Sem interrupções

Restrições:

Catálogo habilitado
Zona de entrega não obrigatória
Polling a cada 30s

`INDOOR`

Status: Em breve

Estados possíveis de uma operação

Estado	Significado
`OK`	Operação online e pronta para receber pedidos
`WARNING`	Online com restrições (verificar validações)
`CLOSED`	Fechada conforme esperado (fora de horário)
`ERROR`	Problema detectado (verificar validações)
`UNAVAILABLE`	Operação não configurada ou desabilitada