TSBMJO_DT_Integración_Protheus_Synthesis_ARG

Integración Protheus vs. Bridge POS - Synthesis

Importante

Esta mejora depende de la ejecución de los compatibilizadores de base. Primero, realice la ejecución del UPDLO114 y a continuación, el UPDLO143, de acuerdo con el Procedimiento de implementación.

Esta implementación consiste en realizar la integración del Microsiga Protheus® con el Synthesis Bridge POS, para realizar la importación de los movimientos vinculados a las ventas en el Bridge POS y la exportación de los archivos necesarios a una tienda, realizados en el Protheus®, mediante servicios webservices.

Flujo de Importación/Exportación de la Integración Microsiga Protheus® vs. Synthesis Bridge POS

Características de la integración:

• Los archivos se realizan en el ERP Microsiga Protheus®.

• Los Jobs de control ejecutan la verificación de la base de datos para identificar los registros que deben exportarse al Bridge Manager, considerando los incluidos y borrados desde la última exportación, además de realizar la transferencia de los datos a una tabla intermedia.

• Los movimientos de venta, venta previa, confirmación de pago, devolución, entrada de vuelto, retiro parcial de caja, informe Z, apertura/cierre de caja e inclusión de clientes se realizan en el Synthesis Bridge Pos.

• No es posible acceder a las rutinas de transferencia/importación. Todo se ejecuta automáticamente en background por el Job, en un intervalo configurable de tiempo.

• En toda ocurrencia de no importación (inconsistencia) se genera un registro en la tabla de Log de importación para futura visualización. 

Motor de integración:

Para proporcionar flexibilidad y practicidad en la integración de los archivos y movimientos con el Bridge, existe un motor de integración entre los sistemas. Este motor se utiliza para soporte de control de la integración, que contiene tablas auxiliares para configuración y grabación de los datos, procesos automáticos para exportación y/o importación al Protheus® y log de errores para análisis.

En los casos de exportación de los archivos (productos, unidades de medida, lista de precios, etc.) el Protheus® es el client de la integración, es decir, realiza la llamada de un WebService puesto a disposición por el Bridge.

En los casos de importaciones de los movimientos (venta, consulta de stock, informe Z, etc.) el Protheus® es el server de la integración, que pone a disposición un WebService para que el Bridge pueda acceder.

Exportación - WebService Client:

• Flujo del proceso de archivo de los WebServices

En la tabla de Exportación/Configuración del Webservices (MF1) se informan los WebServices, Métodos y la Condición (Query) que deben utilizarse para la exportación de los datos. Estos archivos se registran previamente después de la ejecución de la rutina LJSTSCLIE(U_LJSTSCLIE).

• Flujo del proceso de verificación de nuevos datos para integración

La tabla Intermedia de exportación (MF3) se utiliza para almacenar los registros hasta que se envíen definitivamente al Bridge, además de permitir la verificación de los registros que están esperando la integración, los que se integraron y los que tuvieron error durante la integración.

Procesamiento de la integración:              

En el procesamiento se realiza la lectura de la tabla Intermedia (MF3), la identificación de los registros que se integran y la realización de la llamada del WebService correspondiente al envío de los datos.

• Flujo del Procesamiento de la integración

      En este proceso, la rutina realiza la lectura de la tabla Intermedia (MF3), que busca los registros que deben enviarse para Integración (contenido del campo MF3_ECFLAG igual A) y para cada registro ubicado verifica el WebService (MF3_ECWS) simultáneamente con el Método (MF3_ECMETO), utilizado para el envío de datos. Para completar los atributos del Método, la rutina verifica la tabla de Configuraciones de campos – Exportación (MF2) ejecutando la regla informada en el campo MF2_ECVAL.

Si el Sistema presenta inconsistencias en el proceso de integración, la rutina graba un Log en la tabla de Exportación – Log de error (MF4). Este Log permite informar cualquier inconsistencia resultante de la integración, para permitir el análisis y corrección mediante la utilización del Monitor de logs. Después de corregir la inconsistencia, el registro se envía nuevamente a la cola de integración.

Importación - WebService Server: 

En la Importación, al igual que en la Exportación también existen tablas de control para la integración, sin embargo, en la exportación es posible enviar el mensaje XML enviado por el POS, que se almacena en una tabla intermedia para posterior procesamiento por el Protheus®.

Procesos de los casos de importación:

• Archivo de WebServices y De/A

Este proceso realiza el archivo de los Webservices, del De/A de las tags XML y los campos correspondientes del Protheus® para el procesamiento de los mensajes XML que están almacenados en la tabla Intermedia.

Los registros de las tablas intermedias se incluyen automáticamente después de la ejecución de la rutina de carga. Las tablas son: Importación - Configuración WS (MDY) e Importación - Configuración Camp. (MEL).

• Flujo del proceso de archivo de los WebServices y del De/A

• Recepción de carga en las Tablas intermedias (MDY) y (MEL)

En la tabla MDY se informan los WebServices puestos a disposición para que el Bridge realice la integración. En esta tabla se definen los WebServices (MDY_ECWS), Métodos (MDY_ECMETO), Rutinas automáticas (Ejecauto) para el procesamiento (MDY_ECEXEC), etc.

En la tabla MEL se informa el De/A que se utiliza en el procesamiento del XML. Esta tabla permite informar el campo del Protheus® correspondiente a una determinada Tag del XML, cómo debe ser su tratamiento para la grabación y en qué condición debe grabarse.

Importante

Las tablas MDY y MEL son previamente informadas después de la ejecución de la rutina LJSTSSRV (U_LJSTSSRV) de acuerdo con la descripción del procedimiento de configuración.

• Grabación de los registros en la tabla intermedia (MEY)

En este proceso, cada WebService realiza la grabación de los datos enviados por el Bridge en la tabla Importación - Tabla intermedia (MEY). Esta tabla almacena el XML (MEY_ECXML) enviado en la integración, el WebService (MEY_ECWS) y el Método (MEY_ECMETO) ejecutado. Esta información es utilizada por el Protheus® para la grabación de los datos para el Protheus®.

• Flujo del proceso de grabación de los registros

• Procesamiento de importación

En este proceso se realiza la lectura de la tabla Intermedia (MEY) y la identificación de los registros que son procesados por el Protheus®.

• Flujo del procesamiento de importación

Si el sistema presenta alguna inconsistencia en el proceso de integración, se graba un Log de error  en la tabla MEZ. Este Log permite informar cualquier inconsistencia resultante de la integración, para permitir el análisis y corrección mediante la utilización del Monitor de logs. Después de corregir la inconsistencia, el registro se envía nuevamente a la cola de integración.

¡Importante!

En el flujo de integración entre los sistemas Protheus® y POS, los archivos se realizan en el Protheus® y deben enviarse al POS mediante la integración vía WebService que se utiliza en la venta. 

Flujo del envío de los archivos del Protheus® al POS:

Los archivos integrados del Bridge POS para el Protheus® son:

• Unidad de medidas
• Productos.
• Marcas.
• Códigos de barras.
• Categoría de productos.
• Productos vs. Categorías.
• Productos similares.
• Productos complementarios.
• Niveles y grupos de jerarquía.
• Grilla de productos.
• Lista de precios.
• Productos vs. Lista de precios.
• Almacenes.
• Formas de pago.
• Parámetros de tienda.
• Parámetros de estación.
• Planes de pago.
• Planes de cuotas.
• Prefijos de tarjetas.
• Factor de cotización de monedas.
• Proveedor.
• Tiendas.
• Clientes.
• Categoría de estaciones.
• Estaciones.
• Usuarios.
• Vendedores
• Jurisdicciones impositivas.
• Impuestos variables.

Flujo de los archivos:

Tablas integradas - Protheus® Client:

ACU - Categoría de productos.                                                    

ACV - Categoría vs. Grupo o Producto.                                       

DA0 - Lista de precios.                                                                  

DA1 - Ítems de la lista de precios.                                                 

MGA - De-A de integraciones.                                                      

MGE - Parámetros por tienda                                                                      

MGF - Parámetros por estación                                                    

MGG - Planes medios de pago Estación.                                     

MGH - Parám Estación vs. Pago vs. Cuota.                                 

MGI - Prefijos de tarjetas.                                                             

NNR - Lugares de stock.                                                               

SA1 - Clientes.

SA2 – Proveedores.

SAH - Unidades de medida.

SB1 - Descripción genérica del producto.

SB2 - Saldos físico y financiero.

SBV - Tabla ítems cuadrícula.

SLG - Estaciones.

SLJ - Identificación de tiendas.

SLK - Códigos de barra por producto.

SX5 (Tabla OG) - Marcas - Integración Synthesis                        

SX5 (Tabla 24) - Formas de pago

Orden/Dependencia integración archivos - Protheus® Client:

1 - Unidad de medida

2 - Almacén

3 - Marcas

4 - Proveedor

5 - Cliente

6 - Categoría de productos

7 - Jurisdicciones impositivas

8 - Impuestos variables

9 - Impuestos de Producto

10 - Producto

11 - Grd. Productos - Color

12 - Grd. Productos - Tamaño

13 - Cod.Barras

14 - Productos x Impuestos

15 - Productos Complementarios

16 - Productos Similares

17 - Lista de Precio

18 - Stock

 19 - Forma Pago.

 20 - Categ. de Terminal

 21 - Estación

 22 - Archivo de tienda

 23 - Param. por tienda

 24 - Parámetros por estación vs. forma de pago

 25 - Planes de pago vs. estación

 26 - Planes de pago vs. cuotas

 27 - Prefijos tarjetas

 28 - Usuarios

Tablas integradas - Protheus® Server:

SA1 - Clientes.

SL1 - Presupuesto.

SL2 - Ítems del presupuesto.

SL4 – Condición negociada.

SE5 - Movimiento bancario.

MEI - Encabezado de regla de descuento.

SFI - Resumen del informe Z.

SLW - Movimiento de procesos de venta.

SLT - Verificación de caja.

Movimientos y procesos integrados del Bridge al Protheus®:

• Ventas.
• Consulta de stock.
• Reserva de productos.
• Consulta Venta previa/Presupuesto.
• Pago de venta previa.
• Devoluciones.
• Consulta NCC.
• Apertura/Cierre de caja.
• Entrada de vuelto/Retiro parcial de caja.
• Verificación de caja.
• Movimiento de procesos de venta.
• Informe Z
• Clientes.

¡Importante!

Para realizar la importación de los movimientos del Bridge POS al Protheus® es necesario utilizar los WebServices específicos para cada movimiento. Para ello, los WebServices deben estar activos en el Protheus®. Para activar los servicios de webservices en el Protheus acceda al TDN, y consulte el documento Cómo iniciar un servidor de WebServices en el Protheus.

• Flujo de los movimientos:

Archivo De-A (LOJA758):

El Archivo De-A está disponible para facilitar y optimizar la integración entre los Sistemas, para realizar el vínculo de códigos distintos entre los sistemas para integración.

Al ejecutar la rutina de carga de datos se crean automáticamente los siguientes de-a:

• Forma de pago (FPAGTO).
• Tipo de ítem (ITEMTYPE).
• Monedas (MONEDA).
• Tes (TES).

El Archivo de categoría de terminales se almacena en la tabla de-a. El campo MGA_PROTHE es el código, el campo MGA_ORIGEM es la descripción, el campo MGA_TIPO con el contenido CTGTRM identifica si el registro es una categoría de terminal y automáticamente la rutina de Carga incluye cuatro tipos de categorías.

Este ejemplo presenta el de-a de TES(Protheus) vs. Impuesto(Synthesis), ya que solamente el Protheus® tiene el concepto de TES y para una venta en el Protheus® es necesario el código de una TES.

El Sistema Synthesis envía una venta al Protheus® con el(los) código(s) de impuesto(s) en los ítems o en el encabezado. en el momento de la importación de la venta se ejecuta la rutina De-A para buscar la TES(Protheus®) a partir de los impuestos (Synthesis) enviados en la venta. En este ejemplo, los impuestos son el IVA e IVB y para esta venta es necesario que la TES sea la 521, por lo tanto, el archivo de-a debe ser de la siguiente manera: 

• Tipo De A = TES
• Cód.Protheus = 521
• Cód.Origen = IVA/IVB

¡Importante!

Los archivos que tienen De-A predefinidos en el Setup de la integración son:

• Tipo de formas de pago vs. Formas de pago.
• TES vs. Impuestos.
• Categoría de terminales (Estaciones).
• Tipo de producto.
• Monedas

Formas de pago: Las formas de pago se registran en la tabla SX5, sin embargo, la Synthesis tiene una necesidad especial para el tratamiento de las formas de pago, es decir, las formas de pago con tarjeta se registran en la tabla Administradora financiera (SAE). Para la Synthesis las formas de pago con tarjeta tienen el mismo concepto de la Administradora financiera en el Protheus®. 

¡Importante!

Después de incluir una forma de pago en e SX5 o SAE, es necesario vincular al grupo equivalente la forma de pago, por medio del archivo De-A(MGA).

• Grupos de formas de pago

Los grupos de forma de pago definidos previamente por la Synthesis son:

1. Cash
2. Check
3. Coupon
4. Card
5. Cash on delivery
6. Nota de crédito
7. Crédito

Importante

Si existe alguna forma de pago registrada en el Protheus® que no esté relacionada en el Archivo de-a con alguno de los grupos anteriores, esta forma no se integrará y generará error de integración.

Para la Integración Parámetros de estación, es necesario registrar os archivos referentes a los parámetros de terminal en la tabla De-A(MGA) utilizando el tipo del De-A (CTGTRM).

• Parámetros de tienda

Se ha puesto a disposición el archivo Parámetros de tiendas, exclusivo para su utilización en la Integración Synthesis. El objetivo de este archivo es almacenar los datos en el Protheus® y enviar estos datos al Bridge para que el POS realice los tratamientos de acuerdo con el archivo. Para acceder, en el Control de tiendas, acceda a Actualizaciones/Integración/Parám. Tienda.

• Parámetros de estación

Se ha puesto a disposición el archivo Parámetros de estación, exclusivo para su utilización en la Integración Synthesis. El objetivo de este archivo es almacenar los datos en el Protheus® y enviar estos datos al Bridge para que el POS realice los tratamientos de acuerdo con el archivo. Para acceder, en el Control de tiendas, acceda a Actualizaciones/Integración/Parám Estación vs. Pago.

¡Importante!

Tanto para Parámetros de tienda como para Parámetro de las estaciones, en el campo Medio de pago, informe el código de la forma de pago, tomando en cuenta que, cuando la forma de pago sea por tarjeta es necesario informar el código de la Administradora financiera.

Ejemplo: VIS - VISA, AMX - AMEX, es decir, pueden informarse tanto datos de la tabla 24 (SX5) - Formas de pago como de la tabla SAE - Administradora financiera. 

• Planes de pago vs. Parámetros de la estación

Se ha puesto a disposición el archivo Planes de pago vs. Parámetros de estación exclusivo para su utilización en la Integración Synthesis. El objetivo de este archivo es almacenar los datos en el Protheus® y enviar estos datos al Bridge, para que el POS realice los tratamientos de acuerdo con el archivo. Para acceder, en el Control de tiendas, acceda a Actualizaciones/Integración/Parám Estación vs. Plan de pago. 

¡Importante!

En el campo Cód Par Term informe el mismo código de aquel que se registró en los Parámetros de estación.

• Planes de Cuotas vs. Planes de pago

Se ha puesto a disposición el archivo de planes de cuotas vs. planes de pago exclusivo para la integración Synthesis. El objetivo de este archivo es almacenar los datos en el Protheus y enviar estos datos al Bridge para que el POS realice los tratamientos de acuerdo con el archivo. Para acceder, en el Control de tiendas, acceda a Actualizaciones/Integración/Plan de pago vs. Cuotas.     

¡Importante!

En el campo Cd Plan Pag es necesario informar el mismo código registrado en el Planes de pago vs. Parámetros de estación.

• Prefijos

Se ha puesto a disposición el archivo de Prefijos exclusivo para que sea utilizado por Integración Synthesis. El objetivo de este archivo es almacenar los datos en el Protheus® y enviar estos datos al Bridge para que el POS realice los tratamientos de acuerdo con el archivo. Para entrar, en el Control de tiendas, acceda a Actualizaciones/Integración/Prefijos tarjetas.

• Impuestos

Para realizar la inclusión de los impuestos en el archivo de Impuestos variables (SFB) es necesaria cuidado al cumplimentar los campos Clasif.(FB_CLASSIF) y Clase Imp.(FB_CLASSE). También se pusieron a disposición los campos exclusivos para la integración Synthesis en este archivo. Los campos disponibles son: Categoría de impuestos, Uso ítem, Categoría ítem, Código regla, Valor bruto, Tipo impuesto y Forma de cálculo.

Importante

La cumplimentación de estos campos es fundamental para la integración de este archivo al Sistema Bridge y no influye en las rutinas de cálculo de impuestos en el Protheus®. Para ello, en el Fiscal acceda a Actualizaciones/Archivos/Impuestos Variab.

Algunos impuestos definidos previamente se incluirán durante la ejecución de las rutinas de carga de datos, sin embargo, el archivo y las configuraciones de los impuestos son de responsabilidad del responsable por la implantación y sustentación del entorno Fiscal en el cliente.

• Tablas auxiliares Impuestos – SX5

Se han puesto a disposición las tablas auxiliares con contenidos definidos previamente para el archivo de impuestos. Estas tablas se almacenan en el archivo SX5. Las tablas auxiliares disponibles para completar el archivo de impuestos para integración con Bridge son:

• OH - Categoría de impuestos.
• OI  - Tipos de impuestos por jurisdicción.
• OJ  - Categoría de ítems para impuestos.
• OL  - Uso del ítem.
• OM - Clase de impuesto.
• ON - Reglas de impuestos.
  
  

Tipo de impuestos:

• Impuestos variables - Percepciones de IIBB o IVA

Para efectuar la integración del archivo de Impuestos variables (SFB), además de la cumplimentación de los campos clave para registrar el impuesto, es fundamental la cumplimentación de los siguientes campos:

• El campo Clasif.(FB_CLASSIF) debe cumplimentarse con el contenido 1 = Ingresos brutos para percepciones de IB(IIBB) o con el contenido 3 = IVA para percepciones de IVA(VAT).
• El campo Clase Imp.(FB_CLASSE) debe cumplimentarse con el contenido P = Percepción.

Para ello, en Fiscal acceda a Actualizaciones/Archivos/Impuestos Variab.

• Impuestos internos ítems

Para realizar la integración del archivo Impuestos internos(SFB), además de la cumplimentación de los campos clave para el registro del impuesto, es fundamental la cumplimentación de los siguientes campos:

• El campo Clasif.(FB_CLASSIF) debe cumplimentarse con el contenido 2 = Internos.
• El campo clase Imp.(FB_CLASSE) debe cumplimentarse con el contenido I = Impuestos.

Para ello, en el Fiscal acceda a Actualizaciones/Archivos/Impuestos Variab.

• Impuestos IVA de los productos 

Para realizar la integración del archivo Impuestos IVA de los productos(SFB) además de la cumplimentación de los campos clave para el registro del impuesto, es fundamental la cumplimentación de los siguientes campos:

• El campo Clasif.(FB_CLASSIF) debe cumplimentarse con el contenido 3 = IVA.
• El campo clase Imp.(FB_CLASSE) debe cumplimentarse con el contenido I = Impuesto.

Para ello, en Fiscal acceda a Actualizaciones/Archivos/Impuestos Variab.

Modificación en el Archivo de productos.

Se efectuó la implementación de campos en el Archivo de productos para atender la Integración Protheus® vs. Synthesis:

• ¿Venta?(B0_VENDA): Informa si se permite la venta del producto.
• Digit Precio(B0_OBRGPRC): Informa si requiere la digitación del precio de venta.
• Digit. Ctd(B0_OBRGQTD): Informa si requiere la digitación de la cantidad.
• Permit. Ctd(B0_DIGQTD): Informa si permite la digitación de cantidad.
• Restr. Hr.(B0_RESTHR): Informa si existe restricción de hora para venta.
• Aut. Superior(B0_AUTSUPR): Informa si requiere de la autorización del supervisor para venta.
• Dig. Núm.Ser(B0_OBRGNSR): Informa si el producto requiere la digitación del número de serie.
• ¿Devolución?(B0_DEVOLV): Informa si permite devolución.
• Código marca(B0_CODMAR): Campo para informar el código de la marca registrada en la tabla OG del archivo SX5.
• Tipo de IVA(B0_TPIVA): Campo para informar el código del impuesto (VAT) vinculado al producto. Solamente seleccione los impuestos IVA de los productos(campo Clasif.(FB_CLASSIF) con el contenido 3 = IVA y campo clase Imp.(FB_CLASSE) con el contenido I = Impuesto.¿Per Ctd Frac?(B0_QTDFRAC): Permite informar cantidad fraccionada.

Importante

Estos campos son exclusivos de la Integración Protheus® vs. Synthesis y no se consideran en las rutinas del Protheus®.

• Archivo de productos complementarios

Para registrar un producto complementario para enviar al Bridge, basta acceder la rutina de sugerencia de ventas en el módulo de control de tiendas, en Actualizaciones->Escenario de Ventas->Sugerencia de ventas. Es necesario que la base de datos ya posea movimientos de ventas para que la rutina wizard realice la debida vinculación y también el parámetro MV_LJCATPR esté activado conforme procedimientos de implantación.

• Archivo de productos similares

Para registrar un producto complementario para enviar al Bridge basta acceder a la rutina de vinculación de categorías vs. productos en el módulo de control de tiendas, en Actualizaciones->Archivos->Vinculación Cat.xprd. Para que la rutina de integración con Bridge entienda que se trata de un registro de productos similares es necesario que el contenido del campo Sug. Venta (Sugerencia de venta) se cumplimente con el contenido 1 y campo secuencia no esté vacío, de acuerdo con la siguiente imagen. 

Archivo de marcas

Disponible el archivo de Marcas, exclusivo para utilización en la Integración Synthesis. El objetivo de este archivo es almacenar los datos en Protheus®, vincular la marca al producto y enviar estos datos al Bridge para que el POS realice los tratamientos conforme el archivo. Para acceder, en el Control de tiendas, acceda a Actualizaciones/Integración/Marcas. Porque este archivo utiliza nuestro archivo de tablas (SX5) es necesario que el campo Tabla siempre se complete con el contenido OG. 

Impuestos vs. Productos

Para el envío de los Impuestos vinculados es necesario que la TES esté registrada en la tabla SFC en el momento del envío de la información al Bridge. A partir de la TES vinculada al producto, se ubicarán los impuestos en la tabla SFC y se enviarán al Bridge Manager.

Encabezado Promo

Para almacenar el Archivo de promociones (Promo Bridge) se utiliza la tabla MEI - Encabezado regla de descuento. Para alimentar esta tabla existe un servicio WS(Protheus Server) cuya promoción se registra en el Bridge y se envía el código, descripción y vigencia al Protheus®.

En las ventas en las cuales se aplica el descuento referente a una promoción, se informa el código de la promoción, para ello, se creó un campo en los ítems de venta del Protheus(LR\L2_IDPROMO).

Aumento financiero (Recargos) 

En las rutinas de integración Protheus vs. Synthesis el aumento financiero se trata a través de un producto cuyo tipo (B1_TIPO) debe ser igual a CG – Recargo. 
El tipo de producto CG – Recargo se incluye automáticamente en la tabla de tipos de productos en el archivo SX5 después de la ejecución de la rutina de carga en las tablas intermediarias LJSTSCLIE conforme informado en procedimientos de implementación. 

El producto del tipo CG – Recargo se identifica al Bridge a través de la TAG genericItemFlag en el webservice de envío de productos.
Este producto debe estar relacionado a una TES que no calcule stock (F4_ESTOQUE = N), caso el producto del tipo CG - Recargo no posea una TES vinculada a través del campo B1_TS o la TES vinculada esté parametrizada para calcular stock la venta no se procesará y estará pendiente en la tabla intermediaria de exportación hasta el debido ajuste. 
Por el hecho de que la integración funciona solo con el escenario de ventas activo este producto del tipo CG debe estar vinculado a una lista de precios activa (DA1).
En las ventas con aumento financiero el Bridge va a enviar el valor del aumento financiero (recargo) da venta en el producto parametrizado como aumento financiero (recargo) y el Protheus va a considerar el valor enviado por el Bridge y no considerar los valores parametrizados para este producto en especial. Para los productos del tipo CG(Recargo) la tabla de/para de TES no se considera automáticamente y se considera la TES del producto. 

Venta de servicios 
En las rutinas de integración Protheus vs. Synthesis la venta de servicios es tratada a través de un producto cuyo tipo (B1_TIPO) debe ser igual a SV – Servicios. 
 

El tipo de producto SV – Servicios se incluye automáticamente en la tabla de tipos de productos en el archivo SX5 después de la ejecución de la rutina de carga en las tablas intermediarias LJSTSCLIE conforme informado en procedimientos de implementación. 
 

El producto del tipo SV – Servicios se identifica al Bridge a través de la TAG genericItemFlag en el webservice de envio de productos.

 
Este producto debe estar relacionado a una TES que no calcule stock (F4_ESTOQUE = N), caso el producto del tipo SV - Servicio no posea una TES vinculada a través del campo B1_TS o la TES vinculada esté parametrizada para calcular stock para venta no se procesará yestará pendiente en la tabla intermediaria de exportación hasta el debido ajuste. 

Por el hecho de que la integración funcione solo con el escenario de ventas activo este producto de tipo SV debe estar vinculado a una lista de precios activa (DA1).

En las ventas de productos del tipo servicio el Bridge va a enviar el valor del servicio en el producto parametrizado como servicio y el Protheus va a considerar el valor enviado por el Bridge y no considerar los valores parametrizados para este producto en especial. Para los productos del tipo SV (Servicio) la tabla de/para de TES no se considera automáticamente y es considerada la TES del producto.

Pago de ventas utilizando NCC

Para que las ventas que utilizan NCC como forma de pago se graben correctamente en las tablas del Protheus®, el parámetro MV_LJCPNCC(Utilización de la NCC si la utilización fuera parcial) se utiliza con el Contenido 2 – Modificación de saldo.

Integración de Ventas previas/Presupuestos

Las ventas previas/presupuestos se realizan en el Sistema Bridge(Synthesis) y se envían al Protheus® para posterior consulta y envío como Pago. Para casos de ventas previas/presupuestos, el campo L1_SITUA se graba con el contenido AG (Esperando pago).

Código de países

Los códigos de los países utilizados en la integración será a partir del estándar ISO 3166-1 alfa-3. Los principales países de América del Sur y Central se graban en la tabla SYA a partir de la ejecución de la rutina de carga de datos LJSTSCLIE con la codificación ISO 3166-1 alfa-3.

Integración Usuarios

Los usuarios se registran en el Protheus® y se envían de forma encriptada al Bridge, que realiza la validación del hash en el momento del login en el Bridge POS. Para la integración con la Synthesis es obligatoria la cumplimentación de la fecha de validez del login del usuario. Después de la inclusión de un usuario por medio del Control de tiendas se muestra una pantalla para que se informe el perfil del usuario al Bridge, esta información es obligatoria para el Bridge. Existen tres tipos de perfil 1, 2 o 3. Siendo 1 = Admin, 2 = Advanc, 3 = Basic. Las configuraciones referentes a cada perfil quedan almacenadas en el sistema Bridge. Después de informar el perfil del usuario se activa la pantalla de archivo de vendedores para facilitar el registro del vendedor. El código del vendedor debe ser el mismo del login del usuario. Para el Bridge un usuario (login) puede ser vendedor y caja. 

Archivo de clientes

• La integración no acepta caracteres especiales en los campos del Archivo de clientes.
• El campo fecha de nacimiento es obligatorio para la integración.
• Para clientes persona física, es necesario completar los campos Nombre reducido(A1_NREDUZ) y el campo Nombre(A1_NOME).
• Para clientes persona Jurídica es necesario completar el campo Nombre(A1_NOME).
• Si el cliente tuviera ingresos brutos, complete el campo N.Ing.Brutos(A1_NROIB).
• Si se hubiera completado el campo Teléfono, los campos DDN y DDI, también deben completarse.
• Si el cliente tuviera impuestos para registrar (SFH) es obligatorio completar los siguientes campos: FH_PERCENT - % Exención, FH_ALIQ – Alícuota, FH_DECRETO – Decreto, FH_INIVIGE – Ini. Vigencia, FH_FIMVIGE – Fin Vigencia, FH_CATCLI – Cód Categoría.
• Por el hecho que Bridge no trata el concepto de vigencia para sus registros de impuestos del cliente la integración siempre envía todos los registros de la tabla SFH sn considerar los campos de vigencia.
• Si el cliente posee un registro en la tabla SFH con el campo de exento (FH_ISENTO) igual a S se envía un registro con la alícuota 0(cero).
• Si el cliente posee un registro en la tabla SFH con el campo de alicuota igual a 0(cero) se envía un registro con la alícuota vacía para que el Bridge entienda que será tratado de la forma de cálculo de impuesto general.
• Es obligatorio informar el CUILT para persona física, el DI (Documento de identidad) para persona física o el número de pasaporte para los extranjeros. Esta información es necesarias para la generación automática del código del cliente.
• Es obligatorio el rellenado del campo Cod.Municipio (A1_COD_MUN) debido a las validaciones internas del sistema Bridge. El campo Municipio (A1_MUN) se completa de forma automática tras el rellenado del código del municipio. Para la importación del cliente a partir del sistema Bridge el processo es el mismo. Las informaciones referentes al código, descripción y estado/prov. del municipio están almacenadas en la tabla CC2 (Municipios). Para facilitar la implantación esta tabla se publica de forma automática por las rutinas de setup de la integración. Caso necesario el mantenimiento en esta tabla está disponible la rutina de registro de municipios (FISA010) localizada en Actualizaciones->Integración->Municipios.

Regla para generación del código del cliente 

Con el objetivo de evitar duplicidades de códigos de clientes, el campo Código del cliente (A1_COD), tendrá 13 caracteres y se compondrá de:  tipo de documento del cliente (01 – Documento nacional de identidad; 02 – Pasaporte; 03 – CUIT) + Número del documento y se completará con ceros a la izquierda del número del documento.

Ejemplo: Un cliente persona física que presenta su DNI(Documento nacional de identidad) que tiene el número 12345, el Código del cliente (A1_COD) debe ser de la siguiente manera: 010000012345. El código del cliente se revalidará y ajustará de forma automática de acuerdo con la regla Synthesis en el momento de la confirmación del archivo del cliente. El código informado manualmente se ignorará.

Bloqueo de registros

El bloqueo de registros se trata por medio del campo (ALIAS)_MSBLQL para las siguientes entradas. Después del bloqueo del registro, se envía al Bridge el registro como bloqueado

• Proveedores.
• Clientes.
• Niveles de jerarquía.
• Grupos de jerarquía.
• Unidad de medidas.
• Impuestos IVA de los productos.
• Tipo de impuestos internos. Productos.
• Medios de pago.
• Prefijos.

Monitor de LOGS

Para facilitar la identificación y corrección de las inconsistencias ocurridas en la integración, se puso a disposición un Monitor de Logs (LOJA743). Por este monitor, es posible verificar qué error ocurrió en la integración y permite modificar el estatus del registro para reprocesamiento. Para registrar las inconsistencias ocurridas en el transcurso de las integraciones, se utilizan tablas específicas dependiendo de la modalidad de la integración (MF4 – Exportación y MEZ – Importación). Interfaz para modificación de la tabla intermediaria de exportación – MEZ 

Está a disposición la interfaz para modificación de los registros almacenados en la tabla intermedia de exportación de los dados al Sistema Bridge. El objetivo de esta interfaz es modificar el estatus de los registros de la tabla intermedia MEZ por medio del campo Estatus POS (MEZ_STFLAG). Para entrar al Control de tiendas, acceda a Actualizaciones/Integración/Interfaz intermedia exportación.

Interfaz para modificación de la tabla intermedia de importación – MF3

Está a disposición la interfaz para modificación de los registros almacenados en la tabla intermedia de importación de los dados al sistema Bridge. El objetivo de esta interfaz es modificar el estatus de los registros de la tabla intermedia MF3 por medio del campo Estatus POS (MF3_STFLAG). Para entrar al Control de tiendas, acceda a Actualizaciones/Integración/Interfaz intermedia importación.

Monitor de errores Integración ERP 
Para facilitar la identificación y corrección de las inconsistencias ocurridas en la integración de las ventas con el ERP Protheus después de la grabación de las tablas del módulo de control de tiendas, está disponible un Monitor de errosr Integración ERP (LOJA781). 


Es posible verificar el error ocorrido en la integración con las tablas del ERP y permite modificar el estatus del registro para reprocesamiento; 

Facilitadores de implantación y diagnóstico de posibles inconsistencias durante la integración: 
• Rutina de carga para publicar las tablas del motor de integración client y server con todos los datos necesarios para ejecutar la integración; 
• Rutina para publicar la tabla de-para con los principales deparas (tipos de productos, formas de pago, categorías de terminal, monedas y países ya definidos entre TOTVS y Synthesis; 
• Rutina para publicar nuevas tablas y datos necesarios para los archivos Synthesis con los datos ya definidos entre TOTVS y Synthesis (Categorías del cliente ante los impuestos, Tipos de Impuesto por Jurisdicción, Categorías de ítems para los impuestos, Uso del ítem, Clase de Impuesto, Reglas de Impuestos, Impuestos IVA Productos, formas de pago (NCC, Euro, Dólar), países para seguir el estándar ISO 3166-1 alfa-3, tipo de productos 02-SX5) y Municipios Argentina (Ciudades); 

• Rutina para publicar la tabla SB0 con base en los datos de la tabla SB1 ya rellenando todos los campos obligatorios para integración existente en la tabla SB0. Para ejecutar esta rutina acceda la sucursal que desea crear la tabla SB0 Actualizaciones/Integración/Crea SB0. 

• Rutina para publicar una nuva tienda en la tabla intermediaria de exportación del Protheus y envío al Bridge con todos los datos base ya cargados para las demás tiendas. Para ejecutar esta rutina acceda Actualizaciones/Integración/Genera Nueva tienda. 

• Monitores de LOGS de integración para importación (SERVER) y exportación (CLIENT) donde consta el estatus del registro, el motivo de la inconsistencia y los datos inconsistentes, todo en una sola pantalla y con la opción de que el propio usuario solicite el reprocesamiento tras el ajuste de las inconsistencias de datos. 
• Envío automático de alerta vía e-mail al responsable por la operacion cuando detecta alguna inconsistencia en el proceso de integración dentro del Protheus para importación y exportación de datos y movimientos; 
• Rutina para modificación de datos en las tablas intermediarias de integración tanto Server como Client, evitando la necesidad de accesos directos a base de datos; 
• Monitor integracion ERP (GRAVABATCH) donde consta el estatus del registro, el motivo de la inconsistencia y los datos inconsistentes, todo en una sola pantalla y con la opción de que el propio usuário solicite el reprocesamiento tras el ajuste de las inconsistencias de datos;

Restricciones:

No se consideran en esta Integración los siguientes procesos:

1. Estilos, envases, imágenes, enlazados y servicios (productos)
2. Formato de franqueo, Comprobantes y Prefijos de comprobantes (medios de pago)
3. Parámetros de terminal (datos de la tienda)
4. Grupos y papeles (usuarios).
5.  Aumento financiero por condición de pago.

• La generación de los valores fiscales son de responsabilidad de Synthesis.
• Los datos relacionados a movimiento ej. ventas, informe Z, movimiento caja, retiros parciales de caja, entrada de vuelto son de responsabilidad de Synthesis.
• La integración soporta movimientos de devolución en dinero o en factura de crédito (NCC).

Procedimiento de implementación:

Importante

Antes de ejecutar el compatibilizador UPDLO114 y UPDLO143, es imprescindible:

1. Realizar la copia de seguridad de la base de datos y de los diccionarios de datos SXs del producto donde se ejecutará el compatibilizador.
2. Los directorios mencionados anteriormente corresponden a la instalación estándar del Protheus, por lo tanto, deben modificarse de acuerdo con el producto instalado en la empresa.
3. Esta rutina debe ejecutarse de modo exclusivo, es decir, ningún usuario debe estar utilizando el sistema.
4. Si los diccionarios de datos tienen índices personalizables (creados por el usuario), antes de ejecutar el compatibilizador, asegúrese de que estén identificados por el nickname. Si el compatibilizador necesita crear índices, los agregará a partir del orden original instalado por el Protheus, lo que podrá superponer índices personalizables, si no están identificados con por el nickname.
5. El compatibilizador debe ejecutarse con la Integridad referencial desactivada*.

1. En TOTVS Smart Client, digite U_UPDLO114 en el campo Programa inicial.

Importante

Para la correcta actualización del diccionario de datos, asegúrese de que la fecha del compatibilizador es igual o superior al 22/06/2013.

1. Haga clic en OK para continuar.
2. Después de la confirmación, se muestra una pantalla para seleccionar la empresa en la cual se modificará el diccionario de datos.
3. Al confirmar se muestra un mensaje de advertencia sobre la copia de seguridad y la necesidad de su ejecución de modo exclusivo.
4. Haga clic en Procesar para iniciar el procesamiento. El primer paso de la ejecución es preparar los archivos. Se muestra un mensaje explicativo en la pantalla.
5. A continuación, se muestra la ventana Actualización finalizada con el historial (log) de todas las actualizaciones procesadas. En este log de actualización sólo se muestran los campos actualizados por el programa. El compatibilizador crea los campos que aún no existen en el diccionario de datos.
6. Haga clic en Grabar para guardar el historial (log) mostrado.
7. Haga clic en OK para finalizar el procesamiento.

Importante

Realice el mismo procedimiento de implementación utilizado para aplicación del UPDLO114, al UPDLO143.

Actualización del compatibilizador UPDLO114

1. Modificación de tabla en el archivo SX2– Tablas:

2. Creación de tabla en el archivo SX2– Tablas:

3. Creación de disparadores en el archivo SX7 – Disparadores:

• Tabla MFB - Vínculo Categoría vs. Filtro:

1. Creación de tablas genéricas en el archivo SX5 – Tablas genéricas:

2. Modificación de Campos en el archivo SX3 – Campos:

• Tabla ACU - Categoría de productos:

• Tabla ACV – Categoría vs. Grupo o Producto:

• Tabla SA5 – Vínculo Producto vs. Proveedor:

• Tabla SB5 - Datos adicionales del producto:

1. Creación de campos en el archivo SX3 – Campos:

• Tabla ACU – Categoría de productos:

• Tabla ACV – Categoría vs. Grupo o Producto:

• Tabla MDY – Importación – Configuración WS:

• Tabla MEL – Importación – Configuración campos:

• Tabla MEY - Importación - Tabla intermedia:

• Tabla MEZ – Importación – Log de error:

• Tabla MF1 – Exportación – Configuración WS: