Histórico da Página

01. 

...

VISIÓN GENERAL

Configuraciones necesarias para el registro de boletas por el API del

...

Configurações necessárias para o registro de boletos por API do Banco do Brasil.

Para testes em ambiente de homologação deve ser utilizados os dados fictícios para testes conforme documentação no 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

Para la configuración del layout es necesario obtener ante el Banco do Brasil la siguiente información

...

Para a configuração do layout será necessário obter junto ao Banco do Brasil as informações abaixo:

Application Key - Chave da aplicação: Chave de acesso do aplicativoClave de la aplicación: Clave de acceso de la aplicación

Client ID - ID do Clientedel cliente: Código de identificação do identificación del cliente

Client Secret - Chave Secreta do Cliente: Chave secreta de validação do cliente.Clave secreta del cliente: Clave secreta de validación del cliente.

No considere la clave BASIC si la hubiera recibidoDesconsidere a chave BASIC caso seja recebida.

03.

...

REGISTRO DEL BANCO - MATA070

• Para habilitar a configuração la configuración de um un layout para o el Banco do Brasil deve ser informado no debe informarse en el campo A6_BCOOFI  (Banco oficial)  o  el código 001.

04.

...

PARÁMETROS DEL BANCO - FINA130

• Número de convênio deve ser informado no campo Codconvenio debe informarse en el campo Cód. Empresa(EE_CODEMP).
  • Campo será validado na inclusão do Borderô.
  • El campo se validará en la inclusión del Borderó.
• Código de la cartera debe informarse en el campo Cód. Cartera Código da carteira deve ser informado no campo Cód. Carteira (EE_CODCART).
• Número da variação da carteira deve ser informado no de la variación de la cartera debe informarse en el campo Var. Carteira Cartera (EE_VARCART).
  • Campo será validado na inclusão do Borderô.
  • El campo se validará en la inclusión del Borderó.
• Nuestro número debe parametrizarse en los campos Rango inicial Nosso número deve ser parametrizadonos campos Faixa Inicio (EE_FAXINI),  Faixa Fim Rango final (EE_FAXFIM) e Faixa atual y Rango actual (EE_FAXATU).
  
  • O campo El campo (EE_FAXATU) será validado quanto ao seu tamanho, onde deverá conter no máximo 10 caracteres na inclusão do Borderô e também na transmissão do boleto. Havendo divergência será logado no NGF o motivo do erro.

05. CONFIGURAÇÃO DE LAYOUT

Para utilizar o registro online de boletos para o Banco do Brasil, deve-se observar a seguinte regra:

• Número do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

      Onde poderá ser:

• •  se validará con respecto a su tamaño, donde debe tener como máximo 10 caracteres en la inclusión del Borderó y también en la transmisión de la boleta. Si hubiera divergencia, se comunicará en el NGF el motivo del error.
• Número días límite cobranza debe informarse en el campo Días Cobranz (EE_DIASREC)
  • Si este campo tiene un valor > 0, internamente el Indicador aceptación título vencido se envía con 'S' 
• Cantidad días protesto debe informarse en el campo Días Prot (EE_DIASPRT)
• Mensaje para instrucción de cobranza debe informarse en el campo Mensaje 1 (EE_FORMEN1), cabe resaltar que el banco acepta como máximo 165 caracteres. Se recomienda el uso de letras minúsculas, pues en la impresión de la boleta existe un espacio definido previamente para exhibición del mensaje
• Cobranza on-line debe informarse por lo menos a un convenio cuando la devolución(FINA715 o Webhook) estuviera configurada (EE_RETAUT). Si no esteviera habilitado, la devolución no se procesará para este convenio. 

05. CONFIGURACIÓN DEL LAYOUT

Para utilizar el registro online de boletas para el Banco do Brasil, debe observarse la siguiente regla:

• Número del documento: En este campo debe informarse cuál será el número del documento que se transmitirá al banco y posteriormente se imprimirá en la boleta.

      Donde puede ser:

1. 1. Número del título Número do Título (E1_NUM)
   2. ID CNAB (E1_IDCNAB)
   3. Expressão definida pelo usuárioExpresión definida por el usuario.
      • O resultado da expressão será atribuído ao El resultado de la expresión se atribuirá al campo “Número do del documento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

Image Removed

1. 1. • las macroejecuciones la expresión que se ejecutará debe ser válida. Para informar una expresión, haga clic en el “Engranaje” que está al lado del campo.

Image Added

Image Added

• Aceptación: Este campo indica el reconocimiento formal de la deuda (firma en el documento) por el pagador y deben informarse los valores:
  • Sí - Cuando existe la necesidad de que el pagador reconozca/acepte la cobranza.
  • No - Cuando no existe la necesidad de reconocimiento de la cobranza.

Image Added

• Beneficiario sucursal: En este campo debe informarse la sucursal que se utilizará para la transmisión e impresión de la boleta. 

Image Added

Los datos registrados en esta sucursal se utilizarán en la transmisión y en la impresión:

Image Added

• Descuento: En este campo se podrá informar o no un valor de descuento para la boleta.  

       Donde:

1. 1. Vacío - Si el valor original ya está calculado con la deducción de los valores de descuento o no exista descuento para la boleta.
   2. Valor Descuento (SomaAbat()) - Calculo estándar del sistema según la expresión: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
   3. Expresión definida por el usuario.
      • El resultado de la expresión se atribuirá al campo “Descuento”. Para las macros ejecuciones la expresión que se ejecutará debe ser válida. Para informar una expresión, haga clic en el “Engranaje” que está al lado del campo.

Image Added

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:

• • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Image Added

• Boleta híbrida (Boleta + PIX)
  • Sí - La boleta se registrará con el PIX, en la impresión aparecerá el QR Code PIX para cobrar el valor.
  • No - La boleta se registrará sin el PIX, en la impresión no aparecerá el QR Code PIX.

06. WEBHOOK - BAJA TÍTULOS (DEVOLUCIÓ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:

Image Added

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.

07. CONFIGURACIÓN DE BOLETA

Permite que el usuario configure cómo se imprimirán los valores en la boleta.

• Imprime rebaja
  • Como mensaje - El valor de la rebaja se imprimirá en los mensajes de la boleta
  • Campo descuento/rebaja - El valor de la rebaja en el título se imprimirá en el (-) Descuento/Rebaja de la boleta

Image Added

...