Miles de pymes y distribuidores en España utilizan Factusol en sus instalaciones locales para gestionar el almacén físico, preparar albaranes con lectores de códigos de barras y controlar las existencias sin latencias. Al mismo tiempo, sus asesorías y directores financieros prefieren Holded Cloud ERP para la facturación electrónica, el seguimiento de tesorería y la conciliación bancaria en tiempo real. Bentian ERP Bridge une ambos mundos: conecta tu base de datos local de Factusol con la API oficial de Holded sin necesidad de duplicar el trabajo administrativo ni teclear facturas a mano.
1. El Dilema: Almacén Físico (Factusol) vs Facturación Cloud (Holded)
Hasta ahora, las empresas que querían beneficiarse de la agilidad de Holded y la solidez local de Factusol se enfrentaban a un grave cuello de botella operativo:
- Doble picado de albaranes: El almacén prepara el pedido en Factusol y la persona de administración debe volver a introducir el cliente, las líneas y los precios en Holded para emitir la factura.
- Descuadres de IVA y Recargo de Equivalencia: Al introducir facturas manualmente, es habitual cometer errores en los decimales o en el tipo impositivo aplicable.
- Retrasos en la gestoría: La gestoría no recibe las facturas hasta final de mes o trimestre, dificultando las previsiones de tesorería y liquidaciones del modelo 303.
Bentian automatiza este traspaso: en cuanto un pedido o albarán queda validado en Factusol, el agente emite la factura legal en Holded de forma instantánea y desatendida.
2. Generación de API Key en Holded Business
Para autorizar a Bentian a interactuar con tu cuenta de Holded:
- Inicia sesión en tu cuenta de Holded (
app.holded.com) con permisos de administrador. - Haz clic en el icono de tu perfil (esquina superior derecha) y selecciona Configuración.
- En la barra lateral izquierda, entra en Desarrolladores → API.
- Pulsa en Nueva API Key. Asigna una descripción identificativa (ej:
Bentian Factusol Bridge). - Copia la clave generada (un hash alfanumérico seguro de 32 caracteres).
3. Mapeo de Entidades: Albarán/Pedido Factusol ➔ Factura Holded
Bentian traduce los registros relacionales de Factusol en documentos canónicos JSON compatibles con la API REST v1 de Holded (/api/invoicing/v1/documents/invoice):
| Campo Factusol (OLEDB) | Propiedad Holded REST API | Transformación / Regla |
|---|---|---|
| F_PCL.CODPCL / F_FAC.CODFAC | customId | Identificador unívoco para idempotencia anti-duplicados. |
| F_CLI.NIFCLI | contactCode / code | Búsqueda o alta automática del contacto por NIF/CIF. |
| F_LPC.ARTLPC | items[].sku | Código de artículo maestro de Factusol. |
| F_LPC.CANLPC | items[].units | Cantidad facturada con precisión decimal. |
| F_LPC.TOTLPC / F_LPC.IVALPC | items[].subtotal / taxes | Tipo impositivo de IVA (21%, 10%, 4%) y R.E. aplicable. |
4. Sincronización Automática de Clientes, NIFs y Formas de Pago
Cuando se emite una factura en Holded, Bentian comprueba previamente si el cliente ya existe en el directorio de contactos de Holded. Si no existe:
- Crea el contacto en Holded con su razón social, NIF/CIF, dirección postal, código postal y provincia de Factusol.
- Asigna el canal de venta y la cuenta contable de cliente (
4300xxxx) correspondiente. - Mapea la forma de pago (transferencia, tarjeta, domiciliación SEPA o pagaré) respetando los plazos de vencimiento pactados.
5. Libros de IVA, Asientos Contables y Traspaso a Gestoría
Una de las mayores ventajas de Holded es su módulo de contabilidad automatizada. Al generar las facturas a través de Bentian:
6. Configuración del Conector en Bentian y Políticas Offline
La activación en el agente de Bentian se realiza en dos minutos:
- Abre la interfaz gráfica del agente Bentian (
http://127.0.0.1:39281). - Ve a la pestaña Canales & ERPs Cloud y activa el interruptor Holded ERP.
- Introduce tu API Key de Holded y selecciona la serie de facturación deseada (ej. serie "F26" o "HOLD").
- Elige el evento disparador: emitir factura al registrar el pedido, o emitir factura únicamente cuando el albarán pase a estado "Cobrado" en Factusol.
- Pulsa en Probar Conexión para verificar el handshake TLS 1.3 con la API de Holded.
7. Idempotencia y Prevención de Duplicados (customId)
La API de Holded soporta el atributo customId en la creación de documentos. Bentian asigna a este parámetro el identificador único del documento de Factusol (ej: FACTUSOL-FAC-2026-00452).
Si la conexión a Internet se interrumpe durante el envío y el agente reintenta la llamada, Holded detecta que el customId ya existe y devuelve la factura previamente generada en lugar de duplicarla. Esto proporciona garantía transaccional de entrega única (Exactly-Once Semantics).