A API Recintos importação acaba de ganhar um campo obrigatório. Ele pode quebrar integrações silenciosamente se sua equipe não agir antes da Release Paraná. O campo em questão é o tipoPesagem. Recintos alfandegados, despachantes e desenvolvedores de sistemas logísticos precisam revisar seus ambientes agora. Não é uma mudança cosmética: sistemas que não enviarem o campo corretamente terão registros rejeitados ou inconsistentes na plataforma do Siscomex.
- O campo tipoPesagem passa a ser obrigatório na API Recintos do Siscomex.
- A mudança entra em vigor com a Release Paraná, sem prazo de tolerância confirmado.
- Sistemas não atualizados podem gerar quebra de integração e atrasos no despacho.
- Recintos alfandegados e despachantes precisam acionar seus fornecedores de TI imediatamente.
O que é a API Recintos e por que ela importa para o seu despacho
A API Recintos é a interface de programação que conecta os sistemas dos recintos alfandegados ao Portal Único de Comércio Exterior. Portos secos, terminais e armazéns usam essa API para transmitir informações sobre chegada de carga, pesagem, armazenagem e liberação de mercadorias diretamente ao Siscomex.
Na prática, quando uma carga chega ao recinto, o sistema do terminal dispara uma chamada à API Recintos importação com os dados do lote. Esses dados alimentam a DUIMP e as demais declarações associadas. Portanto, qualquer falha na transmissão afeta toda a cadeia: do despachante ao importador, passando pela Receita Federal.
O nível de integração exigido é alto. Por isso, alterações no contrato da API precisam ser tratadas como prioridade de TI. A inclusão de um campo obrigatório não é ajuste de rotina.

O campo tipoPesagem na API Recintos importação: o que muda na prática
O tipoPesagem é o novo campo obrigatório. Ele identifica o método utilizado para aferir o peso da mercadoria no recinto. Sem ele preenchido corretamente, a transmissão pode ser recusada pela API Recintos importação. Além disso, pode gerar inconsistência nos dados de peso registrados na declaração.
Existem diferentes métodos de pesagem reconhecidos pela operação aduaneira: pesagem direta, pesagem por diferença e estimativa por cubagem, entre outros. O campo obriga o recinto a declarar explicitamente qual método foi adotado. Isso aumenta a rastreabilidade. Além disso, reduz disputas sobre divergência de peso na conferência aduaneira.
Para quem opera com grandes volumes, como importadores de insumos industriais ou distribuidores, a consistência no peso declarado tem impacto direto no cálculo de tributos. Divergências de peso podem gerar autuações ou exigências de complementação de tributos pela Receita Federal.
Além disso, o campo tipoPesagem está relacionado ao encadeamento de informações que sustenta o modelo da DUIMP. Ou seja, a atualização não é isolada: ela compõe um conjunto de melhorias que a Release Paraná traz para o rastreamento de carga na API Recintos importação.
Estudo Gratuito de Importação
Preencha e nossa equipe monta uma análise personalizada para sua empresa.
Panorama legal e o contexto da Release Paraná
A Release Paraná é uma das versões de atualização do Portal Único de Comércio Exterior. Ela é coordenada pela Receita Federal e pela Secretaria de Comércio Exterior. Cada release implementa novos módulos, corrige fluxos e, frequentemente, altera contratos de API utilizados pelos agentes do comércio exterior.
A fonte oficial desta mudança é o comunicado publicado pelo Siscomex (disponível em sistemas nº 2026-009). Esse documento detalha a obrigatoriedade do campo tipoPesagem e orienta os recintos sobre como atualizar suas integrações.
Não há, até o momento, um período de tolerância publicado. Portanto, na virada da release, integrações desatualizadas simplesmente param de funcionar. Ou, pior, começam a gerar erros silenciosos. São aqueles que não travam o processo imediatamente, mas acumulam inconsistências que aparecem apenas na conferência ou no canal de parametrização.
Vale lembrar que o modelo DUIMP já substituiu a DI em várias modalidades de despacho. Ele depende fortemente da qualidade dos dados transmitidos pelos recintos. Qualquer ruído nessa transmissão se propaga para o processo de despacho do importador. Por isso, a atualização da API Recintos importação precisa ser tratada com urgência.

Checklist prático para recintos e despachantes
Se você é despachante aduaneiro ou gestor de recinto alfandegado, use este checklist para garantir que sua operação não seja impactada:
- Identifique o fornecedor do sistema de gestão do recinto e abra chamado formal solicitando a atualização do campo tipoPesagem na API.
- Solicite documentação técnica confirmando que o sistema já contempla os valores aceitos para o campo (os tipos de pesagem reconhecidos pelo Siscomex).
- Teste em ambiente de homologação antes da release entrar em produção. Não espere a virada para descobrir erros.
- Alinhe com o importador que você representa: se o recinto de destino não estiver atualizado, o problema vai aparecer na operação dele.
- Monitore os comunicados do Siscomex regularmente. Mudanças de API costumam vir acompanhadas de notas técnicas com exemplos de payload.
- Verifique se outros campos da mesma release também sofreram alteração. Releases costumam agrupar múltiplas mudanças.
Para importadores com habilitação RADAR ativa e despacho regular, vale conversar com o despachante sobre o status de atualização dos recintos mais utilizados. A responsabilidade técnica é do recinto, mas o impacto operacional cai no seu processo.
Perguntas que recebemos sobre a API Recintos
Reunimos abaixo as dúvidas mais comuns que chegam quando há mudanças de API no Siscomex:
O importador precisa fazer alguma coisa diretamente?
Não diretamente na API. A atualização é responsabilidade do recinto alfandegado e do fornecedor de sistema. Porém, o importador deve cobrar do seu despachante uma confirmação de que os recintos utilizados já estão atualizados.
O que acontece se o campo não for enviado?
A API pode rejeitar a transmissão ou registrar o evento com inconsistência. Nos dois casos, o resultado prático é atraso no despacho. Além disso, pode surgir a necessidade de retificação de dados na declaração.
Isso afeta apenas importação ou também exportação?
A API Recintos importação cobre operações de entrada e saída de carga. Portanto, recintos que operam tanto importação quanto exportação precisam revisar os dois fluxos.
Onde encontro os valores aceitos para o campo tipoPesagem?
A documentação técnica está disponível nos comunicados do Siscomex e no portal de desenvolvimento do Portal Único. Seu fornecedor de sistema deve ter acesso a esse material.
Para quem também precisa revisar como os tributos incidem sobre o valor aduaneiro declarado, vale conferir como funciona a base de cálculo de PIS e COFINS na importação. Afinal, divergências de peso e valor afetam diretamente esses cálculos.
Conclusão: atualize antes, não depois
Mudanças na API Recintos importação não dão aviso na hora em que causam problema. O erro aparece no meio de uma operação, quando a carga já está no recinto e o prazo de armazenagem corre. Agir antes da Release Paraná é a única forma de evitar esse cenário.
Se você opera como recinto, acione seu fornecedor de sistema hoje. Se você é despachante, confirme com cada recinto parceiro o status de atualização. E se você é importador, pergunte ao seu despachante: os recintos que usamos já estão prontos para a API Recintos importação?
Estudo Gratuito de Importação
Preencha e nossa equipe monta uma análise personalizada para sua empresa.
Este conteúdo tem caráter informativo e não substitui a análise técnica de um especialista em sistemas aduaneiros ou consultoria especializada em comércio exterior.
Perguntas frequentes
É um campo que passou a ser obrigatório na API Recintos do Siscomex e identifica o método utilizado para aferir o peso da mercadoria no recinto alfandegado. Sem ele preenchido corretamente, a transmissão pode ser rejeitada ou gerar inconsistências na declaração de importação.
A responsabilidade técnica é do recinto alfandegado e do seu fornecedor de sistema de gestão. Despachantes e importadores devem cobrar confirmação de que a atualização foi realizada antes da Release Paraná entrar em produção.
É uma versão de atualização do Portal Único de Comércio Exterior que implementa novos módulos e altera contratos de API utilizados pelos agentes do comércio exterior. Cada release pode tornar campos obrigatórios ou modificar fluxos existentes, exigindo atualização dos sistemas integrados.
Solicite ao fornecedor do sistema de gestão do recinto uma confirmação formal por escrito e teste o envio do campo tipoPesagem em ambiente de homologação antes da release entrar em produção. Não espere a virada para identificar erros.
