DT Portal - API Faturamento - Pré-Cálculo - Zoom de Lote / Documento de Saída

Tempo aproximado para leitura: 3 min

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Disponibilizar API para informações de lote / documento de saída para utilizar os dados para a realização de pré-cálculo de faturamento SARA. A API deverá respeitar as permissões de acesso de portal do SARA, disponibilizando somente dados relacionados a CNPJs aos quais o usuário autenticado possui permissão de acesso.

03. SOLUÇÃO

Desenvolvido API de Zoom de Lote / Documento de Saída que permite filtrar e utilizar os dados para pré-cálculo de faturamento respeitando as regras de acesso a dados de CNPJs liberados na configuração de acesso para portal do SARA.

API Informações do Lote / Documento Saída
Dados de entrada: anoLote, numeroLote, numeroDocumentoSaida, numeroConhecimento
Dados de resposta: lista numeroLote, numeroConhecimento, dataConhecimento e numeroDocumentoSaida

04. DEMAIS INFORMAÇÕES

Como pré-requisito para utilização da solução, o módulo REST-Server do SARA deve estar instalado e em funcionamento. Detalhes da instalação do módulo REST-Server SARA em 05. ASSUNTOS RELACIONADOS / Documento de Referência.

A rota da API deve ser registrada na base de dados. Para registrar a rota, realize o download do script 82-route-PORTAL-FATURAMENTO-PreCalculo-FiltroLote.sql e execute na base de dados do SARA.

Após o registro da rota, realize a liberação de acesso a API para os perfís desejados em Módulo Segurança / Permissões do Perfil conforme imagem abaixo:

A API respeita as permissões de acesso a dados configurados para o Portal WEB SARA, que pode ser realizado em Módulo Segurança / Portal WEB / Permissão de Acesso adicionando o menu Portal Faturamento / Pré-Cálculo como opção de acesso a menu. Entretanto, para que o menu Portal Faturamento / Pré-Cálculo seja exibido como opção, o parâmetro PERMISSAO_ACESSO_MODULO deverá estar configurado para exibir o módulo SARA_APP, além do módulo SARA_WEB já existente. Para isso, adicionar uma vírgula entre o SARA_WEB e SARA_APP (exemplo: SARA_WEB,SARA_APP). Exemplo de configuração de acesso na imagem abaixo:

05. ASSUNTOS RELACIONADOS

Documento de Referência: LOGSARA01-382 DT Appserver Framework Fase II

Documentação do Swagger: ZoomPreCalculoLotePortal_v1000.json

Para visualizar a documentação do Swagger da API, realize o download do arquivo acima e abra-o no endereço https://editor.swagger.io/.

"A TOTVS recomenda que os recintos alfandegados, quando da atualização do sistema informatizado de controle aduaneiro (SARA) observe as normas legais vigentes conforme segue: o artigo 14 da IN   SRF 682/2006 (que dispõe sobre a auditoria de sistemas informatizados de controle aduaneiro, estabelecidos para os recintos alfandegados), estabelece que qualquer alteração ou atualização de versão ou substituição do sistema informatizado de controle deverá ser previamente comunicada à SRF (Secretaria da Receita Federal do Brasil); o artigo 40 da Portaria RFB 3518/2011 (que estabelece requisitos e procedimentos para o alfandegamento recintos) que determina que quaisquer alterações no sistema informatizado de controle aduaneiro, desde que devidamente justificadas pela              administradora do recinto, poderão ser autorizadas pelo titular da unidade de despacho jurisdicionante."