01. VISIÓN GENERAL

Configuraciones necesarias para el registro de pagos 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.

02. CREDENCIALES

Es posible realizar la configuración de la operación de extracto bancario y/o registro online de pagos por medio de las opciones:

    • API Extracto - Realiza la configuración de las credenciales para la operación de Extractos bancarios automáticos (Funcionalidad en desarrollo).
    • API Pagar - Realiza la configuración de las credenciales para la operación de registro online de pagos.
    • Ambos - Realiza la configuración de las credenciales para la operación del extracto bancario automático y el registro online de pagos.

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.

La comunicación entre el ERP y el banco sucede vía autenticación mutua de certificados (mTLS), de esta manera, es necesario solicitar los datos sobre el Banco do Brasil. Para más detalles acceda a la documentación que está disponible en el Portal Developers BB.

Red 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://oauth.bb.com.br

https://oauth.hm.bb.com.br

https://api.bb.com.br

https://api.hm.bb.com.br

https://api-ip.bb.com.br

03. CERTIFICADO DIGITAL

Para promover la integración sistémica del registro on-line de pagos, es necesario tener el Certificado Digital ICP Brasil del tipo A1. Puede utilizar un certificado tipo A1 que ya tenga (por ejemplo, que utiliza en las transmisiones de las facturas electrónicas) o solicitar un nuevo certificado ante el Banco do Brasil. Para saber más detalles sobre el certificado digital, acceda a los siguientes enlaces:

Seguridad

Autenticación mutua de certificados (mTLS)

Después de enviar al Banco do Brasil el certificado A1 que se utilizará en el proceso, importe este mismo certificado por medio de la rutina CFGX060 - Documento de referencia: https://tdn.totvs.com/x/viabEg.

La validación del certificado digital por medio del (NGF) Nuevo administrador financiero, se realizará por medio de la confirmación de los archivos "CERT" y "KEY" que deben estar grabados en el camino \CERT\NGF\{nombre del archivo}.

El nombre de los archivos debe estar compuesto por:

"nombre del certificado".pem;
"nombre del archivo clave del certificado".pem.

IMPORTANTE:

a) En la generación del archivo por el módulo configurador (rutina CFGX060), se generarán los archivos con la extensión .pem, los cuales deben ser renombrados manualmente a .key y .crt.

b) Si los nombres de los archivos fuera iguales, el usuario puede utilizar el texto "_key""_cert" para diferenciarlos.

c) La estructura de las carpetas deben crearse abajo del camino informado en el RootPath del archivo server INI.

04. REGISTRO DE BANCO - MATA070

  • Para habilitar la configuración de un layout para el Banco do Brasil debe informarse el código 001 en el campo A6_BCOOFI (Banco oficial).

05. PARÁMETROS DEL BANCO - FINA130

  • Número de convenio debe informarse en el campo Cód. Empresa (EE_CODEMP).
  • ID de la transacción debe informarse el secuencial utilizado para efectuar transacciones de los pagos (EE_IDTRANS).
  • Libera Aut. campo que define si el pago entrará liberado en la institución financiera/Banco" (EE_LIBEAUT).

    ATENCIÓN (campo EE_LIBEAUT)

    Es muy importante la configuración correcta de este campo, porque este define si el pago entrará liberado o no. Y aunque la configuración del cliente, dentro del Banco do Brasil, determine que los pagos necesitan de aprobación, si este campo estuviera configurado con liberación automática, el pago entrará de forma liberada.

  • Agencia oficial debe informarse el número de la agencia oficial (EE_AGEOFI)
  • Cuenta oficial debe informarse el número de la cuenta oficial (EE_CTAOFI)
  • Dígito de la cuenta oficial debe informarse el dígito verificador de la cuenta oficial (EE_DVCTOFI)


Liberación (EE_LIBEAUT)

Si el Protheus est configurado para que la aprobación ocurra por medio del internet banking del Banco, por estándar los títulos se listarán individualmente, aunque pertenezcan al mismo borderó. En este caso, los títulos deben ser aprobados uno por uno. Pero existe la posibilidad de configurar su cuenta corriente para que la aprobación sea en lotes. Para ello, entre en contacto con su gerente de cuentas BB y solicite el ajuste de la configuración de la cuenta que está utilizando.

06. BORDERÓ DE PAGOS

Es posible generar un borderó de pagos con el registro online, para ello basta acceder a la rutina Borderó de pagos (FINA240) o Borderó de pago con impuestos (FINA241), al completar la información del banco y la subcuenta previamente registrados, se habilitará la opción Registro Online, al marcar essa opción el borderó se marcará para el registro online (EA_BORAPI = S).

Modelos de pagos (Tabla genérica 58 del SX5) homologados para transmisión:

    • 30 - Transmisión de pago de las boletas generadas
    • 31 - Transmisión de pago de las boletas generadas
    • 01 - Transmisión de transferencia entre cuentas
    • 03 - Transmisión de transferencia entre cuentas
    • 41 - Transmisión de transferencia entre cuentas
    • 43 - Transmisión de transferencia entre cuentas
    • 13 - Transmissão de pagos de FORMULARIO con código de barras 
    • 16 - Transmisión de pagos de la DARF
    • 18 - Transmisión de pagos de la DARF
    • 17 - Transmisión de pagos de la GPS
    • 45 - Transmissão de transferência PIX 


07. PROBLEMAS COMUNES

  • FALLA EN LA COMUNICACIÓN CON EL BANCO DO BRASIL, VERIFIQUE CON EL BANCO SI EL SERVICIO...
    • Este mensaje podrá aparecer en el monitor de asuntos pendientes después de la transmisión de un pago para el banco, vea a continuación, algunas de las posibilidades que pueden ocasionar este problema:
      • Verifique si los certificados están en la carpeta correcta "cert/ngf/", vea el tópico 3.
      • Verifique si el nombre de los archivos está correcto, vea el tópico 3.
      • Verifique si los certificados se enviaron correctamente al banco.