Aviso
Producto aún en etapa piloto.
Modelo que se seguirá para la integración de Movimientos bancarios enviados del sistema Gesplan al Protheus.
El envío de datos debe realizarse vía SmartLink utilizando el Estándar CloudEvents para envío de mensajes en el formato Json.
El job FwTotvsLinkJob debe configurarse en el schedule, este es responsable por la lectura de los mensajes recibidos en la cola del SmartLink.
A continuación tenemos el modelo de mensaje enviado por Gesplan.
El atributo type indica el evento que se ejecutará en el ERP. El job FWTotvsLinkJob identifica un nuevo mensaje y ejecuta la clase MOVreadXGsp, responsable por la inclusión del Movimiento bancario (FINA100) vía rutina automática. El fuente que contiene la clase MOVreadXGsp es el FINI100G.prw.
Fomato de respuesta:
a. Principales campos y parámetros
a1. Movimiento bancario por pagar o cobrar
Campo | Descripción | Tipo | Tamaño(MÁX) | Obligatorio | Observación |
---|---|---|---|---|---|
CompanyId | Código del grupo de empresas | Carácter | 2 | X | Grupo de empresa del Protheus. |
BranchId | Código de la sucursal | Carácter | 8 | X | Sucursal del Protheus. Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas, el BranchId está compuesto por Empresa + Unidad de negocio + Sucursal |
E5_MOEDA | Dinero | Carácter | 2 | X | N/A |
E5_VALOR | Valor del movimiento | Numérico | 16 | X | Decimal debe enviarse con el carácter punto |
E5_DATA | Fecha del movimiento | Carácter | 10 | X | Fecha enviada en formato carácter ddmmaaaa ej: "08/09/2022" |
E5_NATUREZ | Modalidad | Carácter | 10 | X | N/A |
E5_BANCO | Código del banco | Carácter | 3 | X | N/A |
E5_AGENCIA | Agencia del banco | Carácter | 5 | X | N/A |
E5_CONTA | Cuenta corriente en el banco | Carácter | 10 | X | N/A |
E5_RECPAG | Cobranza o Pago | Carácter | 1 | X | Enviar: "S" → Movimiento por pagar (salida) "E" → Movimiento por cobrar (entrada) |
E5_CCUSTO | Centro de costo | Carácter | 9 | N/A | |
E5_BENEF | Beneficiario | Carácter | 30 | N/A | |
E5_DOCUMEN | Número del documento | Carácter | 50 | N/A | |
E5_HISTOR | Historial del movimiento | Carácter | 40 | N/A | |
SYSCODE | Clave identificadora Gesplan | Carácter | X | N/A | |
ID | Código de control Gesplan | Carácter | X | N/A | |
Específico | Variable | Ver más detalles de la utilización de campos específicos en el "ítem c" siguiente. |
a2. Transferencia bancaria
Campo | Descripción | Tipo | Tamaño(MAX) | Obligatorio | Observación |
---|---|---|---|---|---|
CompanyId | Código del Grupo de empresas | Carácter | 2 | X | Grupo de empresa del Protheus. |
BranchId | Código de la sucursal | Carácter | 8 | X | Sucursal del Protheus. Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas el BranchId está compuesto por la Empresa + Unidad de negócio + Sucursal |
CBCOORIG | Código del banco origen | Carácter | 3 | X | N/A |
CAGENORIG | Código de la agencia origen | Carácter | 5 | X | N/A |
CCTAORIG | Cuenta corriente origen | Carácter | 10 | X | N/A |
CNATURORI | Modalidad origen | Carácter | 10 | X | N/A |
CBCODEST | Código del banco destino | Carácter | 3 | X | N/A |
CAGENDEST | Código de la agencia destino | Carácter | 5 | X | N/A |
CCTADEST | Conta corrente destino | Carácter | 10 | X | N/A |
CNATURDES | Modalidad destino | Carácter | 10 | X | N/A |
CTIPOTRAN | Tipo da transferencia | Carácter | 6 | X | N/A |
CDOCTRAN | Número del documento | Carácter | 15 | X | N/A |
NVALORTRAN | Valor que será transferido del banco origen al banco destino. | Numérico | 16 | X | Decimal debe enviarse con el carácter punto |
CHIST100 | Historial de la transferencia | Carácter | 40 | X | Historial referente a la transferencia efectuada. |
CBENEF100 | Beneficiario | Carácter | 30 | X | Nombre del favorecido en el caso de emitirse un cheque referente a transferencia. |
NCTBONLINE | ¿Contabiliza On Line? | Numérico | 1 | 1=Sí;2=No | |
DDATACRED | Fecha de crédito | Carácter | 10 | X | Fecha enviada en formato carácter ddmmaaaa ej: "08/09/2022" |
E5_RECPAG | Cobranza o pago | Carácter | 1 | X | Enviar: "T" → Transferencia bancaria (salida) |
SYSCODE | Clave identificadora Gesplan | Carácter | X | N/A |
a3. Reversión de transferencias
Campo | Descripción | Tipo | Tamaño(MAX) | Obligatorio | Observación |
---|---|---|---|---|---|
CompanyId | Código del Grupo de empresas | Carácter | 2 | X | Grupo de Empresa do Protheus. |
BranchId | Código de la sucursal | Carácter | 8 | X | Sucursal del Protheus. Identificación de la sucursal del sistema donde ocurrirá el movimiento bancario. En entornos con Gestión de empresas el BranchId está compuesto por la Empresa + Unidad de negocio + Sucursal |
AUTNRODOC | Número del documento | Carácter | 15 | X | N/A |
AUTDTMOV | Fecha del movimiento | Carácter | 10 | X | Fecha enviada en formato carácter ddmmaaaa ej: "08/09/2022" |
AUTBANCO | Código del banco | Carácter | 3 | X | Código del banco al que se refiere al documento que será revertido |
AUTAGENCIA | Agencia del banco | Carácter | 5 | X | Agencia del banco al que se refiere el documento que será revertido |
AUTCONTA | Cuenta corriente en el banco | Carácter | 10 | X | Cuenta a la que se refiere el documento que se revertirá |
E5_RECPAG | Tipo de movimiento | Carácter | 1 | X | Enviar: "X" → Reversión de la transferencia |
SYSCODE | Clave identificadora Gesplan | Carácter | X | N/A | |
ID | Código de control Gesplan | Carácter | X | N/A |
b. Moneda del movimento bancario
El Movimiento bancario se generará en la moneda del banco informado. De esta manera, al presentarse en informes y consultas, solamente tendrá su valor convertido si la moneda solicitada en los parámetros fuera diferente de la moneda del registro del banco.
c. Campo específico/personalizado
Existe la posibilidad de enviar cualquier otro campo existente en el diccionario de datos de la tabla SE5 del entorno donde se está procesando el mensaje. Este campo puede ser un campo estándar (no ejemplificado en la tabla anterior) o un campo personalizado (creado específicamente para el entorno Protheus donde la integración está activa). En este caso, basta que se inscluya una nueva línea en el contenido del mensaje, con el mismo formato Clave/Valor, de acuerdo con el siguiente ejemplo, donde incluimos los campos E5_DEBITO (campo estándar del producto) y E5_XDTCLI (campo específico del ERP del cliente).
d. Entes contables
A continuación se muestran los principales campos representando los entes contables que pueden utilizarse para clasificación del movimiento.
Los campos SysCode y ID no se grabarán en el ERP, estos solamente son informaciones de control de Gesplan, que llegará en la requisición y se enviarán en la respuesta del procesamiento, indicando éxito o falla de la inclusión de este Movimiento bancario. Además de los índices consultados a disposición, es posible listar los registros generados por medio del campo origen, con contenido FINI100G.IMPORTANTE