Atención a las Devoluciones bancarias
- Bajas de títulos (Devolución bancaria) por API vía job FINA715 para el Banco do Brasil se ha puesto a disposición en el paquete de expedición continua con fecha igual o superior al 23/01/2023 para las releases 12.1.33 y posteriores.
- Webhook para el Banco do Brasil disponible a partir de la versión 12.1.2310 del Protheus o Appserver igual o superior a 20.3.1.4.
- Bajas de títulos (Devolución bancaria) por API vía job FINA715 y Webhook para el Itaú están en etapa de piloto, aún no están a disposición.
01. VISIÓN GENERAL
Rutina para visualización de los logs de bajas de títulos por API, generados vía job FINA715 o vía Webhook.
FINA715 vs. Webhook
- Al ejecutar el Job FINA715, el Protheus inicia la comunicación con el banco solicitando informaciones de eventos de baja de boletas.
- Al configurar el Webhook es el banco que inicia la comunicación con el Protheus, enviando informaciones de eventos de baja de boletas.
Para que el Protheus reciba las informaciones enviadas por el banco vía Webhook es necesario un servicio REST habilitado en el Protheus y puesto a disposición para el banco.
→ Banco do Brasil → Webhook - Para más detalles sobre la configuración del Webhook del Banco do Brasil Haga clic aquí.
→ Itaú → Webhook - Para más detalles sobre la configuración del Webhook del Itaú Haga clic aquí.
→ Santander → Webhook - Para más detalles sobre la configuración del Webhook del Santander Haga clic aquí.
Importante
- Las tablas F79 y F7A deben tener el mismo uso compartido, en caso contrario no será posible ejecutar el JOB - FINA715.
- Para que esta nueva opción sea accesible en el nuevo administrador financiero, es necesaria la existencia del campo F79_ESTCOB
02. CONDICIÓN PREVIA
1) Es necesario que se configure el Job FINA715 para alimentar los Logs de bajas de títulos, si no se hubiera configurado se mostrará un mensaje de alerta encaminando al usuario a Configuración de los Jobs de boletas.
2) En Configuraciones de cuentas, editar la cuenta deseada y configurar la Baja de títulos (Devolución):
Configure de acuerdo con su necesidad:
Dirección (URL) de call-back del webhook: Completar para utilización del Webhook.
Grabar Modificaciones:
3) En la rutina Parámetro de Banco (FINA130), completar con la opción 4=Cobranza on-line en el campo Ret. Automát. (EE_RETAUT) para indicar la subcuenta que se utilizará para Baja de títulos (Devolución)::
Importante
- Opción 4=Cobranza on-line para el campo EE_RETAUT disponible a partir de la primera expedición continua de enero de 2023.
03. EJEMPLO DE UTILIZACIÓN
En la ejecución del Job FINA715 se graban las tablas F79 y F7A.
- Para los bancos que tienen API de lista → API donde es posible consultar eventos de liquidación/baja de boletas por período:
Banco do Brasil e Itaú.
El Job solicitará al banco boletas liquidadas(se realizó pago), dados de baja(no se realizó pago y el banco dio de baja automáticamente) y protestados 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 hubiera informado el parámetro.
Para el Banco do Brasil se solicitan los códigos de estado de cobranza definidos por el BB:
06 - LIQUIDADO → Pago realizado → Job realizará la baja en el Protheus vía execauto del FINA070.
07 - DADO DE BAJA → (Anulado), por ejemplo: no se pagó hasta la fecha límite máxima de cobranza y el banco dio de baja la boleta → Job realizará la transferencia de este título en el Protheus a la situación de cobranza 0 -> Cartera retirando del borderó vía execauto del FINA060.
05 y 09 - PROTESTADO ELECTRÓNICO y TÍTULO PROTESTADO MANUAL → el banco colocó en protesto → Job realizará la transferencia de este título en el Protheus a la situación definida en la Configuración de cuentas de este banco, teniendo como estándar transferir a la cartera F → CARTERA PROTESTO vía execauto del FINA060.
Los otros códigos puestos a disposición por el Banco do Brasil actualmente no se consultan, por lo tanto, no se tratan por el Protheus. Son los siguientes:
01 - NORMAL
02 - MOVIMIENTO NOTARÍA
03 - EN NOTARÍA
04 - TÍTULO CON OCURRENCIA DE NOTARÍA
08 - TÍTULO CON ASUNTO PENDIENTE DE NOTARÍA
10 - TÍTULO DADO DE BAJA/PAGADO EN NOTARÍA
11 - TÍTULO LIQUIDADO/PROTESTADO
12 - TÍTULO LIQUID/PAGADO EN NOTARÍA
13 - TÍTULO PROTESTADO ESPERANDO BAJA
14 - TÍTULO EN LIQUIDACIÓN
15 - TÍTULO PROGRAMADO EN AGENDA
16 - TÍTULO ACREDITADO
17 - PAGO EN CHEQUE - ESPERANDO LIQUIDACIÓN
18 - PAGO PARCIALMENTE ACREDITADO
80 - EN PROCESAMIENTO (ESTADO TRANSITORIO)
Otros valores cobrados
Si la API devuelve valores en la tag "valorOutroRecebido" este se sumará a los intereses del título en el movimiento de baja.
Flujo en proceso de pilotos
- El flujo de devolución para el procesamiento de bajas con el banco Itaú está en proceso de piloto, siendo así, ¡aún NO esta liberado para su uso!
Para el Itaú se solicitan por API las situaciones:
LIQUIDADO → Pago realizado → Job realizará la baja en el Protheus vía execauto del FINA070.
DADO DE BAJA → (Anulado), se realizará la transferencia de este título en el Protheus para la situación de cobranza 0 -> Cartera retirando del borderó vía execauto del FINA060.
PROTESTADO → banco colocó en protesto → Job realizará la transferencia de este título en el Protheus para la situación definida en la Configuración de cuentas de este banco, teniendo como estándar transferir a la cartera F → CARTERA PROTESTO vía execauto del FINA060.
Atención→ La API del Banco Itaú no tiene información de fecha de crédito. Como fecha de crédito para devolución se considerará la fecha del pago + A6_RETENCA, siempre tomando en cuenta fechas válidas. Es posible manejar la fecha de crédito por el Punto de entrada NGFDTDIS.
- Para bancos que no tienen API de lista:
Banco Santander
Si el banco no tiene API de lista para consultar bajas de boletas de un período determinado, el job FINA715 realizará la consulta de todas las boletas pendientes en la base de datos.
Se realiza una query en la base de datos para seleccionar todas las boletas pendientes basadas en las tablas SEA y SE1 y registro a registro se consulta la API de consulta de boletas en el referido banco para saber si la boleta fue liquidada. Si se hubiera liquidado, el Protheus efectúa la baja del título.
Al utilizar el Punto de entrada NGFQRRET es posible restringir la query de consulta para determinar los registros que se procesarán y consultarán vía API, optimizando la cantidad de registros que se procesarán.
Si el banco tuviera Webhook, como el banco Santander:
- Si el referido banco tuviera webhook y el pago se realizara con código de barras, la boleta aún no puede considerarse liquidada, se considera como Baja operativa. (En algunos casos pude anularse o revertirse a lo largo del día por el banco).
- En este caso se graba la tabla F79 en el Protheus con los datos que el banco envía y devuelve el estatus ok al banco.
- Este registro de la tabla F79 que se grabó por el Webhook será procesado por el Job FINA715, que realizará la consulta de esta boleta en el banco para verificar si la boleta se liquidó.
- Si la boleta aún no se hubiera liquidado, el registro de la F79 continua activo para una próxima ejecución del Job FINA715.
- Si la boleta se hubiera liquidado, el Protheus efectúa la baja del título.
Obs: Si no existiera ninguna ocurrencia de bajas/transferencia/protesto en el período solicitado al banco, no se grabará F79 ni F7A, solamente se actualizará el parámetro MV_FNGDTBX con la última ejecución del job que se muestra en la pantalla al lado del título de la rutina.
En la siguiente pantalla podemos acompañar los procesamientos de devolución bancaria realizados por API, donde es posible visualizar la cantidad de títulos dados de baja y no dados de baja, así como también, por qué motivo no ocurrió la baja.
En la pantalla solamente se muestran los procesamientos con algún error en la requisición al banco o error en el procesamiento de baja/transferencia del título.
El encabezado del log (F79) se mostrará independientemente de la sucursal en la que se generó. Habrá filtro de sucursal solamente en los títulos mostrados en detalle, respetando las sucursales a las que el usuario tiene acceso y la selección de sucursales de la rutina NGF. En este caso, el sistema considera el campo F7A_FILTIT para realizar la verificación del acceso para exhibición o no del registro en el monitor, es decir, el campo F7A_FILIAL no se considerará en este escenario. Por lo tanto, en un caso donde el título no se encuentra (ejemplo de un título ya borrado en el Protheus), el sistema mostrará este registro para todos los usuarios que tengan acceso a la rutina, ya que no fue posible identificar la sucursal de origen del título.
JOB FINA715
Para cada ejecución con éxito del Job FINA715 se actualizará el título de la pantalla con fecha y hora de la ejecución.
04. BUSCAR
Encuentre cualquier registro de logs utilizando el campo Buscar.
05. BÚSQUEDA AVANZADA
Para encontrar datos más específicos, utilice la opción de búsqueda avanzada.
06. DETALLES
Para cada log en la grilla es posible expandir los detalles (Títulos) que lo compone. Haga clic en la flecha ubicada al inicio de la línea del log que desea expandir y se mostrarán los datos referentes a este log.
ESTATUS
El Estatus determina la situación del detalle del Log (Título), donde podemos tener dos valores:
RESUELTO
Este estatus determina que el detalle del log (Título) fue corregido. Para este estatus las acciones quedan deshabilitadas.
PENDIENTE
Este estatus determina que el detalle del log (Título) aún tiene errores. Para este estatus las acciones quedan habilitadas.
07. ACCIONES DE LOS DETALLES
Para cada detalle en la grilla, es posible saber más información sobre Detalles del error o también Marcar como resuelto.
Muestra los detalles de error de un detalle de Log (Título) que no fue dado de baja por algún motivo.
Marca el registro como resuelto y modifica el estatus.
08. PROCESAR BAJAS
Esta funcionalidad está disponible en paquetes de expedición continua con fecha igual o superior al 14/04/2023.
Por medio de esta funcionalidad es posible realizar la comunicación online con el banco, y bajar los títulos por cobrar en el ERP sin necesidad del job (FINA715).
Todo el procesamiento ocurrirá de forma asincrónica, es decir, el ERP no esperará la finalización, permitiendo la navegación libre del usuario.
09. LISTA DE BAJAS
Por medio del informe de Lista de bajas (FINR190) es posible listar todas las bajas realizadas por el job (FINA715).
El historial estándar grabado en los movimientos de baja es "Baja por proceso automático (API)" y el origen del movimiento FINA715 (E5_ORIGEM), siendo posible crear layout personalizado con el filtro de origen para exhibición de las bajas vía API.
Por medio de los recursos disponibles en el smart view Lista de bajas (FINSV010) es posible listar todas las bajas realizadas por el job (FINA715).
El historial estándar grabado en los movimientos de baja es "Baja por proceso automático (API)" y el origen del movimiento FINA715 (E5_ORIGEM).
Más información: Smart View - Lista de bajas
10. TABLAS UTILIZADAS
- F79 - Log devolución boleta API Encabez.
- F7A - Log devolución boleta API Ítems
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas