TOTVS Automação Fiscal

Árvore de páginas

Versões comparadas

Versão antiga 28

changes.mady.by.user ALEXANDRE DE LIMA SANTOS

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user ALEXANDRE DE LIMA SANTOS

Gravado em

Chave

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

Dados Gerais

Módulo:

TOTVS Automação Fiscal (SIGATAF)

Issue:

DSERTAF1-35311

Descrição:

Criação do evento S-5503

Data

03/07/2024

Analistas

Alexandre de Lima Santos

Descrição Funcional

  • Modelo de gravação de dados.
  • Com base nas funcionalidades especificas no front, listagem de todas as APIs necessárias.

01. Tabela Modelo

A tabela modelo irá seguir o padrão TAF de desenvolvimento assim como é hoje, a diferença se da em 4 campos que irão gravar parte do json e xml do totalizador integrado, o modelo abaixo é uma representação dos valores que irão ser gravados em seus respectivos campos assim como as api´s referentes a cada funcionalidade no front.

...

Nome do campoDescrição do campo
VXXT8N_FILIAL Filial do registro
VXXT8N_IDId do registro na tabela
VXXT8N_VERSAO Versão do registro na tabela
VXXT8N_PERAPU Periodo do registro
VXXT8N_ATIVO Status do registro
VXXT8N_EVENTOTIpo do evento (NÃO NECESSARIO)
VXXT8N_STATUSStatus de transmissão (NÃO NECESSARIO)
VXXT8N_XMLID XML id do registro (NÃO NECESSARIO)
VXXT8N_LAYOUT Versão do layout no eSocial
VXXT8N_XMLGRVXml que será gravado no momento do retorno do totalizador.
VXXT8N_VIEW

Json para api Registros S-5503 | Listagem.

VXXT8N_MATCAT

Json para api Trabalhador do S-5503 | Informações Relativas a Matrícula e Categoria.

VXXT8N_STABPAG STABPA

Json para api-Trabalhador do S-5503 | Identificação do estabelecimento responsável pelo pagamento dos valores informados.

Registros S-5503 | Listagem

Ao realizar a requisição para montar a tela de view e as demais telas será passado o id + tag relativa ao campo a ser pesquisado e retornar o json para a view, caso nossa requisição seja para a tela inicial será enviado Id+ Campo, exmplo 00010434_VIEW no caso teremos 00010434 como recno do registro e _VIEW o campo que iremos buscar os valores.

VXX→VXX_VIEW :

...

Campo - VXX_XMLGRV

CampoJson gerado na integração.
VXX_XMLGRV

<eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtFGTSProcTrab/v_S_01_02_00">
    <evtFGTSProcTrab Id="ID0530000000000000000000025822311609">
        <ideEvento>
            <nrRecArqBase>1.1.0000000025822311609</nrRecArqBase>
            <perApur>2024-04</perApur>
        </ideEvento>
        <ideEmpregador>
            <tpInsc>1</tpInsc>
            <nrInsc>53113791</nrInsc>
        </ideEmpregador>
        <ideProc>
            <origem>1</origem>
            <nrProcTrab>10008931220215020016</nrProcTrab>
        </ideProc>
        <ideTrabalhador>
            <cpfTrab>82273082010</cpfTrab>
        </ideTrabalhador>
        <infoTrabFGTS>
            <matricula>GP0001</matricula>
            <codCateg>101</codCateg>
           

...

<infoFGTSProcTrab>
             

...

  <totalFGTS>0</totalFGTS>
           

...

</infoFGTSProcTrab>
        </infoTrabFGTS>
    </evtFGTSProcTrab>
</eSocial>
   

Registros S-5503 | Listagem

CampoJson gerado na integração.
VXX→VXX_VIEW

{
    "hasNext": false,
    "items": [ 
        {
            "id": "

...

00010434",
            "period": "2023-08",
            "cpf": "

...

82977978054",
            "name": "

...

Alex André",
            "receipt": "1.2.

...

0000000000195474657",
            "processNumber": "

...

00010434"
        }

...

    ]
}


image-2024-3-1_14-4-22.png

Trabalhador do S-5503 | Informações Relativas a Matrícula e Categoria

VXX_MATCAT - O conceito de id + tag relativa ao campo a ser pesquisado irá retornar o json para a view.

00010434_MATCAT

Recno = 00010434

Campo = _MATCAT

CampoJson gerado na integração.
VXX→VXX_MATCAT

...

{
    "hasNext": false,
    "items": [ 
        {
            "id": "00010434",
            "registration": "MAT_42227624078",
            "category": "101",
            "fgtsTot": "27000.15"
        }
    ]
}


Trabalhador do S-5503 | Identificação do estabelecimento responsável pelo pagamento dos valores informados

...

CampoJson gerado na integração.

VXX_STABPAG - O conceito de id + tag relativa ao campo a ser pesquisado irá retornar o json para a view.

00010434_STABPAG

Recno = 00010434

...

VXX→VXX_STABPAG

...

"hasNext": false,
    "items": [ 
        {
            "id": "00010434",
            "referencePeriod": "2023-12",
            "category": "101",
            "typeOfLaborProcessValue": "71",
            "remFGTSProcTrab": "59000.99",
            "remFGTSSefip": "845.00",
            "dpsFGTSSefip": "23500.45",
            "remFGTSDecAnt": "5015.19",
            "dpsFGTSDecAnt": "23055.45"
        }
    ]


image-2024-3-1_14-6-39.png


Gravação e geração do modelo :

...

3 - Criar uma função que reavalie o xml do front para gerar novo Json de view caso ocorra erro no momento da integração  que leve dados incorretos a tela ( Hoje temos o reavaliar totalizadores).

02. Chamada da View

Ao realizar a requisição para montar a tela de view e as demais telas será passado o id + tag relativa ao campo a ser pesquisado e retornar o json para a view, caso nossa requisição seja para a tela inicial será enviado Id+ Campo, exmplo 00010434_VIEW no caso teremos 00010434 como recno do registro e _VIEW o campo que iremos buscar os valores.

recno + tag CampoRetorno
00010434_VIEWVXX_VIEWJson
00010434_MATCATVXX_MATCATJson
00010434_STABPAGVXX_STABPAG Json

03. Listagem das api ´s

1- Registros S-5503 | Listagem

 Carrega registros do evento S-5503, filtrados ou não, ordenados ou não.

2- Registros S-5503 | Exclusão

 Exclui eventos S-5503 conforme coleção de ID's informados.

3- Registros S-5503 | XML

Retorna XML's do evento S-5503 encodados em base64.

4- Trabalhador do S-5503 | Informações Relativas a Matrícula e Categoria

Carrega informações relativas a Matrícula e Categoria de trabalhador específico do evento S-5503, ordenadas ou não.

5- Trabalhador do S-5503 | Identificação do estabelecimento responsável pelo pagamento dos valores informados

Carrega informações relativas a Identificação do estabelecimento responsável pelo pagamento a trabalhador específico dos valores informados do evento S-5503, ordenadas ou não.


04. Links de consulta:

https://www.gov.br/esocial/pt-br/documentacao-tecnica/leiautes-esocial-v-1-2-nt-02-2024/index.html#evtFGTSProcTrab

...