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.

Deck of Cards

effectDuration	0.5
id	cabecalho
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	tudo-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.

[Imagem Imagen para ilustrar as las etapas do del Checklist]

*Haga clic en la imagen para ampliar.

Painel

title	Integración (Proceso macro):

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.

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	Fluxograma
label	Flujograma
title	Fluxograma
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 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.

Card

effectDuration	0.5
id	Tabelas
label	Tablas / Fuentes
title	Tabelas
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 mediante el TOTVS Transmite
COMXCOL	Monitor
MATA140I	Importa FactE/FactS del TOTVS Colaboración / Importador XML
MATA116I	Importa CTE/CTEOS del TOTVS Colaboración / Importador XML

Card

effectDuration	0.5
id	Configuração
label	Configuración
title	Configuração
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	Dicionario
label	Diccionario
title	Dicionario
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í	RGPJ/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/Provincia/Región
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 (NFE/NFS/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

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

Tabla 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 (NFE/NFS/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

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

Tabla 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

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	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_XMLHIST	L	.F.	Graba historial de Id importados y/o con errores.	El historial se graba en la tabla DHZ.
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_TRAEXP	L	T	T = Solamente documentos no integrados con el ERP / F = Todos documentos.	Estándar: T
MV_TRAXML	C	\transmite\	Directorio que se creará dentro de la carpeta in (MV_NGINN) para lectura de los XML importados por medio del TOTVS Transmite.	Es obligatorio que esté informado el parámetro MV_NGINN. Obs: Entornos Linux, dejar nomenclatura minúscula

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

Image Added

Image AddedImage Removed Image Removed

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.

Image RemovedImage Added

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 -> ENTORNO -> SCHEDULE -> SCHEDULE (Programación en agenda -> Registro):
- Informar usuario (Ej: 000000 - Administrador)
- Rutina (siguiente tabla)
  Programación en agenda
  Descripción
  COLAUTOREAD Para importar XML y grabar informaciones en la tabla CKO
  SCHEDCOMCOL
  Leer los XML de la CKO e importar al monitor (SDS y SDT)
- Empresa/Sucursal: Empresa que se utilizará para importar los XML
- Modulo: (Ej: 02 - Compras)
- Dejar habilitado
- Informar recurrencia: Definir el tiempo en que los XML se importarán y grabarán.
  Observación: Sugerimos que no deje siempre activo, defina la ejecución de tiempo en tiempo, jx: 30 minutos
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 configuración, el Agent y el Schedule se activen.

Card

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

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

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

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

FAQ - Integración Importador XML v. Totvs Transmite

IX08013 - Importador XML vs. 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 6

Nova versão 7

Chave

Índice

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

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

FAQ - Integración Importador XML v. Totvs Transmite

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 6

Nova versão 7

Chave

Índice

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

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

FAQ - Integración Importador XML v. Totvs Transmite