Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
iddocentrada
labelREINF - Documento Entrada
titledocentrada
effectTypeslide
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide
Column
Aviso
titleATENÇÃO - EFD-Reinf 2.1.1
Foi publicado no Diário Oficial da União, de 08/07/2022, Ato Declaratório Executivo COFIS nº 60, de 6 de julho de 2022, que aprova a versão 2.1.1 dos leiautes dos arquivos que compõem aEscrituração Fiscal Digital de Retenções e Outras Informações Fiscais - EFD-Reinf, que será exigida para os eventos ocorridos a partir da competência de março de 2023.
Para ter acesso ao Ato Declaratório Executivo, clique aqui.
Para ter acesso à versão 2.1.1 dos leiautes, clique aqui.
Para ter acesso ao Manual de orientação do usuário,  clique aqui.
Não deixe para aplicar as atualizações para a última hora, pois os dados de março/2023 já deverão conter as informações a serem enviadas a RFB em abril/2023 (verifique os links na sessão do lado direito da página).


Através do documento de entrada, será possível aplicar alguma suspensão judicial de tributos (IR / PIS / COFINS / CSLL).

Para aplicar suspensão judicial no documento de entrada, se faz necessário informar "natureza de rendimento" e ter "processos referencias" vinculados ao cadastro do fornecedor.DFdasdfsgvfs eg


Card
defaulttrue
effectDuration0.5
idFluxograma
labelFluxograma / Etapas do Processo
titleFluxograma
effectTypeslide
Deck of Cards
effectDuration0.5
idFluxo
effectTypeslide
Card
defaulttrue
effectDuration0.5
idFluxograma
labelFluxograma
titleFluxograma
effectTypeslide
Painel
titleDescrição das Etapas do Processo

(aviso) Observação:   


[Imagem para ilustrar o Fluxo integração Importador XML e TOTVS Transmite]



Card
defaulttrue
effectDuration0.5
idEtapas
labelEtapas
titleEtapas
effectTypeslide
Painel
titleDescrição das Etapas do Processo

(aviso) Observação: Para um melhor aproveitamento e entendimento da integração entre o Importador XML e TOTVS Transmite é importante que o usuário tenha o conhecimento prévio  



Etapas
Importador XML x TOTVS Transmite

Descrição do Processo

TOTVS Transmite

Descrição do Processo 

Importador XML

Descrição do Processo

TEC




PASSO 1

Configuração da integração Importador XML x Totvs Transmite


Parâmetros:

  • MV_IMPXML (Habilitado Importador XML)
  • MV_XMLCID (Client Id Transmite)
  • MV_XMLCSEC (Client Secret Transmite)
  • MV_APITRAN (Ambiente Transmite)
  • MV_NGINN (Pasta IN)
  • MV_NGLIDOS (Pasta Lidos)
    MV_TRAXML (Pasta a ser criada dentro da Pasta IN - MV_NGINN)
  • MV_DOCIMP (Tipo documentos a serem importados)

Wizard:

Através do Wizard é possível configurar todos os parâmetros descritos acima e informar as filiais do Importador XML que serão integradas junto ao Totvs Transmite (Gravando na DHW)


PASSO 2

Agendamento COLAUTOREAD


  • Inicia verificando se possui XMLs na pasta IN (MV_NGINN)
  • Após leitura da pasta IN (MV_NGINN), é feita a chamado do EndPoint no Totvs Transmite para requisitar os XMLs pendentes para integração com Importador XML

Importante: Para correto funcionamento do EndPoint, é preciso ter:

  • Tabela DHW com o vinculo entre as filiais do Protheus e Totvs Transmite
  • Parâmetro: MV_DOCIMP e MV_XMLDIAS

PASSO 3

Agendamento COLAUTOREAD

Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus os "Recibos"

Importante: Totvs Transmite retorno um recibo por tipo de documento (MV_DOCIMP)



PASSO 4

Agendamento COLAUTOREAD


Protheus (Importador XML) recebe os "Recibos" do Totvs Transmite e os grava na tabela DHY

PASSO 5

Agendamento COLAUTOREAD


Com os "Recibos" na tabela DHY é feito a chamada de outro EndPoint no Totvs Transmite para gravar o XMLs no Importador XML (Tabela CKO) 

PASSO 6

Agendamento COLAUTOREAD

Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus um arquivo em Encode64 com todos os XMLs daquele "Recibo"



PASSO 7

Agendamento COLAUTOREAD


Protheus (Importador XML) recebe o Encode64 com os XMLs e vai fazer o Decode64 (TEC)O Decode64 é feito e seu retorno gera um arquivo .ZIP

PASSO 8

Agendamento COLAUTOREAD


Com o arquivo .ZIP gerado através do Decode64, é necessário fazer a descompactação desse arquivo.A descompactação do arquivo .ZIP é feito pela função FUnZip

PASSO 9

Agendamento COLAUTOREAD


Os arquivos descompactados serão salvos dentro da pasta (MV_TRAXML) e feita a leitura dos XMLs gravando na tabela CKO

PASSO 10

Agendamento COLAUTOREAD


Após a gravação na tabela CKO, o Importador XML chama o EndPoint do Totvs Transmite para fazer as atualizações de status do documento no Totvs Transmite

PASSO 11

Agendamento COLAUTOREAD

Totvs Transmite recebe requisição solicitada pelo Importador XML com a chave do documento e faz a atualização dos status no Totvs Transmite.

PASSO 12

Agendamento SCHEDCOMCOL


Protheus (Importador XML) lê os XMLs da tabela CKO e os envia para o Monitor, caso não encontre nenhuma inconsistência. 
Card
effectDuration0.5
idTabelas
labelTabelas / Fontes
titleTabelas
effectTypeslide
  • Tabelas:
TabelaDescrição
DHWConfiguração Grupo/Empresa que integra com o Totvs Transmite
DHYGrava os Ids para consulta dos XML importados do Totvs Transmite
DHZHistórico de Ids com erros e já importados no Importador XML
CKOCOLRegistros do XMLs importados
SDS

Cabeçalho do documento no monitor

SDTItens do documento no monitor


  • Fontes envolvidos:
FontesDescrição
COLXCFGWizard de configuração TOTVS Colaboração / Importador XML
COLAUTOREADRotina para importar XMLs na CKOCOL
COMTRANSMITEClasse/Objeto para importação dos XML originados via TOTVS Transmite
COMXCOLMonitor
MATA140I

Importa NFE/NFS do TOTVS Colaboração / Importador XML

MATA116IImporta CTE/CTEOS do TOTVS Colaboração / Importador XML
Card
effectDuration0.5
idConfiguração
labelConfiguração
titleConfiguração
effectTypeslide
Deck of Cards
effectDuration0.5
idFuncionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idWizard
labelWizard
titleWizard
effectTypeslide

Pode-se utilizar o Wizard como facilitador da configuração.

Link: IX09 - Wizard Configuração

Card
defaulttrue
effectDuration0.5
idDicionario
labelDicionário
titleDicionario
effectTypeslide
  • Tabela DHW
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHW_GRPEMPC2 (Tamanho da Grupo de Empresa)@!RealAlterarSimGrupo Empresa            
DHW_FILEMPC8 (Tamanho da Filial)@!RealAlterarSimFilial Empresa
DHW_CGC   C14@!RealAlterarSimCGC (CNPJ/CPF)
DHW_IE    C14@!RealAlterarSimInscrição Estadual
DHW_UF    C2@!RealAlterarSimEstado
DHW_CODFILC40@!RealAlterarSimCódigo Filial no Transmite
Índices:
DHW_FILIAL+DHW_GRPEMP+DHW_FILEMP                                                                                                                                

DHW_FILIAL+DHW_CGC+DHW_IE                                                                                                                                       

DHW_FILIAL+DHW_CODFIL                                                                                                                                           
  • Tabela DHY
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHY_CODFILC40@!RealAlterarSimCódigo Filial no Transmite         
DHY_TPXML C5@!RealAlterarSimTipo XML (NFE/NFS/CTE/CTEOS)
DHY_ID       C36@!RealAlterarSimId Recibo Transmite
DHY_STATUS   C1@!RealAlterarSimStatus (0-Pendente/1-Ok/2-Erro)
DHY_DTID   D8
RealAlterarSimData Importação ID Recibo
DHY_FILTROC200@!RealAlterarSimFiltro requisição
DHY_TENTN14@999,999,999,999,99RealAlterarSimTentativas
Índices:
DHY_FILIAL+DHY_CODFIL+DHY_TPXML+DHY_ID                                                                                                                          
DHY_FILIAL+DHY_TPXML+DHY_FILTRO


  • Tabela DHZ
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHZ_CODFILC40@!RealAlterarSimCódigo Filial no TOTVS Transmite         
DHZ_TPXML C5@!RealAlterarSimTipo XML (NFE/NFS/CTE/CTEOS)
DHZ_ID       C36@!RealAlterarSimId Recibo Transmite
DHZ_STATUS   C1@!RealAlterarSimStatus (0-Pendente/1-Ok/2-Erro)
DHZ_DTIDD8
RealAlterarSimData Importação
DHZ_FILTROC200@!RealAlterarSimFiltro requisição
DHZ_TENTN14@999,999,999,999,99RealAlterarSimTentativas
DHZ_DTLIDD8
RealAlterarSimData Lido Recibo
Índices:
DHZ_FILIAL+DHZ_CODFIL+DHZ_TPXML+DHZ_ID                                                                                                                          
DHZ_FILIAL+DHZ_TPXML+DHZ_FILTRO


  • Tabela CKO
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
CKO_CHVDOCC44@!RealVisualizarSimChave Documento      
CKO_ORIGEMC10@!RealAlterarSimOrigem
CKO_STRAN C1@!RealAlterarSimStatus Transmite (1-Pendente/2-CKO/3-SF1)
CKO_ERRTRAM

RealAlterarSimErro status Transmite
Card
effectDuration0.5
idParâmetros
labelParâmetros
titleParâmetros
effectTypeslide
  • Parâmetros utilizados na integração.
ParâmetroTipoConteúdoDescriçãoObservação
MV_IMPXMLLTHabilita integração Importador XMLParâmetro deve ser T para que integração com o TOTVS Transmite funcione.
MV_DOCIMPCNFE/NFS/CTETipo de XML a serem importados pela integração Importador XML x TOTVS Transmite
MV_XMLCIDC
Client ID do TOTVS Transmite

Informação virá do TOTVS Transmite. Para obter a credencial:

  • Na página Inicial do Transmite
  • Clicar no símbolo (interrogação) 
  • Opção - Obter Credenciais
MV_XMLCSECC
Client Secret do TOTVS Transmite

Informação virá do TOTVS Transmite

Para obter a credencial:

  • Na página Inicial do Transmite
  • Clicar no símbolo (interrogação) 
  • Opção - Obter Credenciais
MV_XMLDIASN30Range dias para importar documentos do TOTVS Transmite.

Data Inicio: Data de hoje - MV_XMLDIAS (30)

Data Final: Data de hoje


MV_XMLHISTL.F.Salva histórico de Ids importados e/ou com erros.O histórico é salvo na tabela DHZ.
MV_NGINNC
Caminho para importar XMLs pelo Importador XML

Tratamento continuara funcionando mesmo com a integração com o TOTVS Transmite ativa

Obs: Ambientes Linux deixar nomenclatura minúscula

MV_NGLIDOSC
Caminho para onde o XMLs lidos da pasta IN serão armazenados.

Tratamento continuara funcionando mesmo com a integração com o Totvs Transmite ativa

Obs1: Ambientes Linux deixar nomenclatura minúscula

Obs2: Documentos originados via Totvs Transmite, não serão salvos na pasta LIDOS, pois XML's já são armazenados no Totvs Transite.

MV_APITRANCproductionIndica ambiente do Totvs Transmite (production / staging / development)Default: production
MV_TRAEXPLTT = Somente documentos não integrados com o ERP / F = Todos documentos.Default: T
MV_TRAXMLC\transmite\Diretório que será criado dentro da pasta in (MV_NGINN) para leitura dos XML importados via TOTVS Transmite.

Obrigatório ter preenchido parâmetro MV_NGINN.

Obs: Ambientes Linux deixar nomenclatura minúscula


  • Imagens da configuração dos parâmetros no Wizard:

 




Card
effectDuration0.5
idEmpresa
labelGrupo/Filial
titleEmpresa
effectTypeslide
  • Deve-se informar qual Grupo/Filial estará integrada com o TOTVS Transmite. Para que assim somente XMLs pertencentes ao mesmo Grupo/Filial sejam importados.

Observação: Ao selecionar Grupo/Filial, o mesmo devera conter o seu Código Filial do TOTVS Transmite. Informação estará na tabela DHW (DHW_CODFIL)


  • Imagem da configuração de Grupo/Filial no Wizard.

Card
defaulttrue
effectDuration0.5
idAgendamento
labelAgendamento
titleAgendamento
effectTypeslide

No Importador XML é necessário criar agendamentos das rotinas responsáveis pela importação e gravação do XML no Monitor (Protheus).

Para realizar o cadastro dos agendamentos é necessário o seguinte:

  • SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agendamento -> Cadastro): 
    • Informar usuário (Ex: 000000 - Administrador)
    • Rotina (tabela abaixo)

      Agendamento

      Descrição

      COLAUTOREADPara importar XML's e gravar informações na tabela CKO
      SCHEDCOMCOL

      Ler os XML's da CKO e importar para o monitor (SDS e SDT)

    • Empresa/Filial: Empresa que serão utilizadas para importarem os XML's
    • Modulo: (Ex: 02 - Compras)
    • Deixar habilitado
    • Informar recorrência: Definir o tempo em que os XML serão importados e gravados.
      Observação: Sugerimos que não deixa sempre ativo, defina a execução de tempo em tempo, Ex: 30 minutos

  • SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agent -> Cadastro): 
    • Incluir o Grupo de empresa/Empresa que contem configurado os agendamentos.

Para que funcione corretamente os agendamentos é necessário que após toda configuração, o Agent e o Schedule sejam ativados.

Card
effectDuration0.5
idDocImportados
labelDocumentos Importados
titleDocumentos Importados
effectTypeslide

Lista de documentos importados pela integração Totvs Transmite x Importador XML

DocumentoCódigoTipo Requisição

NF-e

109

Recebimento

NFS-e

319

Recebimento

CT-e

214

Recebimento

CTEOS273Recebimento



Aviso
titleImportante

Importador XML integrado com TOTVS Transmite: Documentos NFS serão importados.

Importador XML NÃO integrado com TOTVS Transmite: Documentos NFS NÃO serão importados

Card
effectDuration0.5
idFAQs
labelFAQs
titleFAQs
effectTypeslide

FAQs - Integração Importador XML x Totvs Transmite

IX08013 - Importador XML x Totvs Transmite - Performance