Integração do SAP com o Portal Único do comércio exterior: credencial, limite e aviso por evento
Como o seu SAP recebe o status do Portal Único sem digitar duas vezes e sem ser bloqueado por excesso de consulta? Veja o que o Siscomex publica, com a data em que lemos, e o que provar no SAP antes de automatizar.
A regra de acesso é do órgão. A credencial e a decisão de registrar documento são da sua empresa. O nosso trabalho está do lado do SAP: onde o status entra e a prova de que chegou certo.
Comece pela pergunta do seu papel
Quatro entradas para a mesma decisão: cada papel começa por uma dúvida própria sobre o status do processo.
01Comércio exterior
Como o status da carga e da declaração chega ao processo sem digitação dupla.
Ver o trecho do papel02Fiscal e tributário
Que prova mostra, na auditoria, que o status veio do órgão e em que hora.
Ver o trecho do papel03TI e integração
Credencial, chave, autenticação, limite e endereço de aviso por evento.
Ver o trecho do papel04Diretoria
Quem responde pelo robô, o que o órgão não garante e o que perguntar à NTT DATA.
Ver o trecho do papelO SAP não lê o Portal Único sozinho: alguém precisa integrar
O SAP guarda pedido, nota e custo. O estado oficial da carga e da declaração está nos sistemas do órgão e chega ao SAP por uma camada de integração que consulta, é avisada por evento ou depende de digitação.
O que o órgão publica
Credencial, representação, chave de acesso, autenticação, limite de consultas e aviso por evento, cada um com regra escrita.
O que o órgão não publica
Garantia de entrega do aviso, tempo de resposta e limites de todas as funcionalidades. Não foram conferidos.
O que a DFSpro prova
Que o status guardado no SAP veio do órgão, em que hora, e que a mesma informação não entrou duas vezes.
O que é norma e processo de importação está em comércio exterior no SAP. Esta página trata só do caminho da informação até o SAP, com a regra pública do órgão e a data de cada leitura, sem prometer ligação automática nem decisão por você.
Três jeitos de o SAP saber o status, e o custo de cada um
A escolha muda o volume de consultas, o risco de bloqueio e o rastro que fica para auditoria.
| Jeito | Como funciona | Custo e risco |
|---|---|---|
| Consulta periódica | Um programa pergunta ao Portal Único, de tempos em tempos, o estado de cada processo conhecido. | Quanto mais processos e menor o intervalo, mais perto do limite por hora. É o jeito mais sujeito a bloqueio. |
| Aviso por evento | O Portal Único envia uma notificação ao endereço da empresa quando o status muda, para alguns documentos. | Exige endereço seguro disponível. Não lemos garantia de entrega nem de prazo. |
| Digitação | Um analista abre o portal e copia o status para o SAP ou para uma planilha. | Custa tempo e gera erro. Sem hora da leitura nem origem, o status não tem prova. |
Para a Duimp, a página do Siscomex de 02/10/2026 orienta consultar primeiro a data da última alteração e assinar os eventos, em vez de baixar tudo de hora em hora. Lida em 16/10/2026.
Habilitação, perfil e certificado: quem pode consultar
O acesso ao Portal Único parte do cadastro da Receita Federal, e não de uma configuração do SAP.
Titular
Só empresas e representantes habilitados a operar no comércio exterior perante a Receita Federal acessam, segundo a página Integre seu sistema.
Representante
Quem atua pela empresa, como despachante ou agente, aparece no cadastro de intervenientes com vínculo próprio.
Perfil
O acesso é por perfil: agente de carga, declarante, depositário, transportador, operador portuário e terceiros, entre outros.
Certificado digital
A API usa certificados digitais, e o serviço oficial de integração exige e-CNPJ do contratante. A MP 2.200-2/2001 trata da validade jurídica do certificado ICP-Brasil.
O que cada perfil enxerga define o que o seu SAP poderá receber. Perfil errado não aparece como erro de sistema: aparece como processo que some da lista. Fontes lidas em 16/10/2026.
O vínculo que decide o que o robô enxerga
Quando falta permissão sobre um conhecimento de carga, o sistema responde que a consulta não é permitida. Não há falha técnica para alertar ninguém.
| Ponto | O que vale |
|---|---|
| Data final preenchida | O vínculo vence na data. Depois dela, o robô deixa de ver os processos do representado e recebe a resposta de consulta não permitida. |
| Data final em branco | O sistema entende validade ilimitada. Quem sai da empresa continua com acesso até alguém encerrar o vínculo. |
| Registro da resposta | O SAP precisa guardar a resposta recebida, e não só os processos que voltaram. Sem isso, o sumiço passa despercebido. |
| Responsável pelo alerta | Uma pessoa recebe o aviso quando a resposta muda para consulta não permitida. |
O manual do CCT Importação, modal aéreo (ago/2025), diz que cabe à empresa manter o cadastro atualizado, informando o fim da vigência dos representantes. Lido em 16/10/2026. Procuração eletrônica da Receita: não conferido.
Chave para sistema de terceiro: quem usa age como se fosse o dono
A documentação da API descreve o roteiro: o titular, logado com certificado, gera um par de chaves, escolhe perfis e prazo, e aceita um termo de responsabilidade.
- O sistema que se autentica com o par de chaves acessa os serviços como se fosse o proprietário da chave.
- A guarda segura é do usuário: não enviar a chave por e-mail e não guardá-la sem criptografia.
- O titular define o prazo de expiração, e o encerramento antecipado se faz por revogação, com efeito imediato.
- O uso indevido recai sobre o titular da chave, e por isso a empresa decide quem a recebe e onde ela fica.
- Ao trocar de fornecedor de integração, revogue a chave antiga e gere outra, com prazo curto.
- Registre quem gerou, para que perfis e até quando. A DFSpro não guarda chave nem certificado do cliente.
Fonte: documentação da API do Portal Único, página Chaves de Acesso, lida em 16/10/2026.
Reutilize o token: autenticar a cada chamada contraria a orientação
A autenticação devolve um token, e a documentação indica validade de 60 minutos.
- 01
Autenticar uma vez
O robô se autentica e recebe o token, com validade de 60 minutos segundo a documentação.
- 02
Reutilizar o token
Cada consulta usa o mesmo token enquanto ele for válido.
- 03
Renovar antes de expirar
Um novo pedido só sai quando o token está perto do fim.
- 04
Guardar o registro
O log mostra intervalo superior a 60 segundos entre pedidos de autenticação.
No comunicado Sistemas nº 014/2024, de 02/10/2024, o Siscomex avisou que não aceitaria pedidos sucessivos de autenticação em menos de 60 segundos, com vigência prevista em 19/01/2025.
Fontes lidas em 16/10/2026: comunicado do Siscomex e página Autenticação da API. Se a regra mudou depois, vale a página do órgão no dia.
O que o órgão publicou e como desenhar para não ser bloqueado
O limite é por usuário e por janela de uma hora. A reincidência aumenta o bloqueio.
| Ocorrência na janela | Bloqueio da funcionalidade |
|---|---|
| Primeira vez | Até o fim da janela de 1 hora em curso. |
| Reincidência | A janela corrente mais uma janela extra de 1 hora. |
| Terceira vez em diante | A janela corrente mais duas janelas, ou 2 horas. |
O erro de bloqueio traz o código PUCX-ER1001, e à 00:00 os bloqueios terminam e a contagem zera. Para consultas automatizadas à Duimp, o Siscomex informou em 02/10/2026 o limite de 1.000 consultas por hora, por usuário. Limites de outras funcionalidades: não conferidos.
Julgamento nosso: separe a credencial do robô da credencial do analista, quando o perfil permitir, para que o robô não bloqueie quem trabalha na tela. Guarde o último estado no SAP e atualize por evento ou por data de última alteração.
O que o webhook entrega e o que ele exige
O Portal Único descreve o serviço como envio de notificações sobre mudanças de status das operações em andamento.
Eventos disponíveis
DU-E, Duimp, licença (LPCO) e controle de carga de exportação, segundo a página de notificações.
Destinatários
A notificação vai a todos os representantes do CNPJ. Se dois assinam o mesmo endereço, ele recebe a notificação mais de uma vez.
Endereço da empresa
Precisa aceitar HTTPS na porta 443, com TLS 1.2 ou superior.
Falhas de envio
Há consulta de falhas, e o SAP precisa tratar o evento repetido com chave única.
Não lemos garantia de entrega nem tempo de resposta. Para drawback e outros documentos, nenhuma interface pública foi lida, e não afirmamos que exista. Lido em 16/10/2026.
Os sete estados que o SAP vai ler no modal aéreo
O manual do CCT Importação para o modal aéreo (ago/2025) descreve a carga e define, em cada situação, quem responde pelo tributo em caso de extravio ou acréscimo.
- 01
Informada
O transportador ou o agente de carga informa o conhecimento.
- 02
Manifestada
A viagem e o conhecimento estão no sistema.
- 03
Em área de transferência ou não descarregada
Situação que acompanha a chegada da viagem.
- 04
Recepcionada
O depositário gera o lote e recebe a carga.
- 05
Em troca entre recintos
A carga muda de recinto.
- 06
Em trânsito terrestre
A carga segue para outro local.
- 07
Entregue
A entrega fica registrada.
Para o modal aquaviário, o manual não foi conferido. O mercado costuma chamar o sistema aquaviário de Siscarga, e a documentação oficial lida o chama de Siscomex Carga. A equivalência é julgamento nosso.
Não misture o que o órgão diz com o que a empresa fez
Seis erros comuns em portal de acompanhamento, e como o SAP os evita.
Status misturado
Desembaraçado, do órgão, ao lado de pago, da empresa, sem dizer a origem. Cada status leva sua origem.
Defasagem escondida
O status mostra a última leitura. Sem a hora, parece tempo real.
Bloqueio escondido
Carga bloqueada que aparece como em andamento. O motivo do bloqueio precisa aparecer.
Chegada sem definição
Chegada da viagem, presença de carga e recepção no recinto são marcos distintos no manual. Escolha um e escreva a regra.
Prazo legal como SLA
Prazo de lei não é compromisso do prestador. SLA existe quando está em contrato.
Portal sem dono
Ninguém corrige o status errado e a confiança some. Nomeie um responsável.
Motoristas e representantes aparecem nas respostas
A resposta do órgão pode trazer CPF e nome de pessoas físicas.
- 01
Finalidade e necessidade
A LGPD, no art. 6, pede finalidade, adequação e necessidade. Guarde só o que o processo precisa.
- 02
Segurança
O art. 46 exige medidas de segurança. Limite quem vê o campo pessoal no SAP.
- 03
Prazo de guarda
Quanto tempo guardar é decisão do cliente. Nós registramos a regra e provamos que ela roda.
Informação pessoal exige cuidado redobrado na integração. Fontes lidas em 16/10/2026: Lei 13.709/2018 e página da ANPD sobre direitos do titular. A base legal de cada caso é análise do seu jurídico.
Seis cenários de prova antes de ligar o robô
Julgamento nosso: guardar o último estado, a hora da leitura, a origem e uma chave única que evite duplicidade.
| Cenário | Como provar | Evidência que fica |
|---|---|---|
| Representação vencida | Simule a data final vencida e confira o alerta. | Resposta de consulta não permitida e o aviso ao responsável. |
| Limite excedido | Rode volume acima do limite em ambiente de teste do robô. | Código PUCX-ER1001 tratado e nova tentativa depois da janela. |
| Evento duplicado | Envie o mesmo evento duas vezes. | Um único registro, com contagem conferida. |
| Status que volta atrás | Grave um estado e depois um anterior. | Regra escrita sobre qual vale, e histórico preservado. |
| DI substituída por Duimp | Acompanhe o mesmo processo nas duas declarações. | Vínculo único com o pedido, sem perder o histórico. |
| Troca de despachante | Revogue um vínculo e crie outro. | Processos antigos e novos visíveis ao responsável certo. |
Onde o estado entra no SAP, em que campo e com que alerta é desenho de implantação. Veja integração fiscal com BTP e API, parametrização fiscal e testes fiscais. A nota de entrada da importação está em NF-e de entrada, Duimp e nota de importação.
O que a NTT DATA descreve, com data de leitura
O GUEPARDO é produto da NTT DATA. O que segue é a descrição pública dela, lida em 16/10/2026, e não medição nossa.
Robôs
Segundo a NTT DATA, leem dados em sites e servidores do Governo, comparam com os demais módulos e emitem alertas. Para o controle de carga aquaviário, falam em leitura periódica de novas cargas, sugerida a cada 3 horas.
Registro no órgão
A NTT DATA diz que o registro no Siscomex ocorre quando autorizado pelo usuário. Quem autoriza é a sua empresa.
Follow-up WEB
Segundo a NTT DATA, é um portal de relacionamento em que o cliente do importador, do exportador ou do prestador acompanha os processos, com acesso por empresa e usuário.
A frequência sugerida pela NTT DATA não é regra do órgão. Se ela cabe nos limites oficiais depende do volume de identificadores, e não foi conferido. O sem custo por consulta, no texto da NTT DATA, refere-se à licença do software e não altera limite do órgão.
Perguntas para a NTT DATA
- O robô consulta por limite ou usa aviso por evento?
- Como o produto trata a Duimp e o limite de 02/10/2026?
- Onde ficam a chave de acesso e o certificado do cliente, e com quem?
- O registro automático no órgão pede aprovação humana, e onde fica o rastro?
Para ler mais
O produto como um todo: GUEPARDO Global Trade. O conjunto dos módulos está no hub dos módulos, e a emissão de documentos no GUEPARDO e-Invoicing.
Desenha, configura e prova; a credencial é do cliente
A DFSpro faz
- Define onde o status entra no SAP, em que campo e com que alerta.
- Configura a integração e a conciliação com o pedido e a nota.
- Prova cada cenário, com evidência e data.
- Como Canal Autorizado, licencia o GUEPARDO da NTT DATA, implanta o produto e acompanha a governança.
Fica com o cliente
- Certificado, chave de acesso e representação.
- A decisão de registrar documento no órgão sem aprovação humana.
- A tese tributária e aduaneira.
- O prazo de guarda do dado pessoal.
Quem define o quê, e quem decide
A regra de acesso, de limite e de aviso é do Siscomex, e esta página a resume com a data em que foi lida. A credencial e a decisão de registrar documento no órgão são do seu time. A DFSpro desenha, configura e prova como o seu SAP recebe e guarda o status.
Quem publicou cada informação, e quando
Siscomex e gov.br
- Autenticação no Portal Único (Sistemas nº 014/2024, 02/10/2024)Lido em 16/10/2026
- Limite de consultas automatizadas à Duimp (02/10/2026)Lido em 16/10/2026
- Integre seu sistema (atualizado em 02/10/2026)Lido em 16/10/2026
- Integra COMEX, serviço gov.br (última modificação 15/12/2025)Lido em 16/10/2026
- Manual CCT Importação, modal aéreo (ago/2025)Lido em 16/10/2026
API do Portal Único
Não conferido: limites por funcionalidade além da Duimp, custo do Integra COMEX, estados de carga do modal aquaviário, garantia de entrega do aviso, termos de uso formais de automação e a procuração eletrônica da Receita. Releia a página do órgão no dia em que for decidir.
Perguntas frequentes sobre a Integração com o Portal Único
01O meu robô pode usar a mesma credencial do meu analista?+
Tecnicamente pode, mas o limite é por usuário e por janela de uma hora, e um robô que consulta de hora em hora pode bloquear o analista. Separar as credenciais, quando o perfil permitir, é julgamento nosso.
02Quem responde se o robô errar um registro no órgão?+
O titular da credencial, porque quem usa a chave age como se fosse o proprietário. Por isso o registro automático, sem aprovação humana, é decisão da sua empresa.
03O que acontece quando o órgão muda um limite de consulta?+
O Siscomex publicou novo limite para a Duimp em 02/10/2026. O desenho precisa de monitor de mudança de regra e de tratamento do erro de bloqueio, em vez de depender de um valor fixo.
04Como sei que o robô parou de ver meus processos?+
A representação vencida devolve consulta não permitida, sem erro de sistema. O SAP precisa guardar essa resposta e avisar um responsável, e não só listar o que voltou.
05Dá para o SAP ser avisado em vez de consultar de hora em hora?+
O Portal Único oferece aviso por evento para alguns documentos e exige um endereço HTTPS da empresa. A garantia de entrega e o tempo de resposta não foram lidos, então o desenho mantém uma consulta de conferência.
06Quantos processos por mês justificam automatizar?+
Não há número oficial. Abaixo de um volume em que a consulta manual cabe no dia do analista, o robô pode custar mais do que poupa. É julgamento, e não medida.
07Que prova eu tenho, na auditoria, de que o status veio do órgão?+
A hora da leitura, a origem, a resposta guardada e uma chave única por processo. Sem esses quatro itens, o status equivale a uma digitação.
08O robô guarda dado pessoal de motorista ou representante?+
A resposta do órgão pode trazer. Finalidade, necessidade e prazo de guarda são decisão da sua empresa, com a LGPD como base, e a análise jurídica é do seu time.
09O meu despachante já consulta por mim. Os dois entram em conflito?+
O limite é por usuário, e cada um usa a sua credencial. O conflito possível é de duplicidade de registro no SAP, que a chave única por processo resolve.
10Quanto custa o serviço oficial de integração e quem contrata?+
O serviço Integra COMEX é contratado na loja do Serpro, por faixa de volume, e quem contrata é o titular do certificado. Os valores não foram conferidos.
11O que muda no desenho quando a DI some e fica só a Duimp?+
Pelo cronograma do Siscomex, a DI é desligada operação a operação, e a LI segue existindo. O desenho aceita as duas declarações durante a transição e guarda a data de cada leitura.
12A DFSpro opera o robô?+
Não. Do lado do SAP, a DFSpro desenha, configura e prova o caminho do status. Como Canal Autorizado, também licencia o GUEPARDO da NTT DATA. Credencial e decisão de registrar no órgão ficam com a sua empresa.
Conte como o status do processo chega hoje ao seu SAP
A conversa trata do seu ambiente, da credencial e da prova que a auditoria vai pedir. Conte como o status chega hoje, quem consulta e onde ele fica guardado.
Para aprofundar antes: integração fiscal com BTP e API.