Fretes com Filtro de Status de Contratos

Anteriormente, a consulta de contratos de frete pela API (GET /fretes) não permitia a filtragem por status de vigência. O endpoint retornava a totalidade dos contratos cadastrados na loja (ativos, inativos ou legados). Como consequência, hubs de integração (como o Anymarket) exibiam todas as opções simultaneamente, gerando duplicidade de informações (por exemplo, múltiplas entradas com o nome "PAC Correios") sem indicar qual estava efetivamente vigente.

Esse cenário levava a mapeamentos incorretos de transportadoras, falhas na exportação de pedidos para marketplaces e um volume elevado de dúvidas e chamados no suporte. Com esta atualização, solucionamos esse gargalo ao permitir que a integração consulte de forma limpa e assertiva exclusivamente os contratos que estão em operação.

O que mudou?

O endpoint GET /fretes ganhou o parâmetro opcional de query ativo (formato boolean), que funciona como um filtro de status. Os valores aceitos são:

• ativo=true: Retorna somente os contratos ativos/vigentes.
• ativo=false: Retorna somente os contratos inativos/desativados.

Caso o parâmetro seja omitido na requisição, a API continuará retornando todos os contratos (comportamento histórico). Isso garante que as integrações atuais continuem operando normalmente, sem qualquer quebra ou impacto imediato.

Principais Benefícios:

• Dado Limpo na Origem: Parceiros e sistemas integrados (ERPs/Hubs) não precisam mais criar lógicas complexas para tratar e descartar contratos inativos de seus lados.
• Mapeamento Correto e Seguro: Ao selecionar o parâmetro true, apenas os contratos vigentes aparecem na sincronização, reduzindo drasticamente as falhas de roteamento e exportação de pedidos.
• Zero Impacto Operacional: A evolução foi desenhada de forma retrocompatível, preservando a estabilidade de todos os fluxos de integração já existentes.

Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:

🔗 Filtro de Status nos Contratos de Frete via API

Publicado em: 13/10/2026