Versões comparadas

Chave

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




 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

 

Especificação

Produto

 RM

Módulo

 Fiscal

Segmento Executor

Serviços

Projeto1

Integração RM X TAF

IRM1


Requisito1

FISCAL01-3559

Subtarefa1


Chamado2


Release de Entrega Planejada

12.1.20

Réplica: 12.1.18, 12.1.19


País

(x) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>

Objetivo

Implementar Documentar as implementações do cadastro de controle das integrações das informações do RM para o TAF para a geração da REINF

Definição da Regra de Negócio

  • As informações serão geradas através do Gerador de Saídas em layout específico para este fim.
  • Os registros serão são gravados em uma tabela a ser criada que será especificada adiante neste documentotabela interna para posterior envio ao TAF (DINTEGRACAOTAF).
  • A visualização dos registros será feita através de cadastro a ser desenvolvido.
    • O cadastro deverá permitir permite a visualização dos registro registros em lista na qual poderão ser selecionados um ou mais registros para a  execução do processo de integração com o TAF
    • O cadastro deverá permitir permite a abertura dos registros somente para a visualização. Não será permitida a edição ou inclusão de registros .Deverá ser permitido a exclusão do registro com exceção dos registros com Status " - Incluído" ou " - Registro integrado com erro"
  • Os registros desta visão deverão possuir possuem um anexo onde será é armazenado o log da integração, semelhante ao existente na visão de Notas Fiscais Eletrônicas.Através deste cadastro será feita a integração das informações com o TAF.
  • Os registros terão seus status controlados de acordo com os processos executados.
     Eles poderão assumir os seguintes valores:
    • Incluído: Status inicial do registro quando ele é gravado na tabela "DINTEGRACAOTAF"  e que ainda não foi integrado com o TAF. 
    • "Registro Enviado para o TAF" ou "Enviado Integração Banco x Banco":  O status deverá ser apresentado quando o registro  for enviado para a integração TAF via processos "Integração TAF - WebService - Envio" ou "Integração TAF - Banco x Banco".
    • Registro com erro na integração. O status é apresentado quando o registro integrado com o TAF apresentar erros de estrutura ou de validação realizado pelo TAF.
    • Registro integrado com sucesso com o TAF. O status é apresentado quando o registro for integrado com sucesso pelo TAF.
    • Registro integrado via banco de dados. O status é apresentado quando o registro for integrado com sucesso pelo TAF a partir da tabela TAFST1.
  •  (Não Implementado aindaMelhoria - Implementação futura) Cada registro deverá indicar sua origem conforme relação a ser criada com base nos registros do layout TAF conforme exemplo abaixo:
    • Registro TAF T001 - Complemento do Cadastro de Estabelecimentos  => Cadastro de Filiais no RM.
    • Registro TAF T013 - Cadastro de Documentos Fiscais => Lançamentos de Entrada/Saída no RM.
  • (Não Implementado aindaMelhoria - Implementação futura) Deverá ser feito o controle dos registros do RM que já foram integrados para que no processo possa-se escolher integrar todos os registros, somente os não integrados ou somente os já integrados.
  • (Não Implementado aindaMelhoria - Implementação futura) Para que não sejam gerados problemas de performance a tabela que armazena os registros da integração será incluída no processo de Liberação de Período.
  • O envio das informações da REINF para a receita e controle de seus recibos será feito somente pelo TAF não sendo retornadas para o TOTVS Gestão Fiscal. 
  • O TOTVS Gestão Fiscal fará somente o controle das informações integradas com o TAF para a geração da REINF.


Especificação das tabelas a serem criadas para auxiliar o processo

Nome da Tabela: DINTEGRACAOTAF A tabela poderá ser alterada de acordo com necessidades surgidas no momento da implementação porém a existência destes campos é obrigatória para a comunicação com o webservice do TAF. 

Uma vez que os dados desta tabela serão são a ligação entre as informações do TOTVS Gestão Fiscal e o TAF não será permitida a exclusão dos mesmo. (Não Implementado aindaMelhoria - Implementação futura) Para solucionar um possível problema com performance deverá ser criada uma tabela espelho desta (DINTEGRACAOTAFHIST) para que os registros desta tabela sejam transferidos via processo de Liberação de Período. 

CAMPOTIPOTAMANHOPRECISÃOSCALEPERMITE NULODESCRIÇÃO
CODCOLIGADAint-

nãoCódigo da Coligada
IDINTEGRACAOTAFint-

nãoID de Integração RM x TAF
TAFFILvarchar40          simEmpresa e Filial de integração
TAFCODMSGvarchar1          nãoTipo da mensagem de integração
TAFSEQvarchar3          simSequencial da mensagem de integração
TAFTPREGvarchar10          simTipo do Registro a ser integrado
TAFKEYvarchar100          simChave do Registro a ser integrado
TAFMSGtext16          simMensagem de integração
TAFSTATUSvarchar1          simStatus do Registro
TICKETCODEvarchar50

simCódigo do Lote do Registro

Tabela de log da integração

Nome da Tabela: DINTEGRACAOTAFLOG

Nesta tabela devem ser serão gravados os registros referentes às tentativas de integração do registro RM com o TAF.

CAMPOTIPOTAMANHODESCRIÇÃO
CODCOLIGADAint

-

Código da Coligada
IDLOGint

-

Id do Log da Integração RM x TAF
DATALOGdatetime
Data do Log da Integração RM x TAF
CODIGOERROint-Código do erro na Integração RM x TAF
MENSAGEMmemo

256

Log da Integração RM x TAF
IDINTEGRACAOTAFint-Sequencial do registro da DINTEGRACAOTAF


(Melhoria - Implementação futura) Observação: Esta tabela também deverá ser incluída no processo de Liberação de Período. Os registros serão gravados por este processo na tabela DINTEGRACAOTAFLOGHIST. Esta implementação será entregue em liberações futuras.


Parametrização

Para atender ao processo de integração das informações da REINF com o TAF será necessário que sejam criados alguns parâmetros que deverão ser preenchidos pelo usuário é necessário o preenchimento dos parâmetros para integração de acordo com o seu ambiente TAF.

Localização: Processo 03.05 - Integração | 03.05.05 - TAF

Servidor:  Onde o TAF está instalado (de onde o webservice da REINF é distribuído)

Porta:  Pota na qual o webservice da REINF escuta

Usuário:  O mesmo utilizado para  login no TAF

Senha: A mesma utilizada para login no TAF

          É obrigatório a informação de todos os parâmetros para que os registros sejam integrados com o TAF via WebService.

Tela

obs.: Caso na Base de Dados não seja encontrado o Script com os Parâmetros da Integração com o TAF, será visualizada uma mensagem informando a inconsistência.          É obrigatório a informação de todos os parâmetros para que o registro seja integrado com o TAF via WebService



O Cadastro


No Acesse o menu Obrigações Fiscais | TAF, o sub-menu de nome TAF-Fiscal terá seu nome alterado para "Integração RM X TAF e passara a carregar a visão de registros de integração no lugar a tela de geração da integração. Esta passará a ser carregada pelo menu de processos deste novo cadastro".


Para

os registros deverá ser criado um anexo para armazenar as operações de integração e inconsistências que poderão ocorrerO Log de integração é acessado através do Menu Anexos | Log da Integração do Registro.


 Os registros não poderão ser editados ou excluídos mas deverá ser criada uma tela de visualização para os mesmos conforme modelo , apenas visualizados conforme imagem abaixo.

A geração da integração (execução do layout TAF do gerador de saídas) poderá ser chamada pelo menu de processos do cadastro e também pelo menu Obrigações Acessórias | TAF | Integração RM x TAF. (Não Implementado ainda) Avaliar a possibilidade de criação de um processo para a exportação do XML que será retornado pelo TAF.   

Image Removed

Descrição do processo

Menu de processos atual:

Image Removed

Novos processo a serem criados:

Image Removed

O parâmetro Nome da tabela do TAF deve ser alterado para o nome da nova tabela criada

Os registros de integração devem ser gerados com o layout do gerador de saídas exclusivamente criado para este processo. Esta geração poderá ser disparada de  dentro do cadastro Integração RM X TAF no menu de Processos "Geração de Registros - TAF Fiscal". Esta etapa irá:


Descrição do processo

Image Added


Processo "Geração de Registros - TAF Fiscal"

Este processo seleciona os lançamentos de acordo com os parâmetros passados para o Layout do Gerador de Saída e grava os dados selecionados na tabela DINTEGRACAOTAF. 

Primeiro deve-se importar para o sistema o Layout atualizado para integração com o TAF. Ao executar o processo informe os parâmetros para seleção e demais informações solicitadas pelo layout.

DICA!!! Marque o campo "Gravar preferências do Usuário" para agilizar novas (re)gerações.


Image Added


(Melhoria - Implementação futura) 

  • Gravar os registros e integração na tabela DINTEGRACAOTAF
  • Marcar os lançamentos selecionados no processo como já exportados. Para isto deverá ser utilizado o campo DLAF.STATUSEXPORTFAZ

    (Não Implementado ainda)Deverão ser criados quatro processos para trabalhar com a integração dos registros como TAF

    .


    Integração TAF - WebService -

    Envio

    Envio 

    • Este processo deverá chamar chama o método POST do web service do TAF.
    • Se não houver nenhum registro selecionado na visão serão selecionados todos os registros com status Image Modified - Incluído
    • Se houver registros selecionados somente estes serão integrados.
    • Após o envio o status do registro deverá ser alterado de acordo com o resultado da chamada do serviço.

    Integração TAF - WebService - Consulta

    • Este processo deverá chamar chama o método GET do web service do TAF.
    • Se não houver nenhum registro selecionado na visão serão selecionados todos os registros com status Image Modified "Registro Enviado para o TAF" ou "Enviado Integração Banco x Banco"
    • Se houver registros selecionados somente este estes serão consultados.
    • Os registros consultados deverão ter terão seu status alterado de acordo com o resultado da consulta.
    • Deverá ser verificada a necessidade de alterar o status dos Lançamentos Fiscais associados aos registros do TAF. (Não Implementado aindaMelhoria - Implementação futura)


    Integração TAF - WebService - Excluir (

    Não Implementado ainda

    Melhoria - Implementação futura)

    • Este processo deverá deve chamar o método DELETE do web service do TAF.
    • Este processo deve exigir a seleção de pelo menos um registro para ser executado para garantir que um clique indevido no menu apague todos os registros listados na visão.
    • Os registros processados com sucesso devem ser deletados da tabela de integração.

    Integração TAF - Banco x Banco

    • No Este Processo deve ser utilizado no caso de impossibilidade de uso do web service do TAF para integração dos registros deverá ser criada como contingência o uso da integração banco X banco.
    • Este processo consiste na gravação dos registros que estão na tabela de integração com o status "Image Modified - Incluído" na tabela TAFST1. Os registros processados deverão: 
      • Permanecer gravados na tabela de integração e ter seu status alterados para Integrados via Banco de Dados
      • Ser gravados na tabela TAFST1 para posterior integração com o TAF.
      • Posteriormente ser consultados através do processo Integração TAF - WebService - Consulta
    • Implementações futuras (Não Implementado ainda

    (Melhoria - Implementação futura)

    • Implementar a opção de integração ao TAF de um Lançamento Fiscal específico ou um intervalo. Este filtro poderá ser feito por data ou número do documento. Este processo poderá ser chamado pelo processos na visão de Lançamentos Fiscais de Entrada/Saída e também pela visão do novo cadastro criado para a integração com o TAF.
    • Integração on line de Lançamentos Fiscais. Ao salvar um registro de Lançamento Fiscal  gravar os registros correspondentes no layout de integração TAF. Verificar no layout de integração quais são os registros relacionados ao Lançamento Fiscal, como itens, CliFor, observação, etc. 

    O web service de integração com o TAF

      • Para mais informações a respeito acesse: http://tdn.totvs.com.br/pages/viewpage.action?pageId=270904682
      • Para a integração dos registros deve-se chamar o método POST do webservice : O objetivo do método é enviar informações que devem ser gravadas na tabela transacional do TAF  ( TAFST2 ), permitindo que os dados sejam submetidos aos processos de integração.
      • Para consultar o status da integração deve-se chamar o método GET do webservice: O método GET retorna os status dos registros integrados de acordo com os parâmetros (atributos) enviados na URL.
      • Para deletar um registro ou conjunto de registros deve-se chamar o método DELETE: O método DELETE permite excluir toda a cadeia de integração de um TICKETCODE; Um ticket submetido a exclusão tem seus TAFKEYS avaliados, rastreados e excluídos, desde a sua inclusão na TAFST2 e TAFXERP até o cadastro no TAF caso já tenha ocorrido o Processamento. 

     Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.