TOTVS Automação Fiscal

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Evandro Dos Santos Oliveira

Gravado em

comparado com

Nova versão 3

changes.mady.by.user Evandro Dos Santos Oliveira

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
    • Integração do Primeiro Vínculo
    • Integração do Segundo Vínculo
  3. Tabelas utilizadas


01. VISÃO GERAL


Este documento tem como finalizada de orientar a configuração do certificado digital no TSS utilizando o módulo de segurança criptográfica Dinamo través através da wizard de configuração do modelo módulo TAF (Totvs Automação Fiscal), este documento tem como base a homologação realizada pelo produto TAF/TSS/Tecnologia e Segurança da Informação em 18/11/2020.

02. 

...

Pré Requisitos

1 - Modulo de Segurança Dinamo. versão: v4.1.4.0

2 - Totvs Appserver (TSS e TAF). versão: 19.3.1.1

3 - RPO com os fontes D-1 (TSS e TAF) referentes a 18/11/2020, versão da lib: 20201123, data da Lib: 20201106_171455


Card documentos
InformacaoAs especificações contidas neste documento são referentes a homologação realizada pelas equipes do TAF/TSS/TEC e SI conforme relatado no tópico Visão Geral, portando as versões mínimas estabelecidas  são as utilizadas nos testes.
TituloIMPORTANTE!


03. Configuração do Dinamo HSM


O Download do dinamo HSM (client) pode ser realizado diretamente do site do fabricante no seguinte endereço: https://docs.dinamonetworks.com/soft_client/downloads

A configuração do dinâmico deve ser solicitada para a equipe de segurança da informação pois necessita do apontamento do servidor e de credenciais para acesso:


Image Added

Após a configuração é necessário a criação das variáveis de ambiente para utilização da biblioteca PKCS#11, a documentação das variáveis podem ser consultadas em https://docs.dinamonetworks.com/integration/pkcs11/configuration. 

Variáveis utilizadas na homologação:


Image Added

Image Added

Obs: DFENCE_PKCS11_IP e DFENCE_PKCS11_USER são os mesmos valores utilizados na configuração do client.


04. Configuração dos parâmetros na Wizard TSS no módulo TAF


...

2.1 - Integração do Primeiro Vinculo

2.1.1 - Neste exemplo utilizaremos a API WsTAFST2 (integração via WebService) para realizar a integração através de um cliente REST (PostMan).

Informaçõs do arquivo: 

Ambiente: 2

Periodo de Apuração: 05-2018

CPF do Beneficiario: 23727526009

Tipo de Pagamento: 1

Data de Pagamento: 16-05-2018

Bloco de código
languagexml
themeEclipse
titlePrimeiro Vínculo
<eSocial xmlns='http://www.esocial.gov.br/schema/evt/evtPgtos/v02_05_00'>
	<evtPgtos Id='ID1123456780000002018060709393704698'>
		<ideEvento>
			<indRetif>1</indRetif>
			<indApuracao>1</indApuracao>
			<perApur>2018-05</perApur>
			<tpAmb>2</tpAmb>
			<procEmi>1</procEmi>
			<verProc>1.0</verProc>
		</ideEvento>
		<ideEmpregador>
			<tpInsc>1</tpInsc>
			<nrInsc>46991782</nrInsc>  
		</ideEmpregador>
		<ideBenef>
			<cpfBenef>23727526009</cpfBenef>
			<deps>
				<vrDedDep>379.18</vrDedDep>
			</deps>
			<infoPgto>
				<dtPgto>2018-05-16</dtPgto>
				<tpPgto>1</tpPgto>
				<indResBr>S</indResBr>
				<detPgtoFl>
					<perRef>2018-05</perRef>
					<ideDmDev>1</ideDmDev>
					<indPgtoTt>S</indPgtoTt>
					<vrLiq>10150.00</vrLiq>
					<retPgtoTot>
						<codRubr>4700</codRubr>
						<ideTabRubr>TBPADRAO</ideTabRubr>
						<vrRubr>3850.00</vrRubr>
					</retPgtoTot>
				</detPgtoFl>
			</infoPgto>
		</ideBenef>
	</evtPgtos>
</eSocial>

2.1.2 - Realizar o envio do lote o serviço REST WSTAFST2 conforme a especificação A configuração do certificado HSM dinamo é realizado através da Wizard de Configuração do TSS, para mais informações acesse: https://tdn.totvs.com/x/aq0lE

Image Removed

2.1.3 - O registro será inserido na tabela TAFST2

Image Removed

2.1.4 - Integrar o registro no TAF através da rotina de processamento:

Image Removed

Image Removed

2.1.5 - Ao final do processamento será gravado na tabela TAFXERP  o Alias e o Recno do Registro integrado:

Image Removed

2.1.6 - Na tabela T3P será incluido o registro, neste exemplo o número do Recno é 1376. Note que o Status está em branco (Não Transmitido).

Image Removed

2.1.7 - Acessando o cadastro  é possível verificar o vinculo integrado.

Periodo 05-2018, Beneficiario 23727526009 - Jose e Data de Pagamento 16/05/2018:

Image Removed

2.2 - Integração do Segundo Vínculo 

2.2.1 -  O Segundo Vinculo segue os mesmos passos do primeiro, a diferença entre os 2 está no grupo pagamentos:

Informaçõs do arquivo: 

Ambiente: 2

Periodo de Apuração: 05-2018

CPF do Beneficiario: 23727526009

Tipo de Pagamento: 9

Data de Pagamento: 04-05-2018

Bloco de código
languagexml
themeEclipse
titleSegundo Vínculo
linenumberstrue
<eSocial xmlns='http://www.esocial.gov.br/schema/evt/evtPgtos/v02_05_00'>
	<evtPgtos Id='ID1123456780000002018060709393704698'>
		<ideEvento>
			<indRetif>1</indRetif>
			<indApuracao>1</indApuracao>
			<perApur>2018-05</perApur>
			<tpAmb>2</tpAmb>
			<procEmi>1</procEmi>
			<verProc>1.0</verProc>
		</ideEvento>
		<ideEmpregador>
			<tpInsc>1</tpInsc>
			<nrInsc>46991782</nrInsc>
		</ideEmpregador>
		<ideBenef>
			<cpfBenef>23727526009</cpfBenef>
			<infoPgto>
				<dtPgto>2018-05-04</dtPgto>
				<tpPgto>9</tpPgto>
				<indResBr>S</indResBr>
				<detPgtoAnt>
					<codCateg>101</codCateg>
					<infoPgtoAnt>
						<tpBcIRRF>11</tpBcIRRF>
						<vrBcIRRF>42000.00</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>00</tpBcIRRF>
						<vrBcIRRF>16661.59</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>09</tpBcIRRF>
						<vrBcIRRF>42040.22</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>31</tpBcIRRF>
						<vrBcIRRF>6401.58</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>41</tpBcIRRF>
						<vrBcIRRF>621.03</vrBcIRRF>
					</infoPgtoAnt>
				</detPgtoAnt>
			</infoPgto>
		</ideBenef>
	</evtPgtos>
</eSocial>

2.2.2 - Realizar o Envio utilizando a API REST WSTAFST2.

Obs: O Envio pode ser através de qualquer meio (exemplo: integração online ou importação de arquivos)

Image Removed

2.2.3 - O registro será inserido na tabela TAFST2

Image Removed

2.2.4 - Realizar a Integração conforme item 2.1.4, após o termino será incluido um registro na tabela TAFXERP informando o Alias e o Recno da tabela em que o evento foi integrado. Note que o Alias e o RecNo são os mesmos do arquivo TAFKEY_PRIMEIRO_VINCULO, o status 2 indica que houve uma alteração no evento.

Image Removed

2.2.5 - Ao acessar o cadastro é possível constatar a aglutinação do evento:

Image Removed

2.2.6 - Após a aglutinação o evento pode ser transmitido, neste exemplo vamos somente gerar o XML para verificar sua estrutura:

Image Removed

2.2.7 - Arquvio gerado a partir da rotina exportar XMLs do monitor e-Social. Note que os pagamentos foram aglutinados e as tags em comum não foram duplicadas.

Bloco de código
languagexml
themeEclipse
titleSegundo Vínculo
linenumberstrue
<eSocial xmlns='http://www.esocial.gov.br/schema/evt/evtPgtos/v02_05_00NT16'>
	<evtPgtos Id='ID2320090378390002020081702170194261'>
		<ideEvento>
			<indRetif>1</indRetif>
			<indApuracao>1</indApuracao>
			<perApur>2018-05</perApur>
			<tpAmb>2</tpAmb>
			<procEmi>1</procEmi>
			<verProc>1.0</verProc>
		</ideEvento>
		<ideEmpregador>
			<tpInsc>2</tpInsc>
			<nrInsc>32009037839</nrInsc>
		</ideEmpregador>
		<ideBenef>
			<cpfBenef>23727526009</cpfBenef>
			<deps>
				<vrDedDep>379.18</vrDedDep>
			</deps>
			<infoPgto>
				<dtPgto>2018-05-04</dtPgto>
				<tpPgto>9</tpPgto>
				<indResBr>S</indResBr>
				<detPgtoAnt>
					<codCateg>101</codCateg>
					<infoPgtoAnt>
						<tpBcIRRF>11</tpBcIRRF>
						<vrBcIRRF>42000.00</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>00</tpBcIRRF>
						<vrBcIRRF>16661.59</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>09</tpBcIRRF>
						<vrBcIRRF>42040.22</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>31</tpBcIRRF>
						<vrBcIRRF>6401.58</vrBcIRRF>
					</infoPgtoAnt>
					<infoPgtoAnt>
						<tpBcIRRF>41</tpBcIRRF>
						<vrBcIRRF>621.03</vrBcIRRF>
					</infoPgtoAnt>
				</detPgtoAnt>
			</infoPgto>
			<infoPgto>
				<dtPgto>2018-05-16</dtPgto>
				<tpPgto>1</tpPgto>
				<indResBr>S</indResBr>
				<detPgtoFl>
					<perRef>2018-05</perRef>
					<ideDmDev>1</ideDmDev>
					<indPgtoTt>S</indPgtoTt>
					<vrLiq>10150.00</vrLiq>
					<retPgtoTot>
						<codRubr/>
						<vrRubr>3850.00</vrRubr>
					</retPgtoTot>
				</detPgtoFl>
			</infoPgto>
		</ideBenef>
	</evtPgtos>
</eSocial>

Card documentos
InformacaoÉ imprescindível que o eventos não estejam transmitidos para que a aglutinação ocorra. Caso o campo TAFCOMP seja informado em 1 dos vínculos todos os demais devem ser integrados com esta informação.
TituloIMPORTANTE!

03. TABELAS UTILIZADAS

...

AuTzEQ

Na etapa de configuração de certificado utilizar os seguintes parâmetros:


Em tipo de certificado selecione HSM

Image Added



Inserir a Label e a senha do certificado, o usuário é cadastrado nas variáveis de ambiente conforme especificado acima. Em caminho e arquivo do módulo HSM selecione a dll referente a biblioteca PKCS#11 (tacndp11.dll), exemplo: C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\c\tacndp11.dll

Image Added



Informações
  • Dentro da pasta SDK existem versões da biblioteca em várias linguagens de programação, utilizar a biblioteca relacionada a linguagem C.
  • O caminho do módulo utilizado foi em um servidor onde estavam instalado o Dinamo e o TSS, desta forma o caminho utilizado foi um path absoluto ou seja é obrigatório que o dinamo esteja no mesmo servidor que o TSS. 


Após avançar é exibido uma mensagem informando os dados do certificado.

Image Added






PKCS11 Instalação: https://docs.dinamonetworks.com/integration/pkcs11/instalation

Module TOTVS TEC: https://tdn.totvs.com/x/

...

6opc




HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>