Erros de API no NCM Intel: autenticação, valores divergentes e campos ausentes

Se sua empresa consome dados do NCM Intel via API e você encontrou erros na integração, este guia cobre os três cenários mais comuns e o que reunir antes de escalar. Uma boa preparação do chamado costuma reduzir horas de investigação para minutos.

Uma nota rápida: API (Application Programming Interface) é a forma de consumo automatizado dos dados Logcomex, para integração com sistemas próprios do cliente.

Erro de autenticação (401, 403 ou "produto não contratado")

Antes de abrir chamado, reúna as informações que a nossa equipe vai precisar. Não peça o Trace ID ao seu time técnico — isso é informação técnica que geralmente eles não localizam facilmente. Nossa equipe extrai o que precisa do próprio comando de request ou do header de resposta.

Reúna:

• O comando completo que está sendo executado (endpoint, headers, método HTTP).
• Confirmação de que o Bearer Token foi gerado pelo endpoint de Authorization antes da chamada. Se você pulou essa etapa, é aqui que está o problema.
• Se a falha acontece em todas as tentativas ou apenas em algumas.
• Se chegou a funcionar antes e parou, ou se nunca funcionou.

Com essas informações no chamado, o diagnóstico avança sem idas e voltas.

Valores divergentes entre API e plataforma

Se você compara o retorno da API com o que aparece na plataforma web e os valores não batem, o primeiro ponto é confirmar se a consulta é equivalente.

Exemplo típico de comparação errada: você fez uma pesquisa por empresa na plataforma e uma pesquisa por NCM na API. São recortes diferentes — não vão bater. Antes de reportar divergência, confirme que ambos os lados estão consultando o mesmo escopo (mesma NCM, mesmo período, mesmos filtros).

Se a comparação é equivalente e ainda assim os valores divergem de forma expressiva, abra chamado com:

• Endpoint da API utilizado
• Request completo (parâmetros usados)
• Exemplos dos valores divergentes (valor obtido na API x valor obtido na plataforma)

Campo ausente no retorno da API (ex.: código CNAE)

Se um campo que você espera não aparece no retorno da API:

• Confirme na documentação atual que aquele campo está previsto para o endpoint que você está usando. A documentação está em Central do Cliente > Documentações e API.
• Se o campo está previsto e não retorna, é caso de chamado com:
  • Endpoint utilizado
  • Request completo
  • Nome exato do campo esperado

Limite de consultas mensais atingido

Se a API retorna uma tela indicando limite mensal atingido, isso é comportamento contratual — não é bug. Cada plano tem um número máximo de consultas mensais.

O que fazer:

• Confirme com o Guardião da Conta o limite do seu plano atual.
• Se você precisa de volume maior, o Guardião avalia upgrade.

NCM fora do plano retornando na API (histórico)

Se a API traz dados de NCMs que não estão no seu plano, o comportamento não é esperado. Abra chamado com sua conta, a NCM consultada e o retorno recebido. O sistema tem validação automática para restringir NCMs do plano — se algo escapou, precisa ser corrigido.