Painel

title	Objetivo

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.

Aviso

title	Importante - Integración Importador XML vs. TOTVS Transmite

Integración Importador XML vs. TOTVS Transmite

Nuevas programaciones en agenda separando procesos y mejora de desempeño:

SCHEDIMPTRA: Responsable por la requisición y lectura de recibos enviado por el TOTVS Transmite
SCHEDUPDTRA: Responsable por la actualización de estatus en el TOTVS Transmite

Obs: Al configurar las 2 nuevas programaciones en agenda COLAUTOREAD quedará responsable solamente por la importación de XML vía carpeta IN, en caso contrario continua responsable por la lectura de la carpeta IN y todo proceso de requisición, lectura y actualización del TOTVS Transmite.

Deck of Cards

effectDuration	0.5
id	encabezado
effectType	slide

Card

default	true
effectDuration	0.5
id	transmite
label	Importador XML vs. TOTVS Transmite
title	Transmite
effectType	slide

Deck of Cards

effectDuration	0.5
id	todo-sobre
effectType	slide

Card

default	true
effectDuration	0.5
id	Introducción
label	Introducción
title	Introducción
effectType	slide

Column

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

Painel

title	Proceso de Check-list

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.

[Imagen para ilustrar las etapas del Checklist]

*Clique na imagem para ampliar.

Painel

title	Integración (Proceso macro):

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

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

*Haga clic en la imagen para ampliar.

Card

default	true
effectDuration	0.5
id	Flujograma
label	Flujograma / Etapas del proceso
title	Flujograma
effectType	slide

Deck of Cards

effectDuration	0.5
id	Flujo
effectType	slide

Card

default	true
effectDuration	0.5
id	Flujograma
label	Flujograma
title	Flujograma
effectType	slide

Painel

title	Descripción de las etapas del proceso

Observación:

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

Card

default	true
effectDuration	0.5
id	Etapas
label	Etapas
title	Etapas
effectType	slide

Painel

title	Descripción de las etapas del proceso

Observación: Para un mejor aprovechamiento y entendimiento de la integración entre el Importador XML y 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 (Se habilitó 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_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)
PASO 3 Programación en agenda SCHEDIMPTRA		Se realizó la activación del EndPoint en el Totvs Transmite para requisitar los XML "pendientes" para integración con 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 y MV_DTINITR
PASO 4 Programación en agenda SCHEDIMPTRA	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 5 Programación en agenda SCHEDIMPTRA		Protheus (Importador XML) recibe los "Recibos" del Totvs Transmite y los graba en la tabla DHY
PASO 6 Programación en agenda SCHEDIMPTRA		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 7 Programación en agenda SCHEDIMPTRA	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 8 Programación en agenda SCHEDIMPTRA		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 9 Programación en agenda SCHEDIMPTRA		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 10 Programación en agenda SCHEDIMPTRA		Los archivos descomprimidos se grabarán dentro de la carpeta (\transmite\) y se realizará la lectura de los XML grabando en la tabla CKO
PASO 11 Programación en agenda SCHEDUPDTRA		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 12 Programación en agenda SCHEDUPDTRA	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.

Card

effectDuration	0.5
id	Tablas
label	Tablas / Fuentes
title	Tablas
effectType	slide

Tablas:

Tabla	Descripción
DHW	Configuración Grupo/Empresa que integra con el Totvs Transmite
DHY	Graba los Id para consulta de los XML importados del Totvs Transmite
DHZ	Historial de Id con errores e importados al Importador XML
CKOCOL	Registros de los XML importados
SDS	Encabezado del documento en el monitor
SDT	Ítems del documento en el monitor

Fuentes involucrados:

Fuentes	Descripción
COLXCFG	Wizard de configuración TOTVS Colaboración / Importador XML
COLAUTOREAD	Rutina para importar XML en la CKOCOL
COMTRANSMITE	Clase/Objeto para importación de los XML originados vía TOTVS Transmite
COMXCOL	Monitor
MATA140I	Importa E-Fact/FactS del TOTVS Colaboración / Importador XML
MATA116I	Importa CTE/CTEOS del TOTVS Colaboración / Importador XML
WIZIMP	Wizard Integración Importador XML vs. TOTVS Transmite
IMPTRATOOL	Herramienta de Análisis Integración Importador XML vs. TOTVS Transmite
SCHEDIMPTRA	Programación en agenda requisición y lectura de los recibos
SCHEDUPDTRA	Programación en agenda actualización estatus en el TOTVS Transmite

Card

effectDuration	0.5
id	Configuración
label	Configuración
title	Configuración
effectType	slide

Deck of Cards

effectDuration	0.5
id	Funcionalidades
effectType	slide

Card

default	true
effectDuration	0.5
id	Wizard
label	Wizard
title	Wizard
effectType	slide

Puede utilizarse el Wizard como facilitador de la configuración.

Enlace: IX09 - Wizard Configuración

Card

default	true
effectDuration	0.5
id	Diccionario
label	Diccionario
title	Diccionario
effectType	slide

Tabla DHW

Campo	Tipo:	Tamaño:	Formato:	Contexto:	Propiedad:	Utilizado:	Descripción:
DHW_GRPEMP	C	2 (Tamaño del Grupo de empresa)	@!	Real	Modificar	Sí	Grupo Empresa
DHW_FILEMP	C	8 (Tamaño de la sucursal)	@!	Real	Modificar	Sí	Sucursal Empresa
DHW_CGC	C	14	@!	Real	Modificar	Sí	RCPJ/RCPF (Registro de Contribuyente Persona Jurídica/Registro de Contribuyente Persona Física)
DHW_IE	C	14	@!	Real	Modificar	Sí	Inscripción estatal
DHW_UF	C	2	@!	Real	Modificar	Sí	Estado/Prov/Reg
DHW_CODFIL	C	40	@!	Real	Modificar	Sí	Código sucursal en el Transmite

Índices:
DHW_FILIAL+DHW_GRPEMP+DHW_FILEMP
DHW_FILIAL+DHW_CGC+DHW_IE
DHW_FILIAL+DHW_CODFIL

Tabla DHY

Campo	Tipo:	Tamaño:	Formato:	Contexto:	Propiedad:	Utilizado:	Descripción:
DHY_CODFIL	C	40	@!	Real	Modificar	Sí	Código sucursal en el Transmite
DHY_TPXML	C	5	@!	Real	Modificar	Sí	Tipo XML (E-FACT/E-FACTS/CTE/CTEOS)
DHY_ID	C	36	@!	Real	Modificar	Sí	Id Recibo Transmite
DHY_STATUS	C	1	@!	Real	Modificar	Sí	Estatus (0-Pendiente/1-Ok/2-Error)
DHY_DTID	D	8		Real	Modificar	Sí	Fecha Importación ID Recibo
DHY_FILTRO	C	200	@!	Real	Modificar	Sí	Filtro requisición
DHY_TENT	N	14	@999,999,999,999,99	Real	Modificar	Sí	Intentos
DHY_MESSAG	C	220	@!	Real	Modificar	Sí	Mensaje de devolución del TOTVS Transmite

Índices:
DHY_FILIAL+DHY_CODFIL+DHY_TPXML+DHY_ID
DHY_FILIAL+DHY_TPXML+DHY_FILTRO

Tabela DHZ

Campo	Tipo:	Tamaño:	Formato:	Contexto:	Propiedad:	Utilizado:	Descripción:
DHZ_CODFIL	C	40	@!	Real	Modificar	Sí	Código sucursal en el TOTVS Transmite
DHZ_TPXML	C	5	@!	Real	Modificar	Sí	Tipo XML (E-FACT/E-FACTS/CTE/CTEOS)
DHZ_ID	C	36	@!	Real	Modificar	Sí	Id Recibo Transmite
DHZ_STATUS	C	1	@!	Real	Modificar	Sí	Estatus (0-Pendiente/1-Ok/2-Error)
DHZ_DTID	D	8		Real	Modificar	Sí	Fecha Importación
DHZ_FILTRO	C	200	@!	Real	Modificar	Sí	Filtro requisición
DHZ_TENT	N	14	@999,999,999,999,99	Real	Modificar	Sí	Intentos
DHZ_DTLID	D	8		Real	Modificar	Sí	Fecha leído recibo
DHZ_MESSAG	C	220	@!	Real	Modificar	Sí	Mensaje de devolución del TOTVS Transmite

Índices:
DHZ_FILIAL+DHZ_CODFIL+DHZ_TPXML+DHZ_ID
DHZ_FILIAL+DHZ_TPXML+DHZ_FILTRO

Tabela CKO

Campo	Tipo:	Tamaño:	Formato:	Contexto:	Propiedad:	Utilizado:	Descripción:
CKO_CHVDOC	C	44	@!	Real	Visualizar	Sí	Clave documento
CKO_ORIGEM	C	10	@!	Real	Modificar	Sí	Origen
CKO_STRAN	C	1	@!	Real	Modificar	Sí	Estatus Transmite (1-Pendiente/2-CKO/3-SF1)
CKO_ERRTRA	M			Real	Modificar	Sí	Error estatus Transmite
CKO_RECIBO	C	36	@!	Real	Modificar	Sí	Recibo del TOTVS Transmite

Card

effectDuration	0.5
id	Parámetros
label	Parámetros
title	Parámetros
effectType	slide

Parámetros utilizados en la integración.

Parámetro	Tipo	Índice	Descripción	Observación
MV_IMPXML	L	T	Habilita integración Importador XML	Parámetro debe ser T para que la integración con el TOTVS Transmite funcione.
MV_DOCIMP	C	NFE/NFS/CTE/CTO	Tipo de XML que se importará mediante la integración Importador XML vs. TOTVS Transmite
MV_XMLCID	C		Client ID del TOTVS Transmite	La información vendrá del TOTVS Transmite. Para obtener la credencial: En la página Inicial del Transmite Hacer clic en el símbolo Opción - Obtener credenciales
MV_XMLCSEC	C		Client Secret del TOTVS Transmite	La información vendrá del TOTVS Transmite. Para obtener la credencial: En la página Inicial del Transmite Hacer clic en el símbolo Opción - Obtener credenciales
MV_XMLDIAS	N	30	Rango días para importar documentos del TOTVS Transmite.	Fecha inicial Fecha de hoy - MV_XMLDIAS (30) Fecha final: Fecha de hoy
MV_NGINN	C		Camino para importar XML por el Importador XML	El tratamiento continuará funcionando inclusive con la integración con el TOTVS Transmite activa Obs: Entornos Linux, dejar nomenclatura minúscula
MV_NGLIDOS	C		Camino donde los XML leídos de la carpeta IN se almacenarán.	El tratamiento continuará funcionando inclusive con la integración con el TOTVS Transmite activa Obs1: Entornos Linux, dejar nomenclatura minúscula Obs2: Documentos originados por medio del Totvs Transmite, no se grabarán en la carpeta LEÍDOS, porque los XML ya se almacenaron en el Totvs Transmite.
MV_APITRAN	C	production	Indica entorno del Totvs Transmite (production / staging / development)	Default: production
MV_DTINITR	D	20230101	Fecha inicial de la integración Importador XML vs. Totvs Transmite	Obs: Si no se informara se solicitará TODOS los documentos en el TOTVS Transmite, si hubiera informado, solamente a partir de la fecha se seleccionarán documentos en el TOTVS Transmite

Imágenes de la configuración de los parámetros en el Wizard:

Card

effectDuration	0.5
id	Empresa
label	Grupo/Sucursal
title	Empresa
effectType	slide

Informe qué Grupo/Sucursal estará integrado con el TOTVS Transmite. Para que solamente se importen los XML pertenecientes a este mismo Grupo/Filial.

Observación: Al seleccionar Grupo/Sucursal, este debe tener su Código sucursal del TOTVS Transmite. La información estará en la tabla DHW (DHW_CODFIL)

Imagen de la configuración de Grupo/Sucursal en el Wizard.

Card

default	true
effectDuration	0.5
id	Programación en agenda
label	Programación en agenda
title	Programación en agenda
effectType	slide

En el Importador XML es necesario crear programaciones en agenda de las rutinas responsables por la importación y grabación del XML en el Monitor (Protheus).

Para realizar el registro de las programaciones en agenda, es necesario lo siguiente:

SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Programación en agenda -> Registro):

Informar usuario (Ej: 000000 - Administrador)

Rutina (siguiente tabla)

Programación en agenda	Descripción	Recurrencia	Configuración	Consumo Licencia
COLAUTOREAD	Para importar XML por medio de la carpeta IN (MV_NGINN) y grabar informaciones en la tabla CKO	48 (00:30 min)	Configurar solamente una sucursal por grupo de empresa que ocurra la importación Ej.: T1 / D MG 01 T2 / D SP 01 Obs: De esta manera al importar XML se analizará si el documento pertenece a cualquier sucursal de cada grupo de empresa.	Por empresa
SCHEDIMPTRA	Para requisitar y leer recibos devueltos del TOTVS Transmite	144 (00:10 min)	Configurar solamente una sucursal por grupo de empresa que ocurra la importación Ej.: T1 / D MG 01 T2 / D SP 01 Obs: De esta manera al importar XML se analizará si el documento pertenece a cualquier sucursal de cada grupo de empresa.	Por empresa
SCHEDUPDTRA	Para actualizar estatus de documentos en el TOTVS Transmite	72 (00:20 min)	Configurar solamente una sucursal por grupo de empresa que ocurra la importación Ej.: T1 / D MG 01 T2 / D SP 01 Obs: De esta manera al actualiza el estatus se analizará toda la CKO, con documentos de todos los grupos y sucursales importados.	Por empresa
SCHEDCOMCOL	Leer los XML de la CKO e importar al monitor (SDS y SDT)	288 (00:05 min)	Configurar TODOS los grupos y sucursales cuyos documentos puedan pertenecer para que se importe al monitor en el grupo y sucursal correcto Ej.: T1 / D MG 01 T1 / D MG 02 T2 / D SP 01 T2 / D SP 02	Por sucursal

Módulo: (Ex: 02 - Compras)
Dejar habilitado

SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agent -> Registro):
- Incluir el Grupo de empresa/Empresa que tiene configuradas las programaciones en agenda.

Para que funcionen correctamente las programaciones en agenda, es necesario que después de toda la configuración, el Agent e o Schedule se activen.

Card

effectDuration	0.5
id	DocImportados
label	Documentos importados
title	Documentos importados
effectType	slide

Lista de documentos importados por medio de la integración Totvs Transmite vs. Importador XML

Documento	Código	Tipo Requisición
e-Fact	109	Recepción
e-FactS	319	Recepción
e-CT	214	Recepción
CTEOS	273	Recepción

Aviso

title	Importante

Importador XML integrado con TOTVS Transmite: Documentos FactS se importarán.

Importador XML NO integrado con TOTVS Transmite: Documentos FactS NO se importarán

Card

effectDuration	0.5
id	FAQ
label	FAQ
title	FAQ
effectType	slide

FAQs

FAQ - Integración Importador XML vs. Totvs Transmite

IX08013 - Importador XML x Totvs Transmite - Desempeño

Card

default	true
effectDuration	0.5
id	Soporte
label	Soporte
effectType	slide

Materiales auxiliares

Importador XML - Guía de referencia (SIGACOM)

HTML

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

HTML

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

Composition Setup
deck.tab.inactive.background = #e7e7e7 deck.tab.active.background = #252626

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 4

Nova versão Atual

Chave

Integración Importador XML vs. TOTVS Transmite

Obs: Al configurar las 2 nuevas programaciones en agenda COLAUTOREAD quedará responsable solamente por la importación de XML vía carpeta IN, en caso contrario continua responsable por la lectura de la carpeta IN y todo proceso de requisición, lectura y actualización del TOTVS Transmite.

Índice

Lista de documentos importados por medio de la integración Totvs Transmite vs. Importador XML

Importador XML integrado con TOTVS Transmite: Documentos FactS se importarán.

FAQ - Integración Importador XML vs. Totvs Transmite

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 4

Nova versão Atual

Chave

Integración Importador XML vs. TOTVS Transmite

Obs: Al configurar las 2 nuevas programaciones en agenda COLAUTOREAD quedará responsable solamente por la importación de XML vía carpeta IN, en caso contrario continua responsable por la lectura de la carpeta IN y todo proceso de requisición, lectura y actualización del TOTVS Transmite.

Índice

Lista de documentos importados por medio de la integración Totvs Transmite vs. Importador XML

Importador XML integrado con TOTVS Transmite: Documentos FactS se importarán.

FAQ - Integración Importador XML vs. Totvs Transmite