Orientações para conformidade dos recintos aduaneiros

com a API Recintos (Portaria Coana nº 72/2022)

Orientamos que os recintos alfandegados e Redex ajustem a integração do sistema informatizado de
controle aduaneiro (SICA) com a API Recintos tendo em vista a conformidade requerida pela legislação
de alfandegamento e a implementação de novas validações no decorrer do segundo semestre de
2023.

Este documento agrega as principais inconformidades verificadas. Logo, é relevante que os recintos
ajustem seus sistemas e integrações, conforme segue:

1. Documentação
a. Portaria Coana nº 72/2022
b. Perguntas frequentes
c. Documentação técnica da API Recintos (área de TI)
2. Dúvidas:
a. Sobre API Recintos: diexp.df.coana@rfb.gov.br
b. Sobre legislação de alfandegamento: digin.df.coint@rfb.gov.br
3. Orientações para todos os eventos:
a. Eventos não recepcionados:
i. Problema: Tentativas de envio de eventos errados (pacotes de dados com
sintaxe/semântica errada) em loop, sem limites de tentativas;
ii. Solução: Os recintos devem manter monitoramento de sua integração com a API
Recintos. Devem ser evitadas tentativas de envio de eventos em loop e/ou sem
limites. Orientamos que após um “x” tentativas então o recinto realize uma
análise manual do pacote de dados relativo ao evento. É relevante também que
o SICA implemente as validações necessárias na captura de dados.
b. Protocolo do evento
i. Problema: Recintos que não estão salvando o protocolo do evento enviado à API
Recintos.
ii. Solução: Para cada evento enviado pelo recinto aduaneiro à API Recintos esta
retorna um protocolo. Este protocolo é o recibo digital que comprova o envio das
informações e DEVE ser armazenado no SICA, conforme §3º e §4º do art. 19 da
Portaria Coana 72/2022. Além disso, para retificar ou excluir um evento anterior
enviado é necessário possuir o protocolo do evento alvo da retificação/exclusão.
c. Campos obrigatórios: documentação da API versus Portaria Coana nº 72/2022
i. Problema: A área de TI de diversos recintos aduaneiros menciona que estão
enviando todos os campos “obrigatórios”, ou seja, os que possuem o asterisco,
informativo de campo obrigatório, na documentação técnica da API Recintos.
ii. Solução: A Portaria Coana 72/2022, anexo III, e art. 6º c/c art. 19, rege o tema. É
importante salientar aos recintos da jurisdição o teor do art. 6º dessa portaria: "...
Art. 6º O interveniente deverá registrar em seus sistemas, para cada operação que
realizar, no mínimo, as informações de cada evento descritas nos Anexos II e III
desta Portaria, excetuadas as informações inaplicáveis ao caso em concreto...”.
Ou seja, todas as informações previstas em cada evento (anexo III) devem ser
enviadas se existirem na ocorrência do evento. Dito de outra forma, na
documentação da API (objeto de consulta pela área de TI do recinto), o número
do contêiner não possui o asterisco (sinal de campo obrigatório para a solução
 tecnológica API Recintos) pois é possível um veículo terrestre acessar o recinto
sem carga, com carga solta, com carga granel ou com carga contêiner. Logo,
quando o veículo ingressar com um ou mais contêineres então o recinto é
juridicamente obrigado a informar o campo contêiner mesmo que na API não
tenha asterisco. Em suma, todas as informações previstas em cada evento,
quando existirem na ocorrência do evento, devem ser enviadas no pacote de
dados.
d. Ausência de Georreferenciamento
i. Problema: Os recintos não estão realizando o georreferenciamento das áreas e
equipamentos.
ii. Solução: É obrigatório que os recintos realizem o georreferenciamento das áreas
e equipamentos e, posteriormente, informem o protocolo do
georreferencimento nos eventos periódicos (acessos de pessoas e veículos,
pesagens...). Quase todos os eventos possuem algum campo georreferenciado,
segue a lista dos campos de todos os eventos:
1. jsonOriginal.catraca
2. jsonOriginal.listaCameras.protocoloCamera
3. jsonOriginal.gate
4. jsonOriginal.areaVeiculos
5. jsonOriginal.areaConteiner
6. jsonOriginal.equipamento
7. jsonOriginal.balanca
8. jsonOriginal.portainer
9. jsonOriginal.areaArmazenamento
10. jsonOriginal.scanner
11. JsonOriginal.areaConferenciaFisica
e. CPF do operador do registro
i. Problema: Diversos recintos estão omitindo o CPF do operador do registro
(campo: cpfOperadorRegistro) de seus eventos.
ii. Solução: O CPF do operador do registro deve ser informado em todos os eventos,
ressalvadas as situações de informações geradas sem intervenção de funcionário
do recinto aduaneiro como por exemplo: o acesso de pessoa via catraca com
biometria/cartão ou o agendamento de acesso de veículos via portal web do
recinto aduaneiro. Vejam que estes últimos podem ocorrer sem intervenção de
funcionário do recinto.
f. Eventos repetidos
i. Problema: Diversos recintos estão enviando eventos repetidos.
ii. Solução: É esperado que a API Recintos receba 1 evento para cada 1 ocorrência
de evento no mundo real. O recinto deve acompanhar constantemente os logs do
SICA. O campo idEvento (identificador único do evento no SICA) deve ser utilizado
pelo recinto como forma de configuração de seu sistema para não enviar eventos
repetidos. Já constatamos na base da API, principalmente eventos de Controle de
Acesso de Pessoas e Credenciamento de Pessoas, eventos repetidos com mesmo
idEvento e/ou com os mesmos dados. Por exemplo, acesso de pessoa no mesmo
segundo, mesmo CPF e mesmo sentido (entrada) com 100 eventos iguais ao invés
de 1. A TI do recinto deve criar mecanismos para que isso não ocorra bem como
aperfeiçoar seus logs para monitoramento.
g. Muitas retificações
 i. Problema: Diversos recintos estão retificando eventos sem alterar informações
ii. Solução: É possível enviar um evento retificador (§3º, art. 19, PT Coana 22/2022),
porém a TI dos recintos precisam monitorar se as retificações são efetivas e, caso
não sejam, precisam adequar suas integrações com a API Recintos.
h. Omissão de documentos da operação
i. Problema: Omissão das informações dos documentos que amparam a carga (NFe,
conhecimento de carga, manifesto e/ou declaração aduaneira).
ii. Solução: Os campos referentes aos documentos da carga devem ser informados
sempre que existirem e SEM máscaras, conforme as operações de importação ou
exportação.
i. Informações com máscara
i. Problema: Os campos de documentos e de CPF/CNPJ estão sendo enviados com
máscara.
ii. Solução: Orientamos que os campos de documentos (NFe, conhecimento de
carga, manifesto e/ou declaração aduaneira) e de CPF/CNPJ sejam informados
SEM máscara.
j. Informação Escala e conhecimento do Mercante/Siscomex Carga
i. Problema: Informação escala da embarcação bem como do conhecimento de
carga na importação diferente do Mercante/Siscomex Carga.
ii. Solução: Deve-se informar a escala e CE mercante (cargas na importação)
utilizados do Mercante/Siscomex Carga.
k. Informação do CE Mercante na importação do modal aquaviário
i. Problema: Alguns recintos estão informando o BL ou o BL e o CE Mercante nos
eventos relacionados a cargas de importação do modal aquaviário.
ii. Solução: A documentação da API orienta que seja informado apenas o CE
Mercante nos eventos relacionados a cargas de importação. Logo, nos eventos
relativos a cargas de importação do aquaviário informar os documentos da carga
(CE Mercante, DI ou DTA ou outra declaração simplificada na saída da carga, NF-
E na saída de carga desembaraçada).
l. Informação do CTE
i. Problema: As cargas de exportação que chegam em terminais de cargas de
aeroporto ou de porto estão sendo enviadas sem NFE, DUE e/ou CTE. No caso do
CTE, quando este é informado, estão informando o número e não a chave
completa.
ii. Solução: Em cargas de exportação informar a chave NFE, DUE e/ou chave do CTE
sempre que existir.
4. Evento de Credenciamento de Pessoas
a. Omissão de informações: Informar o CPF ou documento de estrangeiro da pessoa
credenciada e todos os demais dados relativos ao credenciamento (validade, horário de
entrada/saída, materiais, áreas permitidas, dados do representado...).
5. Evento de Controle de Acesso de Pessoas
a. Omissão de informações: Informar o CPF ou documento de estrangeiro da pessoa.
6. Evento de Controle de Agendamento/Acesso de Veículos
a. Omissão de informações: Informar os dados do veículo, contêiner, indicador de vazio,
indicador de captura com OCR, dados do motorista e do transportador, documentos da
carga na importação (conhecimento internacional, DTA e DI/NFE quando a carga estiver
desembaraçada) ou na exportação (NFe, CTE ou conhecimento internacional quando
existir, manifesto e/ou declaração aduaneira) e as previsões de embarque sempre que
 existirem no ingresso do veículo com carga de exportação (navio de embarque, país
destino, porto de descarga, lacres e empresa de estufagem).
7. Evento de Embarque/Desembarque do Navio
a. Informações das cargas
i. Problemas: Informações incompletas que permitam identificar se é carga
contêiner, carga solta ou granel bem como da origem/destino (viagem, escala,
porto, navio e país)
ii. Solução: Prestar todas as informações que permitam identificar se é carga
contêiner, carga solta ou granel e a da origem/destino (viagem, escala, porto,
navio e país)
8. Evento de Pesagem de Veículo/Carga
a. Omissão de informações: Informar os dados do veículo, contêiner, as respectivas taras,
peso manifestado, peso quantificado em balança, indicador de vazio e indicador de
captura automática do peso.
b. Peso da balança
i. Problema: Observamos que há recintos informando o peso quantificado em
balança (campo: pesoBrutoBalanca) igual ao peso informado no manifesto da
unidade de carga ou carga (campo: pesoBrutoManifesto).
ii. Solução: A informação do peso quantificado em balança deve ser o peso real em
Kg e não ficto. Espera-se receber todas as informações pertinentes da carga ou
unidade de carga quantificada como os documentos da carga, placas de veículo,
número do contêiner, todas as taras bem como o peso manifestado e peso real
da balança.
9. Evento Inspeção Não Invasiva
a. Omissão de informações: Informar os dados do veículo, contêiner, indicador de leitura
com OCR e indicador de vazio.
b. Burla da imagem
i. Problema: Foi observado envio de imagem que não era a imagem do scanner.
ii. Solução: É necessário que o recinto se certifique que está enviado a imagem
correta, na qualidade de 800 linhas de ALTURA com colunas proporcionais e não
invertida.
c. Qualidade da imagem
i. Problema: Foi observado que a qualidade da imagem que os recintos estão
enviando não está de acordo com a documentação técnica
ii. Solução: A área de TI do recinto deve observar que a cópia da imagem do scanner,
a ser enviada na API Recintos, deve possuir a qualidade de 800 linhas (ALTURA)
com colunas proporcionais (LARGURA) e em posição correta (não invertida).
Todos os recintos devem se adequar. Limitação da API é arquivo com até 400 Kb.
Utilizar filtro Antialias/Lanczos próprio para redução de imagens.
10. Evento de Indisponibilidade de Equipamentos
a. Oscilações na disponibilidade de câmeras
i. Problema: Envio de múltiplos eventos de indisponibilidade de câmeras por meras
oscilações na rede que tornam a câmera indisponível por poucos segundos.
ii. Solução: O evento "/ext/indisponibilidade-equipamentos" tem por objeto a
informação de que um equipamento (câmera, catraca, balança rodoviária...) ficou
indisponível temporariamente bem como informar a previsão de retorno à
normalidade. Quando os equipamentos ficam indisponíveis por apenas alguns
poucos segundos na rede então essa indisponibilidade não impacta o uso do
 equipamento, por exemplo: a visualização da câmera no CFTV, o ingresso no
recinto via gate/catraca ou a pesagem (no caso da balança), etc. Logo, no caso de
câmeras, entendemos que o evento deve ser enviado apenas no caso da câmera
que fique indisponível por mais de 30 minutos ou, nos demais equipamentos,
quando efetivamente impactar o fluxo ou o uso do equipamento.
11. Evento Bloqueio/Desbloqueio de Veículo/Carga
a. Bloqueios automáticos
i. Problema: Envio de bloqueios automáticos que foram implementados no SICA.
ii. Solução: Não devem ser enviados bloqueios automáticos implementados no SICA
com a função de controle de fluxos. Por exemplo, diversos recintos implementam
bloqueios automáticos para que todo contêiner seja submetido à pesagem,
inspeção não invasiva, apresentação de documentos perante o recinto,
faturamento perante o recinto. A documentação técnica deixa claro que estes
bloqueios automáticos para controle de fluxo não devem ser enviados. Devem ser
enviados os bloqueios/desbloqueios que tiveram uma ação manual com objetivo
de bloquear uma operação/veículo/carga, por exemplo: bloqueio de veículo por
ordem judicial, bloqueio de contêiner para repesagem ou scanner, bloqueios para
conferência física, bloqueio a pedido ou operado pela RFB...
12. Evento Representantes
a. Novas representações
i. Problema: Após um credenciamento de pessoa há novas representações e os
recintos estão enviando novos eventos de Credenciamento de Pessoas.
ii. Solução: Após credenciar uma pessoa que vai acessar o recinto podem ocorrer
novas representações para a mesma pessoa neste mesmo recinto. As novas
representações de pessoa já credenciada devem ser enviadas no evento de
Representantes.
13. Evento Georreferenciamento
a. Coordenadas corretas
i. Problema: Os recintos estão realizando o georreferenciamento das áreas e
equipamentos com as coordenadas erradas;
ii. Solução: É obrigatório que os recintos realizem o georreferenciamento das áreas
e equipamentos com as coordenadas CORRETAS e, posteriormente, informem o
protocolo do georreferenciamento nos eventos periódicos (acessos de pessoas e
veículos, pesagens...). A documentação da API Recintos possui exemplo de como
deve ser informada a latitude e longitude. Basicamente devem ser informadas
com 6 casas decimais. Ressalte-se que em boa parte do BRASIL as coordenadas
são negativas. Um bom teste é colocar a coordenada (latitude e longitude) no
buscador de internet (Google Maps, por exemplo) e verificar se houve sucesso no
ponto georreferenciado. Exemplo de coordenadas no formato correto (negativas
e com 6 casas decimais):
"listaCoordenadas": [
{
"idElemento": "string",
"latitude": -23.123456,
"longitude": -48.123456
}
] ]