Recintos
-
-
GERAL
Qual o cronograma previsto para a implantação da API do Módulo Recintos?
Resposta (atualizada em 16/11/2022):O projeto iniciou no segundo semestre de 2019.Há 22 eventos mapeados e que foram desenvolvidos na API.Cronograma:
- abril/2020: 11 eventos foram disponibilizados em ambiente de validação;
- dezembro/2020: outros 11 eventos foram disponibilizados em ambiente de validação, ou seja, todos os endpoints estão disponíveis para testes;
- julho/2021: atualização do ambiente de validação/treinamento;- 03/11/2022: atualização do ambiente de validação/treinamento;- 13/11/2022: implantação do ambiente de produção;
- 01/12/2022: obrigatoriedade;Quais as Notícias Siscomex Sistemas foram publicadas sobre o tema?
Resposta (atualizada em 16/11/2022)::As seguintes Notícias Siscomex foram publicadas durante o projeto:Sistemas n° 004/2024 (Novos campos e novas validações)Sistemas n° 008/2023 (Novas validações)Sistemas n° 007/2022 (Orientações gerais sobre o ambiente de produção e treinamento)Sistemas n° 003/2022
Sistemas n° 001/2022
Sistemas n° 002/2021
Sistemas n° 012/2020
Sistemas n° 011/2020
Sistemas n° 004/2020
Sistemas n° 010/2019
Sistemas n° 006/2019Quais intervenientes devem enviar eventos na API do Módulo Recintos?
Resposta:Os perfis de autenticação que devem ser utilizados pelas empresas são: a) Depositário (DEPOSIT) ou b) Operador Portuário (OPERPORT). O processo de autenticação deve ser executado conforme descrito em Autenticação PUCOMEX.
Devo utilizar e-CPF ou e-CNPJ para autenticação e posterior envio dos eventos?
Resposta (atualizada em 27/10/2022, alteração de forma):O envio de eventos na API-Recintos pressupõe a autenticação no Portal Único Siscomex com e-CNPJ.
Qual o código de recinto devo utilizar ao enviar eventos na API Recintos?
Resposta:O campo "codigoRecinto" deve ser informado obrigatoriamente em todos os eventos transmitidos na API Recintos.A documentação técnica da API apresenta a descrição do campo:Campo: codigoRecinto
Descrição: Código Siscomex do recinto onde ocorreu o evento a ser transmitido.Os perfis de autenticação que devem ser utilizados pelas empresas são: a) Depositário (DEPOSIT) ou b) Operador Portuário (OPERPORT).O depositário, inclusive quando executar atividades de operador portuário em seu próprio recinto, pode enviar todos os eventos com a autenticação DEPOSIT. Deve informar, no pacote de dados a ser transmitido, o seu código de recinto (codigoRecinto), ou seja, o código do recinto onde ocorreu o evento a ser transmitido.Caso o interveniente atue exclusivamente como operador portuário, ou seja, não acumule ambas as atuações (depositário e operador portuário) no recinto de ocorrência do evento, então ele deve usar o perfil OPERPORT para autenticação. Enfatiza-se que o código de recinto (codigoRecinto), indicado no pacote de dados, deve refletir o recinto onde, de fato, ocorreu o evento a ser transmitido.
Devo utilizar e-CNPJ da filial ou da matriz para autenticação e posterior envio dos eventos?
Resposta:Cada recinto deve utilizar o seu e-CNPJ de filial para autenticação e envio dos dados pois é esse CNPJ que está associado ao recinto aduaneiro dentro do cadastro.
Ao testar a integração no ambiente de validação/treinamento posso entrar em contato com Serpro por canal específico?
Resposta (atualizada em 17/11/2022, alteração de forma):As dúvidas ou problemas tecnológicos relacionados à API devem ser tratadas com o Serpro: Clique aqui.Orientamos que no contato com Serpro seja indicada a request e a response das chamadas.Dúvidas de negócio: diexp.df.coana@rfb.gov.brCaso se trate de uma orientação de preenchimento de atributos podemos incorporar ao Perguntas Frequentes.
Posso enviar eventos de passivo com data anterior ao início de vigência do recinto no Cadastro Aduaneiro?
Resposta:Há regra de negócio na API Recintos que impede o envio de eventos com data e hora de ocorrência anterior ao início de vigência do recinto no Cadastro Aduaneiro.Entretanto há situações em que o recinto possui um passivo a ser enviado cuja data de ocorrência do evento é uma data anterior a data de início de vigência do recinto com o CNPJ da empresa atual.Por exemplo, quando a empresa se torna a nova administradora de local ou recinto alfandegado ou, ainda, há alteração de CNPJ por alterações societárias.O seguinte erro é retornado pela API: “CNPJ `<xxx>` não habilitado com o perfil `<xxx>` para o Recinto Aduaneiro `<xxx>` na Data de Ocorrência do evento: `<xxx>`.”Orientamos que, nestes casos, o recinto considere a data de início de vigência de seu recinto no Cadastro Aduaneiro como sendo a data de ocorrência do evento.Ressaltamos que o servidor da API Recintos possui horário sincronizado com o protocolo NTP.BR. Orientamos que os recintos sincronizem os servidores envolvidos na geração e transmissão dos eventos com o mesmo protocolo.
Quais validações existem sobre os atributos data e hora de ocorrência ou registro informados nos eventos?
Resposta:A API Recintos possui regra de negócio que impede o envio de eventos no futuro, ou seja, não permite enviar um evento com data e hora de ocorrência ou de registro maior que a data/hora atual. A API valida se a dataHoraOcorrencia* <= dataHoraRegistro* <= dataHoraTransmissao***informada no evento (JSON) pelo recinto**gerada pelo Serpro na recepção do eventoRessaltamos que o servidor da API Recintos possui horário sincronizado com o protocolo NTP.BR. Orientamos que os recintos sincronizem os servidores envolvidos na geração e transmissão dos eventos com o mesmo protocolo.
Como o Recinto poderá verificar se o estoque no ADE02 está batendo com o estoque físico do terminal? Atualmente na DTE, geramos um arquivo do estoque no sistema do recinto no layout definido pela DTE e encaminhamos à ABTRA. Este arquivo é comparado com o estoque informado no sistema DTE (através dos eventos enviados em todas as operações) e devolve ao recinto um relatório com as divergências entre os sistemas. Este relatório é gerado diariamente e as divergências são corrigidas imediatamente pelo recinto.
Resposta:O Módulo Recintos é uma API para recebimento de informações dos recintos aduaneiros.Para cada envio de eventos será devolvido um protocolo que atesta o recebimento das informações prestadas.Demandas por funcionalidades ou consultas que auxiliem a conformidade do recinto aduaneiro poderão ser estudadas nos moldes das iniciativas INTEGRA COMEX, por demanda dos intervenientes.
Existe uma ordem para envio dos endpoints disponibilizados? A ordem deverá seguir o fluxo de acordo com a ocorrência das operações no terminal, sem interrupções, independente de recusas de XMLs de pacotes anteriores relacionados à informação deste pacote?Exemplos:Ao enviar a informação de saída de um contêiner do terminal, caso o JSON da entrada deste contêiner tenha sido recusado, o terminal deve mesmo assim enviar o JSON da saída? Estes pacotes serão recusados caso os pacotes anteriores relacionados não estejam aceitos? O terminal deve obrigatoriamente corrigir o pacote de entrada antes de enviar o de saída?Caso não tenha sido enviado o JSON de credenciamento de uma pessoa física, o terminal deve mesmo assim enviar o JSON de acesso da entrada e saída desta pessoa da área alfandegada? Estes pacotes serão recusados caso os pacotes anteriores relacionados não estejam aceitos? O terminal deve obrigatoriamente enviar o credenciamento do usuário antes de enviar movimentação para este usuário?
Resposta (atualizada em 27/10/2022, alteração de forma):Há algumas premissas no projeto da API Recintos que visam facilitar o envio dos eventos:- O registro e envio dos eventos, via de regra, deve ocorrer de forma simultânea à ocorrência física, ou seja, em ordem cronológica, conforme a ocorrência de eventos com pessoas, veículos, cargas ou unidades de carga no recinto aduaneiro;
- Os eventos são independentes, ainda que no mundo real haja um sequencialismo oriundo da logística e operações;
Ou seja, se há um evento em contingência os eventos posteriores podem e devem ser enviados.Respondendo os exemplos apresentados na questão:- Para a API os eventos são independentes e é possível enviar um evento sem que o antecessor dele (pela ordem logística) tenha sido enviado. É possível que a TI organize uma fila de envio de eventos em contingência para essas situações. Sempre lembrando que a regra é o item 1 (em ordem cronológica), porém, nos casos de contingência ou não recepção do evento, o recinto deve corrigir e/ou reenviar o pacote de dados (JSON);
- A mesma lógica é aplicável para o exemplo do credenciamento de pessoa e o acesso de pessoa. O credenciamento, via de regra, deve ocorrer antes. Porém a API permite o envio do evento "Controle de acesso de pessoas" antes do evento de "Credenciamento de pessoas" visto que os eventos são independentes para a solução tecnológica.
Dessa forma, acreditamos dar a flexibilidade necessária no envio de eventos. Salientamos que o envio fora de ordem deve ser motivado (recusa do pacote, contingência, retificação...).
Existe algum limite de envio de requisições por segundo/minuto ou os eventos poderão ser enviados no momento que ocorrem, independentemente da quantidade?
Resposta (atualizada em 27/10/2022, alteração de forma):A Portaria Coana 72/2022 estabelece que o registro no SICA e o envio à API Recintos devem ser tempestivos:"...Art. 5º O registro de informações relativas às operações de entrada e saída de pessoas e veículos, movimentação de carga e armazenamento de mercadorias no SICA deverá ser executado simultaneamente à ocorrência física das operações.§ 1º Entende-se por registro simultâneo de informações aquele realizado no SICA com lapso temporal de até 1 (um) minuto em relação à ocorrência física das operações ou a hipótese a que se refere o art. 22....Art. 19. O sistema do interveniente deverá funcionar de forma ininterrupta e permitir o envio de eventos à API-Recintos de forma simultânea e integrada com o registro de informações relativas às operações executadas nos locais ou recintos alfandegados ou autorizados a operar com mercadorias sob controle aduaneiro...."Logo, em ambiente de produção os eventos devem ser registrados no SICA e enviados à API de maneira tempestiva e na medida em que ocorrem no mundo real.Nota: O ambiente de treinamento/validação deve ser utilizado de forma racional, ou seja, para testar a autenticação, as validações e o JSON que deve ser enviado, vide Notícia Siscomex Sistemas nº 002/2021.Qual a diferença entre o ID evento(chave) ou protocolo solicitado nos eventos? Todos campos são obrigatórios? Existe um padrão na API em geral para envio desses campos?
Resposta (atualizada em 27/10/2022, alteração de forma):O campo idEvento, atributo básico de todos os eventos, deve indicar, conforme a documentação técnica, os registros das tabelas do sistema do recinto de onde saíram os dados que compõem o evento. Por exemplo: chave tabela 1+ … + chave tabela n - tantas chaves quantas forem as tabelas necessárias para montar o registro do evento. Em caso de auditoria, permite que a RFB localize os dados no sistema do recinto.Em boa parte dos eventos é requisitado o protocolo de áreas ou equipamentos georreferenciados (vide seção do evento Georreferenciamento) indicando a área ou equipamento relacionado ao evento, logo é necessário enviar o protocolo relacionado ao prévio cadastro da área/equipamento em questão.São campos distintos com funções diferentes.
Os campos CPF do operador da ocorrência e CPF do operador do registro são obrigatórios?
Resposta (atualizada em 27/10/2022, alteração de forma):Cabe observar o §2º, art. 19, da Portaria Coana 72/2022:"...Art. 19...§ 2º Todos os eventos enviados à API-Recintos devem conter o CPF do preposto que realizou o registro das informações no sistema informatizado do interveniente, ressalvados os casos de informações coletadas automaticamente...."Logo, o CPF do operador da ocorrência e/ou do registro devem ser informados, ressalvadas situações de informações geradas sem intervenção de funcionário do recinto aduaneiro. Por exemplo, o acesso de pessoa via catraca com biometria ou o agendamento de acesso de veículos via portal web do recinto aduaneiro.
Os endpoints Atribuição/Troca de Navio, Embarque/Desembarque no Navio e Posição do Contêiner estão fora do escopo de armazém alfandegado Aéreo, correto?
Resposta:Há eventos mapeados para a API Recintos que são comuns a todos os modais (exemplo: acesso pessoas, acesso veículos, dentre outros) e há eventos próprios de um e outro modal, por exemplo: Atribuição/Troca Navio e Embarque/Desembarque de Navio, ambos para o aquaviário; Chegada ao Ponto Zero, na importação do modal aéreo.Cada recinto aduaneiro vai implementar a integração com os endpoints do seu ramo de operação.
Como faço para retificar informações em eventos já enviados? Devo enviar apenas parte retificada do evento ou todo novamente?
Resposta (atualizada em 27/10/2022, alteração de forma):Cabe observar o §3º, art. 19, da Portaria Coana 72/2022:"...Art. 19...§ 3º O envio de eventos retificadores substitui completamente as informações prestadas no evento retificado...."Observar que no caso de evento retificador ou de exclusão, é obrigatório que o protocolo do evento retificado ou excluído seja informado para possibilitar a correta vinculação.
Como deve ser o cancelamento de eventos já enviados? Devo informar todos os atributos do evento original?
Resposta:Para cancelamento ou exclusão de eventos enviados anteriormente é suficiente o preenchimento do cabeçalho do evento, indicando, obrigatoriamente, o "Protocolo do Evento retificado / excluído" (protocoloEventoRetificadoOuExcluido).
Em relação a "dataHoraOcorrencia", "dataHoraRegistro", "cpfOperadorOcorrencia" e "cpfOperadorRegistro", a distinção entre as informações de data e CPF de ocorrência e de registro é aplicada nos casos em que o sistema está fora do ar e nos demais casos as informações de ocorrência e registro seriam as mesmas? Ou seja, as informações de data e CPF de ocorrência somente serão diferentes da data e CPF de registro se a TAG "contingencia" for "true"?
Resposta (atualizada em 27/10/2022, alteração de forma):Via de regra a "dataHoraOcorrencia" e "dataHoraRegistro" bem como "cpfOperadorOcorrencia" e "cpfOperadorRegistro" devem ser os mesmos quando não ocorrer contingência. Entretanto, também podem ser diferentes em situações em que não haja contingência, por exemplo: uma retificação.Os campos "cpfOperadorOcorrencia" e "cpfOperadorRegistro" podem ser transmitidos nulos. Considerar, por exemplo, o registro de entrada de pessoas pela catraca automatizada com biometria. Não há operador de ocorrência e nem de registro já que tudo pode ser automatizado.Por outro lado, em caso de pane na mesma catraca e/ou sistema de biometria, por exemplo, estes campos serão preenchidos quando do envio do evento pois houve uma entrada de pessoa com captura e registro manual de informações (CPF operador ocorrência) e a inserção (digitação) dos dados coletados em papel no sistema informatizado (CPF operador registro sistema).
Em caso de indisponibilidade da Ferramenta (sistema) dos Terminais para envio de informações para a aplicação API – Recintos existe alguma forma de contingência para informar os dados? (Algum portal para lançar estas informações?) Como devemos proceder em uma situação destas?
Resposta (atualizada em 27/10/2022, alteração de forma):Cabe observar o art. 22, da Portaria Coana 72/2022:"...Art. 22. Na hipótese de falha operacional que impossibilite o registro ou envio das informações de forma simultânea à ocorrência física das operações, o interveniente deverá adotar medida de contingência que possibilite registro no SICA e o envio das informações à API-Recintos tão logo seja restabelecida a operacionalidade do sistema afetado.§ 1º A medida de contingência citada no caput deve permitir registrar, para cada indisponibilidade de sistema, a sua causa, o seu horário de início e término, e as ações corretivas implementadas.§ 2º As informações previstas no § 1º deste artigo deverão ser armazenadas por, no mínimo, 5 anos e disponibilizadas à RFB sempre que solicitado.§ 3º Na hipótese de que trata o caput, os eventos deverão ser registrados no SICA e transmitidos à API-Recintos com indicador de contingência quando do restabelecimento do sistema...."O único padrão disponibilizado para estes serviços é o formato JSON? XML não existe no momento?
Resposta:O único padrão é o JSON.
Realizando alguns testes de envio percebemos que a API aceita o envio do mesmo "ID EVENTO" para a operação de inclusão mais de uma vez. Gostaríamos de saber como seria este comportamento. Quando for enviado o mesmo "ID EVENTO" mais de uma vez para o mesmo evento para operação de inclusão. Como vocês procedem? Consideram o último envio? ou tratam de outra forma?
Resposta:Os campos “idEvento” e “tipoOperacao” fazem parte das informações comuns a todos os eventos, as quais devem ser agregadas pelo interveniente responsável pelo seu envio.O campo “tipoOperacao” possui os domínios: Inclusão, Retificação ou Exclusão. Esse campo determina se um evento foi recepcionado como um evento novo ou retificador/exclusão.No caso de retificação ou exclusão de eventos, há a obrigação de informar o protocolo do evento retificado ou excluído para possibilitar a correta vinculação.O envio de eventos retificadores substitui completamente as informações prestadas no evento retificado.O campo “idEvento” deve indicar os registros das tabelas do sistema do recinto de onde saíram os dados que compõem o evento. Logo, é o identificador do evento no Sistema do Recinto. Por exemplo, pode ser composto por: Chave tabela 1+ … + chave tabela n - tantas chaves quantas forem as tabelas necessárias para montar o registro do evento. Em caso de auditoria de sistema, permite que a RFB localize os dados no sistema do recinto.Para o campo “idEvento” não há validação, ou seja, o padrão adotado pelo recinto aduaneiro como identificador do evento será recebido neste campo.Exemplificando: se a API do Módulo Recintos receber 2 eventos “tipoOperacao=Inclusão” vamos considerar 2 ocorrências no mundo real, uma para cada evento.
Caso o sistema de controle de acesso de pessoas fique off-line, devemos anotar no formulário de contingência e posteriormente entrar com esses dados no sistema de forma manual?
Resposta (atualizada em 27/10/2022, alteração de forma):Cabe observar o art. 22, da Portaria Coana 72/2022:"...Art. 22. Na hipótese de falha operacional que impossibilite o registro ou envio das informações de forma simultânea à ocorrência física das operações, o interveniente deverá adotar medida de contingência que possibilite registro no SICA e o envio das informações à API-Recintos tão logo seja restabelecida a operacionalidade do sistema afetado.§ 1º A medida de contingência citada no caput deve permitir registrar, para cada indisponibilidade de sistema, a sua causa, o seu horário de início e término, e as ações corretivas implementadas.§ 2º As informações previstas no § 1º deste artigo deverão ser armazenadas por, no mínimo, 5 anos e disponibilizadas à RFB sempre que solicitado.§ 3º Na hipótese de que trata o caput, os eventos deverão ser registrados no SICA e transmitidos à API-Recintos com indicador de contingência quando do restabelecimento do sistema...."Sempre que algum recurso apresenta falhas (catraca, ocr, balanças, o próprio sistema informatizado de controle do recinto, etc) os dados devem ser coletados de forma manual e inseridos no sistema do recinto assim que possível.Com a nova API o que muda é que além de lançar os dados no sistema é necessário, ainda, enviar os eventos correspondentes imediatamente após o restabelecimento do SICA.Verificar, ainda, que há informações nos pacotes sobre os CPFs de quem coletou os dados em papel e de quem inseriu os mesmos no sistema do recinto.Os seguintes campos devem ser corretamente preenchidos, conforme a documentação técnica:- Data e Hora da ocorrência do eventoDesc: Data e hora em que o evento ocorreu ou que se coletou, em formulário papel durante uma contingência, os dados do evento.- Data e Hora do registro do eventoDesc: Data e hora em que se efetuou o lançamento, no sistema informatizado, seja em operações normais, seja das informações coletadas durante uma contingência.- CPF operador ocorrênciaDesc: CPF da pessoa que coletou, em formulário papel, durante uma contingência, os dados do evento.- CPF operador registro sistemaDesc: CPF da pessoa que efetuou o lançamento, no sistema informatizado, seja em operações normais, seja das informações coletadas durante uma contingência.- Contingência [S/N]Desc: Indica que este evento ocorreu durante uma contingência. Via de regra deverá haver um evento (Ocorrências de indisponibilidade de equipamentos) para o equipamento envolvido. Transmitir como true sempre que ocorrer falha operacional no sistema do recinto que impeça o registro e/ou envio de informações em seu sistema.
Os eventos aplicam-se para cargas de cabotagem?
Resposta:Toda carga dentro de área autorizada ou alfandegada está sujeita ao controle aduaneiro e, portanto, os eventos gerados devem ser transmitidos na API.
Para um terminal especialista em exportação existe alguma tratativa especial para cargas que serão devolvidas para o exportador por qualquer razão?
Resposta:Do ponto de vista da API, não. Os eventos mapeados devem ser transmitidos sempre que ocorrerem.
Operadores de cais público também deverão prestar informações no perfil "Operador Portuário"?
Resposta:Sim.
Há prestadores de serviço que ingressam no recinto, por exemplo: coleta de lixo, retirada de sucatas, mecânicos e eletricistas. Devemos enviar eventos relacionados a esses acessos?
Resposta:Todos os acessos de pessoas e/ou veículos ao recinto devem ser enviados./ext/credenciamento-veiculos
Todo veículo que ingressa no recinto deve estar credenciado.
Um dos campos desse evento é "Áreas permitidas de acesso" e neste campo devem ser identificadas as áreas que o veículo prestador de serviço pode acessar. Por ser campo livre, é possível informar a finalidade desse acesso. Por exemplo: "área A2.5.1 - Coleta de lixo"/ext/credenciamento-pessoas
Toda pessoa que ingressa no recinto deve estar credenciada.
Além do campo "Áreas permitidas de acesso", devem informar os campos "Materiais/ferramentas de trabalho" e "Motivação do credenciamento".
Por meio desses campos é possível deixar explícito tratar-se de prestador de serviço./ext/acesso-pessoas
Todo acesso de pessoa ao recinto deve ser enviado à API, exceto se ingressar conduzindo veículo(motorista).
Neste caso as informações do motorista constam do próprio evento de Acesso Veículo./ext/acesso-veiculos
Todo acesso de veículo ao recinto deve ser enviado à API, incluindo as informações do motorista, dentre outras pertinentes.No json a ser enviado, como devemos informar campos quando não contiverem valores?
Resposta (atualizada em 27/10/2022, alteração de forma):Cabe observar o art. 6º, da Portaria Coana 72/2022:"...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...."Atributos não obrigatórios, quando inaplicáveis ao caso em concreto, devem ser transmitidos nulos(null) ou omitidos do pacote JSON.
Como devo acessar os domínios disponíveis no sistema Tabelas Comex (TabX)?
Resposta:Os domínios que já foram migrados para o novo sistema de tabelas do Portal Único, Tabelas Comex (TabX), são acessíveis pelo link disponível na descrição do campo ou via acesso direto ao Portal Único. Utilizar o eCPF ao logar no Portal Único para acessar o TabX.Abaixo, por exemplo, segue o campo pais constante da documentação técnica da API Recintos com descrição e link:Ao ser redirecionado para tela de login do Portal Único, efetue o login, conforme o perfil de usuário:Nesta tela é possível consultar domínios ou realizar o download da tabela vigente: -
Situações que demandam o envio de passivo
Quais são as situações que demandam o envio de passivo?
Resposta (atualizada em 27/10/2022, alteração de forma):As situações abaixo demandam envio prévio do passivo do recinto, considerando o momento de entrada em produção da API Recintos, conforme item 3, Anexo III, da Portaria Coana 72/2022:
Lista de Pessoas CadastradasEnviar um evento de Credenciamento de Pessoas (Item 2.1) para cada pessoa cadastrada para acesso aos locais ou recintos mencionados no art. 1º desta Portaria cujo credenciamento esteja vigente.
Lista de Veículos CadastradosEnviar um evento de Credenciamento de Veículos (Item 2.3) para cada veículo cadastrado para acesso aos locais ou recintos mencionados no art. 1º desta Portaria cujo credenciamento esteja vigente.
Lista de Representantes CadastradosEnviar um evento de Representantes (Item 2.17) para cada representação registrada que esteja vigente.
Lista de Objetos GeorreferenciadosEnviar um evento de Georreferenciamento (Item 2.21) para cada área ou equipamento.
Situação do Pátio de ContêineresTransmitir a situação atual do pátio de contêineres.O recinto deve estabelecer um “marco temporal” e listar todas as unidades de carga que estão presentes no pátio naquele momento. Para cada uma delas, transmitir um evento de Acesso Veículos (Item 2.4), se a unidade entrou pelo Gate ou Desembarque Navio (Item 2.15), caso tenha chegado em navio. Em seguida, transmitir um evento de Posição Pátio Contêiner (Item 2.8) com os dados da localização da unidade no marco temporal escolhido. Por fim, um evento Atribuição / Troca Navio (Item 2.14) para cada contêiner que vai embarcar (exportação, transbordo, trânsito).Situação das cargas armazenadasTransmitir a situação atual dos armazéns de cargas. O recinto deve estabelecer um “marco temporal” e listar todas os lotes de carga que estão presentes no armazém naquele momento. Para cada um deles, transmitir um evento de Geração de Lotes (Item 2.9) e, em seguida, um evento de Armazenamento de Lote (Item 2.10) com os dados da localização do lote no marco temporal escolhido.
Situação do Pátio VeículosTransmitir a situação atual do pátio de veículos. O recinto deve estabelecer um “marco temporal” e listar todos os veículos que estão no pátio naquele momento. Para cada veículo deve transmitir um evento de Acesso Veículos (Item 2.4) referente ao ingresso do veículo no recinto.
Os dados dos pacotes de eventos passivos (enviados apenas na geração do estoque inicial) terão as mesmas estruturas e campos dos pacotes dos eventos enviados periodicamente?
Resposta:Sim, terão a mesma estrutura.Caso alguns atributos não tenham sido capturados na época então não há o que transmitir nesses campos.
Posso enviar eventos de passivo com data anterior ao início de vigência do recinto no Cadastro Aduaneiro?
Resposta:Há regra de negócio na API Recintos que impede o envio de eventos com data e hora de ocorrência anterior ao início de vigência do recinto no Cadastro Aduaneiro.Entretanto há situações em que o recinto possui um passivo a ser enviado cuja data de ocorrência do evento é uma data anterior a data de início de vigência do recinto com o CNPJ da empresa atual.Por exemplo, quando a empresa se torna a nova administradora de local ou recinto alfandegado ou, ainda, há alteração de CNPJ por alterações societárias.O seguinte erro é retornado pela API: “CNPJ `<xxx>` não habilitado com o perfil `<xxx>` para o Recinto Aduaneiro `<xxx>` na Data de Ocorrência do evento: `<xxx>`.”Orientamos que, nestes casos, o recinto considere a data de início de vigência de seu recinto no Cadastro Aduaneiro como sendo a data de ocorrência do evento.Ressaltamos que o servidor da API Recintos possui horário sincronizado com o protocolo NTP.BR. Orientamos que os recintos sincronizem os servidores envolvidos na geração e transmissão dos eventos com o mesmo protocolo.
-
Evento Credenciamento de Pessoas
Quando devo enviar esse evento?
Resposta:Um evento para cada pessoa credenciada para acessar o recinto (entrada/saída).Considerar acesso às áreas alfandegadas apenas.Transmitir logo que encerrar o ato de credenciamento.Um evento para cada CPF credenciado.
Qual a relação entre os campos de “dataInicioValidade”, “dataFimValidade” e “credenciamentoAtivo”?
Resposta (atualizada em 27/10/2022, alteração de forma):No credenciamento devem ser informados o campo “credenciamentoAtivo : true” e, quando existir, os campos de validade do credenciamento.Casos em que a validade do credenciamento seja informada, a RFB vai considerar credenciamento inativo quando do vencimento do prazo.Para os casos que não exista validade do credenciamento o evento deve ser retificado para “credenciamentoAtivo : false”, quando for o caso. Por exemplo: no caso de funcionários não há validade de credenciamento, logo no caso de demissão o evento de credenciamento deve ser retificado para “credenciamentoAtivo:false”.
O evento 'Credenciamento de Pessoa' deve ser enviado considerando as pessoas cadastradas com crachá "permanente" no sistema?
Resposta:O evento "/ext/credenciamento-pessoas" deve ser enviado sempre que o recinto credenciar pessoas para acesso em áreas alfandegadas do recinto, conforme normas de alfandegamento vigentes, inclusive normas locais de unidades da RFB.
Neste evento há os campos “Lista materiais/ferramentas de trabalho”. Um visitante e/ou funcionário chega no Porto com uma maleta cheia de ferramenta, devemos listar todas as ferramentas?
Resposta (atualizada em 27/10/2022, alteração de forma):O credenciamento, via de regra, deve preceder os eventos de efetiva passagem nas catracas (Controle de acesso de pessoas).No credenciamento, dentre outras informações, deve ser inserida uma listagem dos materiais/ferramentas que a pessoa costuma utilizar e/ou possuem relação com a atividade que motiva o seu ingresso no recinto alfandegado.Ao adentrar no recinto, a critério do protocolo de segurança local, pode/deve haver checagens.Se o recinto adotar um controle simplificado ("bolsa de ferramentas", "caixa de ferramentas") no lugar de uma lista detalhada, pode (e deve) enviar desta forma (simplificada).Observar que os eventos devem sempre refletir a situação "no mundo real".
É possível conceituar claramente a diferença entre credenciamento e acesso? Em muitas situações, esses dois eventos devem ocorrer em momentos muito próximos. Nessa situação, ainda assim, é obrigatório o envio dos dois eventos individualmente?
Resposta:Sim, ambos os eventos devem ser enviados. São eventos distintos. O credenciamento, que é a coleta dos dados da pessoa que vai acessar o recinto, via de regra, ocorre apenas uma vez enquanto o acesso ocorre “N” vezes.Alguns recintos atuam com credenciamento com validade de, por exemplo, um ano. Neste caso, há um credenciamento, “N” acessos durante o ano e outro credenciamento no ano seguinte.
Não está claro no “Credenciamento de Pessoas”, para quais tipos de pessoas precisa ser enviado o CPF ou CNPJ do representado e nome do representado e qual a relação do evento “Representantes” ?
Resposta:Preencher o campo "CPF/CNPJ do representado" do evento Credenciamento de Pessoas apenas quando existir relação de representação. Caso exista, pode ser informado no evento de "Credenciamento de pessoas" e/ou no evento de "Representantes" para o caso de várias representações para a mesma pessoa credenciada.
Nos casos de credenciamentos de veículos ou de pessoas cujo cadastro ocorra em sistema comunitário de recintos (sistemas ou cadastros compartilhados por vários terminais/recintos) é possível o envio do evento de Credenciamento de Veículos ou Credenciamento de Pessoas apenas no recinto que efetuar o cadastramento inicial? ou tais eventos devem ser replicados em todos os recintos em que o veículo ou pessoa ingressará?
Resposta (atualizada em 27/10/2022, alteração de forma):Sempre que o compartilhamento de equipamentos e/ou sistemas for permitido pelas normas de alfandegamento então pode haver o envio de apenas 1 evento no ato do credenciamento da pessoa ou veículo pelo recinto que efetuar esse cadastro inicial. Importante incluir nas observações/motivação maiores detalhes. -
Evento Credenciamento de Veículos
Quando devo enviar esse evento?
Resposta:Um evento para cada veículo credenciado para entrar / sair do recinto.Transmitir ao final do ato de credenciamento.Um evento deve ser transmitido para cada credenciamento de cavalo-trator, outro evento para cada semirreboque, outro para cada vagão…Um evento para cada PLACA credenciada.
Qual a relação entre os campos de “dataInicioValidade”, “dataFimValidade” e “credenciamentoAtivo”?
Resposta:No credenciamento devem ser informados o campo “credenciamentoAtivo : true” e, quando existir, os campos de validade do credenciamento.Casos em que a validade do credenciamento seja informada, a RFB vai considerar credenciamento inativo quando do vencimento do prazo.Para os casos que não exista validade do credenciamento o evento deve ser retificado para “credenciamentoAtivo : false”, quando for o caso.
Nos casos de credenciamentos de veículos ou de pessoas cujo cadastro ocorra em sistema comunitário de recintos (sistemas ou cadastros compartilhados por vários terminais/recintos) é possível o envio do evento de Credenciamento de Veículos ou Credenciamento de Pessoas apenas no recinto que efetuar o cadastramento inicial? ou tais eventos devem ser replicados em todos os recintos em que o veículo ou pessoa ingressará?
Resposta (atualizada em 27/10/2022, alteração de forma):Sempre que o compartilhamento de equipamentos e/ou sistemas for permitido pelas normas de alfandegamento então pode haver o envio de apenas 1 evento no ato do credenciamento da pessoa ou veículo pelo recinto que efetuar esse cadastro inicial. Importante incluir nas observações/motivação maiores detalhes. -
Evento Controle de Acesso de Pessoas
Quando devo enviar esse evento?
Resposta:Um evento para cada acesso (entrada ou saída) de pessoa no recinto.Transmitir imediatamente ao acesso (entrada ou saída).Um evento para cada acesso de CPF.
No campo "catraca" é necessário enviar alguma especificação de marca/modelo ou apenas a identificação no sistema da catraca correspondente ao acesso registrado?
Resposta (atualizada em 27/10/2022, alteração de forma):No evento de "Georreferenciamento" deve ocorrer o cadastro de áreas ou equipamentos do recinto, vide seção específica, como câmeras, gates, balanças rodoviárias, catracas, dentre outros. Este evento também retorna um protocolo.Todos os campos dos eventos cuja descrição contenha a expressão "Usar o protocolo do evento de georreferenciamento..." devem ser preenchidos com o protocolo do cadastro dessa área ou equipamento.No caso do evento de "Controle de acesso de pessoas" devem ser informados:- Portão/catraca de acesso (georreferenciamento)Desc: Portão ou catraca de acesso. Usar o protocolo do evento de georreferenciamento relativo ao ponto de acesso utilizado- Lista de Identificação das Câmeras (georreferenciamento)Desc: Lista de identificação das câmeras. Usar o protocolo do evento de georreferenciamento para indicar, nesta lista, todas as câmeras que cobrem a área de acesso
Para os campos portão/catraca de acesso e identificação da câmera neste evento há uma referência ao Georreferenciamento, teremos que ter uma tabela relacionando as catracas com as câmeras?
Resposta (atualizada em 27/10/2022, alteração de forma):É necessário manter um controle sobre quais câmeras "cobrem" cada área e/ou equipamento.Notar que há vários outros eventos que necessitam da indicação da lista de câmeras, como a passagem nos gates, eventos de lotes, pesagem, escaneamento, etc.
Para o acesso de pessoas deverá ser recolhida a digital?
Resposta (atualizada em 27/10/2022, alteração de forma):A API não prevê o envio dos dados biométricos.A obrigatoriedade do uso da biometria no controle de acesso de pessoas é requisito constante nas normas de alfandegamento e deve ser cumprida na forma determinada pela legislação.O evento de "Controle de acesso de pessoas" prevê apenas a indicação da forma de identificação da pessoa: cartão, biométria, cartão + biometria ou manual. -
Evento Controle de Agendamento / Acesso de Veículo
Quando devo enviar esse evento?
Resposta:Um evento para cada agendamento ou acesso (entrada ou saída) de veículo terrestre ao recinto.Transmitir imediatamente ao agendamento ou ao acesso (entrada ou saída).Um evento para cada agendamento / acesso PLACA/CHASSI/LOCOMOTIVA.
Será exigido o envio das informações de entrada e saída de contêineres vazios?
Resposta:Sim. Acessos de veículos, pesagens ou escaneamentos, dentre outros, de contêineres vazios devem ser informados.
Nosso sistema irá realizar o armazenamento de todos protocolos recebidos em eventos que gerenciamos. Em relação aos eventos que referenciam protocolos de outros eventos, queremos confirmar a obrigatoriedade de envio deste protocolo.
Ex. Tenho sistema de controle de acesso X que faz cadastro e credenciamento do motorista. O credenciamento ocorre e ele armazena o protocolo recebido pelo Siscomex. Quando o veículo desse motorista entra com a carga no terminal, o sistema de gestão operacional Y vai enviar o evento de acesso. O sistema Y obrigatoriamente deve mandar o protocolo de credenciamento do motorista? Assim como o protocolo do agendamento?
Gostaríamos de confirmar se esses campos de protocolo são obrigatórios no evento agendamentos/acesso de veículos? Talvez para um terminal que tenha um único sistema gerindo tudo, isso não seja importante, porém para terminais que utilizam sistemas diferentes essa informação é muito importante, pois interfaces entre esses sistemas precisarão ocorrer.
Resposta (atualizada em 27/10/2022, alteração de forma):Considerar que existem 3 momentos:01 – Credenciamento, quando o recinto recebe os dados / documentos do motorista (de qualquer pessoa…) e concede (ou não) o direito de acesso fornecendo crachá, coletando biometria, etc. Neste caso, o evento de credenciamento é enviado com os dados básicos e documentos de cada pessoa;02 – Agendamento, quando o recinto agenda uma data para o veículo (e o motorista…) entrarem no recinto;03 – Acesso, quando o veículo, na data / hora agendada, efetivamente entra no recinto.No agendamento, momento 02, indicar o protocolo do evento de credenciamento do motorista para que a RFB possa checar os documentos (se necessário).No efetivo acesso, momento 03, indicar tanto o protocolo do credenciamento quanto o protocolo de agendamento.
No evento de acesso de veículos "/ext/acesso-veiculos" quando tratamos o modal ferroviário temos que mandar um acesso único com o trem e a lista de vagões no momento do acesso? Há vários terminais que registram a chegada dos vagões um a um, assim como sua pesagem, e não a chegada do trem de uma vez como um todo. Podemos mandar um evento para cada placa de vagão quando ocorrer cada acesso? Repetindo as informações na lista do campo semi-reboques pois lá que enviamos dados como OCR, etc.
Respostas:O recinto deve armazenar os dados durante a chegada dos vagões, enviando o evento Acesso de Veículos completo quando a composição estiver toda recebida.As pesagens devem ser enviadas conforme ocorrem, ou seja, por unidade de carga (vagão) pesada com a correspondente tara e demais informações.
No evento de acesso de veículos "/ext/acesso-veiculos" o campo "modal" hoje refere-se somente aos modais "rodoviário e ferroviário". Como será informado o caso de acesso de barcaças (fluviais)? Exemplificando: Trata-se de barcaça ou conjunto de barcaças (comboio) que acessam o recinto. A barcaça, ou comboio, atraca no píer onde equipamentos como (swivertell ou grua) fazem o descarregamento da carga. As cargas são transportadas por esteiras até chegarem nas balanças de fluxo, onde são pesadas (bateladas). Após isto, a carga vai para o armazém ou pode ir para um navio. Não tem acesso de pessoas.
Resposta (atualizada em 27/10/2022, alteração de forma):O acesso de barcaças com cargas em recintos deve ser transmitido no endpoint "/ext/embarque-desembarque-navios" com as informações pertinentes, inclusive a pesagem.O evento de pesagem (/ext/pesagem-veiculos-cargas) deve ser enviado quando a pesagem ocorrer em momento muito anterior ao embarque ou muito posterior ao desembarque do navio ou barcaça.O evento "/ext/acesso-veiculos" será transmitido apenas para veículos rodoviários ou ferroviários.O acesso de um veículo rodoviário que esteja fazendo travessia, pode ser transfronteiriça, por meio de barcaça e que chegar ao recinto deve ser informado no evento "/ext/acesso-veiculos".
As informações referentes tanto a "listaDeclaracaoAduaneira" e "listaNfe" sempre devem ser preenchidas ou basta enviar uma delas?
Respostas:Sempre que existirem as informações no momento do agendamento ou, principalmente, no acesso do veículo elas devem ser enviadas. Por exemplo, em uma exportação pode acontecer de existir a informação da NFe e ainda não ter Declaração Única de Exportação(DUE) no momento do acesso do veículo.
Que chassis devem ser incluídos na "listaChassis"?
Respostas:Informar todos os chassis das mercadorias, inclusive o tipo “meios próprios” (Importação ou exportação de ônibus, cavalo-trator, semirreboque, veículos...), conforme determinação da unidade RFB local.
Caso não se tenha a informação do "imoNavio" da "listaConteiner", esta pode permanecer em branco?
Resposta (atualizada em 27/10/2022, alteração de forma):Quando o atributo for inaplicável à operação em concreto então não preencha o campo no pacote de dados a ser enviado.Conforme art. 6º da Portaria Coana 72/2022:"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."
No mundo real os agendamentos são constantemente alterados (motorista, veículo, carga, navio, etc.). Isto está previsto?
Resposta:Sim. Todos os eventos podem ser retificados quando necessário.
Quando houver troca de motorista dentro do terminal, haverá alguma crítica não permitindo o registro de saída do veículo com outro motorista?
Resposta (atualizada em 27/10/2022, alteração de forma):A API Recintos é um repositório e, portanto, não impedirá a recepção de informações de eventos que tenham ocorrido no mundo real.Se a política do recinto (amparada em normas, inclusive da unidade local) permite esta troca, ela pode ocorrer.Na prática, é possível ocorrer diversos acessos de entrada ou saída para veículos ou pessoas.O mais relevante é que os dados informados nos eventos guardem relação com que efetivamente ocorreu.Por exemplo:- Veículo rodoviário ingressa em recinto ocorrendo o envio do "Controle de agendamento/acesso de veículos" com os dados do veículo e motorista A;
- Haverá troca de motorista então um motorista B ingressa no recinto e ocorre a saída do motorista A. Tanto o ingresso como a saída de pessoas serão registrados no evento de "Controle de acesso de pessoas";
- Posteriormente, quando ocorrer a saída do veículo com o motorista B então o registro ocorre no "Controle de agendamento/acesso de veículos".
-
Evento Pesagem Veículo / Carga
Quando devo enviar esse evento?
Resposta (atualizada em 27/10/2022, alteração de forma):Um evento para cada pesagem de unidades de carga ou carga.A utilização deste evento inclui as situações:- Pesagem em balança rodoviária ou ferroviária;
- Pesagem efetuada em equipamentos de movimentação de Contêineres (RTG, etc) e, neste caso, não informar placas (veículos e semirreboques) e nem taras do conjunto transportador;
- Granel que ingressar ou sair do recinto via dutos ou correias transportadoras. Granel gasoso ou líquido: informar a quantificação do medidor de fluxo(volume em metros cúbicos) aferido ao final da operação. Granel sólido: informar na pesagem a soma das bateladas da balança de fluxo ao final da operação.
Outras pesagens:- Caso a pesagem ocorra via Portâiner, dutos ou balança de fluxo na operação de embarque/desembarque navio, informar o peso aferido no evento Embarque/Desembarque Navio 2.15;
- A pesagem dos volumes, nos casos de geração de lotes, deve ser informada no evento 2.9 – Geração Lotes.
Um evento para cada conjunto de PLACA/CONTÊINER/VOLUME pesado.
Transmitir após a pesagem.Na pesagem de contêiner(CTR) de Exportação realizamos a pesagem do veículo carregado com o CTR na entrada e na saída pesamos o veículo vazio. Como devemos mandar esta pesagem no evento?
Resposta (atualizada em 27/10/2022, alteração de forma):Enviar o evento pesagem e usar um dos atributos de tara:- Tara Cavalo-trator/truck/locomotiva- Lista semirreboques/vagão- Taraou- Tara (Peso do conjunto cavalo + carreta sem a unidade de carga)Serão enviados 2 eventos: o 1º evento com veículo + contêiner (pesagem carregado) e o 2º evento da pesagem do veículo vazio.
Em uma exportação, recebemos 1 cegonha com até 10 veículos, nesse caso o pesobrutobalanca corresponde ao total de 10 veículos e não do um veículo especificamente. Nesse caso o que devemos enviar?
Resposta (atualizada em 27/10/2022, alteração de forma):Há 3 eventos que tratam de pesagem (Pesagem Veículo/Carga, Geração de Lotes, Embarque/Desembarque Navio) a depender do tipo e momento da ocorrência da pesagem.Para os casos de pesagem em balança rodoviária, enviar o peso bruto total (pesoBrutoBalanca) da pesagem, neste caso do veículo transportador rodoviário, no evento de Pesagem de Veículo/Carga.Observar que serão prestadas as informações do evento que realmente ocorreu, conforme o modal e tipo de operação do recinto.
Temos casos onde existe excesso lateral do qual a carga não consegue passar pela balança física, gerando assim entrada de carga como IOP (impossibilidade de pesagem). Nessas situações não será enviado o pesoBrutoBalanca, isso ocorrerá também no evento de geração de lotes. Principalmente com cargas soltas, veículos, hélices e afins.
Resposta:Para o caso de excesso de peso ou de dimensões que acarretem impossibilidade física ou operacional para realizar a pesagem ou escaneamento, não serão enviados os eventos de Pesagem Veículo/Carga e/ou Inspeção Não Invasiva pois, de fato, não ocorreram.Nessas situações, há dois flag (oogDimensao ou oogPeso) no evento “Controle de Agendamento / Acesso de Veículo” para informar que não será possível pesar ou escanear aquele veículo ou carga.
Para os casos de barcaças, onde se utiliza também de balanças de fluxo, como deverá ser feito o envio das pesagens?
Resposta (atualizada em 27/10/2022, alteração de forma):A carga a granel que ingressar ou sair do recinto, via dutos ou correias transportadoras, deve ser enviada no evento Pesagem Veículos/Carga.- Granel que ingressar ou sair do recinto via dutos ou correias transportadoras. Granel gasoso ou líquido: informar a quantificação do medidor de fluxo(volume em metros cúbicos) aferido ao final da operação. Granel sólido: informar na pesagem a soma das bateladas da balança de fluxo ao final da operação.
No caso da operação de barcaças, tendo em vista se tratar de carga/descarga de embarcação, orientamos que a informação da quantificação seja enviada no evento Embarque/Desembarque Navio.- Caso a pesagem ocorra via Portâiner, dutos ou balança de fluxo na operação de embarque/desembarque navio, informar o peso aferido no evento Embarque/Desembarque Navio 2.15;
Um modal rodo ou ferro que acessa o terminal para realizar descarga ou carregamento faz 2 pesagens, sendo uma tara e outra peso bruto. Nesse caso mandaremos 2 eventos. Para uma exportação, por exemplo, mandaremos o peso bruto na hora que entrou, e mandaremos a tara na hora que estiver saindo vazio. Mandaremos na entrada somente o campo pesoBrutoBalanca (pois só temos a tara no final)? E na saída mandaremos tara, taraconjunto e pesoBrutoBalanca com o mesmo valor?
Resposta (atualizada em 27/10/2022, alteração de forma):As taras de veículo e semirreboque podem ser informadas em separado ou em conjunto e são excludentes, ou seja, caso o recinto opere com a tara do conjunto (cavalo / semirreboque), comum no modal aquaviário, informar esta e ignorar a tara em separado, conforme determinação unidade local.As taras devem ser informadas em separado nos casos de recintos que possuem cadastro de taras, conforme determinação da unidade local. Esse tipo de cadastro é comum em portos secos de fronteira (modal rodoviário) em que cargas de importação ou exportação ingressam no recinto e permanecem sob rodas até o desembaraço.Para os casos em que a pesagem é feita no gate (ou balança interna), comum no modal aquaviário, usar a tara aferida na última pesagem do conjunto vazio.Caso o conjunto realize a primeira passagem no recinto “carregado / cheio”, retificar o evento assim que obter a tara do conjunto vazio.Pesagens de veículos vazios, conforme determinação da unidade local, devem ser transmitidas com valores iguais para os atributos peso bruto da balança (pesoBrutoBalanca ) e tara individual (tara e listaSemirreboque.tara) ou tara do conjunto (taraconjunto), conforme o caso.
Devo informar a pesagem da carga no evento Pesagem Veículo/Carga, Geração de Lotes ou no Embarque/Desembarque de Navio? Quando informar em cada um?
Resposta (atualizada em 27/10/2022, alteração de forma):As pesagens de caminhões, contêineres ou cargas devem ser informadas de acordo com a ocorrência no mundo real e conforme normatização, inclusive determinações da unidade RFB local.O evento de "Pesagem de veículos/carga" será utilizado geralmente em recintos portuários (aquaviário), portos secos de fronteira ou recintos de zona secundária (rodoviário), incluindo as seguintes pesagens:- Pesagem em balança rodoviária ou ferroviária;
- Pesagem efetuada em equipamentos de movimentação de Contêineres (RTG, etc);
- Granel que ingressar ou sair do recinto via dutos ou correias transportadoras. Granel gasoso ou líquido: informar a quantificação do medidor de fluxo(volume em metros cúbicos) aferido ao final da operação. Granel sólido: informar na pesagem a soma das bateladas da balança de fluxo ao final da operação.
Outras pesagens:- Caso a pesagem ocorra via Portâiner, dutos ou balança de fluxo na operação de embarque/desembarque navio, informar o peso aferido no evento Embarque/Desembarque Navio 2.15;
- A pesagem dos volumes, nos casos de geração de lotes, deve ser informada no evento 2.9 – Geração Lotes.
Nos casos onde o recinto trabalha com operações casadas, ou seja, o veículo entrega uma exportação e já retira uma importação. Nessa situação não teremos o peso vazio do conjunto(cavalo+carreta), como proceder?
Resposta:A pesagem do conjunto (cavalo+carreta) vazio e/ou carregado será enviada para a API do Módulo Recintos.O que determina a pesagem do conjunto vazio são as normas, inclusive locais, e sempre que ocorra este tipo de pesagem deverá ser transmitida à API.Caso o recinto não seja obrigado a efetuar a pesagem do conjunto vazio, como por exemplo em operações casadas, não há o que se transmitir pois o evento não ocorreu no mundo real.
Devemos enviar o primeiro pacote da primeira pesagem dos contêiner como Inclusão e os demais pacotes de repesagem deste contêiner devem ser enviados como Retificação?
Resposta:A retificação ou exclusão de eventos pressupõe o envio (Inclusão) do evento original. Inclusive, para o envio de eventos do tipo retificação/exclusão há validação em relação ao protocolo do evento original (protocoloEventoRetificadoOuExcluido).Casos de contingência devem ser tratados pela TI e reenviados com flag "contingencia:true".Em relação aos exemplos abordados, observar que a retificação deve ser utilizada para informações erroneamente transmitidas.No caso de pesagens do contêiner, caso ocorra repesagem por problemas técnicos ou operacionais notórios(por exemplo: veículo parcialmente fora da balança rodoviária) pode ser considerada uma retificação. Entretanto, via de regra, toda pesagem e repesagem é considerada um evento independente e, dessa forma, deve ser enviada como Inclusão de evento.
No nosso processo, o granel chega ao Recinto Alfandegado vindo da usina até o pátio por meio de correias transportadoras onde são pesadas por balança de fluxo. Visando a transmissão da API /ext/pesagem-veiculos-cargas e seus campos (pesoBrutoBalança, dutos e ncm), nesse caso, tendo em vista a similaridade entre os meios, podemos adotar para “Correia Transportadora” o procedimento de “Duto”?
Resposta (atualizada em 27/10/2022, alteração de forma):O evento de pesagem pode ser transmitido de forma similar a dutos, ou seja, no caso de granel que ingressar ou sair do recinto via dutos (ou em situação similar via correia transportadora), transmitir o presente evento com a soma das bateladas da balança de fluxo ao final da operação com o adequado preenchimento dos campos pesoBrutoBalança, dutos, ncm e demais pertinentes. Preencher o atributo dutos ou correiasTransportadoras, conforme o caso. -
Evento Inspeção não Invasiva
Quando devo enviar esse evento?
Resposta:Um evento para cada inspeção não invasiva efetuada em unidades de carga ou volumes (carga solta).Transmitir imediatamente após a finalização da inspeção.Um evento para cada PLACA/CONTÊINER/VOLUME escaneados.
Quais arquivos devo enviar no evento de inspeção não invasiva?
Resposta (atualizada em 27/10/2022, alteração de forma):Nesse evento devem ser enviados o arquivo de imagem do scanner (arquivoImagem) e também o arquivo de metadados, geralmente xml, (arquivoMetadados) gerado pelo escâner, além dos demais atributos pertinentes ao evento (exemplo: placas, número contêiner, conhecimento, Nfe...).
Para enviar a imagem do scanner, devemos utilizar a API do Módulo Anexação? Como será o fluxo desses arquivos?
Resposta (atualizada em 27/10/2022, alteração de forma):O evento deverá ser enviado diretamente para API do Módulo Recintos, da mesma forma que os demais eventos, contendo os arquivos de imagem e de metadados (geralmente xml) gerado pelo escâner, além dos demais atributos pertinentes ao evento (exemplo: placas, número contêiner, conhecimento, Nfe...).
Qual a especificação do arquivo de imagem e do arquivo de assinatura?
Resposta (atualizada em 27/10/2022, alteração de forma):O atributo arquivoAssinatura deixou de ser previsto na estrutura do evento de Inspeção Não Invasiva.O atributo arquivoImagem é obrigatório na inclusão ou na retificação de eventos desse tipo:arquivoImagem
String em BASE64 representando o conteúdo do arquivo de imagem jpeg. Enviar uma cópia da imagem original gerada pelo equipamento de inspeção não invasiva no formato jpeg, redimensionada para 800 linhas, com colunas proporcionais, com uso de filtro Antialias/Lanczos próprio para redução de imagens, com preservação da informação de canais de cor original. (doc técnica). A imagem redimensionada também não poderá ser superior a 400KB, sendo o caso, redimensionar para um tamanho um pouco menor que 800 linhas.arquivoAssinatura
RemovidoPara os casos de compartilhamento de equipamento de inspeção não invasiva (scanner) entre diferentes recintos temos dúvidas: o recinto que efetua o escaneamento deve enviar o evento de Inspeção não Invasiva? O recinto que efetua o escaneamento não tem conhecimento das informações da carga, os campos relativos aos documentos (conhecimento, declaração, NF-e) não serão transmitidos?
Resposta (incluída em 29/04/2024):O compartilhamento do equipamento de quantificação ou inspeção não invasiva deve ser autorizado pela unidade local da RFB, conforme determina o §3º, art. 8º, da Portaria Coana nº 76/2022. A autorização indicará o responsável pelo envio dos eventos à API-Recintos bem como eventual dispensa de preenchimento de alguns campos que não possuam dados disponíveis. -
Evento Posição Veículo Pátio
Quando devo enviar esse evento?
Resposta:Um evento para cada posicionamento ou mudança de posição de veículo no pátio.Evento comum para portos secos de fronteira.Transmitir imediatamente a finalização do posicionamento.Um evento para cada conjunto PLACA/CONTÊINER posicionada num box no pátio.
O evento de Posição veículos Pátio registra veículos que movimentam granel (recinto de granel) ou área de armazenagem de cargas do tipo veículos?
Respostas:O evento de “Posição de Veículos no Pátio” deve ser utilizado principalmente para registro de informações de localização dos veículos (box ou posição no pátio) nos portos secos. Nesses casos, a carga de importação ou exportação, via de regra, entra no recinto sob rodas e permanece sob rodas até o desembaraço aguardando em uma posição no pátio.O armazenamento de volumes de cargas (carga solta) deve ser registrado com os eventos Geração de Lotes e Armazenamento de Lote. -
Evento Posição Contêiner
Quando devo enviar esse evento?
Resposta (atualizada em 27/10/2022, alteração de forma):Um evento para cada posicionamento ou mudança de posição de contêiner dentro do pátio. Não considerar os movimentos do tipo “house keeping”, quando a unidade retorna, em pouco tempo, para a mesma posição. Transmitir imediatamente a finalização do posicionamento.Um evento para cada CONTÊINER posicionado no pátio. -
Evento Geração de Lotes
Quando devo enviar esse evento?
Resposta (atualizada em 27/10/2022, alteração de forma):Um evento para cada conjunto de lotes gerados por conhecimento de carga.Eventos de lotes devem ser enviados quando a carga é controlada por volumes, carga solta.Não considerar os movimentos do tipo “house keeping”, a exemplo de desunitização para verificação ou inspeção física de órgão anuente, casos em que a carga deve ser reunitizada em pouco tempo após o processo.Exemplos de geração de lote; desunitização = n... lotes; baldeação imediata = n... lotes; depositada em armazém = n... lotes;Não aplicar para granel.Transmitir imediatamente a geração de um conjunto de lotes por conhecimento.Pode repetir o conhecimento de carga na transmissão de um novo evento no caso de cargas com chegada parcial.
Em relação ao evento de geração de lote, nosso sistema gera um lote para identificar cada carga independente de estar num contêiner ou não. Por exemplo, um contêiner pode ter em seu interior 4 BL Houses. Neste caso, deve-se enviar 4 eventos de geração de lote para cada um dos lotes? Em porto seco de fronteira, quando a mercadoria entra e permanece sobre-rodas deve-se gerar o evento de geração de lote e armazenagem de lote?
Resposta:A API-Recintos segue a lógica da ocorrência física de eventos no mundo real, ou seja, se o evento ocorreu então deve ser enviado aquele conjunto de dados pertinente.Os eventos de lotes (geração de lotes, armazenamento de lotes e carregamento/entrega de lotes) somente devem ser enviados para a carga que passa a ser controlada por volumes, carga solta.Por exemplo, caso o contêiner seja desunitizado para armazenamento físico dos pallets então deve ser enviado o evento Geração de Lotes e Armazenamento de Lotes. Se o contêiner entrou no recinto e foi embarcado então, do ponto de vista da API, não deve ser enviado eventos de lotes pois em nenhum momento houve controle de volumes. Nesse último caso, todos os eventos, conforme o fluxo físico do contêiner, devem ser enviados, por exemplo na exportação: evento Agendamento/Acesso de Veículos, Pesagem de Veículo/Carga, Inspeção Não Invasiva, Posição do Contêiner no Pátio, Embarque no Navio, dentre outros, conforme o caso em concreto.Observar que no caso de terminais do modal aéreo as cargas possuem um controle por volumes, logo sempre serão transmitidos os eventos de lotes.Nos casos de porto seco a mesma lógica deve ser seguida, enviar eventos de lotes apenas quando houve controle de volumes (descarga em armazém).Via de regra, em porto seco de fronteira a carga permanece sob rodas e não sendo armazenada então não haverá controle por volumes e consequentemente não ensejando envios de eventos de lotes para API-Recintos. Por outro lado, em recintos alfandegados de interior(zona secundária), via de regra, ocorre o armazenamento e controle por volumes, nesses casos deverão ser enviados os eventos de lotes.
Existem cargas que são desovadas de contêiner(CTR) para saneamento ou conferência física, ficando às vezes por semanas fora do CTR e depois são reestufados no CTR de origem. Durante este tempo o CTR retorna para quadra ficando vazio neste período e depois é novamente posicionado para a estufagem da carga. Nestes casos, temos que informar a geração do lote ou somente se a carga for desovada em definitivo?
Resposta:Não considerar os movimentos do tipo “house keeping”, quando a unidade retorna, em pouco tempo, para a mesma posição.Se a desova for realizada unicamente para conferência física por interveniente e retornar ao contêiner (ova) em até 1 dia, os eventos de Geração de Lote e Posição do Contêiner não precisam ser informados.Incluímos o atributo “vazio[sim/não]” no evento Posição Contêiner.
Na geração do lote gostaríamos de saber se ao recebermos uma carreta com carga para exportação precisamos fracionar, pesar e criar um numero de lote ou se podemos criar um lote único para carga e adotar o peso da balança rodoviária menos a tara do veículo como peso do produto?
Resposta (atualizada em 27/10/2022, alteração de forma):A API-Recintos segue a lógica da ocorrência física de eventos no mundo real, ou seja, se o evento ocorreu então deve ser enviado aquele conjunto de dados pertinente. Os eventos de lotes (geração de lotes, armazenamento de lotes e carregamento/entrega de lotes) somente devem ser enviados para a carga que passa a ser controlada por volumes, carga solta. Certamente, conforme a questão apresentada, deverá ocorrer o envio do evento de "Controle de agendamento/acesso de veículo", tendo em vista o ingresso de veículo, e "Pesagem de veículo/Carga", tendo em vista a pesagem em balança rodoviária. Outros eventos podem ser aplicados, conforme o tipo de operação e logística, por exemplo: Inspeção não invasiva, Posição do contêiner no pátio, Embarque em Navio...A forma de trabalho do recinto é que dita como será formado o lote. Presume-se que haverá ao menos um lote para cada carga de exportação, ou seja, para cada DUE. Entretanto há a hipótese de o recinto receber várias remessas (para formação de uma exportação) e decidir criar um lote para cada parte da carga recebida. Já o peso do produto pode (deve) ser feito na forma proposta.
No campo ListamercadoriaPerigosa, o campo Classe deve ser enviado o código da classe de riscou ou a descrição? O campo Cod é para ser enviado o código ou a descrição do ONU?
Resposta:O campo mudou. Enviar apenas a lista de códigos de acordo com a tabela aduaneira Mercadoria Perigosa.
Caso ocorra um saneamento pela RFB e a carga após saneada retorne para o CTR de origem, temos que mandar este evento para o lote criado ou usaremos o evento posição de contêiner? Neste caso devemos informar a unitização do lote no contêiner alugado? Cargas que foram desunitizadas e reunitizadas em contêineres alugados, devemos considerar como solta, enviando este evento ou considerar como contêiner e usaremos o evento posição de contêiner? – Esta situação ocorre muito em contêineres de cargas refrigeradas em abandono onde o Armador entra com mandato de segurança, exigindo o Contêiner vazio de volta.
Resposta:Quando ocorrer a desunitização deve haver a informação do evento Geração de Lotes, via de regra, seguido do evento Armazenamento de Lote.Não considerar os movimentos do tipo “house keeping”, quando a unidade de carga retorna, em pouco tempo, para a mesma posição.Se a desunitização for realizada unicamente para verificação ou inspeção física ou saneamento por interveniente público e a carga retornar ao mesmo contêiner (reunitização) e o contêiner retornar para a mesma posição em pouco tempo, até 1 dia, os eventos de Geração de Lote e Posição do Contêiner não precisam ser informados, porém, no caso contrário, precisam ser informados.Incluímos o atributo “vazio[sim/não]” no evento Posição Contêiner.No caso de desunitização e/ou conferência física por longo período e/ou reunitização em contêiner diverso, os eventos Geração de Lotes, Armazenamento de Lote (se for o caso), Carregamento/Entrega de Lote e Posição do Contêiner devem ser informados.
Iremos enviar este endpoint sempre que houver o cadastro de uma desunitização da carga do contêiner de origem? Devemos enviar para algum outro processo, como saneamento de uma carga mesmo que ela retorne para o contêiner de origem após o saneamento?
Resposta:Sim, quando ocorrer a desunitização deve haver a informação do evento Geração de Lotes, via de regra, seguido do evento Armazenamento de Lote.Não considerar os movimentos do tipo “house keeping”, quando a unidade de carga retorna, em pouco tempo, para a mesma posição.Se a desunitização for realizada unicamente para verificação ou inspeção física ou saneamento por interveniente público e a carga retornar ao mesmo contêiner (reunitização) e o contêiner retornar para a mesma posição em pouco tempo, até 1 dia, os eventos de Geração de Lote e Posição do Contêiner não precisam ser informados, porém, no caso contrário, precisam ser informados.Incluímos o atributo “vazio[sim/não]” no evento Posição Contêiner.No caso de desunitização e/ou conferência física por longo período e/ou reunitização em contêiner diverso, os eventos Geração de Lotes, Armazenamento de Lote (se for o caso), Carregamento/Entrega de Lote e Posição do Contêiner devem ser informados.
Acredito que há confusão no termo "lote" por conta do "lote de fabricação" da mercadoria. Sobre a questão da utilização do chassis para identificar o veículo(mercadoria) movimentado, seria interessante observar a forma adotada pela Antaq no SDP. Há uma definição de lote?
Resposta:O lote é um termo usado para um número – código que identifique aquela carga de forma única, ainda que seja uma parcela do conhecimento de carga.Deve ser suficiente para que o recinto saiba informar, de forma inequívoca, onde está aquela carga em particular. Não há um formato definido.Levar em conta, ainda, que todas as cargas dentro do recinto devem estar informadas na API. No caso de cargas desunitizadas ou cargas controladas por volumes então usamos o conceito de lotes.O conceito de lote está relacionado com a rastreabilidade e com o controle do que há no pátio ou armazém. Para cargas unitizadas temos o número da unidade de carga. Para carga desunitizadas devemos ter um número, que seja único dentro de cada recinto, para o mesmo fim. -
Evento Armazenamento de Lote
Quando devo enviar esse evento?
Resposta:Um evento para cada armazenamento/mudança de posição do lote dentro do armazém. Não considerar os movimentos do tipo “house keeping”, a exemplo do posicionamento para verificação ou inspeção física de órgão anuente, casos em que a carga retorna, em pouco tempo, para a mesma posição.Não aplicar para granel.Transmitir imediatamente a finalização do armazenamento.Um evento para cada LOTE armazenado.
Como devo proceder para informar o evento de armazenamento de lote após o posicionamento (não considerando House Keeping) de Lotes de Madeira? Exemplo: Pilhas de madeiras (Lotes) que ocupam espaço físico, com dimensões superiores a de um container (Altura, Largura, Profundidade).
Respostas:O ideal é dividir em vários lotes, de acordo com a divisão do armazém. Por exemplo, se o lote ocupar toda uma quadra, informar um lote e, nos dados de localização, apenas a quadra. SE usar algumas pilhas de uma quadra, dividir em um lote por pilha e informar, no evento, a quadra e a pilha de cada lote. Notar que é ideal agrupar as mercadorias de um mesmo lote na mesma quadra / pilha. Facilita para montar os eventos e para eventual fiscalização.
Entendemos que este endpoint (armazenamento-lote) deve ser enviado apenas para cargas soltas ou cargas que foram desunitizadas e não retornarão mais para o contêiner de origem, correto?
Resposta:O entendimento está correto. Nesses casos, haverá envio de eventos conforme a logística da carga sendo Geração de Lotes, Armazenamento do Lote e, em outro momento, Carregamento/Entrega de Lotes.O evento Carregamento/Entrega de Lotes deve ser utilizado quando os lotes forem carregados ou unitizados em unidade de carga (caminhão, vagão, contêiner, ULD) ou entregue à companhia aérea.No caso de carga solta a ser carregada diretamente em navio, utilizar apenas o evento Embarque Navio informando o número do lote carregado. -
Evento Carregamento/Entrega de Lotes
Quando devo enviar esse evento?
Resposta:Um evento para cada carregamento de lotes em unidade de carga – contêiner, caminhão, etc.Não considerar os movimentos do tipo “house keeping”, a exemplo do carregamento em caminhão para utilizar o scanner, casos em que a carga retorna, em pouco tempo, para a mesma posição.O evento deve ser utilizado quando os lotes forem carregados em unidade de carga(caminhão, vagão, contêiner, ULD aeronave) ou entregue à companhia aérea.No caso de carga solta a ser carregada diretamente em navio, utilizar apenas o evento Embarque Navio informando o número do lote carregado.Transmitir imediatamente a finalização do carregamento.Não aplicar para granel.Um evento para cada conjunto de LOTES carregados do mesmo conhecimento.Transmitir imediatamente ao carregamento de um conjunto de LOTEs por conhecimento.Pode repetir o conhecimento na transmissão de um novo evento no caso de cargas com saída parcial. -
Evento Avaria/Extravio de Lote
Quando devo enviar esse evento?
Resposta:Um evento para cada avaria ou extravio verificados em lote de carga.Transmitir imediatamente a verificação da avaria/extravio.Não aplicar para granel.Um evento para cada LOTE com avaria/extravio. -
Evento Atribuição / Troca de Navio
Quando devo enviar esse evento?
Resposta:Um evento para cada atribuição ou alteração de navio em que a unidade de carga ou carga solta irá embarcar.Transmitir imediatamente a atribuição ou alteração.
A atribuição/troca de navio pode ocorrer antes mesmo do depósito do contêiner(CTR) no terminal. Devemos enviar este JSON de Atribuição/Troca de Navio apenas após a entrada do CTR no terminal? Ou temos que enviar o JSON assim que o CTR for agendado (momento que teríamos a informação da atribuição da unidade ao Navio/viagem) ?
Resposta (atualizada em 26/10/2022, alteração de forma):O navio de embarque deve ser informado tanto no “Agendamento de acesso de veículo” como no efetivo “Acesso de Veículo”.Deve ser utilizado o evento “Atribuição/troca de Navio” nos casos em que:- a carga ingressou no recinto sem a informação do navio de embarque; ou
- a carga ingressou informando navio de embarque, porém houve alteração;
O recinto informa os dados, incluindo o navio, no momento do agendamento. SE houver mudança de navio antes da carga entrar no recinto, não precisa enviar o evento de troca pois quando a carga efetivamente entrar(acesso de veículo) o dado correto será informado. A partir do momento em que a carga esteja no pátio, toda mudança deve ser informada.
Há casos de rolagem de carga e não sabemos qual será o novo navio, o que fazer?
Resposta (atualizada em 26/10/2022, alteração de forma):Gerar o evento Atribuição/Troca de Navio deixando os dados do navio em branco até o momento em que se saiba o novo navio. Ao receber a informação do novo navio de embarque daquele contêiner, enviar evento retificador. -
Evento Embarque/Desembarque Navio
Quando devo enviar esse evento?
Resposta (atualizada em 26/10/2022, alteração de forma):Um evento para cada embarque ou desembarque de unidades de carga, carga solta ou granel em navio (embarcação).Transmitir imediatamente ao encerramento do embarque / desembarque.Transmitir também nos casos de transbordo/baldeação entre navios.Um evento por CONTÊINER/LOTE CARGA SOLTA/GRANEL embarcado ou desembarcadoGranel: um evento ao final do carregamento/descarregamento total do navio graneleiro.
No embarque de veículos não possuímos a posição do navio para a carga, essa informação não será enviada?
Resposta (atualizada em 26/10/2022, alteração de forma):Quando o atributo for inaplicável à operação em concreto então não preencha o campo no pacote de dados a ser enviado.Conforme art. 6º da Portaria Coana 72/2022:"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."
Temos outros tipos de equipamentos para realização de embarque devido a características das carga, até o uso do equipamento do próprio navio. O campo 'portainer' poderá ser utilizado?
Resposta (atualizada em 26/10/2022, alteração de forma):No caso do uso de equipamento do navio, ou equipamento móvel, não informar o campo portainer.O campo portainer deve informar equipamentos georreferenciados fixos (portâiner, esteiras ou correias transportadoras, por exemplo).Esses equipamentos fixos devem estar cadastrados via evento "Georreferenciamento".
Para o evento de embarque de navio, poderá ser enviado o peso aferido na arqueação ou somente o peso das balanças de fluxo para cargas a granel?
Resposta (atualizada em 26/10/2022, alteração de forma):O evento Embarque/Desembarque Navio pode(deve) receber as seguintes informações:- Peso bruto manifesto / VGM (Kg)
- Peso balança (Kg)
- Peso arqueação (Kg) (apenas para granel)
- Volume (metros cúbicos) (apenas para granel)
-
Evento Representantes
Quando devo enviar esse evento?
Resposta:Lista de pessoas que acessam o sistema do recinto em nome de cada cliente ou que possuem representação via procuração. Diferente do cadastro de representação do siscomex. Toda representação via sistema ou papel deve ser informada.Transmitir um evento para cada CPF/CNPJ.
Se no ato do credenciamento de uma pessoa o recinto conceder login/senha para acesso ao portal de internet devemos enviar os eventos “Credenciamento de Pessoas” e “Representantes”?
Resposta:Sim. O credenciamento de pessoas visando acessar fisicamente áreas alfandegadas do recinto deve ser informado no evento “Credenciamento de pessoas” já o credenciamento ou liberação de acesso à sistema como, por exemplo, um portal web de recinto aduaneiro, deve ser informado no evento “Representantes”.
Não está claro no “Credenciamento e pessoas”, para quais tipos de pessoas precisa ser enviado o CPF ou CNPJ do representado e nome do representado e qual a relação do evento “Representantes” ?
Resposta:Preencher o campo "CPF/CNPJ do representado" do evento "Credenciamento de pessoas" apenas quando existir relação de representação. Caso exista, pode ser informado no evento de credenciamento de pessoas e/ou no evento de Representantes para o caso de várias representações para a mesma pessoa credenciada.
Quais pessoas que acessam o sistema do recinto devem ser listadas?
Resposta:Todas as pessoas (usuários externos ao recinto, não os funcionários) que acessem informações de controle aduaneiro em sistemas do recinto (web ou intranet) em nome de um representado devem ser cadastradas neste evento da API-Recintos. -
Evento Conferência Física
Quando devo enviar esse evento?
Resposta (atualizada em 26/10/2022, alteração de forma):Um evento para cada agendamento ou conclusão de verificação ou inspeção física.Considerar todos os tipos de conferência, solicitadas por qualquer interveniente ou pelo proprietário da carga.Não transmitir para conferência de embalagem de madeira.Transmitir um evento para cada agendamento ou conclusão de conferência recebida.
No caso de uma conferência com motivação ANVISA, devemos preencher o campo "solicitante" com o nome do Importador/ Despachante ou o solicitante a ser informado seria o próprio órgão anuente "ANVISA"?
Resposta (atualizada em 26/10/2022, alteração de forma):Conforme a documentação disponível, o atributo solicitante é uma tabela de domínio.Deve ser preenchida ordinariamente com RFB ou o órgão anuente que solicitou a verificação ou inspeção física.O solicitante será juridicamente o importador quando ele fizer uso da verificação prévia ao registro da DI de que trata o Art. 10 da IN SRF n° 680/2006. -
Evento Informação Prévia Trânsito Simplificado Contêiner
Quando devo enviar esse evento?
Resposta:Um evento para cada lista de unidades que serão removidas. Verificar a normatização local sobre os prazos para que os recintos de destino informem o recinto onde a carga vai atracar sobre a remoção da mesma.Transmitir imediatamente a recepção da lista de cargas a remover.Um evento por LISTA CARGAS.
Este evento é apenas para contêineres de Importação? Quem deve informar este evento? O recinto de origem da carga (por exemplo, o operador portuário que fará a descarga das unidades do Navio) ou o recinto de destino da carga (terminal que receberá os contêineres listados para despacho em seu recinto)?
Resposta:Neste evento devem ser informados os contêineres de importação que possuem informação prévia de trânsito simplificado.As unidades locais da RFB já possuem normas disciplinando o tema.Via de regra, o recinto de origem da carga (operador portuário que fez a descarga das unidades do Navio) é comunicado da previsão de trânsito simplificado de contêineres.Tal comunicação é enviada previamente pelo recinto de destino da carga (recinto que receberá os contêineres para despacho) ao recinto de origem da carga.O recinto de origem da carga deve enviar o evento para API-Recintos após a recepção da lista de contêineres com previsão de trânsito simplificado. -
Evento Agenda/Operação de Navios/Aeronaves
Quando devo enviar esse evento?
Resposta:Um evento para cada inclusão / alteração no 'line up' / 'agenda' de navios / aeronaves com atracação / pouso previstos para o recinto.Transmitir a agenda (previsão), a chegada (atracação/desatracação pouso/decolagem) e a operação.Evento aplicável para recintos com atracadouro ou pista aeronáutica próprios.Exemplo de eventos para Navios:Chegada (informa a viagem e escala de chegada, dados da embarcação, dentre outros)- evento 1 - previsão de atracação e desatracação
- evento 2 - previsão de atracação e desatracação + efetiva atracação
- evento 3 - previsão de atracação e desatracação + efetiva atracação + início operação
Saída (informa a viagem e escala de partida, dados da embarcação, dentre outros)- evento 4 - previsão de atracação e desatracação + efetiva atracação + início operação + final operação
- evento 5 - previsão de atracação e desatracação + efetiva atracação + início operação + final operação + efetiva desatracação
Exemplo de eventos para Aeronaves:Chegada (informa o VOO e viagem de chegada, dados da aeronave, dentre outros)- evento 1 - previsão de pouso;
- evento 2 - previsão de pouso + efetivo pouso
- evento 3 - previsão de pouso + efetivo pouso + início operação
Saída (informa o VOO e viagem de partida, dados da aeronave, dentre outros)- evento 4 - previsão de pouso + efetivo pouso + início operação + previsão de partida;
- evento 5 - previsão de pouso + efetivo pouso + início operação + previsão de partida + final operação
- evento 6 - previsão de pouso + efetivo pouso + início operação + previsão de partida + final operação + efetiva partida
Transmitir imediatamente a recepção da informação. -
Evento Informação de Bloqueio / Desbloqueio de Veículo / Carga
Quando devo enviar esse evento?
Resposta (atualizada em 26/10/2022, alteração de forma):Um evento para cada bloqueio/desbloqueio de carga ou unidade de carga solicitado/efetuado diretamente no sistema do recinto.Não enviar os bloqueios/desbloqueios automáticos implementados para controle de fluxo no sistema do recinto.Não se trata do bloqueio no sistema Carga e/ou CCT.Transmitir um evento para cada solicitação de bloqueio ou desbloqueio efetivada no sistema privado do recinto para conhecimento, contêiner, veículo ou lote. -
Evento Ocorrências de indisponibilidades de equipamentos
Quando devo enviar esse evento?
Resposta (atualizada em 26/10/2022, alteração de forma):Transmitir um evento para cada indisponibilidade e retorno à normalidade de cada equipamento definido no evento de Georreferenciamento.Não considerar indisponibilidades do tipo “house keeping”, casos de manutenção preventiva, rápida e, muitas vezes, diária de equipamentos (exemplo: trocas de óleo em Portêiner executadas diariamente).
Tenho um equipamento (catraca ou câmera) que vai para manutenção técnica. Desativo ela no sistema. Devo enviar um evento de indisponibilidade com os dados requisitados para o endpoint "/ext/indisponibilidade-equipamentos" ou "/ext/evento-georreferenciamento"?
Resposta (atualizada em 26/10/2022, alteração de forma):O evento /ext/evento-georreferenciamento será utilizado para cadastro georreferenciado das áreas e equipamentos do recinto.
Posteriormente, podem ocorrer indisponibilidades temporárias ou permanentes dos equipamentos.Para indisponibilidades temporárias basta enviar um novo evento /ext/indisponibilidade-equipamentos referenciando o equipamento (protocolo). Um evento informando a indisponibilidade temporária (Inativo) do equipamento (balança, câmera, catraca, scanner...), incluindo a informação de previsão de retorno à normalidade, e outro evento informando a disponibilidade (Ativo) quando do efetivo retorno à normalidade.Para indisponibilidades permanentes de equipamentos (desalfandegamento da área, desligamento definitivo da câmera, gate, catraca...) a informação de indisponibilidade (Inativo) é enviada como uma retificação do evento /ext/evento-georreferenciamento no atributo areaEquipamentoAtivo, além dos demais atributos.
As câmeras podem ficar indisponíveis (Offline) na rede por alguns poucos segundos. Essas indisponibilidades ocorrem diariamente. Devemos enviar o evento de Indisponibilidade de Equipamentos sempre que uma câmera ficar indisponível? Inclusive quando a indisponibilidade ocorrer por e 1 ou 2 segundos e, em seguida, o equipamento esteja Online?
Resposta (incluída em 05/04/2023)
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 ficar indisponível por mais de 30 minutos ou, nos demais equipamentos, quando efetivamente impactar o fluxo ou o uso do equipamento. -
Evento de Georreferenciamento
Quando devo enviar esse evento?
Resposta:Neste evento devem ser enviadas as informações de georreferenciamento de áreas e equipamentos do recinto.As áreas e equipamentos considerados devem ser os constantes da lista de domínio “tipo”.As coordenadas de cada objeto definido podem ser um polígono ou ponto, por exemplo:- O perímetro da área alfandegada e demais áreas... (polígono);
- As câmeras do sistema de CFTV, inclusive dos Gates e que fazem parte do sistema de OCR (ponto);
- As catracas, torniquetes e outros instrumentos de controle de acesso de pessoas (ponto);
- As balanças rodoviárias (ponto);
- Os Portêineres e outros instrumentos de manipulação de unidades de carga em navios (ponto);
- Os escâneres, tanto de contêineres quanto de volumes (ponto);
- Os gates, portões e outros instrumentos de controle de acesso de veículos (ponto).
Como deve ser o cadastramento do georreferenciamento das posições de quadra ou áreas de posicionamento de contêiner ou dentro do Armazém? Cada posição deve ter um protocolo de georreferenciamento? Há milhares de posições.
Resposta (atualizada em 26/10/2022, alteração de forma):Os códigos utilizado no georreferenciamento podem ser informados de acordo com as áreas ou padrões existentes em cada recinto.As áreas e equipamentos considerados devem ser os constantes da lista de domínio “tipo”.Por exemplo, os gates, as balanças, os escâneres, as câmeras (todas), as catracas / torniquetes, portões, o perímetro total do recinto e algumas sub-áreas internas.Para cada área ou equipamento é preciso enviar um ID, uma forma de identificar unicamente aquele item, um nome (novamente único), indicação se está ativo, azimute (apenas para as câmeras), tipo de área ou equipamento e a(s) coordenada(s).Exemplo:Câmera perimetral 01
... "idAreaEquipamento": "CP01", "nome": "Câmera perimetral 01", "areaEquipamentoAtivo": true, "azimuteCamera": 180, "tipo": "10", "listaCoordenadas": [ { "idElemento": "string", "latitude": 15.123456, "longitude": -29.123456 } ]
Para cadastrar equipamentos é necessário georreferenciar um ponto, logo o atributo listaCoordenadas conterá apenas 1 latitude e 1 longitude.
...Para cadastrar áreas é necessário georreferenciar o polígono, logo o atributo listaCoordenadas conterá uma lista de latitudes e longitudes.NÃO É RECOMENDADO enviar georreferenciamento das milhares de posições individuais (de unidades de carga), enviar, no máximo, as quadras (polígono). O mesmo para as posições paletizadas dentro do armazém, enviar, no máximo, o georreferenciamento da área do armazém (polígono).Devemos enviar o georreferenciamento diariamente? Quando uma câmera e/ou equipamento ficar off-line, por qualquer razão, devemos enviar essa informação?
Resposta (atualizada em 26/10/2022, alteração de forma):No evento de Georreferenciamento deve ser cadastrada a existência/instalação de algum equipamento da lista de domínio "tipo" e, ainda, áreas do recinto.Desta forma, presumimos que o recinto vai enviar uma série de eventos deste tipo para todos os equipamentos e áreas (da lista) que possuir.Novos eventos deste tipo serão enviados somente quando novos equipamentos forem instalados ou desativados ou, ainda, caso ocorram alterações nas áreas que foram cadastradas, ou seja, não será enviado diariamente.Equipamentos que fiquem "off line", ou outros problemas de funcionamento, serão informados no evento de "Indisponibilidade de equipamentos". -
Evento Chegada ao Ponto Zero
Quando devo enviar esse evento?
Resposta:Neste evento o recinto deve informar as cargas que recebe da companhia aérea(transportadora) quando do ingresso em seu recinto.Transmitir quando existir ULD (Unit Load Device - Aéreo) -
Situações Especiais
Quais eventos da API Recintos serão integrados com Controle de Carga e Trânsito na Importação (CCT-Importação) modal aéreo?
Resposta (atualizada em 26/10/2022):Os seguintes eventos da API Recintos possuem integração:- "Controle de agendamento/acesso de veículos" possui integração com CCT Importação para a funcionalidade "chegada de veículo terrestre";
- "Geração de lotes" possui integração com CCT Importação para a funcionalidade de "recepção de carga".
Clique aqui para acessar o manual do CCT importação modal aéreo.
O Controle de Carga e Trânsito na Importação (CCT-Importação), modal aéreo, está preparado para contabilizar estoque com os eventos de Geração de Lote por viagem e por ULD da API Recintos?
Resposta (incluída em 25/10/2023):O CCT Importação, modal aéreo, em ambiente de produção, está preparado para que os depositários possam informar a recepção de carga solta utilizando o evento de Controle de Carga Solta-Geração de Lotes da API Recintos. Esta recepção aceita a informação da viagem aérea (informada no campo "viagem") ou terrestre (representada pela DTA informada no campo "declaracaoAduaneira"), e a informação da ULD (campo identificacaoUld). Sendo assim, em tese, seria possível que a recepção de um conhecimento de carga, em determinada viagem, fosse realizada utilizando-se um evento de Geração de Lotes para cada ULD desta viagem. No caso de o conhecimento de carga estar em várias ULDs, seriam então enviados tantos eventos quantas fossem as ULDs desse conhecimento na viagem. Entretanto, o CCT Importação ainda se integra com sistemas legados (DI, Mantra, Siscomex Trânsito), que não estão preparados para receber a informação separada por ULD. Sendo assim, transitoriamente, orientamos aos terminais de cargas de aeroporto que, na recepção de carga, o evento de Geração de Lotes seja transmitido à API Recintos uma única vez para cada conhecimento de carga incluído na viagem, sem a necessidade de identificar as respectivas ULDs (campo identificacaoUld). O depositário deve, portanto, agregar as informações de todas as ULDs recebidas na viagem para aquele conhecimento e enviá-las em um único evento de Geração de Lotes da API Recintos.
-
GERAL