Pular para o conteúdo principal

Entrega

2026-09-26 — Entrega — configuração de preços e cotação​

🆕 Novo

  • GET /v1/delivery/pricing — Retorna a configuração de precificação de entrega da empresa: se a entrega está ativa, o modo de precificação (FIXED, BY_AREA, BY_DRIVE_DISTANCE, BY_RANGE, BY_DISTRICT) e os parâmetros específicos do modo. FIXED e BY_DISTRICT já trazem o preço aqui; os demais modos precisam de GET /v1/delivery/quote.
  • GET /v1/delivery/quote — Resolve o preço de entrega para um endereço: envie latitude/longitude para BY_AREA, BY_DRIVE_DISTANCE e BY_RANGE, ou district_id para BY_DISTRICT. Um preço 0 com área null significa que o endereço está fora da cobertura configurada, mas o estabelecimento ainda aceita o pedido.

Os dois endpoints existem para que um integrador possa precificar um endereço de entrega antes de POST /v1/orders, que recebe delivery_price literalmente, e reutilizam o escopo existente orders:read.