Integración contable con Finvora ERP

La integración contable con Finvora ERP conecta Bizaldo POS directamente con Finvora ERP. Diseñada para operaciones modernas de hostelería y comercio minorista multisucursal, sincroniza automáticamente los informes Z de cierre diario y las liquidaciones de crédito de clientes (Compre ahora, pague después / BNPL) como asientos de libro mayor equilibrados por partida doble, sin requerir una compleja sincronización de catálogos o menús.
Disponibilidad: La integración contable con Finvora se configura por empresa en el Portal de administración en Empresas → Integraciones y se ejecuta automáticamente en segundo plano durante las sesiones de cierre de día del POS y los registros de pago de crédito de clientes.

Cómo funciona

Aprovisionamiento de clave API en Finvora ERP

El administrador crea una clave API de integración en Finvora ERP en Configuración → Claves API con identificación de auditoría.

Configuración de credenciales en Bizaldo Admin

Las credenciales de la empresa (URL base y clave API) se registran y validan mediante comprobación en tiempo real en Bizaldo Admin en Empresas → Integraciones.

Inicio de turno y fondo de caja en POS

El cajero abre la caja en la tablet POS, verificando el ID del terminal y registrando el fondo de caja inicial en SAR.

Ventas continuas y cobros múltiples

Los pedidos se procesan de forma fluida con efectivo, tarjeta o crédito de cliente (BNPL). Los ingresos, el IVA (15%) y las cuentas por cobrar se acumulan con precisión.

Cierre de turno y revisión provisional

Al finalizar las ventas, el cajero inicia el Cierre de día, bloqueando nuevos pedidos, generando informes provisionales y finalizando el recuento físico.

Informe Z automático y sincronización con el libro mayor

Bizaldo sella la sesión (p. ej., ZR-000044) y contabiliza de forma sincronizada 4 comprobantes de diario equilibrados por partida doble (Salida de caja, Ventas, Reembolso, Liquidación) en Finvora ERP.

Liquidación de cuotas BNPL y conciliación

Cuando los clientes amortizan saldos de crédito en Bizaldo Admin, cada pago genera automáticamente un comprobante de diario de liquidación (p. ej., JE-2026-000005) en Finvora, saldando las cuentas por cobrar.

1. Generación de clave API en Finvora ERP

Antes de configurar Bizaldo Admin, genere una clave API de integración segura dentro de la configuración de su organización en Finvora ERP.

Paso 1.1: Navegar a Claves API en Finvora ERP

Inicie sesión en Finvora ERP, seleccione su empresa en el selector superior, abra Configuración en el panel de navegación izquierdo, cambie a la pestaña Claves API y haga clic en + Generar nueva clave.
Pestaña de configuración y claves API de Finvora ERP1234

Figura 1 — Finvora ERP: Navegue a Configuración y a la pestaña de gestión de claves API

Elementos de la pantalla

1
Navegación a Configuración

Abra Configuración desde el panel de navegación izquierdo para acceder a las preferencias de la organización.

2
Pestaña Claves API

Seleccione la pestaña Claves API en la barra superior para gestionar integraciones externas.

3
Generar nueva clave

Haga clic en '+ Generar nueva clave' para abrir el diálogo de creación de credenciales.

4
URL base de API pública

Revise la URL del endpoint público de su instancia de Finvora en la parte inferior.

Paso 1.2: Asignar nombre a la clave API

En el cuadro modal, ingrese un nombre descriptivo (como Bizaldo) para que las transacciones creadas con esta clave sean fácilmente identificables en las pistas de auditoría del libro mayor, luego haga clic en Generar clave.
Diálogo de generación de clave API en Finvora ERP12

Figura 2 — Finvora ERP: Ingrese un nombre descriptivo para la integración con Bizaldo

Elementos de la pantalla

1
Nombre de la clave

Introduzca un identificador descriptivo (p. ej., 'Bizaldo') que aparecerá en los registros de auditoría y asientos.

2
Botón Generar clave

Haga clic en 'Generar clave' para crear el secreto criptográfico de la API.

Paso 1.3: Copiar la clave secreta y el endpoint

Copie inmediatamente la clave API mostrada (`ak_...`). Por seguridad, Finvora nunca volverá a mostrar este token secreto. Anote también la URL base de la API pública de su organización (p. ej., `https://.../api/public/v1`).
Cuadro modal de clave API generada en Finvora ERP123

Figura 3 — Finvora ERP: Copie la clave API generada antes de cerrar la ventana

Elementos de la pantalla

1
Token de clave secreta

Haga clic en el icono de copiar junto al token secreto de la clave API (prefijo 'ak_').

2
URL base pública

Copie la URL base de la API pública mostrada en la barra de endpoint para la configuración de Bizaldo.

3
Botón Hecho

Haga clic en 'Hecho' tras guardar el token de forma segura en su gestor de credenciales.

[!IMPORTANT]

Guarde su clave API de Finvora de forma segura. En Bizaldo, las credenciales se almacenan cifradas en reposo mediante AES-256.

2. Configuración en Bizaldo Admin

Una vez aprovisionada la clave API de Finvora, conéctela a su empresa en Bizaldo Admin.

Paso 2.1: Abrir la pestaña de Integraciones

En Bizaldo Admin, navegue a Empresas, seleccione su empresa, abra la pestaña Integraciones y localice la tarjeta Finvora.
Pestaña de integraciones de empresa en Bizaldo Admin12

Figura 4 — Bizaldo Admin: Tarjeta de integración con Finvora en Empresas → Integraciones

Elementos de la pantalla

1
Menú Empresas

Navegue a Empresas en el menú lateral de Bizaldo Admin.

2
Tarjeta de Finvora

Tarjeta de integración que muestra el estado de conexión con Finvora ERP.

Paso 2.2: Introducir credenciales y mapear sucursales

Introduzca la URL base de la API pública, pegue la clave API de Finvora (`ak_...`), configure el mapeo de sucursales si corresponde y haga clic en Guardar cambios para validar la conexión.
Diálogo de configuración de Finvora en Bizaldo Admin123456

Figura 5 — Bizaldo Admin: Diálogo de credenciales de API de Finvora y mapeo de sucursales

Elementos de la pantalla

1
Campo URL de la API

Pegue la URL base de la API pública de Finvora (p. ej., https://api.finvora.com/api/public/v1).

2
Campo Clave API

Pegue la clave secreta de API ('ak_...') generada en Finvora ERP.

3
Mapeo de sucursales

Asigne cada sucursal de Bizaldo a su centro de coste o división correspondiente en Finvora.

4
Mapeo de cuentas

Verifique los códigos de cuenta del libro mayor para caja, bancos, clientes e IVA.

5
Interruptor Activar integración

Active el conector para habilitar la sincronización en segundo plano de cierres de caja.

6
Botón Guardar cambios

Haga clic para validar las credenciales contra la API de Finvora y guardar la configuración.

[!NOTE]

Bizaldo valida las credenciales realizando una llamada de comprobación inmediata contra Finvora. Una vez validada, la tarjeta muestra el estado 'Conectado'.

3. Flujo de trabajo en la tablet POS

Los cajeros operan en la tablet POS con normalidad. La integración captura los movimientos financieros de forma transparente.

Paso 3.1: Inicio de jornada y fondo de caja

Al abrir el terminal POS, el cajero debe iniciar la jornada e introducir el fondo de caja físico.
Pantalla de inicio de jornada en tablet POS1

Figura 6 — Tablet POS: Pantalla de inicio de jornada con ID de terminal y selección de moneda

Elementos de la pantalla

1
Botón Iniciar jornada

Haga clic en 'Iniciar jornada' para abrir el diálogo de recuento de fondo de caja.

Diálogo de fondo de caja en tablet POS12

Figura 7 — Tablet POS: Entrada del fondo de caja inicial de apertura en SAR

Elementos de la pantalla

1
Moneda

Confirma la moneda operativa (SAR) para la sesión de caja.

2
Confirmar fondo

Haga clic en Confirmar para abrir el registro y habilitar la toma de pedidos.

Una vez confirmado el fondo, la caja queda abierta y lista para registrar ventas durante todo el turno.

Paso 3.2: Registro de ventas continuas

A lo largo de la jornada, los cajeros cobran pedidos utilizando diferentes medios de pago: tarjeta, efectivo o crédito de cliente (BNPL).
Pantalla de catálogo y carrito en tablet POS1

Figura 8 — Tablet POS: Catálogo de productos y botones de cobro con tarjeta, efectivo y BNPL

Elementos de la pantalla

1
Artículos del carrito e importe total

Carrito activo (Gourmet Burger, 45.50 SAR total con IVA) listo para el cobro.

Procesamiento de pedido con tarjeta

Al pagar con tarjeta (como en el Pedido 2, Sprite por 101.50 SAR), pulsar Tarjeta abre el diálogo de confirmación de pago electrónico.
Diálogo de confirmación de pago con tarjeta en tablet POS123

Figura 10 — Tablet POS: Diálogo de confirmación de cobro con tarjeta electrónica

Elementos de la pantalla

1
Detalles del pedido

Resumen detallado del pedido (p. ej., Sprite 101.50 SAR) cobrado electrónicamente.

2
Mensaje de cobro con tarjeta

Diálogo de confirmación: '¿Desea completar este pedido con tarjeta?'.

3
Confirmar

Confirma la transacción.

Procesamiento de pedido en efectivo

Al seleccionar Efectivo, se abre el diálogo de confirmación con opciones para completar al instante o confirmar e imprimir recibo.
Diálogo de confirmación de pago en efectivo en tablet POS123

Figura 9 — Tablet POS: Diálogo de cobro en efectivo con opciones de recibo

Elementos de la pantalla

1
Mensaje de pago en efectivo

Pregunta al cajero: '¿Desea completar este pedido con efectivo?'.

2
Completar al instante

Finaliza el pedido en efectivo inmediatamente sin imprimir recibo.

3
Confirmar e imprimir recibo

Finaliza el cobro, registra el ingreso en efectivo e imprime el ticket de caja.

Procesamiento de pedido a crédito (BNPL)

Para ventas a crédito (Pedido 3), pulsar BNPL solicita vincular la cuenta del cliente (p. ej., `customer-test`), registrar cualquier entrada inicial (p. ej., `10.00 SAR` con tarjeta) y llevar el resto (`35.50 SAR`) a cuentas por cobrar.
Diálogo de pedido a crédito BNPL en tablet POS1234

Figura 11 — Tablet POS: Completar pedido con crédito de cliente (BNPL) y entrada inicial

Elementos de la pantalla

1
Introducir datos del cliente

Introduzca o seleccione la cuenta de cliente registrada (p. ej., customer-test, 091381093132) para vincular el pedido.

2
Pulsar Completar al instante

Pulse Completar al instante para finalizar el cobro sin imprimir recibo.

3
Seleccionar método de pago

Seleccione el método de pago (tarjeta o efectivo) para la entrada inicial.

4
Pulsar Confirmar

Pulse Confirmar para finalizar el pedido y registrar el saldo pendiente en cuentas por cobrar de clientes.

Paso 3.3: Historial de pedidos y auditoría de turno

La pantalla de Pedidos en el POS muestra todas las transacciones completadas durante el turno con distintivos: `[Synced] [Completed]` para efectivo y tarjeta, y `[Synced] [BNPL] [Completed]` para pedidos a crédito. Pulse cualquier pedido para navegar a su pantalla de detalles.
Historial de pedidos en tablet POS con distintivos de pago1

Figura 12 — Tablet POS: Historial de pedidos mostrando cobros completados en efectivo, tarjeta y BNPL

Elementos de la pantalla

1
Seleccionar pedido para ver detalles

Seleccione un pedido (como el pedido con tarjeta #...5453583 con distintivo [Synced] [Completed]) para abrir su detalle y auditar o gestionar la transacción.

Paso 3.4: Vista detallada de pedido individual

Al pulsar un pedido se abre el desglose completo de artículos, la auditoría de impuestos y los detalles del pago, con la opción de cancelar el pedido desde esta misma pantalla.
Detalle de pedido individual en tablet POS1

Figura 13 — Tablet POS: Desglose de pedido individual con método de pago y resumen de IVA

Elementos de la pantalla

1
Cancelar pedido y desglose financiero

Revise el desglose financiero (Subtotal 95.75 SAR, IVA 5.75 SAR, Total 101.50 SAR) y pulse Cancelar pedido para anular esta venta directamente desde el detalle.


4. Cierre de turno y generación automática de informe Z

Al finalizar el servicio, los cajeros realizan el procedimiento de Cierre de día para sellar contablemente el turno.

Paso 4.1: Preparar cierre e informe provisional

En Configuración → Cierre de día, pulsar Generar informe provisional bloquea inmediatamente la entrada de nuevos pedidos y calcula los totales provisionales de ingresos, impuestos y efectivo.
Paso 2 de cierre de día en tablet POS1

Figura 14 — Tablet POS: Preparar cierre de turno y generar informe de conciliación provisional

Elementos de la pantalla

1
Generar informe provisional

Pulse para bloquear nuevos pedidos y generar los totales de auditoría preliminares.

Paso 4.2: Finalizar cierre de turno

Los cajeros revisan los totales provisionales, comprueban el cajón portamonedas y pulsan Cerrar día. Esto sella la sesión, genera el informe Z inmutable `ZR-000044` y activa la contabilización en Finvora ERP.
Confirmación de cierre de día en tablet POS1

Figura 15 — Tablet POS: Revisión del informe provisional y sellado del turno con Cerrar día

Elementos de la pantalla

1
Botón Cerrar día

Haga clic en el botón Cerrar día para cerrar la jornada y generar los asientos contables asociados a los pedidos realizados a lo largo del día.


5. Informes POS y auditoría de informes Z en Bizaldo Admin

Auditores y directores financieros pueden consultar las conciliaciones de turno en Bizaldo Admin en Informes POS → Informes Z (Sesiones).

Paso 5.1: Tabla de sesiones de informes Z

La tabla de informes Z proporciona verificación visual inmediata de la sincronización con el ERP para cada turno de caja.
Tabla de informes Z en Bizaldo Admin1

Figura 16 — Bizaldo Admin: Tabla de informes Z mostrando el distintivo Sincronizado con Finvora (4)

Elementos de la pantalla

1
Distintivo Sincronizado con Finvora (4)

Insignia verde que confirma que los 4 asientos contables se publicaron con éxito.

Paso 5.2: Panel lateral de auditoría del informe Z

Al abrir el informe `ZR-000044` se despliegan los 4 comprobantes de diario vinculados y registrados en Finvora ERP.
Panel lateral de informe Z en Bizaldo Admin12

Figura 17 — Bizaldo Admin: Desglose del informe Z mostrando los 4 comprobantes vinculados

Elementos de la pantalla

1
Encabezado del informe Z

Código de identificación inmutable del turno (#ZR-000044).

2
Comprobantes de diario vinculados

Cuatro comprobantes directos: Salida de caja (JE-...01), Ventas (JE-...02), Reembolso (JE-...03), Liquidación (JE-...04).

Comprobantes de diario creados para el informe Z:

  • Reducción de caja de registro (Salida de caja: JE-2026-000001): Registra transferencias de efectivo a caja fuerte.
  • Ventas e ingresos diarios (Ventas: JE-2026-000002): Debita Caja y Bancos; acredita Ingresos por ventas e IVA repercutido.
  • Devoluciones y reembolsos de clientes (Reembolso: JE-2026-000003): Contabiliza devoluciones de artículos e inversión de impuestos.
  • Liquidación de lote de tarjetas (Liquidación: JE-2026-000004): Concilia la compensación del terminal con la cuenta bancaria comercial.

6. Verificación en el libro mayor de Finvora ERP (Informes Z)

En Finvora ERP en Contabilidad → Asientos de diario, los cuatro comprobantes de la sesión `ZR-000044` son visibles de inmediato en estado Publicado con perfecto equilibrio contable.
Panel de asientos de diario en Finvora ERP1234

Figura 18 — Finvora ERP: Los cuatro comprobantes publicados del informe Z de Bizaldo ZR-000044

Elementos de la pantalla

1
Asientos sincronizados del informe Z

Cuatro comprobantes con referencias externas BIZ para liquidación, reembolsos, ventas y salida de caja.

2
Resumen de asientos publicados

Contadores que muestran 10 comprobantes de diario publicados en total en el libro mayor.

3
Débito y crédito equilibrados

Comprobación de balance estricta: Total débito igual a total crédito en cada comprobante.

4
Estado Publicado

Estado finalizado que confirma que los asientos están registrados de forma permanente en el libro mayor.


7. Sincronización de liquidación de crédito de cliente (BNPL)

Cuando los clientes saldan sus compras a plazos en Bizaldo Admin, cada abono se contabiliza automáticamente como asiento de liquidación equilibrado en Finvora ERP.

Paso 7.1: Directorio de clientes

En Bizaldo Admin, vaya a Clientes y localice la ficha del cliente (p. ej., `customer-test`). Haga clic en Ver para abrir su perfil.
Directorio de clientes en Bizaldo Admin12

Figura 19 — Bizaldo Admin: Directorio de clientes con la ficha de perfil de customer-test

Elementos de la pantalla

1
Ficha de perfil de cliente

Ficha de cliente customer-test (Teléfono: 091381093132, Gasto total: 45.50 SAR).

2
Botón Ver perfil

Haga clic en 'Ver' para abrir el perfil del cliente y acceder a su historial de crédito.

Paso 7.2: Historial de saldo pendiente

Cambie a la pestaña Saldo pendiente para consultar los pedidos BNPL sin saldar, la deuda total (`35.50 SAR`) y los botones de cobro.
Pestaña de saldo pendiente de cliente en Bizaldo Admin1234

Figura 20 — Bizaldo Admin: Historial de saldo pendiente del cliente con pedido BNPL sin pagar

Elementos de la pantalla

1
Pestaña Saldo pendiente

Pestaña de historial de crédito dedicada a compras 'Compre ahora, pague después'.

2
Métricas de saldo

Total pendiente 35.50 SAR, Total pagado 0.00 SAR, Pedidos pendientes 1.

3
Fila de pedido pendiente

Pedido #...5497588 con Original 35.50 SAR, Pagado 0.00 SAR, Restante 35.50 SAR.

4
Botón Registrar pago

Haga clic en 'Registrar pago' para asentar un cobro a cuenta o liquidación.

Paso 7.3: Registrar pago de cuota

Haga clic en Registrar pago, introduzca el importe amortizado (p. ej., `20.00 SAR`), seleccione el método de pago (Transferencia bancaria) y haga clic en Registrar pago.
Diálogo Registrar pago en Bizaldo Admin1234

Figura 21 — Bizaldo Admin: Registro de amortización de 20.00 SAR por transferencia bancaria

Elementos de la pantalla

1
Importe de la cuota

Introduzca el importe de pago amortizado (p. ej., 20.00 SAR).

2
Desplegable Método de pago

Seleccione Transferencia bancaria (o Efectivo) para determinar el destino contable en el débito.

3
Referencia y notas

Referencia bancaria externa opcional y anotaciones de la liquidación.

4
Acción Registrar pago

Haga clic en 'Registrar pago' para asentar el cobro y disparar el asiento en Finvora.

Paso 7.4: Historial de saldo actualizado y comprobante vinculado

El saldo pendiente del cliente se reduce inmediatamente a `15.50 SAR`. En el Historial de pagos, el registro muestra la etiqueta del comprobante de Finvora vinculado: JE-2026-000005.
Historial de cliente con comprobante de liquidación vinculado123

Figura 22 — Bizaldo Admin: Saldo pendiente reducido con comprobante de Finvora vinculado JE-2026-000005

Elementos de la pantalla

1
Métricas de saldo actualizadas

El Total pendiente baja a 15.50 SAR; el Total pagado sube a 20.00 SAR.

2
Estado de pedido parcial

El distintivo del pedido cambia a Parcial con Importe restante de 15.50 SAR.

3
Etiqueta de comprobante vinculado

El historial de pagos registra la Transferencia bancaria con etiqueta verde de Finvora: JE-2026-000005.


8. Comprobante de diario de liquidación BNPL en Finvora ERP

Consulte el asiento de liquidación en Finvora ERP en Contabilidad → Asientos de diario → JE-2026-000005.
Detalle del asiento de diario de liquidación BNPL en Finvora ERP1234

Figura 23 — Finvora ERP: Comprobante de diario de liquidación JE-2026-000005 con partidas dobles

Elementos de la pantalla

1
Encabezado del asiento de diario

Comprobante JE-2026-000005 en estado Publicado con fecha 04/11/2026.

2
Descripción y referencia

Descripción: Bizaldo POS (Main) — BNPL Credit Payment, Ref: CR-PMT-644CE5FD-050C-44.

3
Partidas dobles de contabilidad

Débito: Cuenta 1020 (Cuenta bancaria, 19.59 AED) | Crédito: Cuenta 1050 (Clientes a cobrar, 19.59 AED).

4
Equilibrio contable exacto

Comprobación estricta: Total débitos (19.59 AED) = Total créditos (19.59 AED).

Fórmula contable de la liquidación:

  • Débito: Cuenta 1020 (Cuenta bancaria) — 19.59 AED (20.00 SAR convertidos según tipo de cambio diario)
  • Crédito: Cuenta 1050 (Clientes por cobrar) — 19.59 AED (compensación del activo a crédito del cliente)

9. Mapeo estándar del plan contable

Bizaldo POS asigna los totales de las transacciones a cuentas estándar del plan contable de Finvora:
Código de cuentaNombre de la cuentaTipoSentido de registroDescripción
1010Caja y efectivoActivoDébito (+)Total del dinero en efectivo físico recaudado durante el turno de caja.
1020Compensación de tarjetas bancariasActivoDébito (+)Recibos y justificantes de cobro con tarjeta de crédito/débito.
1050Clientes por cobrar (BNPL)ActivoDébito al vender / Crédito al cobrarVentas a crédito BNPL pendientes; se saldan al cobrar las cuotas.
2100IVA a pagar (IVA repercutido)PasivoCrédito (+)IVA repercutido recaudado en las ventas sujetas a impuesto.
4000Ingresos por ventasIngresoCrédito (+)Ingresos netos por ventas sin impuestos ni descuentos promocionales.

10. Tolerancia a fallos y seguridad contable

La integración se ha diseñado con resiliencia empresarial para garantizar la continuidad del negocio:
  • Garantías estrictas de idempotencia: Cada solicitud de sincronización del informe Z incluye una referencia externa inmutable (p. ej., EXT-Z-{zReportId} o BIZ-Z-{zReportId}). Si se repite la llamada por fallos de red, Finvora detecta el registro existente y devuelve el asiento sin duplicar datos.
  • Validación estricta de partida doble: Antes de asentar cualquier comprobante, Finvora exige igualdad matemática: Total débitos == Total créditos con tolerancia de 0.01. Cualquier apunte no equilibrado se rechaza de forma segura.
  • Operaciones POS con prioridad sin conexión: Las operaciones en el terminal de caja no dependen de forma síncrona de Finvora. Si se pierde la conexión a Internet o Finvora está en mantenimiento, los cajeros siguen cobrando y cerrando turnos con normalidad; los informes pendientes quedan en cola para sincronizarse al restablecerse el servicio.
  • Aislamiento multiempresa y claves cifradas: Las claves API se almacenan cifradas en Bizaldo mediante AES-256. Finvora aísla cada petición por identificador de empresa (tenantId), garantizando que ninguna organización pueda acceder a los registros financieros de otra.