Configuraciones necesarias para el registro de boletas por el API del banco SICOOB.
Rede interna
Para la comunicación del Protheus con el banco es necesario configurar la seguridad de red, si fuera necesario, para aceptar la salida del rango de IP referente al DNS:
https://api.sicoob.com.br
https://auth.sicoob.com.br
Funcionalidad en desarrollo
¡Esta funcionalidad está en etapa de desarrollo y dentro de poco entrará en pruebas con clientes piloto, por lo tanto, aún no está liberada en ningún release del Protheus!
Se liberará por medio de un paquete de expedición acumulado del módulo financiero en fecha que aún se informará.
¡Esta página puede tener modificaciones hasta la fecha de liberación de la funcionalidad!
Para utilizar la API del banco SICOOB es necesario activar el servicio en su cuenta. Este proceso se debe solicitar directamente a su gerente de cuenta.
Para establecer una conexión segura con los API Gateways del SICCOB es necesario tener un certificado del tipo A1. Este certificado se utiliza para establecer el mTLS (OAuth 2.0 Mutual Transport Layer Security).
Más detalles del proceso de generación del certificado deben obtenerse en el portal del banco SICCOB en el tópico Certificado digital.
En este proceso se generarán dos archivos, uno con extensión CRT y el otro KEY que se utilizarán en el proceso de configuración y layout del Nuevo Administrador Financiero.
Importante
Es necesario el registro correcto del dígito verificador de la cuenta en el campo Dv Cuenta (A6_DVCTA)
Si el registro estuviera incorrecto en la tabla de bancos (SA6), el ajuste debe realizarse en su subcuenta en el Registro Parámetros de bancos (tabla SEE) en los campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) y DV Cta.Ofic. (EE_DVCTOFI).
Ejemplo de cuenta que debe adecuarse: Cuenta 12345-6
En el registro del banco, campo Nº Cuenta (A6_NUMCOM) = 123456 y DV Cuenta (A6_DVCTA) = vacío, el ajuste en su subcuenta debe ser Cta. Oficial (EE_CTAOFI) = 12345 y DV Cta.Ofic. (EE_DVCTOFI) = 6
ATENCIÓN
Para el funcionamiento de la comunicación bancaria por API del banco SICOOB, el usuario debe configurar los parámetros del banco
Los campos de la fórmula EE_FORXXX deben tener expresiones ADVPL válidas para evitar posibles disconformidades o interrupciones inesperadas en el proceso.
Al iniciar la configuración de layout para una nueva cuenta del SICOOB se presentarán los pasos:
Seleccione la cuenta en que desea realizar la configuración
En este paso se incluirán las informaciones obtenidas en el banco en el proceso de habilitar el servicio en su cuenta.
Informe en este paso el ID del cliente y Clave secreta del cliente suministrados por el banco.
Informe el nombre del Archivo clave del certificado (KEY) y Archivo de certificado (CRT).
En este paso, se configurarán todas las informaciones que se enviarán al banco para la transmisión de la boleta.
En este paso se configurarán todas las informaciones necesarias para la devolución de los movimientos vía API, operación que posteriormente efectuará la baja de los títulos en el financiero.
Para utilizar el registro online de boletas para el banco SICOOB, deben observarse las siguientes reglas:
Donde puede ser:
Los datos registrados en esta sucursal se utilizarán en la transmisión y en la impresión:
Atención
Si este campo no estuviera informado, la Sucursal actual (Sucursal conectada o Sucursal configurada en la programación en agenda) se utilizará en los datos de la transmisión e impresión de la boleta.
Donde puede ser:
Es posible informar el valor original deduciendo el valor del descuento. Basta hacer clic en el engranaje en el campo "Valor original" e informar una expresión válida:
Ejemplo:
Importante
Si el valor original estuviera calculado con la deducción de los valores de descuento, el campo "Descuento" no debe completarse para que no ocurra una duplicidad en el valor de descuento.
Si se completara el campo "Descuento" el campo "Valor original" debe contener el valor completo (Sin la deducción del descuento). Si existiera descuento se mostrará un mensaje en el cuerpo de la boleta informando el valor del descuento ya calculado.
El proceso de baja de títulos (devolución) se realiza por medio de la ejecución del Job FINA715.
El Protheus comienza la comunicación con el banco solicitando informaciones de eventos de baja de boletas. El Job solicitará al banco boletas liquidadas (pago realizado) y dados de baja (no se realizó el pago y el banco dio baja automáticamente) en el período determinado del parámetro MV_FNGDTBX hasta el día actual, o del día anterior hasta el día actual si no se informara el parámetro.
Después del procesamiento de las informaciones devueltas por el banco, los títulos se bajan en el sistema o se transfieren de la cartera, de acuerdo con el estatus devuelto por el banco.
Es posible acompañar el log de las ejecuciones por medio del Nuevo administrador financiero accediendo al menú: Comunicación online→ Cuentas por cobrar → Log Devolución (Bajas).
Haga clic en el enlace para más informaciones sobre el proceso de Bajas de títulos (Devolución) - FINA710.