(informação) El objetivo de este documento es ofrecer las informaciones necesarias para la configuración y el uso de la integración entre el Importador XML y el TOTVS Transmite.

Índice

Este documento tiene el propósito de ser un guía para los clientes, analistas y desarrolladores, que utilizan o que quieren adherir, en su rutina de trabajo, a las funcionalidades que se ponen a disposición por medio de la integración del Importador XML vs. TOTVS Transmite.   


Para que la integración entre el Importador XML y el TOTVS Transmite funcione correctamente, preparamos un Checklist de los requisitos mínimos que deben validarse para el correcto funcionamiento de la integración. 



[Imagem para ilustrar as etapas do Checklist]

*Haga clic en la imagen para ampliar.

A continuación, una imagen ilustrativa del proceso de integración entre el Importador XML y el TOTVS Transmite.


[Imagen para ilustrar la integración Importador XML y TOTVS Transmite]

*Haga clic en la imagen para ampliar.

(aviso) Observación:   


[Imagen para ilustrar el Flujo integración Importador XML y TOTVS Transmite]



(aviso) Observación: Para un mejor aprovechamiento y entendimiento de la integración entre el Importador XML y el TOTVS Transmite es importante que el usuario tenga el conocimiento previo  

Etapas
Importador XML vs. TOTVS Transmite

Descripción del proceso

TOTVS Transmite

Descripción del proceso 

Importador XML

Descripción del proceso

TEC

 

 

 

PASO 1

Configuración de la integración Importador XML vs. Totvs Transmite


Parámetros:

  • MV_IMPXML (Habilitado Importador XML)
  • MV_XMLCID (Client Id Transmite)
  • MV_XMLCSEC (Client Secret Transmite)
  • MV_APITRAN (Entorno Transmite)
  • MV_NGINN (Carpeta IN)
  • MV_NGLIDOS (Carpeta Leídos)
    MV_TRAXML (Carpeta que se creará dentro de la Carpeta IN - MV_NGINN)
  • MV_DOCIMP (Tipo documentos que se importarán)

Wizard:

Por medio del Wizard es posible configurar todos los parámetros descritos anteriormente e informar las sucursales del Importador XML que se integrarán al Totvs Transmite (Grabando en la DHW)


PASO 2

Programación en agenda COLAUTOREAD


  • Inicia verificando si tiene XML en la carpeta IN (MV_NGINN)
  • Después de la lectura de la carpeta IN (MV_NGINN), se realiza la llamada del EndPoint en el Totvs Transmite para requisitar los XML pendientes para integración con el Importador XML

Importante: Para el correcto funcionamiento del EndPoint, es necesario tener:

  • Tabla DHW con el vínculo entre las sucursales del Protheus y Totvs Transmite
  • Parámetro: MV_DOCIMP e MV_XMLDIAS

PASO 3

Programación en agenda COLAUTOREAD

Totvs Transmite recibe la requisición solicitada por el Importador XML y devuelve al Protheus los "Recibos"

Importante: Totvs Transmite devuelve un recibo por tipo de documento (MV_DOCIMP)



PASO 4

Programación en agenda COLAUTOREAD


Protheus (Importador XML) recibe los "Recibos" del Totvs Transmite y los graba en la tabla DHY


PASO 5

Programación en agenda COLAUTOREAD


Con los "Recibos" en la tabla DHY se realiza la llamada de otro EndPoint en el Totvs Transmite para grabar los XML en el Importador XML (Tabla CKO) 


PASO 6

Programación en agenda COLAUTOREAD

Totvs Transmite recibe la requisición solicitada por el Importador XML y devuelve al Protheus un archivo en Encode64 con todos los XML de aquel "Recibo"



PASO 7

Programación en agenda COLAUTOREAD


Protheus (Importador XML) recibe el Encode64 con los XML y hace el Decode64 (TEC)

El Decode64 se realiza y su devolución generará una archivo .ZIP

PASO 8

Programación en agenda COLAUTOREAD


Con el archivo .ZIP generado por medio del Decode64, es necesario descomprimir este archivo.

La descompresión del archivo .ZIP se realiza por medio de la función FUnZip

PASO 9

Programación en agenda COLAUTOREAD


Los archivos descomprimidos se grabarán dentro de la carpeta (MV_TRAXML) y se realizará la lectura de los XML grabando en la tabla CKO


PASO 10

Programación en agenda COLAUTOREAD


Después de la grabación en la tabla CKO, el Importador XML llama al EndPoint del Totvs Transmite para hacer las actualizaciones de estatus del documento en el Totvs Transmite


PASO 11

Programación en agenda COLAUTOREAD

Totvs Transmite recibe la requisición solicitada por el Importador XML con la clave del documento y realiza la actualización de los estatus en el Totvs Transmite.



PASO 12

Programación en agenda SCHEDCOMCOL


Protheus (Importador XML) lee los XML de la tabla CKO y los envía al Monitor, si no encuentra ninguna inconsistencia. 




  • 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

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

Link: IX09 - Wizard Configuração

  • 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
  • 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:

 




  • 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.

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.

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



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

FAQs - Integração Importador XML x Totvs Transmite

IX08013 - Importador XML vs. Totvs Transmite - Desempeño



Materiais Auxiliares

Importador XML - Guia de Referencia (SIGACOM)


<!-- 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>



<style>

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:link, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:visited, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:focus, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:hover, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:active {
color: white;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: white; !important}
deck.tab.inactive.background = #e7e7e7
deck.tab.active.background = #252626