Cross Segmentos - Linha Datasul - MOF - html.mcd.govApiParams - Parâmetros para Consumo das APIs do Governo

Tempo aproximado para leitura: 00:03:20 min

Dúvida
Qual o objetivo do parâmetro html.mcd.govApiParams ?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Obrigações Fiscais (MOF) - 12.1.2607

Solução
O programa (html.mcd.govApiParams) - Parâmetros para Consumo das APIs do Governo tem o objetivo de 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. 
Sendo assim,  programa permite parametrizar os certificados digitais que serão utilizados para o consumo das APIs do governo. Os parâmetros cadastrados poderão ser usados para consumir as APIs do Governo, conforme será demonstrado para o programa (html.mcd.credPres) - Cadastro de Crédito Presumido.

1.Tela:

1.1.Parâmetros 

A empresa é um campo não editável, que traz automaticamente o valor da empresa logada no sistema.

Os campos apresentam em suas descrições internas os formatos de extensão que devem ser preenchidos ao final de cada informação (Ex: chavecertificado.pem). Caso não sejam fornecidas essas extensões, o programa irá preenchê-las automaticamente. 

Detalhamento dos campos

Tipo Certificado: Este campo indica qual o tipo de certificado digital será utilizado. Se é PEM, um formato que utiliza de um arquivo chave para o certificado ou se é PFX, um outro formato de certificado digital que funciona com uma senha.

Caminho cURL: Este campo é o caminho completo até o arquivo executável do cURL, componente que realiza as requisições para as APIs do portal da Conformidade Fácil. Esse campo deve ser obrigatoriamente preenchido quando o sistema operacional do servidor RPW for Windows. O motivo é que o cURL padrão do Windows não possui suporte ao uso de SSL nas requisições, o que é necessário para trabalhar com certificados digitais. O arquivo executável do cURL deve poder ser acessado a partir do servidor RPW de escolha para execução do programa.
Para verificar se o seu cURL possui suporte ao SSL, basta digitar o seguinte comando na linha de comando: curl --version. O resultado deve ser semelhante a imagem abaixo:

Para realizar a instalação de uma versão do cURL que possua suporte a SSL acesse: https://curl.se/windows/.

O campo deve conter o caminho completo até a instalação do cURL. Exemplo: C:\ProgramData\chocolatey\bin\curl.exe.

Para descobrir o caminho de instalação do seu cURL no Windows, basta digitar o seguinte comando na linha de comando: where curl. O resultado deve ser semelhante a imagem abaixo:

Caminho Arquivo Certificado: Este campo deve conter o caminho completo até o arquivo do certificado digital que será utilizado, independente do seu tipo. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW. 
Exemplo: C:\Users\testes\certificado_digital.pfx ou C:\Users\testes\certificado_digital.pem.

Chave Certificado: Este campo deve conter o caminho completo até o arquivo de chave do seu certificado digital do tipo .pem. Caso seu tipo de certificado seja .pfx, o preenchimento desse campo não é necessário. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW. Exemplo: C:\Users\testes\certificado_digital.key.

Senha Certificado: Este campo deve conter a senha do seu certificado digital do tipo .pfx. Caso seu tipo de certificado seja .pem, o preenchimento desse campo não é necessário. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW.

O programa apresentará mensagens de erro ao tentar salvar a parametrização quando houver campos obrigatórios vazios.

Saiba Mais:
Reforma Tributária

Glossário
CBS - Contribuição sobre bens e serviços
IBS - Imposto sobre bens se Serviços
API - Interface de Programação de Aplicações
RPW - Remote Procedure Wait