Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.



Painel
titleObjetivo

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

Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idtransmite
labelImportador XML vs. TOTVS Transmite
titleTransmite
effectTypeslide
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
defaulttrue
effectDuration0.5
idIntroducción
labelIntroducción
titleIntroducción
effectTypeslide
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
titleProceso 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
titleIntegració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
defaulttrue
effectDuration0.5
idFlujograma
labelFlujograma / Etapas del proceso
titleFlujograma
effectTypeslide
Deck of Cards
effectDuration0.5
idFlujo
effectTypeslide
Card
defaulttrue
effectDuration0.5
idFluxograma
labelFlujograma
titleFluxograma
effectTypeslide
Painel
titleDescripción de las etapas del proceso

(aviso) Observación:   


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



Card
defaulttrue
effectDuration0.5
idEtapas
labelEtapas
titleEtapas
effectTypeslide
Painel
titleDescripción de las etapas del proceso

(aviso) 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
effectDuration0.5
idTabelas
labelTablas / Fuentes
titleTabelas
effectTypeslide
  • 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
effectDuration0.5
idConfiguração
labelConfiguración
titleConfiguração
effectTypeslide
Deck of Cards
effectDuration0.5
idFuncionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idWizard
labelWizard
titleWizard
effectTypeslide

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

Enlace: IX09 - Wizard Configuración

Card
defaulttrue
effectDuration0.5
idDicionario
labelDiccionario
titleDicionario
effectTypeslide
  • 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
Card
effectDuration0.5
idParámetros
labelParámetros
titleParámetros
effectTypeslide
  • 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
effectDuration0.5
idEmpresa
labelGrupo/Sucursal
titleEmpresa
effectTypeslide
  • 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
defaulttrue
effectDuration0.5
idProgramación en agenda
labelProgramación en agenda
titleProgramación en agenda
effectTypeslide

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

      COLAUTOREADPara 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
effectDuration0.5
idDocImportados
labelDocumentos importados
titleDocumentos importados
effectTypeslide

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

DocumentoCódigoTipo requisición

e-Fact

109

Cobranza

e-FactS

319

Cobranza

e-CT

214

Cobranza

CTEOS273Cobranza



Aviso
titleImportante

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
effectDuration0.5
idFAQ
labelFAQ
titleFAQ
effectTypeslide

FAQ - Integración Importador XML v. Totvs Transmite

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



Card
defaulttrue
effectDuration0.5
idSoporte
labelSoporte
effectTypeslide

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