DT_Integracion_Protheus_con_Banca_Online_PLAID_EUA

Descripción 

Permite extraer los movimientos de la banca On-Line de una manera simple y directa para Protheus, adicional, genera una pre-conciliación operativa de manera previa al proceso de Conciliación bancaria (FINA380), permitiendo así conciliar de manera previa la información. 

Se ealizó ajustes de compatibilidad para las versiones 12.1.23 y 12.1.25 e implementó la generación de archivos de texto que detalla el error de inicio de sesión del usuario. En el contenido del registro se mostrará la siguiente información:

• Código de error
• Mensaje de error
• Tipo de error
• Metadatos link_session_id
• Estado
• Nombre de la institución
• ID de la institución

No es necesario cambiar el diccionario de datos, solo aplique el último paquete disponible que contenga las rutinas actualizadas FINA884, MATA070 y WSFIN884.

Al cambiar la integración bancaria a sí y confirmar el cambio en el registro bancario, se debe abrir un navegador de conexión Plaid.

Debes iniciar sesión en el banco. Si se producen errores, haga clic en la opción Aceptar. El navegador descargará automáticamente un archivo de texto con un código y un mensaje de error de registro que debe enviarse al soporte de Plaid para las acciones apropiadas.

Procedimiento de Implantación 

1. Aplique el patch del issue DMINA-13616.
2. Realice las actualizaciones al Diccionario de Datos, en caso de no contar con ellas.

Nota: Realizar respaldo de tablas SX y base de datos.

Actualizaciones al Diccionario 

1. Creación de Preguntas en el archivo SX1 - Preguntas:
   
   

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

3.  Creación de Campos en el archivo SX3 - Campos:

• Tabla SA6 - Bancos:

• Tabla SE1 - Cuentas por Pagar:

• Tabla SE2 - Cuentas por Cobrar:
  
  

•  Tabla SE5 - Movimientos Bancarios:
  
  

• Tabla RVR - Acces Token Plaid:
  
  

• Tabla RVS - Encabezado de Movimientos:

• Tabla RVT - Detalle de Movimientos:

Nota: El tamaño de los campos que disponen de "Grupo de Campos", puede variar de acuerdo con el entorno en uso.

5.  Creación de Consulta Estándar en el archivo SXB – Consulta Estándar:

 RVR - Consulta de Bancos I

6.  Creación de Índices en el archivo SIX – Índices:

7.  Creación de Parámetros en el archivo SX6 – Parámetros:

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

Procedimiento de Configuración

CONFIGURACIÓN DE MENÚS

1.  En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción del menú SIGAFIN, conforme las instrucciones a continuación:

CONFIGURACIÓN DE APPSERVER.INI PARA HABILITAR EL SERVICIO

2.  Edite el archivo AppServer.Ini y configure como sigue, después guarde y reinicie el servicio:

_{[SSLCONFIGURE]}

_SSL2=1

_SSL3=1

_{TLS1_0=1}

_{TLS1_1=1}

_{TLS1_2=1}

_{TryProtocols=1}

_[ONSTART]

_JOBS=HTTPJOB 

_{RefreshRate=80}

 [HTTPV11]

_Enable=1

_{Sockets=HTTPREST}

 [HTTPREST]

_Port=8084

_URIs=URIHTML

_SECURITY=1

 [URIHTML]

_URL=/rest

_{PrepareIn=All}

_{Instances=2,2}

_CORSEnable=1

_{AllowOrigin=*}

 [HTTPJOB]

_{MAIN=HTTP_START}

_{ENVIRONMENT= Ambiente que  utilizar la integración}

CONFIGURACIÓN DE SMARTCLIENT.INI PARA HABILITAR EL SERVICIO

3.  Edite el archivo SmartClient.Ini y configure como sigue:

[config]

BrowserEnabled=1

 Nota: Una forma de validar que esta activo el parámetro “BROWSERENABLED=1” es cuando ingresas al sistema y en la pantalla principal visualizará la pagina WEB de inicio de su navegador de Windows.

Procedimiento de Utilización 

1. En el módulo Financiero (SIGAFIN), acceda a Updates/ Files / Bank (MATA070). Incluya o modifique una cuenta de bancos para integrar con PLAID.
2. Seleccione la opción “YES” para el campo Integration (A6_IPLAID), el cual permitirá activar la integración. Confirme. 
3. Se abrirá una pantalla para realizar el login de la conexión con PLAID. Seleccione el Login.
4. Seleccione el banco a integrar con PLAID.
5. Ingrese el usuario y password de acceso a la banca electrónica, es muy importante que, al ingresar el usuario, password y botón SUBMIT, se use la tecla <TAB> para poder avanzar en cada uno de los campos y al final confirmar la operación con la tecla <ENTER>. En caso de omitir esta instrucción el sistema aun cuando los datos sean correctos, le negará el acceso a una conexión exitosa.
   1. Ingrese el usuario y se oprima <TAB> dos veces.
   2. Ingrese el password y se oprima <TAB> dos veces.
   3. Oprima <ENTER> para confirmar la operación. 
6. Plaid realizará la validación de los datos de acceso y si todo está correcto se presentará la pantalla de conexión exitosa y retornará la llave pública de la conexión realizada en el momento, por lo que el usuario a partir de ese momento, puede cerrar las ventanas dando click en el icono “X” de las dos siguientes pantallas.
7. Después de cerrar la conexión con PLAID si la conexión fue exitosa, no presentará ningún aviso de ALERTA, en caso contrario notificará al usuario que cambie a “NO” la integración cuando no resulto completada la operación con PLAID.
8. En el módulo Financiero (SIGAFIN), acceda a Updates/ Bank Transaction / Plaid Transaction (FINA884). El sistema solicitará los parámetros de configuración.
9. Configurar el día o periodo que se desea conciliar con los movimientos realizados en el sistema, seleccionar el banco de conexión, seleccionar si visualizará los movimientos: DEBITO, CREDITO o AMBAS. Seleccione “Ok”.
10. Si la cuenta de banco seleccionada, es la primera vez que se realiza la consulta de movimientos On-Line, el proceso identificara esta acción y solicitará al usuario que seleccione la cuenta a relacionar entre la banca y el catálogo de bancos de PROTHEUS, esto porque en caso de existir más de una cuenta relacionada al usuario con el que se realizó la conexión, se deberá establecer el vínculo para cada una de las cuentas que serán utilizadas en la integración. Seleccione la cuenta y Confirme, después de esta acción, el sistema ya no volverá a solicitar la relación de la cuenta, a menos que se restauren los valores de integración a “NO” en el catálogo de bancos y se vuelva a realizar la configuración de conexión.
11. Realizado el punto anterior, el sistema presentará en el browse los movimientos de Ingresos y egresos de la banca On-Line, así como sugerencias cuando identifica similitudes pre-existentes en los movimientos de la banca On-Linea y PROTHEUS,  los cuales se explicaran más adelante
12. Seleccione la opción Modificar y registre los movimientos de PROTHEUS a relacionar con los del PLAID.  Presentará la pantalla (encabezado y Detalle) con los datos:

Datos del Encabezado (solo se visualizaran):

• • • Id: Código secuencia numérico interno para uso en sistema TOTVS.
    • Issue Date: Fecha de la operación Ingreso o Egreso de la banca.
    • Description: Descripción del movimiento Bancario.
    • Payee: Documentos relacionados en el MATCH para Egresos (CXC/Mov Bancario) o para Ingresos (CXC/Mov Bancario)
    • Category: Describe si el movimiento ha sido identificado en la integración o no.                                                       
    • Debit Value: Valor Débito                                                                   
    • Credit Value: Valor Crédito
    • Code: Código del banco en sistema TOTVS
    • Branch Number: Clave de la sucursal del banco TOTVS
    • Account Number: Número de Cuenta del banco TOTVS
    • Branch Name: Nombre del Banco TOTVS.
    • Id Bank: Id del movimiento de banco.

Registre los datos del Detalle:

• • • Ítem: Consecutivo de registro capturados en Grid.
    • Category: Clase (Naturaleza) que debe seleccionar el usuario cuando realiza un registro manual de ingreso o egreso y que al momento de realizar el relacionamiento, grabará un movimiento bancario de manera automática.
    • Type Bill: Tipo de movimiento que el usuario puede seleccionar cuando ingresa de manera manual un movimiento relacionado al registro extraído de la banca. Los movimientos válidos para generar un movimiento bancario son transferencia Bancaria “TB” o Cheque “CH”. Al ser un movimiento relacionado de INGRESOS, EGRESOS o BANCOS este campo es alimentado de manera automática por la información ya existente en el sistema.
    • Num. Doc: Numero de documento capturado de manera manual cuando el usuario está ingresando un registro directamente y que generara un movimiento bancario al realizar el relacionamiento. Al ser un movimiento relacionado de INGRESOS, EGRESOS o BANCOS este campo es alimentado de manera automática por la información ya existente en el sistema.
    • Serie: Prefijo de Títulos por cobrar o por pagar que el usuario ha seleccionado de los botones INGRESOS o EGRESOS. En una captura manual es necesario alimentar información por el usuario.
    • Entity: Entidad (código de Cliente/Proveedor) relacionada a un movimiento financiero preexistente en sistema y que el usuario ha seleccionado en los botones de INGRESOS o EGRESOS dependiendo la naturaleza del movimiento de la banca. En la captura manual no está permitido ingresar información.
    • Branch: Sucursal de la entidad relacionada al título financiero que el usuario ha seleccionado de los botones INGRESOS o EGRESOS. En la captura manual este campo no permite ingresar información.
    • Data: Hace referencia a la misma fecha del movimiento extraído de la banca Online. Esta es considerada cuando se realiza el Match para generar una cobranza en automática de un título por cobrar que se ha seleccionado del botón INGRESOS o para la generación de una orden de pago en automática de un título seleccionado del botón EGRESOS o para la generación de un movimiento bancario automática de ingreso o egreso registrado directamente por el usuario y que se genera de manera automática. Para los movimientos bancarios preexistentes al realizar el match no generara ningún cambien en la fecha con al que se ha generado el movimiento en el sistema.
    • Total Value: Para los movimientos seleccionados del Botón INGRESOS presentara el valor original del título seleccionado, para los movimientos del botón EGRESOS presentara el valor original del título seleccionado y para los movimientos bancarios botón BANCOS presentara el valor del movimiento bancario seleccionado.
    • Balance Bill: Hace referencia al Balance del título seleccionado de los Botones INGRESOS o EGRESOS, este campo no puede ser editado y es utilizado para validar que el usuario pueda visualizar el valor pendiente por liquidar del título y puede disponer para realizar una baja parcial o total al momento de realizar el MATCH del movimiento.
    • Bal PLaid: Hace referencia al saldo pendiente por liquidar con los movimientos de la banca Online y es independiente al Balance del título, debido a que un mismo documento puede estar en proceso de aplicación de Match en diferentes movimientos y el sistema utiliza para controlar el saldo pendiente por liquidar y no exceder el Balance del título al aplicar el MATCH en los movimientos.
    • Val Plaid: Este campo puede sr considerado por cada ítem el de mayor importancia ya que aquí el usuario informará el valor a ser descontado del Balance del título al realizar el MATCH parcial o total para los títulos INGRESOS o EGRESOS. Si y solo si será generado el descuento en el título y generado el movimiento bancario cuando sea aplicado el MATCH. Si el usuario al estar realizando el mantenimiento del registro de la banca y utiliza el botón de confirmar, el sistema restara del título en cuestión el valor informado del campo E1_SLPLAID o E2_SLPLAID, para los movimientos bancarios actualizara el campo E5_INTPLAI. 
    • VLd Payee: Campo que es actualizado de manera automática cuando el usuario informa un valor en el campo “Val Plaid” siendo la finalidad de este es conservar el valor a ser utilizado en la compensación del título INGRESOS o EGRESOS al realizar el MATCH. En el caso que el usuario no requiera realizar una baja sobre el título en gestión este campo puede ser colocado con el valor de Cero y solo realizara la actualización del Balance del campo E1_SLPLAID o E2_SLPLAID sin realizar un proceso automático de baja parcial o total del TITULO. Es importante que el usuario considere si este campo puede estar bloqueado para no permitir realizar solo afectaciones al Balance Plaid de los títulos sin realizar la baja automática del mismo.
    •  Obs.: Campo informativo que permite al usuario colocar comentarios que serán conservados para futuras aclaraciones sobre el MATCH del movimiento bancario Online. En los casos que el ítem sea una captura directa del usuario para generar un movimiento bancario de INGRESOS o EGRESO esta información será grabada en el historial del registro bancario en sistema TOTVS.
    • Installment: La finalidad de este campo es poder informar si el titulo seleccionado de los botones INGRESOS o EGRESOS cuenta con desdoblamiento del título generado por la condición de pago seleccionada al generar el movimiento financiero en los módulos de compras o facturación, así como títulos por cobrar o pagar.
    • Origen: Este campo se alimenta de manera automática cuando se ha seleccionado un título o movimiento bancario de los botones INGRESOS (SE1), EGRESOS (SE2) o BANK (SE5) utilizado para control interno del sistema.
    • Secuence: Este campo es alimentado de manera automática cuando se ha seleccionado un movimiento bancario del botón BANK registrando el valor de la secuencia del registro en la tabla de movimientos bancarios del sistema y es utilizado para control interno del sistema. 

Descripción de los datos al pie de página:

• • Total Item Plaid: Presenta el Valor total informado en el campo “Val Plaid”
  • Bal Header – Bal Item: Presenta la diferencia de valor existente entre el importe del encabezado del movimiento de la banca Online y el importe informado de los ítems en el campo “Val Plaid”. Mientras exista una diferencia en el importe mayor o menor a CERO no permitirá poder realizar el MATCH al usuario.
    

13. Confirme para guardar la información registrada.

DESCRIPCION DE LA UTILIDAD DE OTROS BOTONES

Ingresos.- Permite al usuario visualizar los títulos por cobrar con balance pendiente de integrar con la banca On-line (E1_SLPLAID vacío) y solo estará disponible para los movimientos con valor en campo “CREDIT VALUE”. Después seleccionarlo presentará una pantalla con opción para marcar los registros que se podrían relacionar al registro de la banca. El usuario podrá seleccionar uno o varios títulos y finalizar con la opción Confirmar, y grabará los movimientos para presentarlos en el grid de Detalle. Con la opción EXIT regresará a la pantalla anterior.

Egresos.- Permite visualizar los títulos por pagar con balance pendiente de integrar con la banca On-line (E2_SLPLAID vacío) y solo estará disponible para los movimientos con valor en campo “DEBIT VALUE”. Después de seleccionarlo presentará una pantalla con opción para marcar los registros que se podrían relacionar al registro de la banca. El usuario podrá seleccionar uno o varios títulos y finalizar con la opción Confirmar, y grabara los movimientos para presentarlos en el grid de Detalle.  Con la opción EXIT regresará a la pantalla anterior.

Bancos.- Permite visualizar Movimientos bancarios Pagados, si el movimiento de la banca es “DEBIT VALUE” o visualizar los movimientos bancarios de Ingresos Recibidos, si el movimiento de la banca es “CREDIT VALUE”. Los movimientos presentados son aquellos que no tienen relación con otros movimientos de la banca On-line (E5_INTPLAI) sin valor de integración aplicada. El usuario podrá seleccionar uno o varios movimientos bancarios y finalizar con la opción Confirmar, y grabará los movimientos para presentarlos en el grid de Detalle.  Con la opción EXIT regresará a la pantalla anterior.

Relacionar.- Permite al usuario realizar el Match del movimiento de la banca On-line y el, o los movimientos financieros del sistema. Es en esta parte del proceso donde aquellos títulos en los que el usuario informó un Valor en el campo “Val Plaid” y “Val Payee”, aplicara ya sea una liquidación para un título por cobrar o un movimiento bancario de ingreso si el usuario capturo un registro manualmente, o si es un movimiento bancario ya existente, será marcado como ya integrado con el movimiento de la banca On-line. Así mismo realiza la aplicación de un pago para los títulos por pagar o un movimiento bancario en automático para un registro manual, generando un pago o marcando el movimiento bancario ya existente como ya integrado, con los movimientos de la banca On-line. Realizado este proceso el registro de la banca On-line será marcado con MATCH realizado y en el browse se visualizará de color Rojo.

Borrar.- Permite eliminar el contenido de encabezado y detalle de los ítem informados en el grid, sin la necesidad de que el usuario elimine ítem por ítem. Restaurando el saldo de los movimientos informados si el usuario había informado ya algunos valores en el campo “Val PLAID” y eliminando el registro total del browse de movimientos importados de la banca On-line. Los movimientos eliminados por el usuario en el próximo ingreso a la rutina, el sistema los presentara nuevamente con el number Id consecutivo sin embargo respetará toda la información extraída de la banca como es la fecha, importe, descripción y datos generales del movimiento On-line, este procedimiento aplicara para los movimientos que están pendientes de MATCH.

Para los movimientos que se requieran eliminar y que ya se había realizado el MATCH, el usuario previamente deberá revertir en cada una de las rutinas estándar del sistema los movimientos automáticos realizados en el cual el sistema validara si permite bajo las políticas de seguridad de integridad revertir los movimientos, por lo que deberá tener mucho cuidado de realizar las reversiones en su totalidad como pueden ser, des-conciliar el movimiento bancarios de ingreso o egreso, anular pagos aplicados, cobros aplicados. Paso siguiente el usuario debería realizar dicha anulación. 

Significado de las Leyendas:

• Verde: Se refiere a movimientos de Egresos de la cuenta bancaria y que aún no tienen relacionado ningún documento (Cuenta por Pagar/Mov Bancario).
• Amarillo: Movimientos de Ingreso de la cuenta bancaria y que aún no tienen relacionado ningún documento (Cuenta por Cobrar/Mov Bancario).
• Azul: Movimiento de Ingreso o Egreso que tiene uno o más documentos relacionados y que se encuentra pendiente de relacionarlo.
• Rojo: Movimiento de Ingreso o Egreso que ya se ha realizado la relación entre la Banca On-line y los movimientos de PROTHEUS.

Información Adicional:

Configuración para mostrar la columna “Nombre Cliente” (Ingresos) o “Nombre Proveedor” (Egresos) en las primeras posiciones del grid.
Dentro de módulo de Financiero (SIGAFIN) desde el menú Transacciones > Movim. Bancario > Transacciones Plaid (FINA844)

• Asignar los parámetros solicitados.
• Seleccionar una cuenta por pagar o por cobrar y dar clic en el botón “Modificar”
• En el formulario de actualización dar clic en el botón “Egresos”(para las cuentas por pagar) o “Ingresos”(para las cuentas por cobrar)
• Se mostrara una ventana con un browser de selección con los movimientos bancarios.
• Utilizando el scroll del grid (moviéndolo hacia la derecha) verificar que la columna “Nombre Proveedor”(Egresos) o “Nombre Cliente”(Ingresos) se encuentre dentro del grid.
  Si considera que no es necesario mover la posición de la columna no realizar los siguientes pasos.

1. En la parte superior derecha de la ventana dar clic en el botón en forma de engrane (configuraciones)
2. Esta acción muestra la pantalla de configuración de tabla, seleccionar la opción “Ordenar columnas”
3. Se muestran las columnas disponibles.
4. Ubicar la columna “Nombre Proveedor”(Egresos) o “Nombre Cliente”(Ingresos) y  ordenar (utilizando las flechas indicadoras descendente - ascendente).
5. Dar clic en el botón “guardar ordenación”, después cerrar la configuración.
   Verificar que se actualicen las columnas respetando la configuración realizada a la vista del grid.
   La configuración de la vista del grid se puede realizar las veces que sean necesarias.

Punto de Entrada