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 para ilustrar as etapas do 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 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

TabelasTablas:

Tabela

Tabla

Descrição

Descripción
DHW

Configuração

Configuración Grupo/Empresa que integra

com o

con el Totvs Transmite

DHY

Grava os Ids

Graba los Id para consulta

dos

de los XML importados

do

del Totvs Transmite

DHZ

Histórico de Ids com erros e já importados no

Historial de Id con errores e importados al Importador XML
CKOCOL	Registros

do XMLs

de los XML importados

SDS

Cabeçalho do documento no

Encabezado del documento en el monitor

SDT

Itens do documento no

Ítems del documento en el monitor

Fontes envolvidosFuentes involucrados:

Fontes

Fuentes

Descrição

Descripción
COLXCFG	Wizard de

configuração

configuración TOTVS

Colaboração

Colaboración / Importador XML

COLAUTOREAD

Rotina

Rutina para importar

XMLs na

XML en la CKOCOL

COMTRANSMITE

Classe

Clase/Objeto para

importação dos

importación de los XML originados

via

mediante el TOTVS Transmite
COMXCOL	Monitor
MATA140I	Importa

NFE

FactE/

NFS do

FactS del TOTVS

Colaboração

Colaboración / Importador XML
MATA116I	Importa CTE/CTEOS

do

del TOTVS

Colaboração

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

Pode-se utilizar o Puede utilizarse el Wizard como facilitador da configuraçãode la configuración.

LinkEnlace: IX09 - Wizard ConfiguraçãoConfiguración

Card

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

Tabela Tabla DHW

Campo:	Tipo:	TamanhoTamaño:	Formato:	Contexto:	PropriedadePropiedad:	UsadoUtilizado:	DescriçãoDescripción:
DHW_GRPEMP	C	2 (Tamanho da Tamaño del Grupo de Empresaempresa)	@!	Real	AlterarModificar	SimSí	Grupo Empresa empresa
DHW_FILEMP	C	8 (Tamanho da FilialTamaño de la sucursal)	@!	Real	AlterarModificar	SimSí	Filial EmpresaSucursal empresa
DHW_CGC	C	14	@!	Real	AlterarModificar	SimSí	CGC (CNPJ/CPFRGPJ/RCPF (Registro de Contribuyente Persona Jurídica/Registro de Contribuyente Persona Física)
DHW_IE	C	14	@!	Real	AlterarModificar	SimSí	Inscrição EstadualInscripción estatal
DHW_UF	C	2	@!	Real	AlterarModificar	SimSí	Estado/Provincia/Región
DHW_CODFIL	C	40	@!	Real	AlterarModificar	SimSí	Código Filial no sucursal en el Transmite

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

Tabela Tabla DHY

Campo:	Tipo:	TamanhoTamaño:	Formato:	Contexto:	PropriedadePropiedad:	UsadoUtilizado:	DescriçãoDescripción:
DHY_CODFIL	C	40	@!	Real	AlterarModificar	SimSí	Código Filial no sucursal en el Transmite
DHY_TPXML	C	5	@!	Real	AlterarModificar	SimSí	Tipo XML (NFE/NFS/CTE/CTEOS)
DHY_ID	C	36	@!	Real	AlterarModificar	SimSí	Id Recibo Transmite
DHY_STATUS	C	1	@!	Real	AlterarModificar	SimSí	Status Estatus (0-PendentePendiente/1-Ok/2-ErroError)
DHY_DTID	D	8		Real	AlterarModificar	SimSí	Data Importação Fecha importación ID Recibo
DHY_FILTRO	C	200	@!	Real	AlterarModificar	SimSí	Filtro requisiçãorequisición
DHY_TENT	N	14	@999,999,999,999,99	Real	AlterarModificar	SimSí	TentativasIntentos

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

Tabela Tabla DHZ

Campo:	Tipo:	TamanhoTamaño:	Formato:	Contexto:	PropriedadePropiedad:	UsadoUtilizado:	DescriçãoDescripción:
DHZ_CODFIL	C	40	@!	Real	AlterarModificar	SimSí	Código Filial no sucursal en el TOTVS Transmite
DHZ_TPXML	C	5	@!	Real	AlterarModificar	SimSí	Tipo XML (NFE/NFS/CTE/CTEOS)
DHZ_ID	C	36	@!	Real	AlterarModificar	SimSí	Id Recibo Transmite
DHZ_STATUS	C	1	@!	Real	AlterarModificar	SimSí	Status Estatus (0-PendentePendiente/1-Ok/2-ErroError)
DHZ_DTID	D	8		Real	AlterarModificar	SimSí	Data ImportaçãoFecha importación
DHZ_FILTRO	C	200	@!	Real	AlterarModificar	SimSí	Filtro requisiçãorequisición
DHZ_TENT	N	14	@999,999,999,999,99	Real	AlterarModificar	SimSí	TentativasIntentos
DHZ_DTLID	D	8		Real	AlterarModificar	Sim	Sí	Fecha leído reciboData Lido Recibo

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

Tabela Tabla CKO

Campo:	Tipo:	TamanhoTamaño:	Formato:	Contexto:	PropriedadePropiedad:	UsadoUtilizado:	DescriçãoDescripción:
CKO_CHVDOC	C	44	@!	Real	Visualizar	SimSí	Chave Documento Clave documento
CKO_ORIGEM	C	10	@!	Real	AlterarModificar	SimSí	OrigemOrigen
CKO_STRAN	C	1	@!	Real	AlterarModificar	SimSí	Status Estatus Transmite (1-PendentePendiente/2-CKO/3-SF1)
CKO_ERRTRA	M			Real	AlterarModificar	SimSí	Erro status Error estatus Transmite

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

Card

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

Parâmetros utilizados na integraçãoParámetros utilizados en la integración.

Parâmetro

Parámetro	Tipo

Conteúdo

Índice

Descrição

Descripción

Observação

Observación
MV_IMPXML	L	T	Habilita

integração

integración Importador XML

Parâmetro deve

Parámetro debe ser T para que

integração com o

la integración con el TOTVS Transmite funcione.
MV_DOCIMP	C	NFE/NFS/CTE	Tipo de XML

a serem importados pela integração

que se importará mediante la integración Importador XML

x

vs. TOTVS Transmite
MV_XMLCID	C		Client ID

do

del TOTVS Transmite

Informação virá do

La información vendrá del TOTVS Transmite. Para

obter a

obtener la credencial:

Na

En la página Inicial

do

del Transmite

Clicar no símbolo

Hacer clic en el símbolo

Opção

Opción -

Obter Credenciais

Obtener credenciales
MV_XMLCSEC	C		Client Secret

do

del TOTVS Transmite

Informação virá do

La información vendrá del TOTVS Transmite.

Para

obter a

obtener la credencial:

Na

En la página Inicial

do

del Transmite

Clicar no símbolo

Hacer clic en el símbolo

Opção

Opción -

Obter Credenciais

Obtener credenciales
MV_XMLDIAS	N	30

Range dias

Rango días para importar documentos

do

del TOTVS Transmite.

Data Inicio: Data de hoje

Fecha inicial Fecha de hoy - MV_XMLDIAS (30)

Data Final

Fecha final:

Data

Fecha de

hoje

hoy
MV_XMLHIST	L	.F.

Salva histórico

Graba historial de

Ids

Id importados

e/ou com erros.O histórico é salvo na tabela

y/o con errores.	El historial se graba en la tabla DHZ.
MV_NGINN	C

Caminho

Camino para importar

XMLs pelo

XML por el Importador XML

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

El tratamiento continuará funcionando inclusive con la integración con el TOTVS Transmite activa

Obs:

Ambientes

Entornos Linux

deixar

, dejar nomenclatura minúscula
MV_NGLIDOS	C

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

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

Obs1: Ambientes Linux deixar

nomenclatura minúscula

Obs2: Documentos originados

via

por medio del Totvs Transmite,

não serão salvos na pasta LIDOS, pois XML's já são armazenados no Totvs Transite

no se grabarán en la carpeta LEÍDOS, porque los XML ya se almacenaron en el Totvs Transmite.
MV_APITRAN	C	production	Indica

ambiente do

entorno del Totvs Transmite (production / staging / development)	Default: production
MV_TRAEXP	L	T	T =

Somente

Solamente documentos

não

no integrados

com o

con el ERP / F = Todos documentos.

Default

Estándar: T
MV_TRAXML	C	\transmite\

Diretório

Directorio que

será criado dentro da pasta

se creará dentro de la carpeta in (MV_NGINN) para

leitura dos

lectura de los XML importados

via

por medio del TOTVS Transmite.

Obrigatório ter preenchido parâmetro

Es obligatorio que esté informado el parámetro MV_NGINN.

Obs:

Ambientes

Entornos Linux

deixar

, dejar nomenclatura minúscula

Imagens da configuração dos parâmetros no 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

Deve-se informar qual Informe qué Grupo/Filial estará integrada com o Sucursal estará integrado con el TOTVS Transmite. Para que assim somente XMLs pertencentes ao mesmo solamente se importen los XML pertenecientes a este mismo Grupo/Filial sejam importados.

ObservaçãoObservación: Ao selecionar Al seleccionar Grupo/Filial, o mesmo devera conter o seu Código Filial do Sucursal, este debe tener su Código sucursal del TOTVS Transmite. Informação estará na tabela La información estará en la tabla DHW (DHW_CODFIL)

Imagem da configuração Imagen de la configuración de Grupo/Filial no 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

No Importador XML é necessário criar agendamentos das rotinas responsáveis pela importação e gravação do XML no 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 o cadastro dos agendamentos é necessário o seguinteel registro de las programaciones en agenda, es necesario lo siguiente:

SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agendamento -> Cadastro):
- Informar usuário (Ex: 000000 - Administrador)
- Rotina (tabela abaixo)
  Agendamento
  Descrição
  COLAUTOREAD Para 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

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

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

Documento	Código	Tipo Requisição
NF-e	109	Recebimento
NFS-e	319	Recebimento
CT-e	214	Recebimento
CTEOS	273	Recebimento

Aviso

title	Importante

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

effectDuration	0.5
id	FAQ
label	FAQ
title	FAQ
effectType	slide

FAQs - Integração Importador XML x Totvs Transmite

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

Card

default	true
effectDuration	0.5
id	Soporte
label	Soporte
effectType	slide

Materiais Auxiliares

Importador XML - Guia 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 3

Nova versão 4

Chave

Índice

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

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

FAQs - Integração Importador XML x Totvs Transmite

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 3

Nova versão 4

Chave

Índice

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

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

FAQs - Integração Importador XML x Totvs Transmite