Integración de la API de Billit: conéctate una vez y sincroniza tus facturas automáticamente

Billit es una plataforma de facturación en la nube que se usa para crear, enviar y gestionar facturas de venta y de proveedores, muy popular entre empresas y asesores contables en Bélgica y más allá. Conectar tu producto a Billit te permite:

• Intercambiar facturas de venta y de proveedores de forma programática, en ambos sentidos
• Automatizar la creación, el envío y la conciliación de facturas
• Sincronizar los datos de facturación con herramientas de contabilidad, ERP o gestión financiera
• Eliminar la introducción manual y los errores que conlleva

Esta guía cubre todo lo que necesitas saber sobre la API de Billit, cómo configurarla, las mejores prácticas a seguir y cómo la API unificada de facturación de Chift te ahorra el trabajo pesado.

¿Qué es la API de Billit?

La API de Billit es una API REST que usa JSON para el intercambio de datos y OAuth 2.0 para la autenticación. Todo el tráfico va por HTTPS, con los verbos HTTP estándar (GET, POST, PUT, DELETE) para leer y escribir datos.

Billit expone en realidad dos API:

• API Estándar, facturas de venta y de proveedores, expuestas como una API REST JSON. Es la que Chift integra.
• API Peppol / Access Point, facturación electrónica XML/UBL a través de la red Peppol. Es una API independiente y no la usa este conector.

Nosotros usamos la API JSON estándar. Cuenta con dos entornos, cada uno con su propia URL base:

• Producción: https://api.billit.be
• Sandbox: https://api.sandbox.billit.be

A través de la API accedes a los datos que necesita una integración de facturación: facturas de venta, facturas de proveedores y los detalles que alimentan la automatización de la precontabilidad, los flujos de cuentas por pagar y el reporting financiero aguas abajo.

Encontrarás la referencia técnica completa en nuestra documentación del conector de Billit.

Ejemplos de casos de uso de la integración con la API de Billit

Integrar Billit abre oportunidades prácticas para enriquecer tu producto con datos de facturación reales. Así es como los proveedores de software los aprovechan a través de la API unificada de facturación de Chift.

Sincronizar facturas con software de contabilidad y ERP

Las plataformas de contabilidad y ERP pueden recuperar automáticamente las facturas de venta y de proveedores desde Billit, manteniendo la contabilidad al día sin exportaciones manuales. Las facturas llegan directamente a los libros correctos, lo que elimina la doble introducción de datos y mantiene los registros exactos.

Automatizar las cuentas por pagar

Las herramientas de finanzas y gestión de gastos pueden recuperar las facturas de proveedores desde Billit para impulsar los flujos de aprobación y pago. Los equipos ven qué se debe y cuándo, aprueban más rápido y evitan los recargos por retraso asociados a los documentos extraviados.

Impulsar los cuadros de mando de tesorería y gestión financiera

Los productos de tesorería y gestión financiera pueden usar los datos de facturación de Billit para ofrecer a las empresas una visión en tiempo real de las entradas y salidas de dinero. Con datos de facturación actualizados, los responsables hacen previsiones más precisas y deciden sobre cifras reales.

Configurar tu integración con la API de Billit

Billit usa OAuth 2.0, y las credenciales las emite su equipo de soporte, por lo que la configuración pasa por un breve proceso de aprobación antes de salir a producción.

1. Solicita tus credenciales OAuth al soporte de Billit. Envíales el nombre de tu aplicación y la URL de redirección. Las credenciales de sandbox se emiten primero; las de producción requieren la aprobación de la integración.
2. Recibe tu client_id y tu client_secret.
3. Implementa el flujo OAuth 2.0. Intercambia el código de autorización por tokens de acceso y de actualización.
4. Autentica tus peticiones. Pasa el token de acceso en la cabecera Authorization: Bearer.
5. Define tu entorno. Cambia environment entre sandbox y production. Esto modifica tanto el endpoint del token como la URL base de la API.
6. Gestiona la actualización de tokens automáticamente. Actualiza los tokens de acceso antes de que caduquen. Ten en cuenta que la actualización de tokens de Billit usa autenticación HTTP Basic con tu client_id y tu client_secret, un enfoque algo inusual que conviene contemplar en tu implementación.

Los endpoints de tokens son:

• Producción: https://api.billit.be/OAuth2/token
• Sandbox: https://api.sandbox.billit.be/OAuth2/token

La API en sí está bien estructurada, pero una integración de nivel productivo es mucho más que unas cuantas llamadas. Tendrás que gestionar el ciclo de vida de OAuth, normalizar los datos de Billit en un modelo interno coherente, gestionar los límites de uso y la paginación, y mantenerlo todo a medida que el software evoluciona. Es la parte que la mayoría de los equipos subestima, y la parte de la que Chift se encarga por ti.

Mejores prácticas para la integración con la API de Billit

• Guarda las credenciales de forma segura. Mantén tu client_secret y tus tokens en variables de entorno o en un gestor de secretos seguro, nunca en el código fuente. Billit nunca te pedirá tu secret.
• Gestiona los límites de uso con backoff exponencial. El límite es de 60 peticiones por minuto y es fácil alcanzarlo en sincronizaciones masivas. Captura las respuestas 429 y reintenta con backoff exponencial en lugar de saturar la API.
• Actualiza los tokens de forma proactiva. Guarda el valor expires_at y actualiza los tokens de acceso antes de que caduquen, usando la llamada de actualización con Basic Auth. No esperes a que falle una petición para actualizar.
• Sigue NextPageLink para la paginación. Usa el campo NextPageLink de la respuesta JSON para recorrer los resultados en lugar de calcular los offsets tú mismo.
• Desarrolla y prueba primero en la sandbox. Trabaja contra api.sandbox.billit.be (acceso en my.sandbox.billit.be) antes de solicitar la aprobación de producción. Te ahorra sorpresas en el lanzamiento.

Conéctate a Billit, Pennylane, Odoo y muchos más con una sola integración

Construir una conexión directa a Billit lleva tiempo, esfuerzo y mantenimiento continuo, sobre todo cuando además necesitas integrar otras herramientas de facturación y contabilidad en distintos países.

Con la API unificada de facturación de Chift, te conectas una sola vez y accedes a Billit, Pennylane, Odoo y muchas más herramientas europeas de facturación y contabilidad a través de un modelo de datos coherente.

• Una sola integración para decenas de herramientas de facturación y contabilidad
• Gestión integrada de OAuth, la actualización de tokens, los límites de uso y las particularidades de cada sistema
• Datos unificados y estandarizados, sea cual sea la fuente
• Sincronización en tiempo real y monitorización avanzada
• Una experiencia fluida para tus usuarios

Las integraciones son lo nuestro. Tú, dedícate a lo tuyo.

Reservar una demo para màs informaciones

FAQ de la API de Billit

¿Qué endpoints incluye la API de Billit?

El conector de Billit de Chift expone un conjunto estandarizado de endpoints de facturación, incluyendo (entre otros):

• Facturas de venta
• Facturas de proveedores

Consulta nuestra documentación de la API de Billit para ver la lista completa de rutas disponibles.

¿Cuál es el límite de uso de la API de Billit?

La API de Billit permite 60 peticiones por minuto. Al superarlo, la API devuelve un código de estado 429. Implementa backoff exponencial y regula las sincronizaciones masivas para mantenerte por debajo del límite.

¿Cómo me autentico en la API de Billit?

Billit usa OAuth 2.0. Solicitas un client_id y un client_secret al soporte de Billit, implementas el flujo de código de autorización para obtener tokens de acceso y de actualización, y pasas el token de acceso en la cabecera Authorization: Bearer. La actualización de tokens usa autenticación HTTP Basic con tus credenciales de cliente.

¿Billit tiene un entorno sandbox?

Sí. Puedes desarrollar y probar en la sandbox en api.sandbox.billit.be (acceso en my.sandbox.billit.be). Las credenciales de sandbox se emiten primero; las de producción requieren la aprobación de la integración.

¿Billit está basado en la nube?

Sí. Billit es una plataforma en la nube, así que no hay ninguna instalación local que gestionar.

¿El conector de Billit admite la facturación electrónica Peppol?

No. Billit ofrece una API Peppol / Access Point independiente para la facturación electrónica XML/UBL a través de la red Peppol, pero este conector usa la API JSON estándar de Billit para las facturas de venta y de proveedores.