Skip to main content
Esta página lista as rotas que estão sendo descontinuadas, o que usar no lugar e como migrar. Rotas em deprecação continuam respondendo, mas podem ser removidas: migre o quanto antes.

​
Situação atual

O prazo de 01/08/2026 já passou. As rotas marcadas como Prazo encerrado ainda respondem, mas não há garantia de que continuem: integrações que dependem delas podem parar a qualquer momento. Migre agora.

​
Linha do tempo

Linha do tempo: 22/04/2025 início da deprecação da Partner v1, Merchant v1/v2, invoices e agreementCode; 17/06/2025 Tabs; 30/06/2026 prazo adiado; 01/08/2026 fim do prazoLinha do tempo: 22/04/2025 início da deprecação da Partner v1, Merchant v1/v2, invoices e agreementCode; 17/06/2025 Tabs; 30/06/2026 prazo adiado; 01/08/2026 fim do prazo

Linha do tempo das deprecações

​
Como identificar uma rota em deprecação

Rotas em deprecação respondem normalmente, com dois headers a mais:
Registre um alerta no seu cliente HTTP sempre que uma resposta vier com Deprecation: true. Assim você descobre rotas antigas esquecidas antes que elas parem.
O valor do Sunset enviado hoje não reflete o adiamento para 01/08/2026: as rotas de Merchant v1/v2 e Tabs enviam Mon, 01 Dec 2025 00:00:00 GMT, e as de invoices e agreementCode da Partner V2 enviam Tue, 01 Jul 2025 00:00:00 GMT. Use o header como sinal de deprecação e esta página como referência de prazo.
Depois da remoção, a rota responde 410 Gone (ou deixa de existir) e a integração que não migrou deixa de funcionar.

​
Migrando

Anunciado em 16/06/2025. As ações de abrir e fechar comanda ganharam nomes que dizem o que fazem.
1

Troque o caminho

Substitua /available por /opened (abrir a comanda para consumo) e /unavailable por /closed (fechar a comanda).
2

Confira o header

Depois da troca, as respostas não devem mais trazer Deprecation: true.
Veja Indoor.
Anunciado em 22/04/2025, com o novo sistema de cobrança.
1

Inclua o partnerId no caminho

Use o ID do parceiro dono das faturas. Um token com vários parceiros faz uma chamada por parceiro.
2

Revise o parse da resposta

As rotas novas seguem o modelo de faturas por plano. Veja Invoices.
Anunciado em 22/04/2025.
1

Troque a rota

Envie o mesmo código de contrato pela rota subscription, que atualiza a assinatura inteira.
2

Revise o corpo

Veja os campos aceitos em Gerenciar assinatura dos merchants e das revendas.
Anunciado em 22/04/2025. Todas as rotas v1 e v2 da Merchant API foram substituídas pela V3, que segue o modelo Open Delivery.
1

Gere o token com o scope od.all

A V3 usa o mesmo OAuth2 com o scope od.all.
2

Reimplemente o fluxo de pedidos

Siga Receba seu primeiro pedido: eventos, acknowledgment, detalhes e ações.
3

Migre o catálogo

Use merchantUpdate, merchantUpsert e merchantForce. Veja Catálogo.
Anunciado em 22/04/2025 e já removida: as rotas v1 não são mais atendidas. Use a Partner API V2 com o scope dv.partner.

​
Histórico de avisos

Início da deprecação em 17/06/2025 das rotas available e unavailable das comandas, substituídas por opened e closed. Prazo original de descontinuação: 01/08/2026.
A Partner API consolidou operações redundantes e introduziu assinaturas com governança unificada. Entraram em deprecação as invoices sem partnerId, as rotas agreementCode, todas as rotas v1/v2 da Merchant API e todas as rotas v1 da Partner API. O prazo foi adiado para 01/08/2026 em 30/06/2026, quando a Partner v1 foi removida.