01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Função:


País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :

DBACKRTDTS-6588


02. SITUAÇÃO/REQUISITO

Disponibilizada API de integração do projeto Conformidade Fácil. O objetivo deste serviço é expor interfaces gratuitas para que os sistemas possam estar atualizados com as tabelas e definições das principais codificações e indicadores que associam legislação do IBS e CBS com as regras de validação aplicadas nos ambientes de autorização dos DFe.

03. SOLUÇÃO

Desenvolvido o programa html.mcd.xxxxxxx, que permite parametrizar os certificados digitais que serão utilizados para o consumo das APIs do governo.


Foram criadas novas tabelas para suprir as necessidades de armazenar os parâmetros e controlar as requisições realizadas.

DatabaseTable NameLabelDescription
mgindparametros-api-govParâmetros API GovParâmetros para uso das APIs do governo.
Field NameData TypeFormatLabelColumn LabelDescripton/Help TextMandatory
empresaCharacterx(3)Código EmpresaCódigo EmpresaCódigo da empresa que os registros da tabela terão como chaveYES
tipo-certificadoInteger>>9Tipo CertificadoTipo CertificadoTipo do certificado que será utilizado. Pode ser .pfx ou .pem.NO
caminho-arquivo-certificadoCharacterx(500)Arquivo CertificadoArquivo CertificadoCaminho de onde está salvo o arquivo do certificadoNO
caminho-curl-exeCharacterx(500)Caminho cUrlCaminho cUrlCaminho do arquivo executável curl.exe com versão OpenSSLNO
chave-certificadoCharacterx(500)Chave CertificadoChave CertificadoChave do certificado digitalNO
senha-certificadoCharacterx(500)Senha CertificadoSenha CertificadoSenha do arquivo do certificado para consumo das APIs.NO
cod-servidor-rpwCharacterx(100)Servidor RPWServidor RPWIdentificação do Servidor RPW.NO
Índice primárioCampo
idx-empresaempresa
DatabaseTable NameLabelDescription
mgindrequisicao-api-govRequisição API GovControle de requisições das APIs do governo.
Field NameData TypeFormatLabelColumn LabelDescripton/Help TextMandatory
tipo-servicoCharacterx(100)Tipo do ServiçoTipo do ServiçoIdentificador do tipo da API que foi executada (Ex: credPres)YES
data-execDate99/99/9999Data de ExecuçãoData de ExecuçãoData da consulta da APINO
hora-execCharacter99:99:99Hora de ExecuçãoHora de ExecuçãoHorário da consulta da API.NO
codigo-statusInteger>>9Codigo StatusCodigo StatusO retorno HTTP (200, 429, 500).NO
sucessoLogicalYES/NOSucessoSucessoFlag rápida para filtrar se a requisição foi feita com sucessoNO
mensagem-erroCharacterx(500)Mensagem de ErroMensagem de ErroDescrição amigável caso a requisição tenha falhado.NO
Índice primárioCampo
idx-tp-servico

tipo-servico

Foi desenvolvido o programa Cenários Automatização Eventos, que permite cadastrar os cenários que serão utilizados para a geração automática dos eventos.

(html.mcd.cenarioEventoTributos) - Cenários Automatização Eventos:



Filtros:

Para os campos de Estabelecimento e Natureza de operação, podem ser preenchidos múltiplos valores, ou os campos podem ser preenchidos com asterisco para que sejam selecionados todos os cadastrados.

Os campos de Período, Série, Emitente e  Documento são faixas de pesquisa, sendo necessário preencher o campo inicial e final. Caso os filtros não sejam totalmente preenchidos, o relatório irá filtrar todos os dados, automaticamente . Caso queira preencher os filtros manualmente, atentar-se aos seguintes tamanhos para cada campo:

Série: campo alfanumérico com até 5 dígitos. Exemplo: zzzzz

Documento: campo alfanumérico com até 16 dígitos. Exemplo: zzzzzzzzzzzzzzzz

Emitente: campo numérico com até 9 dígitos. Exemplo: 999999999

Período: campo data no formato dd/mm/aaaa. Exemplo: 12/01/2026


Filtros Refinados:

Finalidade de emissão da NF-e: Podem ser selecionadas múltiplas finalidades. Caso nenhuma finalidade seja selecionada, serão pesquisadas todas as finalidades.

Situação dos documentos: Filtra por documentos com situação normal, cancelada, ou ambos.

Tipo de movimento: Podem ser selecionadas múltiplos tipos de movimento. Caso nenhum seja selecionado, serão pesquisados todos as tipos de movimento.

Configurações de exibição:

Tipo de tributo: Determina quais tributos serão apresentados no relatório.

Grupos: Determina quais grupos serão apresentados no relatório. Caso nenhum seja escolhido, serão apresentados todos.


Geração:

O relatório pode ser executado de forma On-line, onde o arquivo é baixado no navegador, Batch, onde a geração do arquivo é executada via RPW e o arquivo salvo na pasta do servidor RPW, e também Central de Documentos, onde o arquivo é gerado na pasta do servidor.

Além disso, é possível escolher entre tipo de relatório Resumido, onde são apresentados os valores apenas a nível de documento, e Detalhado, onde são apresentados os valores a nível de documento e item do documento.


Ao clicar em Gerar, o programa irá por padrão exibir a seguinte mensagem de aviso:

Após a execução, será gerada a planilha Demonstrativo_Apurac_CBS_IBS.xml, junto com o arquivo de acompanhamento, conforme tipo de execução selecionado na tela de parametrização.

Para a execução Resumida, serão geradas apenas as abas de Parâmetros e Documento.






04. ASSUNTOS RELACIONADOS