O que está mudando na API Recintos Aduaneiros
Se sua empresa opera como recinto aduaneiro ou contrata serviços de despacho que dependem de integração sistêmica com a Receita Federal, preste atenção: a API Recintos Aduaneiros passa por uma atualização relevante na chamada Release Paraná. A mudança introduz o campo tipoPesagem como obrigatório em determinadas transmissões. Portanto, sistemas que não forem atualizados antes do corte vão quebrar a integração e travar operações inteiras.
- A Release Paraná adiciona o campo tipoPesagem como obrigatório na API Recintos Aduaneiros.
- Sistemas de recintos e despachantes que não atualizarem o layout perderão a integração na data de corte.
- A fonte oficial é o comunicado do Siscomex disponível no portal gov.br.
- A adaptação precisa ser feita antes da entrada em produção da release, não depois.
A Receita Federal divulgou o alerta pelo canal de comunicados do Siscomex. O aviso é direto: recintos e desenvolvedores de sistemas precisam revisar os contratos de integração e ajustar os campos transmitidos. Além disso, ignorar essa atualização não é opção, porque a quebra acontece automaticamente na virada de versão.
Por que o campo tipoPesagem importa tanto
Na prática, o campo tipoPesagem identifica o método utilizado para aferir o peso da carga no recinto. Pode ser pesagem estática, dinâmica ou por estimativa, dependendo do tipo de operação e do equipamento disponível. Essa informação alimenta o controle aduaneiro e, em alguns casos, impacta diretamente o cálculo tributário da mercadoria importada.
Quando o campo está ausente ou preenchido fora do padrão exigido, a API rejeita a transmissão. O resultado prático é simples: a carga fica parada, sem o registro necessário para avançar no fluxo de desembaraço. Para recintos que movimentam dezenas de processos por dia, um erro assim gera filas, multas contratuais e desgaste com o importador. Por isso, a atualização não é apenas um ajuste técnico de TI.
Ou seja, ela tem consequência direta na operação logística e no prazo de entrega ao cliente final. Além disso, o impacto se propaga para o importador, que depende do registro correto para liberar a mercadoria no prazo contratado.
Checklist prático para não perder o prazo
Antes de a Release Paraná entrar em produção, siga esta sequência. Na prática, cada etapa depende da anterior, então não pule nenhuma:
- Identifique o sistema responsável pela integração. Pode ser um ERP próprio, um software de recinto contratado ou uma solução desenvolvida internamente. Em qualquer caso, o ponto de partida é saber quem mantém o código.
- Contate o fornecedor do sistema. Pergunte diretamente se a versão atual já contempla o campo tipoPesagem no layout da API Recintos Aduaneiros. Exija confirmação por escrito, porque promessa verbal não garante SLA.
- Acesse o comunicado oficial. O documento completo está disponível no portal do Siscomex em gov.br/siscomex. Portanto, leia as especificações técnicas do campo antes de qualquer desenvolvimento.
- Realize testes em ambiente de homologação. Nunca valide uma mudança de layout diretamente em produção. A Receita Federal disponibiliza ambiente de testes justamente para isso, então use-o sem hesitar.
- Defina um responsável interno pelo acompanhamento. Alguém precisa monitorar a data de corte e garantir que a atualização foi aplicada antes dela. Além disso, esse responsável deve centralizar a comunicação com o fornecedor.
- Documente os testes realizados. Em caso de problema após a virada, você vai precisar demonstrar que a integração foi testada e aprovada no ambiente de homologação. Portanto, guarde os logs e os registros de aprovação.
Empresas que já passaram por atualizações anteriores do Siscomex sabem que o prazo de adaptação costuma ser curto. Por isso, iniciar esse processo assim que o comunicado é publicado faz toda a diferença entre operar normalmente e enfrentar uma fila de cargas paradas.
Perguntas que recebemos sobre atualizações de API aduaneira
Quem é afetado por essa mudança?
Diretamente, os recintos alfandegados e os desenvolvedores de sistemas que fazem a transmissão de dados via API Recintos Aduaneiros. Indiretamente, qualquer importador cujas cargas passam por esses recintos, porque a parada do sistema afeta o prazo de desembaraço. Ou seja, o impacto vai além do setor de TI.
E se o sistema for de um terceiro e ele não atualizar a tempo?
A responsabilidade contratual é do fornecedor, mas o impacto operacional cai no recinto. Por isso, cobrar prazo e confirmação escrita do fornecedor é parte do processo, não cortesia. Se necessário, acione as cláusulas de SLA do contrato antes da data de corte, não depois.
A mudança afeta o cálculo de tributos na importação?
O campo tipoPesagem, por si só, não altera alíquotas. No entanto, o peso correto da mercadoria pode influenciar bases de cálculo em operações onde o frete compõe o valor aduaneiro. Para entender como esses valores se encadeiam, vale revisar como funciona a base de cálculo de PIS e COFINS na importação.
Preciso de habilitação especial no Siscomex para testar a nova versão?
Não para o ambiente de homologação. No entanto, se sua empresa ainda não tem o RADAR ativo ou está com limitações de acesso, esse pode ser um bom momento para regularizar. Entenda o que é o RADAR de importação e como ele se conecta ao seu acesso aos sistemas aduaneiros. Além disso, um RADAR com restrições pode limitar sua capacidade de testar em homologação.
Vale monitorar outros comunicados do Siscomex de forma contínua?
Sim, e isso é mais simples do que parece. O portal gov.br publica todos os comunicados de sistemas na mesma seção. Na prática, uma rotina mensal de verificação evita surpresas como esta. Portanto, inclua essa checagem no calendário operacional da sua equipe de comércio exterior.
Este conteúdo tem caráter informativo e não substitui a análise de um despachante aduaneiro ou consultor especializado. Para situações específicas da sua operação, consulte um profissional habilitado.
Perguntas frequentes
A Release Paraná é uma atualização de versão da API Recintos Aduaneiros, divulgada pela Receita Federal via Siscomex. Ela torna obrigatório o campo tipoPesagem nas transmissões, exigindo que sistemas de recintos e despachantes atualizem seu layout antes da data de corte para evitar rejeição de dados.
A API passa a rejeitar as transmissões que não incluírem o campo tipoPesagem no formato correto. Na prática, isso trava o registro das cargas no sistema aduaneiro, gerando atrasos no desembaraço e potenciais multas contratuais para o recinto.
A atualização técnica é responsabilidade do desenvolvedor ou fornecedor do sistema de integração. Portanto, o recinto deve cobrar prazo e confirmação escrita do fornecedor, além de validar os testes em ambiente de homologação antes da entrada em produção.
O comunicado oficial com as especificações está disponível no portal do Siscomex, na seção de comunicados de sistemas. A Receita Federal também disponibiliza ambiente de homologação para que os desenvolvedores testem a integração antes da virada de versão.