API Documentation - Aiqbridge

API de Integracao

O Aiqbridge traduz a API do Aiqfome para os formatos iFood e Open Delivery. Se voce ja integra com uma dessas plataformas, basta apontar para nossos endpoints — sem reescrever seu sistema.

Quick Start

Dois passos para comecar a receber pedidos.

Adicione uma loja e gere seu token

Acesse o painel do Aiqbridge, crie sua conta, adicione a loja que deseja integrar e gere o token JWT.

Faca sua primeira chamada

Envie o token no header Authorization: Bearer <token> e chame qualquer endpoint.

Autenticacao

Cada loja possui seu proprio token JWT, gerado no painel do Aiqbridge. Envie o token no header Authorization de todas as requisicoes:

Authorization: Bearer SEU_TOKEN_JWT

iFood

Open Delivery

Pedidos

Gerencie o ciclo de vida dos pedidos: consulte, confirme, prepare, despache e entregue.

GET /ifood/order/v1.0/orders/{orderId} Detalhes do pedido ▶

Retorna o pedido completo no formato iFood (itens, pagamento, endereco).

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123"

Response 200

{
  "id": "132095063",
  "displayId": "132095063",
  "createdAt": "2026-02-12T18:18:42-03:00",
  "preparationStartDateTime": "2026-02-12T18:19:21-03:00",
  "orderType": "DELIVERY",
  "orderTiming": "IMMEDIATE",
  "salesChannel": "AIQFOME",
  "merchant": { "id": "40529", "name": "Pizzaria Exemplo" },
  "customer": {
    "id": "52d2c97b-3d89-4996-9386-003482f8b017",
    "name": "Joao Silva",
    "documentNumber": "",
    "phone": { "number": "44999990000", "localizer": null, "localizerExpiration": null },
    "ordersCountOnMerchant": 3,
    "segmentation": "Cliente"
  },
  "items": [
    {
      "id": "225469144",
      "name": "X-Burger",
      "externalCode": "",
      "unit": "UN",
      "index": 1,
      "unitPrice": 2500,
      "quantity": 1,
      "price": 2500,
      "totalPrice": 2500,
      "optionsPrice": 0,
      "observations": "",
      "imageUrl": "",
      "options": []
    }
  ],
  "total": {
    "subTotal": 2500,
    "deliveryFee": 500,
    "benefits": 0,
    "orderAmount": 3000,
    "additionalFees": 0
  },
  "payments": {
    "prepaid": 0,
    "pending": 3000,
    "methods": [
      { "method": "PIX", "type": "ONLINE", "currency": "BRL", "value": 3000, "prepaid": false }
    ]
  },
  "benefits": [],
  "additionalFees": [],
  "delivery": {
    "mode": "DEFAULT",
    "deliveryAddress": {
      "streetName": "Rua Exemplo",
      "streetNumber": "123",
      "neighborhood": "Centro",
      "complement": "Apto 4",
      "city": "Maringa",
      "state": "PR",
      "postalCode": "87000-000",
      "coordinates": { "latitude": -23.4205, "longitude": -51.9333 }
    },
    "deliveryDateTime": "2026-02-12T18:58:42-03:00"
  },
  "takeout": null,
  "extraInfo": "Sem cebola"
}

POST /ifood/order/v1.0/orders/{orderId}/confirm Confirmar pedido ▶

Aceita o pedido. Equivale a clicar em "Aceitar" no painel.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/confirm"

Response: 202 Accepted

POST /ifood/order/v1.0/orders/{orderId}/startPreparation Iniciar preparo ▶

Sinaliza que o pedido comecou a ser preparado.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/startPreparation"

Response: 202 Accepted

POST /ifood/order/v1.0/orders/{orderId}/readyToPickup Pronto para retirada ▶

Marca o pedido como pronto para retirada pelo entregador ou cliente.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/readyToPickup"

Response: 202 Accepted

POST /ifood/order/v1.0/orders/{orderId}/dispatch Despachar pedido ▶

Informa que o pedido saiu para entrega.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/dispatch"

Response: 202 Accepted

POST /ifood/order/v1.0/orders/{orderId}/delivered Marcar como entregue ▶

Confirma que o pedido foi entregue ao cliente.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/delivered"

Response: 202 Accepted

POST /ifood/order/v1.0/orders/{orderId}/cancel Cancelar pedido ▶

Cancela o pedido. Opcionalmente envie um motivo no body.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Cliente desistiu"}' \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/orders/abc-123/cancel"

Response: 202 Accepted

Catalogo

Gerencie o cardapio: catalogos, categorias, itens, precos e disponibilidade.

GET /ifood/catalog/v1.0/merchants/{merchantId}/catalogs Listar catalogos ▶

Retorna os catalogos do merchant. Cada merchant possui um catalogo principal.

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/catalogs"

GET /ifood/catalog/v1.0/merchants/{merchantId}/catalogs/{catalogId} Detalhes do catalogo ▶

Retorna o catalogo com todas as categorias e itens.

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/catalogs/default"

GET .../{catalogId}/categories Listar categorias ▶

Retorna as categorias. Use ?include_items=true para incluir itens.

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/catalogs/default/categories?include_items=true"

PUT /ifood/catalog/v1.0/merchants/{merchantId}/items Criar ou atualizar item ▶

Cria ou atualiza um produto. Se o externalCode ja existir, atualiza.

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"externalCode":"item-100","name":"X-Tudo","description":"Hamburguer completo","price":{"value":32.90}}' \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/items"

PATCH /ifood/catalog/v1.0/merchants/{merchantId}/items/price Atualizar preco ▶

Altera o preco de um item.

curl -X PATCH -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"item-100","price":{"value":29.90}}' \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/items/price"

PATCH /ifood/catalog/v1.0/merchants/{merchantId}/items/externalCode Atualizar externalCode (SKU) ▶

Altera o externalCode (SKU) de um item. O itemId e o UUID do item no Aiqfome.

curl -X PATCH -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"d94896a9-8240-4a8f-9407-d2c6bd745153","externalCode":"MEU-SKU-001"}' \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/items/externalCode"

PATCH /ifood/catalog/v1.0/merchants/{merchantId}/items/status Atualizar disponibilidade ▶

Altera o status (AVAILABLE / UNAVAILABLE) de um ou mais itens.

curl -X PATCH -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"UNAVAILABLE","items":["item-100","item-101"]}' \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/items/status"

DELETE /ifood/catalog/v1.0/merchants/{merchantId}/items/{itemId} Remover item ▶

Remove um item do cardapio permanentemente.

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/catalog/v1.0/merchants/m-456/items/item-100"

Response: 204 No Content

Loja (Merchant)

Gerencie o status, horarios, taxas de entrega, bairros e metodos de pagamento da loja.

Endpoints exclusivos do Aiqbridge

Estes endpoints nao existem na API real do iFood. Sao funcionalidades do Aiqfome expostas pelo bridge em formato camelCase, com campos internos removidos e precos convertidos para centavos (inteiro). IDs de lojas sao numericos do Aiqfome (nao UUIDs). Endpoints como /neighborhoods, /delivery-fees e /payment-methods sao especificos do Aiqfome.

GET /ifood/merchant/v1.0/merchant Info da loja ▶

Retorna informacoes da loja (nome, status, endereco, etc.).

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant"

Response 200

Dados da loja mapeados para formato iFood (camelCase, campos internos removidos).

{
  "id": "53191",
  "name": "Pizzaria Exemplo",
  "corporateName": "Pizzaria Exemplo LTDA",
  "preparationTime": 40,
  "deliveryTime": "40 - 60",
  "isDeliveryRadiusActive": false,
  "cityId": 4006,
  "ratings": {
    "average": 4.5,
    "count": 128,
    "details": { "quality": 4.3, "delivery": 4.6, "accuracy": 4.5 }
  },
  "workingHours": [
    { "weekDayNumber": 1, "hours": "08:00 - 22:00", "status": 1 }
  ]
}

POST /ifood/merchant/v1.0/merchant/status Alterar status ▶

Abre, fecha ou coloca a loja em standby.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"operation":"CLOSE"}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/status"

Valores: OPEN, CLOSE, STANDBY

Response 200

{
  "store_id": 53191,
  "status": "CLOSED"
}

GET /ifood/merchant/v1.0/merchant/hours Horarios ▶

Retorna os horarios de funcionamento configurados.

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/hours"

Response 200

[
  { "weekDayNumber": 1, "hours": "08:00 - 22:00", "status": 1 },
  { "weekDayNumber": 2, "hours": "08:00 - 22:00", "status": 1 }
]

PUT /ifood/merchant/v1.0/merchant/hours Atualizar horarios ▶

Atualiza os horarios de funcionamento.

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"working_hours":[{"weekday":1,"status":true,"hours":[{"open":"08:00","close":"22:00"}]}]}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/hours"

Response: 200 OK

PUT /ifood/merchant/v1.0/merchant/preparation-time Tempo de preparo ▶

Atualiza o tempo medio de preparo (10 a 60 minutos).

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"preparation_time":30}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/preparation-time"

Response 200

{
  "store_id": 53191,
  "preparation_time": 30
}

PUT /ifood/merchant/v1.0/merchant/delivery-time Tempo de entrega ▶

Atualiza o tempo estimado de entrega.

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"delivery_time":"30 - 50"}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/delivery-time"

Response 200

{
  "store_id": 53191,
  "delivery_time": "30 - 50"
}

GET /ifood/merchant/v1.0/merchant/delivery-fees Taxas de entrega ▶

Retorna as faixas de entrega por raio.

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/delivery-fees"

Response 200

{
  "store": { "id": "53191", "name": "Pizzaria Exemplo" },
  "city": { "id": 4006, "name": "Maringa" },
  "radius": [
    { "id": 229, "distanceKm": 3, "value": 500, "returnTaxValue": 0 },
    { "id": 230, "distanceKm": 5, "value": 800, "returnTaxValue": 0 }
  ]
}

POST /ifood/merchant/v1.0/merchant/delivery-fees Criar faixas ▶

Cria novas faixas de entrega por raio.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"radius":[{"distance_km":3.0,"value":5.00},{"distance_km":5.0,"value":8.00}]}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/delivery-fees"

Response: 200 OK

PUT /ifood/merchant/v1.0/merchant/delivery-fees Atualizar faixas ▶

Atualiza faixas de entrega existentes.

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"radius":[{"id":229,"distance_km":3,"value":6.00,"return_tax_value":1.00}]}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/delivery-fees"

Response 200

{
  "radius": [
    { "id": 229, "distance_km": 3, "value": 6.00, "return_tax_value": 1.00 }
  ]
}

DELETE /ifood/merchant/v1.0/merchant/delivery-fees/{id} Remover faixa ▶

Remove uma faixa de entrega especifica.

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/delivery-fees/123"

Response: 200 OK

GET /ifood/merchant/v1.0/merchant/neighborhoods Bairros atendidos ▶

Retorna os bairros e suas taxas de entrega.

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/neighborhoods"

Response 200

[
  { "id": 472, "name": "Centro", "deliveryTax": 450 },
  { "id": 6571, "name": "Zona 07", "deliveryTax": 700 }
]

POST /ifood/merchant/v1.0/merchant/neighborhoods Sincronizar bairros ▶

Sincroniza a lista de bairros atendidos com suas taxas.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"store_neighborhoods":[{"neighborhood_id":"123","delivery_tax":5.00}]}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/neighborhoods"

Response: 200 OK

GET /ifood/merchant/v1.0/merchant/payment-methods Metodos de pagamento ▶

Retorna os metodos de pagamento aceitos pela loja.

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/payment-methods"

Response 200

[
  { "id": 121, "name": "Visa Credito" },
  { "id": 163, "name": "Mastercard Credito" },
  { "id": 1, "name": "Dinheiro" }
]

POST /ifood/merchant/v1.0/merchant/payment-methods Configurar pagamentos ▶

Define quais metodos de pagamento a loja aceita.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"payment_methods_ids":[1,2,3]}' \
  "https://www.aiqbridge.com.br/ifood/merchant/v1.0/merchant/payment-methods"

Response: 200 OK

Webhooks

Receba eventos de pedidos em tempo real via push. Cada evento e assinado com HMAC-SHA256.

POST /ifood/order/v1.0/webhook/config Registrar webhook ▶

Registra ou atualiza a URL de webhook. Um secret_key e gerado automaticamente — guarde-o, ele so e retornado nesta chamada.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://meu-sistema.com/webhook"}' \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/webhook/config"

Response 200

{
  "merchant_id": "m-456",
  "webhook_url": "https://meu-sistema.com/webhook",
  "secret_key": "whsec_abc123...",
  "is_active": true,
  "event_types": null,
  "timeout_seconds": 30,
  "max_retries": 3
}

Payload recebido na sua URL

POST https://meu-sistema.com/webhook
X-Signature: sha256=a1b2c3d4...
Content-Type: application/json

{
  "event": "NEW_ORDER",
  "order_id": "abc-123",
  "merchant_id": "m-456",
  "timestamp": "2026-02-13T10:30:00Z"
}

Validacao HMAC

import hmac, hashlib

expected = "sha256=" + hmac.new(
    secret_key.encode(),
    body.encode(),
    hashlib.sha256
).hexdigest()

assert hmac.compare_digest(expected, request.headers["X-Signature"])

GET /ifood/order/v1.0/webhook/config Ver configuracao ▶

Retorna a configuracao atual do webhook (URL, status, filtros).

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/webhook/config"

DELETE /ifood/order/v1.0/webhook/config Remover webhook ▶

Remove a configuracao de webhook.

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/webhook/config"

Response: 204 No Content

PUT /ifood/order/v1.0/webhook/config/toggle Ativar/desativar ▶

Ativa ou desativa o envio sem remover a configuracao.

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/webhook/config/toggle?enabled=true"

POST /ifood/order/v1.0/webhook/config/test Evento de teste ▶

Dispara um evento WEBHOOK_TEST para validar conectividade.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/ifood/order/v1.0/webhook/config/test"

Pedidos

Endpoints compativeis com Open Delivery v1 para gestao de pedidos.

GET /od/v1/orders/{orderId} Detalhes do pedido ▶

Retorna o pedido completo no formato Open Delivery.

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063"

Response 200

{
  "id": "132095063",
  "type": "DELIVERY",
  "displayId": "132095063",
  "category": "FOOD",
  "createdAt": "2026-02-12T18:18:42-03:00",
  "lastEvent": "PLACED",
  "orderTiming": "INSTANT",
  "preparationStartDateTime": "2026-02-12T18:19:21-03:00",
  "merchant": { "id": "40529", "name": "Pizzaria Exemplo" },
  "items": [
    {
      "id": "0b50304b-8daf-5fe9-abca-361d1573bd60",
      "name": "X-Burger",
      "externalCode": "225469144",
      "unit": "UN",
      "quantity": 1,
      "unitPrice": { "value": 25.00, "currency": "BRL" },
      "totalPrice": { "value": 25.00, "currency": "BRL" },
      "options": []
    }
  ],
  "total": {
    "itemsPrice": { "value": 25.00, "currency": "BRL" },
    "otherFees": { "value": 0.00, "currency": "BRL" },
    "discount": { "value": 0.00, "currency": "BRL" },
    "orderAmount": { "value": 30.00, "currency": "BRL" }
  },
  "payments": {
    "prepaid": 0,
    "pending": 30.00,
    "methods": [
      { "method": "PIX", "type": "PENDING", "value": 30.00, "currency": "BRL" }
    ]
  },
  "customer": {
    "id": "b80473e2-94b5-5b06-b5e2-cea36714fc78",
    "name": "Joao Silva",
    "documentNumber": "",
    "phone": { "number": "(44) 9-9999-0000" },
    "ordersCountOnMerchant": 3
  },
  "sendPreparing": true,
  "sendDelivered": false,
  "sendPickedUp": true,
  "sendTracking": false,
  "extraInfo": "Sem cebola",
  "delivery": {
    "mode": "DEFAULT",
    "deliveryAddress": {
      "streetName": "Rua Exemplo",
      "streetNumber": "123",
      "neighborhood": "Centro",
      "city": "Maringa",
      "state": "PR",
      "postalCode": "87000-000"
    }
  },
  "takeout": null,
  "otherFees": [],
  "discounts": []
}

POST /od/v1/orders/{orderId}/confirm Confirmar pedido ▶

Aceita o pedido.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/abc-123/confirm"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/preparing Iniciar preparo ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/preparing"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/readyForPickup Pronto para retirada ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/readyForPickup"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/dispatch Despachar pedido ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/dispatch"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/pickedUp Retirado pelo entregador ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/pickedUp"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/delivered Marcar como entregue ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/delivered"

Response: 202 Accepted

POST /od/v1/orders/{orderId}/requestCancellation Cancelar pedido ▶

Opcionalmente envie um motivo no body.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Cliente desistiu"}' \
  "https://www.aiqbridge.com.br/od/v1/orders/132095063/requestCancellation"

Response: 202 Accepted

Loja (Merchant)

Gerencie o status, horarios, taxas de entrega, bairros e metodos de pagamento.

Endpoints exclusivos do Aiqbridge

Estes endpoints nao existem na API real do Open Delivery. Sao funcionalidades do Aiqfome expostas pelo bridge em formato camelCase, com campos internos removidos e precos como Price objects {"value": 5.00, "currency": "BRL"}. IDs de lojas sao numericos do Aiqfome. Endpoints como /neighborhoods, /delivery-fees e /payment-methods sao especificos do Aiqfome.

GET /od/v1/merchant Info do merchant ▶

Dados da loja mapeados para formato Open Delivery (camelCase, campos internos removidos).

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant"

Response 200

{
  "id": "53191",
  "name": "Pizzaria Exemplo",
  "corporateName": "Pizzaria Exemplo LTDA",
  "preparationTime": 40,
  "deliveryTime": "40 - 60",
  "isDeliveryRadiusActive": false,
  "cityId": 4006,
  "ratings": {
    "average": 4.5,
    "count": 128,
    "details": { "quality": 4.3, "delivery": 4.6, "accuracy": 4.5 }
  },
  "workingHours": [
    { "weekDayNumber": 1, "hours": "08:00 - 22:00", "status": 1 }
  ]
}

POST /od/v1/merchant/status Alterar status ▶

Abre, fecha ou coloca a loja em standby.

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"operation":"OPEN"}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/status"

Valores: OPEN, CLOSE, STANDBY

Response 200

{
  "store_id": 53191,
  "status": "OPEN"
}

GET /od/v1/merchant/hours Horarios ▶

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant/hours"

Response 200

[
  { "weekDayNumber": 1, "hours": "08:00 - 22:00", "status": 1 },
  { "weekDayNumber": 2, "hours": "08:00 - 22:00", "status": 1 }
]

PUT /od/v1/merchant/hours Atualizar horarios ▶

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"working_hours":[{"weekday":1,"status":true,"hours":[{"open":"08:00","close":"22:00"}]}]}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/hours"

Response: 200 OK

PUT /od/v1/merchant/preparation-time Tempo de preparo ▶

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"preparation_time":30}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/preparation-time"

Response 200

{
  "store_id": 53191,
  "preparation_time": 30
}

PUT /od/v1/merchant/delivery-time Tempo de entrega ▶

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"delivery_time":"30 - 50"}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/delivery-time"

Response 200

{
  "store_id": 53191,
  "delivery_time": "30 - 50"
}

GET /od/v1/merchant/delivery-fees Taxas de entrega ▶

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant/delivery-fees"

Response 200

{
  "store": { "id": "53191", "name": "Pizzaria Exemplo" },
  "city": { "id": 4006, "name": "Maringa" },
  "radius": [
    { "id": 229, "distanceKm": 3, "value": { "value": 5.00, "currency": "BRL" }, "returnTaxValue": { "value": 0, "currency": "BRL" } },
    { "id": 230, "distanceKm": 5, "value": { "value": 8.00, "currency": "BRL" }, "returnTaxValue": { "value": 0, "currency": "BRL" } }
  ]
}

POST /od/v1/merchant/delivery-fees Criar faixas ▶

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"radius":[{"distance_km":3.0,"value":5.00}]}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/delivery-fees"

Response: 200 OK

PUT /od/v1/merchant/delivery-fees Atualizar faixas ▶

Atualiza faixas de entrega existentes.

Request

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"radius":[{"id":229,"distance_km":3,"value":6.00,"return_tax_value":1.00}]}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/delivery-fees"

Response 200

{
  "radius": [
    { "id": 229, "distance_km": 3, "value": 6.00, "return_tax_value": 1.00 }
  ]
}

DELETE /od/v1/merchant/delivery-fees/{id} Remover faixa ▶

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant/delivery-fees/123"

Response: 200 OK

GET /od/v1/merchant/neighborhoods Bairros ▶

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant/neighborhoods"

Response 200

[
  { "id": 472, "name": "Centro", "deliveryTax": { "value": 4.50, "currency": "BRL" } },
  { "id": 6571, "name": "Zona 07", "deliveryTax": { "value": 7.00, "currency": "BRL" } }
]

POST /od/v1/merchant/neighborhoods Sincronizar bairros ▶

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"store_neighborhoods":[{"neighborhood_id":"123","delivery_tax":5.00}]}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/neighborhoods"

Response: 200 OK

GET /od/v1/merchant/payment-methods Pagamentos ▶

Request

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/merchant/payment-methods"

Response 200

[
  { "id": 121, "name": "Visa Credito" },
  { "id": 163, "name": "Mastercard Credito" },
  { "id": 1, "name": "Dinheiro" }
]

POST /od/v1/merchant/payment-methods Configurar pagamentos ▶

Request

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"payment_methods_ids":[1,2,3]}' \
  "https://www.aiqbridge.com.br/od/v1/merchant/payment-methods"

Response: 200 OK

Webhooks

Receba eventos em tempo real. Funciona identicamente aos webhooks iFood, com assinatura HMAC-SHA256.

POST /od/v1/webhook/config Registrar webhook ▶

Registra ou atualiza a URL. Um secret_key e gerado automaticamente.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://meu-sistema.com/od-webhook"}' \
  "https://www.aiqbridge.com.br/od/v1/webhook/config"

GET /od/v1/webhook/config Ver configuracao ▶

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/webhook/config"

DELETE /od/v1/webhook/config Remover webhook ▶

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/webhook/config"

Response: 204 No Content

PUT /od/v1/webhook/config/toggle Ativar/desativar ▶

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/webhook/config/toggle?enabled=true"

POST /od/v1/webhook/config/test Evento de teste ▶

curl -X POST -H "Authorization: Bearer $TOKEN" \
  "https://www.aiqbridge.com.br/od/v1/webhook/config/test"

Codigos de Erro

Todos os endpoints retornam erros no formato {"detail": "mensagem"}.

Status	Significado	Quando ocorre
`400`	Bad Request	Body invalido, campos obrigatorios ausentes
`401`	Unauthorized	Token ausente, expirado ou credenciais invalidas
`404`	Not Found	Pedido ou recurso nao encontrado
`409`	Conflict	Acao fora de ordem (ex: despachar antes de confirmar)
`500`	Internal Error	Erro inesperado — reporte ao suporte