Línea de Producto:

Microsiga Protheus.

Segmento:

Servicios - Mercado Internacional.

Módulo:

SIGAFIN - Financiero.

Rutina:

Rutina

Nombre Técnico

FINA884

Realiza Conexión con la Banca On-Line - PLAID.

WSFIN884

Servicio REST para integración.

MATA070Actualización de Bancos.
LOCXNFDocumentos de Entrada/Salida.

Rutina(s) involucrada(s)

Nombre Técnico

FINA070

Baja de títulos por recibir.

FINA080Baja de títulos por pagar.
FINXATUBajas efectuadas de títulos.
FINA100Movimientos de Bancos.
FINXBXFunciones de Financiero.
FINA050Cuentas por Pagar.
Requisito/Story/Issue:DMINA-3786

País(es):

Estados Unidos de América

Base(s) de Datos:

Todas

Tablas utilizadas:

SA6 - Bancos.

SE1 - Cuentas por Pagar.

SE2 - Cuentas por Cobrar.

SE5 - Movimientos Bancarios.

RVR - Acces Token Plaid.

RVS - Encabezado de Movimientos de Banca On-line.

RVT - Detalle de Movimientos.

Pacote:

  • 005600 (Diccionario de Datos)
  • 005713 (Mantenimiento de Menús)

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. 


Procedimiento de Implantación 

  1. Aplique el patch del issue DMINA-4133.
  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:

Grupo

FINRVS

FINRVS
FINRVS
FINRVS
FINRVS
FINRVS

Orden

01

0203040506

Descripción

¿De Fecha?

¿A Fecha?¿Banco?¿Agencia?¿Cuenta?     ¿Operación?    

Tipo

D

DCCCN

Tamaño

8

855101
Tipo ObjetoGGGGGC
Definición 1




Débito
Definición 2




Crédito
Definición 3




Ambos
Validación





VariableMV_PAR01MV_PAR02MV_PAR03MV_PAR04MV_PAR05MV_PAR06
F3

SA6


Grupo Campos

007008009
Help de pregunta
Informar Fecha Inicial.Informar Fecha Final.Informar Banco.Informar Agencia.Informar Cuenta.Informar Operación.


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

Clave

(X2_CLAVE)

Nombre

(X2_NOME)

Modo

(X2_MODO)

PYME

(X2_PYME)

RVR

Acces Token Plaid

C

S

RVS

Encabezado de Movimientos.

C

S

RVT Detalle de Movimientos.

C

S

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

  • Tabla SA6 - Bancos:


Campo

A6_IPLAID

Tipo

Carácter

Tamaño

1

Decimal

0

Título

Int. Plaid

Descripción

Integración con PLAID

Se utiliza

Obligatorio

Browse

No

Opciones

1=Si;2=No

Inic.  Estándar

'2'

Contexto

Real

Propiedad

Modificar

Disparadores

Carpeta

1

Orden

74

 

Campo

A6_PLID

Tipo

Carácter

Tamaño

40

Decimal

0

Formato@!

Título

Cód. Cuenta

Descripción

Código de la Cuenta

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Carpeta

1

Orden

75

 

Campo

A6_BANKID

Tipo

Carácter

Tamaño

10

Decimal

0

Título

Id Banco

Descripción

Identificador de Banco

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Carpeta

1

Orden

76

 

Campo

A6_INTID

Tipo

Carácter

Tamaño

18

Decimal

0

Título

Acceso Relac

Descripción

Acceso Relacionado.

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Consulta Estándar

RVR

Carpeta

1

Orden

77


  • Tabla SE1 - Cuentas por Pagar:

 

Campo

E1_SLPLAID

Tipo

Numérico

Tamaño

13

Decimal

2

Formato

@E 9,999,999,999.99

Título

Bal Plaid

Descripción

Balance Plaid

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

N4

 

Campo

E1_PORTADO

Tipo

Carácter

Tamaño

3

Decimal

0

Formato

@!

Título

Portador

Descripción

Código del portador

Se utiliza

No

Obligatorio

No

Browse

Val. Sistema

ExistCPO("SA6")

Consulta Estándar

BCO

Grupo de Campos

007 - Banco

Carpeta

5

Orden

07


  • Tabla SE2 - Cuentas por Cobrar:

Campo

E2_SLPLAID

Tipo

Numérico

Tamaño

13

Decimal

2

Formato

@E 9,999,999,999.99

Título

Bal Plaid

Descripción

Balance Plaid

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

L1

Campo

E2_BCOPAG

Tipo

Carácter

Tamaño

3

Decimal

0

Formato

@!

Título

Bco. de Pago

Descripción

Banco de Pago

Se utiliza

No

Obligatorio

No

Browse

No

Val. Sistema

ExistCPO("SA6")

Consulta Estándar

BCO

Grupo de Campos

007 - Banco

Carpeta

4

Orden

20


  •  Tabla SE5 - Movimientos Bancarios:

Campo

E5_INTPLAI

Tipo

Carácter

Tamaño

1

Decimal

0

Formato

@!

Título

INTPLAID

Descripción

INTPLAID

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

A9


  • Tabla RVR - Acces Token Plaid:

Campo

RVR_FILIAL

Tipo

Carácter

Tamaño

8

Decimal

0

Formato

@!

Título

Sucursal

Descripción

Sucursal

Se utiliza

No

Obligatorio

No

Browse

No

Grupo de Campos

033 - Tamaño de la Sucursal

Orden

01

 

Campo

RVR_TOKEN

Tipo

Carácter

Tamaño

60

Decimal

0

Formato

@!

Título

Token Públic

Descripción

Token Público

Se utiliza

Obligatorio

Browse

Contexto

Real

Propiedad

Modificar

Orden

02

 

Campo

RVR_USERID

Tipo

Carácter

Tamaño

18

Decimal

0

Formato

@!

Título

Id Usuario

Descripción

Identificador de Usuario

Se utiliza

Obligatorio

Browse

Contexto

Real

Propiedad

Modificar

Orden

03

 

Campo

RVR_ATOKEN

Tipo

Carácter

Tamaño

60

Decimal

0

Formato

@!

Título

Token acceso

Descripción

Token de acceso

Se utiliza

Obligatorio

Browse

Contexto

Real

Propiedad

Cambiar

Orden

04


  • Tabla RVS - Encabezado de Movimientos:


Campo

RVS_FILIAL

Tipo

Carácter

Tamaño

8

Decimal

0

Formato

@!

Título

Sucursal

Descripción

Sucursal

Se utiliza

No

Obligatorio

No

Browse

No

Grupo de Campos

033 - Tamaño de la Sucursal

Orden

01

 

Campo

RVS_ID

Tipo

Carácter

Tamaño

10

Decimal

0

Título

Id

Descripción

Identificador

Se utiliza

Obligatorio

Browse

Inic.  Estándar

IIf(Inclui, GetSxEnum('RVS', 'RVS_ID'), RVS_ID)

Contexto

Real

Propiedad

Visualizar

Orden

02

 

Campo

RVS_DATA

Tipo

Fecha

Tamaño

8

Decimal

0

Título

Fecha Emi.

Descripción

Fecha de Emisión

Se utiliza

Obligatorio

Browse

Contexto

Real

Propiedad

Visualizar

Orden

03

 

Campo

RVS_DESCRI

Tipo

Carácter

Tamaño

250

Decimal

0

Formato

@!

Título

Descripción

Descripción

Descripción del Título

Se utiliza

Obligatorio

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

04

 

Campo

RVS_DOCREL

Tipo

Carácter

Tamaño

80

Decimal

0

Formato

@!

Título

Numero Doc.

Descripción

Numero de Documento

Se utiliza

Obligatorio

No

Browse

Contexto

Real

Propiedad

Visualizar

Orden

05

 

Campo

RVS_CATEGO

Tipo

Carácter

Tamaño

1

Decimal

0

Título

Categoría

Descripción

Categoría

Se utiliza

Obligatorio

Browse

Opciones

1=Un registro encontrado;2=Varios registros encontrados;3=Gasto No Identificado;4=Ingreso No Identificado

Inic.  Estándar

'1'

Contexto

Real

Propiedad

Visualizar

Orden

06

 

Campo

RVS_VALDEB

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Valor Débito

Descripción

Valor Débito

Se utiliza

Obligatorio

No

Browse

Contexto

Real

Propiedad

Visualizar

Orden

07

 

Campo

RVS_VALCRE

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Valor Crédito

Descripción

Valor Crédito

Se utiliza

Obligatorio

No

Browse

Contexto

Real

Propiedad

Visualizar

Orden

08

 

Campo

RVS_COD

Tipo

Carácter

Tamaño

3

Decimal

0

Título

Código

Descripción

Código del Banco

Se utiliza

Obligatorio

Browse

Contexto

Real

Propiedad

Visualizar

Orden

09

 

Campo

RVS_AGENCI

Tipo

Carácter

Tamaño

5

Decimal

0

Título

Nro Agencia

Descripción

Numero Agencia del Banco

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

10

 

Campo

RVS_NUMCON

Tipo

Carácter

Tamaño

10

Decimal

0

Formato

@!

Título

Nro Cuenta

Descripción

Numero de Cuenta

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

11

 

Campo

RVS_NOMEAG

Tipo

Carácter

Tamaño

40

Decimal

0

Formato

@S20

Título

Nomb.Agencia

Descripción

Nombre de la Agencia

Se utiliza

Obligatorio

No

Browse

Contexto

Real

Propiedad

Visualizar

Orden

12

 

Campo

RVS_STATUS

Tipo

Numérico

Tamaño

1

Decimal

0

Formato

9

Título

Estatus

Descripción

Estatus

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

13

 

Campo

RVS_IDPLAI

Tipo

Carácter

Tamaño

60

Decimal

0

Formato

@!

Título

Id Plaid

Descripción

Id Plaid

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

14

 

Campo

RVS_IDBANK

Tipo

Carácter

Tamaño

60

Decimal

0

Formato

@!

Título

Id Banco

Descripción

Id Banco

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

15

 

  • Tabla RVT - Detalle de Movimientos:


Campo

RVT_FILIAL

Tipo

Carácter

Tamaño

8

Decimal

0

Formato

@!

Título

Sucursal

Descripción

Sucursal

Se utiliza

No

Obligatorio

No

Browse

No

Grupo de Campos

033 - Tamaño de la Sucursal

Orden

01

 

Campo

RVT_ITEM

Tipo

Carácter

Tamaño

2

Decimal

0

Título

Ítem

Descripción

Ítem

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

02

 

Campo

RVT_ID

Tipo

Carácter

Tamaño

10

Decimal

0

Título

Id

Descripción

Identificador

Se utiliza

No

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

03

 

Campo

RVT_CATEGO

Tipo

Carácter

Tamaño

10

Decimal

0

Formato

@!

Título

Categoría

Descripción

Categoría

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Cambiar

Consulta Estándar

SED

Disparadores

Orden

04

 

Campo

RVT_TIPO

Tipo

Carácter

Tamaño

3

Decimal

0

Formato

@!

Título

Tipo Cuenta

Descripción

Tipo de Cuenta

Se utiliza

Obligatorio

No

Browse

No

Opciones

NF=NF;TB=TB;CH=CH;VL=VL

Inic.  Estándar


Contexto

Real

Propiedad

Cambiar

Orden

05

 

Campo

RVT_DOC

Tipo

Carácter

Tamaño

13

Decimal

0

Formato

@!

Título

Num. Doc.

Descripción

Número de Documento

Se utiliza

Obligatorio

Browse

No

Contexto

Real

Propiedad

Modificar

Grupo de Campos018 - Documento de Entrada/Salida

Orden

06

 

Campo

RVT_SERIE

Tipo

Carácter

Tamaño

3

Decimal

0

Formato

@!

Título

Serie

Descripción

Serie

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Grupo de Campos094 - Id de control de Documentos Fiscales

Orden

07

 

Campo

RVT_CLIPRO

Tipo

Carácter

Tamaño

6

Decimal

0

Formato

@!

Título

Entidad

Descripción

Entidad

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

08

 

Campo

RVT_LOJA

Tipo

Carácter

Tamaño

2

Decimal

0

Formato

@!

Título

Tienda

Descripción

Tienda

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Grupo de Campos002 - Tienda Cliente/Proveedor

Orden

09

 

Campo

RVT_DATAMO

Tipo

Fecha

Tamaño

8

Decimal

0

Título

Fecha Mov

Descripción

Fecha Movimiento

Se utiliza

Obligatorio

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

10

 

Campo

RVT_VALOR

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Valor Total

Descripción

Valor Total

Se utiliza

Obligatorio

No

Browse

Contexto

Real

Propiedad

Visualizar

Orden

11

 

Campo

RVT_SALDO

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Saldo

Descripción

Saldo de la Factura

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

12

 

Campo

RVT_SLPLAI

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Bal Plaid

Descripción

Bal Plaid

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

13

 

Campo

RVT_OPPLAI

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Value Plaid

Descripción

Value Plaid

Se utiliza

Obligatorio

No

Browse

No

Val. Sistema

ZIValIMP()

Contexto

Real

Propiedad

Modificar

Disparadores

Orden

14

 

Campo

RVT_VLDOP

Tipo

Numérico

Tamaño

12

Decimal

2

Formato

@E 999,999,999.99

Título

Valor Cheque

Descripción

Valor Cheque Beneficiario

Se utiliza

Obligatorio

No

Browse

No

Val. Sistema

ZIValIMP2()

Contexto

Real

Propiedad

Visualizar

Disparadores

Orden

15

 

Campo

RVT_OBS

Tipo

Carácter

Tamaño

60

Decimal

0

Formato

@!

Título

Observaciones

Descripción

Observaciones

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

16

 

Campo

RVT_PARCEL

Tipo

Carácter

Tamaño

2

Decimal

0

Formato

@!

Título

Parcialidad

Descripción

Parcialidad

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Grupo de Campos011 - Parcela

Orden

17

 

Campo

RVT_ORIGEN

Tipo

Carácter

Tamaño

3

Decimal

0

Formato

@!

Título

Origen

Descripción

Origen

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

18

 

Campo

RVT_SEQ

Tipo

Numérico

Tamaño

12

Decimal

0

Formato

@E 999999999999

Título

Secuencia

Descripción

Secuencia del Registro

Se utiliza

Obligatorio

No

Browse

No

Contexto

Real

Propiedad

Visualizar

Orden

19

 

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


Alias

RVR

Tipo

1 - Consulta Estándar

Secuencia

01

Columna

DB

Descripción

Consulta Bancos I

Contiene

RVR

 

Alias

RVR

Tipo

2 - Órdenes

Secuencia

01

Columna

02

Descripción

Id Usuario

 

Alias

RVR

Tipo

4 - Columnas

Secuencia

01

Columna

01

Descripción

Id Usuario

Contiene

RVR_USERID

 

Alias

RVR

Tipo

4 - Columnas

Secuencia

02

Columna

01

Descripción

Token

Contiene

RVR_TOKEN

 

Alias

RVR

Tipo

5 - Retorno

Secuencia

01

Contiene

RVR_USERID

 

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


Índice

RVR

Orden

1

Clave

RVR_FILIAL + RVR_TOKEN

Descripción

RVR_FILIAL + RVR_TOKEN

Muestra Busq.

 

Índice

RVR

Orden

2

Clave

RVR_FILIAL + RVR_USERID

Descripción

User ID

Muestra Busq.

Índice

RVS

Orden

1

Clave

RVS_FILIAL + RVS_ID

Descripción

ID

Muestra Busq.

 

Índice

RVS

Orden

2

Clave

RVS_FILIAL + RVS_COD + RVS_AGENCI + RVS_NUMCON

Descripción

Código+Nro Agencia+Account Num

Muestra Busq.

 

Índice

RVS

Orden

3

Clave

RVS_FILIAL + RVS_IDPLAI

Descripción

Id Plaid

Muestra Busq.

Índice

RVT

Orden

1

Clave

RVT_FILIAL + RVT_ID + RVT_ITEM

Descripción

ID+ITEM

Muestra Busq.


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

Nombre de la Variable

MV_PLPUBK

Tipo

Carácter

Descripción

Clave de acceso publica para conexión con PLAID, por ejemplo: '4ff6ae0c0253Re5019d24258eb8cf9'. Es proporcionada por el admin. del servicio PLAID.

Valor Estándar


Nombre de la Variable

MV_PLURNET

Tipo

Carácter

Descripción

URL conexión servio REST, ejemplo: 'http://129.150.123.218:8084/rest/ WSFIN884'. El servicio REST está identificado como 'WSFIN884'.

Valor Estándar


Nombre de la Variable

MV_PLUSNET

Tipo

Carácter

Descripción

Usuario protheus para Conexión REST. Se recomienda crear un usuario y password con los permisos de acceso y de uso exclusivo para el servicio                

Valor Estándar


Nombre de la Variable

MV_PLPANET

Tipo

Carácter

Descripción

Contraseña de usuario protheus para conexión REST.

Valor Estándar


Nombre de la Variable

MV_PLLOGIN

Tipo

Carácter

Descripción

Código del usuario que tiene acceso al servicio de PLAID. Por ejemplo: '598b16d04e95b8Acda1f0794'.

Valor Estándar


Nombre de la Variable

MV_PLPASS

Tipo

Carácter

Descripción

Contraseña de conexión al servicio de PLAID. Por ejemplo:  'af8cefe631eb9a2Rf4f465499be87a'.

Valor Estándar


Nombre de la Variable

MV_PLEMENT

Tipo

Carácter

Descripción

Entorno de conexión con sitio PLAID. Por ejemplo: 'pruebas', 'desarrollo' o 'producción'.

Valor Estándar


Nombre de la Variable

MV_PLURL

Tipo

Carácter

Descripción

Https de conexión con sitio PLAID. Por ejemplo: 'pruebas', 'desarrollo' o 'producción'.

Valor Estándar



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


Campo

A6_IPLAID

Secuencia

001

Cnt. Dominio

A6_PLID

Tipo

P - Primario

Regla

M->A6_PLID := IIf(M->A6_IPLAID == "2", "", M->A6_PLID)

 

Campo

A6_IPLAID

Secuencia

002

Cnt. Dominio

A6_BANKID

Tipo

P - Primario

Regla

M->A6_BANKID := IIf(M->A6_IPLAID == "2", "", M->A6_BANKID)

 

Campo

A6_IPLAID

Secuencia

003

Cnt. Dominio

A6_INTID

Tipo

P - Primario

Regla

M->A6_BANKID := IIf(M->A6_IPLAID == "2", "", M->A6_INTID)

Campo

E1_CLIENTE

Secuencia

003

Cnt. Dominio

E1_PORTADO

Tipo

P - Primario

Regla

Posicione("SA1", 1, xFilial("SA1") + M->E1_CLIENTE + M->E1_LOJA, "A1_BCO1")

 

Campo

E1_VALOR

Secuencia

011

Cnt. Dominio

E1_SLPLAID

Tipo

P - Primario

Regla

M->E1_VALOR

Campo

E2_FORNECE

Secuencia

005

Cnt. Dominio

E2_BCOPAG

Tipo

P - Primario

Regla

Posicione("SA2", 1, xFilial("SA2") + M->E2_FORNECE + M->E2_LOJA, "A2_BANCO")

 

Campo

E2_VALOR

Secuencia

001

Cnt. Dominio

E2_SLPLAID

Tipo

P - Primario

Regla

M->E2_VALOR

Campo

RVT_CATEGO

Secuencia

001

Cnt. Dominio

RVT_DATAMO

Tipo

P - Primario

Regla

M->RVT_DATAMO :=  PlaidData()

 

Campo

RVT_OPPLAI

Secuencia

001

Cnt. Dominio

RVT_VLDOP

Tipo

P - Primario

Regla

M->RVT_VLDOP  := IIf(M->RVT_SALDO>=M->RVT_OPPLAI,M->RVT_OPPLAI,0)

 

Campo

RVT_VLDOP

Secuencia

001

Cnt. Dominio

RVT_VLDOP

Tipo

P - Primario

Regla

M->RVT_VLDOP  := IIf(M->RVT_SALDO>=M->RVT_VLDOP,M->RVT_VLDOP,0)

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:

Menú

Actualizaciones

Submenú

Movimientos Bancarios

Nombre de la Rutina

Transacciones PLAID

Programa

FINA884

Módulo

SIGAFIN

Tipo

Función Estándar


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.


Punto de Entrada

Nombre

Finalidad  

FINPIDMNU

Punto de entrada disponible para adicionar botones al menú principal variable aRotinaRVS “ExecBlock("FINPIDMNU",.F.,.F.)”