From 1aff62c78ee3d393ca51f632e738aea140cd7e3d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Thu, 30 Jul 2026 16:50:43 -0300 Subject: [PATCH 1/8] docs: documenta exigir_codigo_confirmacao na abertura de entregas --- pages/v2/openapi-entregas.json | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/pages/v2/openapi-entregas.json b/pages/v2/openapi-entregas.json index ad177b7..3f11647 100644 --- a/pages/v2/openapi-entregas.json +++ b/pages/v2/openapi-entregas.json @@ -3934,7 +3934,8 @@ "codigo_confirmacao": "9999", "valor_cobrar": 852.37 } - ] + ], + "exigir_codigo_confirmacao": true }, "schema": { "type": "object", @@ -4023,6 +4024,10 @@ } } } + }, + "exigir_codigo_confirmacao": { + "type": "boolean", + "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." } } } @@ -5286,7 +5291,8 @@ } ], "data": "31/12/2026", - "hora": "14:30:00" + "hora": "14:30:00", + "exigir_codigo_confirmacao": true }, "schema": { "type": "object", @@ -5383,6 +5389,10 @@ "hora": { "type": "string", "description": "Hora da entrega programada. Formato HH:MM:SS" + }, + "exigir_codigo_confirmacao": { + "type": "boolean", + "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." } } } @@ -5482,7 +5492,8 @@ "nome_cliente_parada": "Maria Souza", "telefone_cliente_parada": "(11) 99999-0002" } - ] + ], + "exigir_codigo_confirmacao": true }, "schema": { "type": "object", @@ -5586,6 +5597,10 @@ } } } + }, + "exigir_codigo_confirmacao": { + "type": "boolean", + "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." } } } From 516c59dfb20930601e9bac58ce7a35c455f8069e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 31 Jul 2026 13:53:39 -0300 Subject: [PATCH 2/8] =?UTF-8?q?docs:=20restringe=20exigir=5Fcodigo=5Fconfi?= =?UTF-8?q?rmacao=20aos=20endpoints=20de=20cria=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A edição de entrega programada está fora do escopo da entrega. O endpoint aceita o campo por reusar o pipeline de criação no V1, como já acontece com outros campos de topo não documentados nele, mas documentar isso criaria contrato para um comportamento que não foi decidido. --- pages/v2/openapi-entregas.json | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/pages/v2/openapi-entregas.json b/pages/v2/openapi-entregas.json index 3f11647..abe501e 100644 --- a/pages/v2/openapi-entregas.json +++ b/pages/v2/openapi-entregas.json @@ -5492,8 +5492,7 @@ "nome_cliente_parada": "Maria Souza", "telefone_cliente_parada": "(11) 99999-0002" } - ], - "exigir_codigo_confirmacao": true + ] }, "schema": { "type": "object", @@ -5597,10 +5596,6 @@ } } } - }, - "exigir_codigo_confirmacao": { - "type": "boolean", - "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." } } } From 007294874fde280655a0bc151bafd5d3e934617a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 31 Jul 2026 13:53:39 -0300 Subject: [PATCH 3/8] docs: adiciona changelog do exigir_codigo_confirmacao --- pages/v2/changelog-entregas.mdx | 40 +++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/pages/v2/changelog-entregas.mdx b/pages/v2/changelog-entregas.mdx index 83d7063..cf5d261 100644 --- a/pages/v2/changelog-entregas.mdx +++ b/pages/v2/changelog-entregas.mdx @@ -154,6 +154,46 @@ export const EndpointBadge = ({ method, path, href }) => (

+ +

+ Exigir o código de confirmação de entrega pela API +

+

+ Agora é possível definir, por solicitação, se o condutor é obrigado a informar o código de + confirmação para concluir a entrega — independente do que está configurado no cadastro da empresa. +

+ + + + +
    +
  • — define se a inserção do código de confirmação é obrigatória. Opcional; se omitido, a solicitação segue a configuração da empresa (ou da central).
    • +
+ + +
+ + + +
    +
  • — mesmo comportamento da criação de entrega. O valor informado é aplicado à solicitação gerada quando a programada dispara.
    • +
+ +
+ +
+ Pré-condições: o parâmetro só tem efeito nas paradas cujo pedido tem código de confirmação — o que depende de a empresa ter Solicitar código de confirmação de entrega habilitado. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. +
+ +

Consulta de status de entrega do webhook From 9b9237e14dc1ef4a649908e89ec346c65051fb77 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 31 Jul 2026 14:21:41 -0300 Subject: [PATCH 4/8] docs: detalha quando o exigir_codigo_confirmacao vale na programada --- pages/v2/openapi-entregas.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/v2/openapi-entregas.json b/pages/v2/openapi-entregas.json index abe501e..8506859 100644 --- a/pages/v2/openapi-entregas.json +++ b/pages/v2/openapi-entregas.json @@ -5392,7 +5392,7 @@ }, "exigir_codigo_confirmacao": { "type": "boolean", - "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." + "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração. Em entregas programadas, o valor informado é aplicado à solicitação gerada no momento do disparo." } } } From 853ee8dedc99872cc9e9c3c93ce4aabb2333593a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 31 Jul 2026 14:21:42 -0300 Subject: [PATCH 5/8] =?UTF-8?q?docs:=20padroniza=20r=C3=B3tulo=20da=20nota?= =?UTF-8?q?=20no=20changelog=20de=20entregas?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pages/v2/changelog-entregas.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/v2/changelog-entregas.mdx b/pages/v2/changelog-entregas.mdx index cf5d261..1423b50 100644 --- a/pages/v2/changelog-entregas.mdx +++ b/pages/v2/changelog-entregas.mdx @@ -190,7 +190,7 @@ export const EndpointBadge = ({ method, path, href }) => ( fontSize: "13px", lineHeight: "1.6", }}> - Pré-condições: o parâmetro só tem efeito nas paradas cujo pedido tem código de confirmação — o que depende de a empresa ter Solicitar código de confirmação de entrega habilitado. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. + Nota: o parâmetro só tem efeito nas paradas cujo pedido tem código de confirmação — o que depende de a empresa ter Solicitar código de confirmação de entrega habilitado. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. From ab2aa7940e5c5c9d6db43732d81e4936c91d7e2f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 31 Jul 2026 14:32:58 -0300 Subject: [PATCH 6/8] =?UTF-8?q?docs:=20distingue=20as=20duas=20configura?= =?UTF-8?q?=C3=A7=C3=B5es=20de=20c=C3=B3digo=20de=20confirma=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A descrição dizia que a obrigatoriedade vale independente do cadastro da empresa e, logo depois, que o parâmetro só tem efeito em parada com código gerado — o que depende justamente de uma configuração da empresa. São dois ajustes distintos no cadastro: o parâmetro sobrepõe "Tornar os códigos de confirmação de entrega obrigatórios", mas a geração do código continua presa a "Solicitar código de confirmação de entrega dos pedidos". Nomear as duas evita que o integrador conclua que o parâmetro funciona com a segunda desligada. --- pages/v2/changelog-entregas.mdx | 5 +++-- pages/v2/openapi-entregas.json | 4 ++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/pages/v2/changelog-entregas.mdx b/pages/v2/changelog-entregas.mdx index 1423b50..1f01313 100644 --- a/pages/v2/changelog-entregas.mdx +++ b/pages/v2/changelog-entregas.mdx @@ -160,7 +160,8 @@ export const EndpointBadge = ({ method, path, href }) => (

Agora é possível definir, por solicitação, se o condutor é obrigado a informar o código de - confirmação para concluir a entrega — independente do que está configurado no cadastro da empresa. + confirmação para concluir a entrega, sobrepondo a configuração de obrigatoriedade do cadastro + da empresa.

@@ -190,7 +191,7 @@ export const EndpointBadge = ({ method, path, href }) => ( fontSize: "13px", lineHeight: "1.6", }}> - Nota: o parâmetro só tem efeito nas paradas cujo pedido tem código de confirmação — o que depende de a empresa ter Solicitar código de confirmação de entrega habilitado. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. + Nota: são duas configurações distintas no cadastro da empresa. O parâmetro sobrepõe apenas Tornar os códigos de confirmação de entrega obrigatórios; a geração do código continua dependendo de Solicitar código de confirmação de entrega dos pedidos — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. diff --git a/pages/v2/openapi-entregas.json b/pages/v2/openapi-entregas.json index 8506859..6df1d56 100644 --- a/pages/v2/openapi-entregas.json +++ b/pages/v2/openapi-entregas.json @@ -4027,7 +4027,7 @@ }, "exigir_codigo_confirmacao": { "type": "boolean", - "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração." + "description": "Define se a inserção do código de confirmação pelo condutor é obrigatória, sobrepondo a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central). Quando omitido, a solicitação segue essa configuração. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração." } } } @@ -5392,7 +5392,7 @@ }, "exigir_codigo_confirmacao": { "type": "boolean", - "description": "Define se a inserção do código de confirmação de entrega pelo condutor é obrigatória, independente do que está configurado no cadastro da empresa. Quando omitido, a solicitação segue a configuração da empresa (ou da central). Só tem efeito nas paradas cujo pedido tem código de confirmação; não relaxa a exigência de pedidos do iFood, onde o código é exigência da própria integração. Em entregas programadas, o valor informado é aplicado à solicitação gerada no momento do disparo." + "description": "Define se a inserção do código de confirmação pelo condutor é obrigatória, sobrepondo a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central). Quando omitido, a solicitação segue essa configuração. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração. Em entregas programadas, o valor informado é aplicado à solicitação gerada no momento do disparo." } } } From c267e4fb8aa245969d3ba9cb097f467be6da4253 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Wed, 5 Aug 2026 11:08:36 -0300 Subject: [PATCH 7/8] =?UTF-8?q?docs:=20ajusta=20exigir=5Fcodigo=5Fconfirma?= =?UTF-8?q?cao=20para=20somar=20exig=C3=AAncia?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A coluna passou a ser NOT NULL DEFAULT 0 no backend, a pedido dos líderes técnicos, e com dois valores o parâmetro deixa de sobrepor a configuração nos dois sentidos: true exige o código, e omitir ou enviar false mantém o que está configurado no cadastro da empresa. Reescreve as descrições dos dois endpoints e a entrada de changelog para descrever esse comportamento, em vez de "sobrepõe a configuração". --- pages/v2/changelog-entregas.mdx | 11 +++++------ pages/v2/openapi-entregas.json | 4 ++-- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/pages/v2/changelog-entregas.mdx b/pages/v2/changelog-entregas.mdx index 1f01313..26668b3 100644 --- a/pages/v2/changelog-entregas.mdx +++ b/pages/v2/changelog-entregas.mdx @@ -159,16 +159,15 @@ export const EndpointBadge = ({ method, path, href }) => ( Exigir o código de confirmação de entrega pela API

- Agora é possível definir, por solicitação, se o condutor é obrigado a informar o código de - confirmação para concluir a entrega, sobrepondo a configuração de obrigatoriedade do cadastro - da empresa. + Agora é possível exigir, por solicitação, que o condutor informe o código de confirmação + para concluir a entrega — mesmo quando o cadastro da empresa não torna o código obrigatório.

    -
  • — define se a inserção do código de confirmação é obrigatória. Opcional; se omitido, a solicitação segue a configuração da empresa (ou da central).
    • +
  • — opcional. Envie true para tornar o código obrigatório nesta solicitação; omitir o campo ou enviar false mantém o que está configurado no cadastro da empresa (ou da central).
 @@ -177,7 +176,7 @@ export const EndpointBadge = ({ method, path, href }) => (
    -
  • — mesmo comportamento da criação de entrega. O valor informado é aplicado à solicitação gerada quando a programada dispara.
    • +
  • — mesmo comportamento da criação de entrega. Quando true, a exigência é aplicada à solicitação gerada no disparo da programada.
 @@ -191,7 +190,7 @@ export const EndpointBadge = ({ method, path, href }) => ( fontSize: "13px", lineHeight: "1.6", }}> - Nota: são duas configurações distintas no cadastro da empresa. O parâmetro sobrepõe apenas Tornar os códigos de confirmação de entrega obrigatórios; a geração do código continua dependendo de Solicitar código de confirmação de entrega dos pedidos — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. + Nota: são duas configurações distintas no cadastro da empresa. O parâmetro soma exigência sobre Tornar os códigos de confirmação de entrega obrigatórios — nunca a remove; a geração do código continua dependendo de Solicitar código de confirmação de entrega dos pedidos — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código independente do valor enviado, por ser regra da própria integração. diff --git a/pages/v2/openapi-entregas.json b/pages/v2/openapi-entregas.json index 6df1d56..0297894 100644 --- a/pages/v2/openapi-entregas.json +++ b/pages/v2/openapi-entregas.json @@ -4027,7 +4027,7 @@ }, "exigir_codigo_confirmacao": { "type": "boolean", - "description": "Define se a inserção do código de confirmação pelo condutor é obrigatória, sobrepondo a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central). Quando omitido, a solicitação segue essa configuração. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração." + "description": "Torna obrigatória a inserção do código de confirmação pelo condutor nesta solicitação, mesmo que a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central) não exija. Envie `true` para exigir; omitir o campo ou enviar `false` mantém o que está configurado — o parâmetro nunca dispensa uma exigência já configurada. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração." } } } @@ -5392,7 +5392,7 @@ }, "exigir_codigo_confirmacao": { "type": "boolean", - "description": "Define se a inserção do código de confirmação pelo condutor é obrigatória, sobrepondo a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central). Quando omitido, a solicitação segue essa configuração. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração. Em entregas programadas, o valor informado é aplicado à solicitação gerada no momento do disparo." + "description": "Torna obrigatória a inserção do código de confirmação pelo condutor nesta solicitação, mesmo que a configuração \"Tornar os códigos de confirmação de entrega obrigatórios\" do cadastro da empresa (ou da central) não exija. Envie `true` para exigir; omitir o campo ou enviar `false` mantém o que está configurado — o parâmetro nunca dispensa uma exigência já configurada. O código só é gerado quando \"Solicitar código de confirmação de entrega dos pedidos\" está habilitado — em paradas sem código o parâmetro não tem efeito. Pedidos do iFood continuam exigindo o código, por ser regra da própria integração. Em entregas programadas, o valor informado é aplicado à solicitação gerada no momento do disparo." } } } From 08235c8b1edcf8485c3687d0d586f8bc6f372324 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Victor=20Dutra?= Date: Fri, 7 Aug 2026 14:27:35 -0300 Subject: [PATCH 8/8] =?UTF-8?q?docs:=20ajusta=20a=20data=20do=20changelog?= =?UTF-8?q?=20para=20a=20subida=20em=20produ=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pages/v2/changelog-entregas.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/v2/changelog-entregas.mdx b/pages/v2/changelog-entregas.mdx index 26668b3..186a158 100644 --- a/pages/v2/changelog-entregas.mdx +++ b/pages/v2/changelog-entregas.mdx @@ -154,7 +154,7 @@ export const EndpointBadge = ({ method, path, href }) => (

- +

Exigir o código de confirmação de entrega pela API