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

TOTVS Gestão Fiscal

Segmento Executor

Backoffice

Requisito/Story/Issue

FISCAL01-9799

Subtarefa

FISCAL01-10176

País

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

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Objetivo

 Detalhar as alterações necessárias no modulo TOTVS Gestão Fiscal para a implementação a integração dos Eventos da EFD-REINF com os webservices (WS) TOTVS Service Soa (TSS)

WebService do TSS

Na integração com o TSS deverá ser utilizado o WS TSSWSREINF onde são disponibilizados os serviços abaixo.

A documentação do TSS pode ser consultada através do link  http://tdn.totvs.com/display/TSS/WebService+-+TSSWSREINF. As parametrizações de integração com o TSS já estão disponíveis no parâmetro da Filial do modulo de Estoque nas etapas referentes à integração com o módulo Fiscal.

Configurar Ambiente

Antes de utilizar o WS da EFD-REINF listados acima é necessário configurar o TSS utilizando os WS abaixo.

  • SpedAdm para configurar a filial que está emitindo os Eventos através do serviço AdmEmpresas. Este Serviço já está implementado e disponível através da interface IFisSpedAdm do projeto RM.Fis.TSS.IService;
  • SpedCfgNfe para configurar o certificado digital através dos serviços CFGCERTIFICATE, CFGCERTIFICATEPFX ou CFGHSMEX. Este serviço já está implementado e disponível através do server FisCertificadoService do projeto RM.Fis.TSS.Service.

Para manter o padrão deverá ser criado uma interface (IFisTssWsReinf) no projeto RM.Fis.TSS.IService para o WS TSSWSREINF com os serviços WsValidarSchema, WsEnviarEventos, WsConsultarEventos. Esta interface deve ser implementada de forma semelhante a IFisSpedAdm. Esta prática evita que outros projetos tenham referências diretas ao TSS.

VALIDARSCHEMA

Através deste WS é realizada a validação da estrutura do XML do Evento conforme o schema disponibilizado pela RFB. Segue abaixo os parâmetros de entrada e saída do serviço. Para mais detalhes consulte a documentação do TSS http://tdn.totvs.com/x/HUhZEg

Parâmetro

Tipo

Tam

Observação

AMBIENTEAlfanumérico1

Conforme definido para o Evento

2 – Produção Restrita Dados Reais.

3 - Produção Restrita Dados Fictícios.

CODIGO

Alfanumérico

10

Código do evento, conforme disponibilizado pela Receita Federal. R-1000, R-2010 etc.

ENTIDADE

Alfanumérico

 6

Código da entidade registrada no TSS.

Retornado pelo serviço AdmEmpresas

ID

Alfanumérico

100

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento.

USERTOKEN

Alfanumérico

6

Fixo TOTVS.

VERSAOAlfanumérico15

Versão do Evento.

Conforme definido nos parâmetros da EFD-REINF

 XML

BASE64Binary


Lista de XMLs dos eventos, conforme layout do Evento.

O layout de cada Evento está definido na especificação do mesmo.

Cada requisição poderá ser realizada com no máximo 100 Eventos.

Parâmetro

Tipo

Tam

Observação

AMBIENTEAlfanumérico1

Ambiente do envio:

2 – Produção Restrita Dados Reais.

3 - Produção Restrita Dados Fictícios.

ENTIDADE

Alfanumérico

 6

Código da entidade registrada no TSS.

ERRO

Alfanumérico

6

Retorno Sefaz com a descrição da rejeição.

ID

Alfanumérico

100

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento.

STATUS

Booleano

1

Indicador de envio com sucesso.

VERSAOAlfanumérico15Versão do Evento.

ENVIAREVENTOS

Através deste WS é realizado o envio dos XMLs dos Eventos ao TSS. Segue abaixo os parâmetros de entrada e saída do serviço. Para mais detalhes consulta a documentação do TSS http://tdn.totvs.com/x/EUJZEg

Parâmetro

Tipo

Tam

Pai

Observação

ENVIAREVENTOS

Estrutura

-

-

 -

REINFENVIO

Estrutura

- 

ENVIAREVENTOS

 -

CABEC

Estrutura

-

REINFENVIO

-

AMBIENTE

Alfanumérico

1

CABEC

Conforme definido para o Evento

2 – Produção Restrita Dados Reais.

3 - Produção Restrita Dados Fictícios.

ENTIDADE

Alfanumérico

 6

CABEC

Código da entidade registrada no TSS.

Retornado pelo serviço AdmEmpresas

USERTOKEN

Alfanumérico

6

CABEC

Fixo TOTVS.

VERSAOAlfanumérico15CABEC

Versão do Evento.

Conforme definido nos parâmetros da EFD-REINF

EVENTOS

Estrutura

-

REINFENVIO

 Lista de Eventos

REINFENVIOEVENTOEstrutura-EVENTOS-

CODIGO

Alfanumérico

10

EVENTOS

Código do evento, conforme disponibilizado pela Receita Federal. R-1000, R-2010 etc.

ID

Alfanumérico

100

EVENTOS

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento.

XML

BASE64Binary


EVENTOS

Deverá ser enviado o XML que foi validado através do serviço VALIDARSCHEMA

  • Cada requisição poderá ser realizada com no máximo 100 Eventos.
  • Só podem ser enviados os XML válidos, ou seja, aqueles que passaram pela validação de schema sem erros.

Parâmetro

Tipo

Tam

Observação

AMBIENTEAlfanumérico1

Ambiente do envio:

2 – Produção Restrita Dados Reais.

3 - Produção Restrita Dados Fictícios.

ENTIDADE

Alfanumérico

 6

Código da entidade registrada no TSS.

ERRO

Alfanumérico

6

Retorno Sefaz com a descrição da rejeição.

ID

Alfanumérico

100

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento.

STATUS

Booleano

1

Indicador de envio com sucesso.

VERSAOAlfanumérico15Versão do Evento.

CONSULTAREVENTOS

Para o serviço CONSULTAREVENTOS sugiro que seja utilizado o serviço SpedAdm.GetAdmEmpresasId para recuperar o código da entidade do TSS conforme documentação do TSS http://tdn.totvs.com/x/cZhSDg

Neste serviço é desnecessário a utilização do WS SpedCfgNfe

Através deste WS é realizada a consulta do XMLs dos Eventos no TSS. Segue abaixo os parâmetros de entrada e saída do serviço. Para mais detalhes consulta a documentação do TSS http://tdn.totvs.com/x/EkBZEg

Parâmetro

Tipo

Tam

Pai

Observação

CONSULTAREVENTOS

Estrutura

-

-

 -

REINFCONSULTA

Estrutura

-

-

 -

CABECEstrutura
REINFCONSULTA-

ID_ENT

Alfanumérico

 06

CABEC

Código da entidade registrada no TSS.

Retornado pelo serviço AdmEmpresas

RETORNAXMLLógico-CABECFixo true

USERTOKEN

Alfanumérico

06

CABEC

Fixo TOTVS.

EVENTOS

Estrutura

 -

REINFCONSULTA

Lista de ID dos Eventos

REINFID

Estrutura

-

EVENTOS

- 

ID

Alfanumérico

100

REINFID

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento

Cada requisição poderá ser realizada com no máximo 100 Eventos.

Parâmetro

Tipo

Tam

Pai

Observação

CONSULTAREVENTOSRESULT

Estrutura

-

-

 -

REINFRETCONSULTA

Estrutura

-

CONSULTAREVENTOSRESULT

-

CHAVE

Alfanumérico

36

REINFRETCONSULTA

Chave Evento.

CODEVENTO

Alfanumérico

10

REINFRETCONSULTA

Código Evento.

CODRECEITA

Alfanumérico

10

REINFRETCONSULTA

 Código da Receita

DETSTATUSAlfanumérico1REINFRETCONSULTADetalhe do evento, conforme disponibilizado pela Receita Federal.
DSRECEITAAlfanumérico30REINFRETCONSULTADescrição do Código Receita.

DTENTRADA

Date

8

REINFRETCONSULTA

Data Entrada Evento.

DTPROC

Date

8

REINFRETCONSULTA

Data Processamento Evento.

DTTRANSDate8REINFRETCONSULTAData Transação Evento.
HRENTRADAAlfanumérico8REINFRETCONSULTAHora Entrada Evento.
HRPROCAlfanumérico8REINFRETCONSULTAHora Processamento Evento.
HRTRANSAlfanumérico8REINFRETCONSULTAHora Transação Evento.
IDAlfanumérico100REINFRETCONSULTA

Identificador do evento.

Este identificador é gerado pelo ERP emissor do evento.

LOTEAlfanumérico32REINFRETCONSULTANúmero do Lote.
PROTOCOLOAlfanumérico40REINFRETCONSULTANúmero do Protocolo.
RECIBOAlfanumérico30REINFRETCONSULTANúmero do Recibo.
STATUSAlfanumérico1REINFRETCONSULTAStatus do documento no TSS.
VERSAOAlfanumérico8REINFRETCONSULTAVersão do Evento.

XMLEVENTO

Alfanumérico


REINFRETCONSULTA

Detalhes do xml do evento

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