Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Integração do Primeiro Vínculo
- Integração do Segundo Vínculo
- Integração do Primeiro Vínculo
- 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 | ||||
---|---|---|---|---|
|
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:
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:
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
<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
2.1.3 - O registro será inserido na tabela TAFST2
2.1.4 - Integrar o registro no TAF através da rotina de processamento:
2.1.5 - Ao final do processamento será gravado na tabela TAFXERP o Alias e o Recno do Registro integrado:
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).
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:
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<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)
2.2.3 - O registro será inserido na tabela TAFST2
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.
2.2.5 - Ao acessar o cadastro é possível constatar a aglutinação do evento:
2.2.6 - Após a aglutinação o evento pode ser transmitido, neste exemplo vamos somente gerar o XML para verificar sua estrutura:
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<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 | ||||
---|---|---|---|---|
|
03. TABELAS UTILIZADAS
...
Na etapa de configuração de certificado utilizar os seguintes parâmetros:
Em tipo de certificado selecione HSM
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
Informações |
---|
|
Após avançar é exibido uma mensagem informando os dados do certificado.
PKCS11 Instalação: https://docs.dinamonetworks.com/integration/pkcs11/instalation
Module TOTVS TEC: https://tdn.totvs.com/x/
...
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> |