...
Para pruebas en entorno de homologación deben utilizarse los datos ficticios para pruebas de acuerdo con la documentación del Portal Developers BB.
Informações |
---|
|
Para la comunicación del Protheuscon el banco, si fuera necesario, debe configurarse la seguridad de red 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 https://api.hm.bb.com.br |
02.
...
CREDENCIALES
Para la configuración del layout es necesario obtener ante el Banco do Brasil la siguiente información:
...
- Número de convenio debe informarse en el campo Cód. Empresa(EE_CODEMP).
- El campo se validará en la inclusión del Borderó.
- Código de la cartera debe informarse en el campo Cód. Cartera (EE_CODCART).
- Número de la variación de la cartera debe informarse en el campo Var. Cartera (EE_VARCART).
- El campo se validará en la inclusión del Borderó.
- Nuestro número debe parametrizarse en los campos Rango campos Rango inicial (EE_FAXINI), Rango Rango final (EE_FAXFIM) y Rango actual (EE_FAXATU).
- El campo (EE_FAXATU) se se validará con respecto a su tamaño, donde debe contener tener como máximo 10 caracteres en la inclusión del Borderó , así como y también en la transmisión de la boleta. Habiendo Si hubiera divergencia, se consignará 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
...
- Número del título (E1_NUM)
- ID CNAB (E1_IDCNAB)
- Expresión definida por el usuario.
- El resultado de la expresión se atribuirá al campo “Número del documento”. Para 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 Modified
Image Modified
- 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
Aviso |
---|
|
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. |
- Descuento: En este campo se podrá informar o no un valor de descuento para la boleta.
Donde:
- 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.
- 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)" .
- 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
Aviso |
---|
|
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ónen 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. |
- 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
Aviso |
---|
|
- No se pueden utilizar las opciones "Como mensaje" y "Campo descuento/rebaja" en conjunto.
- Después de transmitir en la boleta los cambios realizados en el campo Imprime rebaja, no se aplicarán a las boletas transmitidas. Los cambios se aplicarán solamente a las boletas transmitidas después de la modificación.
|