API de Cotação de Frete: obrigatoriedade do campo "accountId" para marketplaces integradores

A partir de 03/09/2026, a API de Cotação de Frete do ANYMARKET passará a exigir o campo accountId em todas as requisições. 

Requisições enviadas sem esse campo serão rejeitadas e a cotação não será processada. 

Este artigo explica o que muda, como se preparar e como validar a integração antes da data de vigência.

Neste artigo:

• Pré-requisitos
• O que muda na API de Cotação de Frete
• Passo a passo para adequação
• Boas práticas
• Dúvidas comuns

Pré-requisitos

Esta mudança se aplica apenas a marketplaces com fluxo de atualização de frete integrado ao ANYMARKET.

Marketplaces sem esse fluxo não precisam realizar nenhuma ação neste momento.

Para adequar a integração, é necessário:

• Ter acesso ao código-fonte da integração que hoje consome a API de Cotação de Frete do ANYMARKET.
• Ter o identificador da conta do marketplace (accountId) vinculada ao seller mapeado e disponível no momento da requisição.
• Ter ambiente de homologação disponível para validar o novo comportamento antes de 03/09/2026.

O que muda na API de Cotação de Frete

Atualmente, a API de Cotação de Frete exige apenas a identificação do marketplace para processar a cotação. 

A partir de 03/09/2026, o campo accountId (identificador da conta do marketplace) passará a ser obrigatório nas requisições de cotação de frete.

Por que essa mudança está sendo feita?

• Garante maior precisão na identificação da conta correta do marketplace durante a cotação.
• Reduz inconsistências e erros de vinculação em cenários com múltiplas contas por marketplace.
• Aumenta a aderência da API ao cenário real de operação dos sellers.

Passo a passo para adequação

1. Mapear o campo accountId (identificador da conta do marketplace) em todas as integrações que hoje enviam requisições de cotação de frete.
2. Garantir que o valor enviado no campo accountId corresponda à conta correta do marketplace vinculada ao seller que está solicitando a cotação.
3. Validar o novo comportamento em ambiente de homologação antes de 03/09/2026.
4. Ajustar o tratamento de erros da integração para lidar com o cenário de rejeição por ausência do campo accountId.
5. Publicar a alteração em produção com antecedência à data de vigência.

Boas práticas

• Realizar os testes de homologação com antecedência para evitar impacto em produção no dia 03/09/2026.
• Testar cenários com sellers que possuem múltiplas contas no mesmo marketplace, garantindo que o accountId enviado corresponde exatamente à conta esperada.
• Registrar o tratamento de erro no log da integração quando a rejeição por ausência de accountId ocorrer, para facilitar diagnóstico.
• Comunicar internamente o time responsável pela integração sobre a data de vigência para evitar rollback ou deploys concorrentes próximos a 03/09/2026.

Dúvidas comuns

Preciso fazer algo se meu marketplace não tem fluxo de atualização de frete integrado ao ANYMARKET?
Não. Marketplaces sem fluxo de atualização de frete não precisam realizar nenhuma ação neste momento.

O que acontece se eu enviar uma requisição de cotação sem o campo accountId a partir de 03/09/2026?
A requisição será rejeitada e a cotação não será realizada. É necessário reenviar a requisição com o campo accountId preenchido corretamente.

Onde posso validar o novo comportamento antes da data de vigência?
No ambiente de homologação do ANYMARKET. Recomendamos concluir os testes com antecedência para evitar impacto em produção.

O que devo enviar no campo accountId?
O identificador da conta do marketplace vinculada ao seller que está solicitando a cotação. Em cenários com múltiplas contas por marketplace, garantir que o valor enviado corresponda exatamente à conta correta.

Essa mudança afeta outras APIs além da Cotação de Frete?
Não. A obrigatoriedade do campo accountId se aplica apenas à API de Cotação de Frete a partir de 03/09/2026.