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




  • 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

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

Enlace: IX09 - Wizard Configuración

  • Tabla DHW
Campo:Tipo:Tamaño:Formato:Contexto:Propiedad:Utilizado:Descripción:
DHW_GRPEMPC2 (Tamaño del Grupo de empresa)@!RealModificarGrupo empresa            
DHW_FILEMPC8 (Tamaño de la sucursal)@!RealModificarSucursal empresa
DHW_CGC   C14@!RealModificarRGPJ/RCPF (Registro de Contribuyente Persona Jurídica/Registro de Contribuyente Persona Física)
DHW_IE    C14@!RealModificarInscripción estatal
DHW_UF    C2@!RealModificarEstado/Provincia/Región
DHW_CODFILC40@!RealModificarCó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_CODFILC40@!RealModificarCódigo sucursal en el Transmite         
DHY_TPXML C5@!RealModificarTipo XML (NFE/NFS/CTE/CTEOS)
DHY_ID       C36@!RealModificarId Recibo Transmite
DHY_STATUS   C1@!RealModificarEstatus (0-Pendiente/1-Ok/2-Error)
DHY_DTID   D8
RealModificarFecha importación ID Recibo
DHY_FILTROC200@!RealModificarFiltro requisición
DHY_TENTN14@999,999,999,999,99RealModificarIntentos
Í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_CODFILC40@!RealModificarCódigo sucursal en el TOTVS Transmite         
DHZ_TPXML C5@!RealModificarTipo XML (NFE/NFS/CTE/CTEOS)
DHZ_ID       C36@!RealModificarId Recibo Transmite
DHZ_STATUS   C1@!RealModificarEstatus (0-Pendiente/1-Ok/2-Error)
DHZ_DTIDD8
RealModificarFecha importación
DHZ_FILTROC200@!RealModificarFiltro requisición
DHZ_TENTN14@999,999,999,999,99RealModificarIntentos
DHZ_DTLIDD8
RealModificarFecha 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_CHVDOCC44@!RealVisualizarClave documento      
CKO_ORIGEMC10@!RealModificarOrigen
CKO_STRAN C1@!RealModificarEstatus Transmite (1-Pendiente/2-CKO/3-SF1)
CKO_ERRTRAM

RealModificarError estatus Transmite
  • 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:

 




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

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