Configuraciones necesarias para el registro de boletas por el API del Banco do Brasil.
Para pruebas en entorno de homologación deben utilizarse los datos ficticios para pruebas de acuerdo con la documentación del Portal Developers BB.
Red interna
Para la comunicación del Protheus con el banco, si fuera necesario, debe configurarse la seguridad de red para aceptar la salida del rango de IP referente al DNS:
Para la configuración del layout es necesario obtener ante el Banco do Brasil la siguiente información:
Application Key - Clave de la aplicación: Clave de acceso de la aplicación
Client ID - ID del cliente: Código de identificación del cliente
Client Secret - Clave secreta del cliente: Clave secreta de validación del cliente.
No considere la clave BASIC si la hubiera recibido.
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
Para la impresión de la boleta se considerarán los campos DV Cta.Ofic. (EE_DVCTOFI) e DV Age.Ofic. (EE_DVAGOFI), si estos estuvieran vacíos se considerarán los campos DV Cuenta (EE_DVCTA) y DV Agencia (EE_DVAGE).
Para utilizar el registro online de boletas para el Banco do Brasil, debe observarse la siguiente regla:
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 programada en agenda) se utilizará en los datos de la transmisión e impresión de la boleta.
Donde:
Se puede informar el valor original ya deduciendo el valor del descuento. Es solo hacer clic en el engranaje en el campo "Valor original" e informar una expresión válida:
Ejemplo:
Importante
Si el valor original ya está calculado con la deducción de los valores de descuento, el campo "Descuento" no se debe informar para que no ocurra una duplicación en el valor de descuento.
Si el campo "Descuento" se completa, el campo "Valor original" debe contener el valor informado (Sin la deducción del descuento). Si existe descuento, aparecerá un mensaje en el cuerpo de la boleta informando el valor del descuento ya calculado.
Importante
El REST debe estar habilitado con SSL utilizando un certificado A1 (Ejemplo de configuración).
Webhook es un servicio donde el banco envía informações de bajas de boletas al ERP Protheus.
La comunicación entre el Protheus y el Banco do Brasil ocurre mediante la autenticación de certificados mTLS.
Para más detalles acceda a la documentación que está disponible en el Portal Developers BB.
Es necesario un servicio REST habilitado en el Protheus con SSL y puesto a disposición para el Banco do Brasil (verifique en el Banco do Brasil dónde informar esta URL para envío de informaciones al Protheus).
Informe la URL del servicio REST disponibilizada por el Banco do Brasil en las configuraciones de cuentas en el campo Dirección (URL) de call-back del webhook:
https://seuendereco:suaporta/api/fin/v1/bb/bol/receivables/
seuendereco:suaporta → Informe la dirección y puerto del servicio REST configurado en el archivo appserver.ini.
/api/fin/v1/bb/bol/receivables/ → API disponible en el servicio REST estándar del Protheus preparada para recibir el payload de cobro(boletas) del Banco do Brasil.
Permite que el usuario configure cómo se imprimirán los valores en la boleta.
Importante