FacturaOne ya dispone de API de lectura para integraciones externas

FacturaOne incorpora una nueva API de lectura diseñada para facilitar la conexión del ERP con aplicaciones externas, tiendas online, plataformas de gestión, sistemas de análisis y desarrollos personalizados.

Esta nueva función permite consultar información almacenada en FacturaOne de una forma ordenada, segura y automatizada, sin necesidad de acceder directamente a la base de datos.

La API es exclusivamente de lectura. Esto significa que una aplicación externa puede consultar información, pero no puede crear, modificar ni eliminar datos dentro de FacturaOne.

¿Qué es una API y para qué sirve?

Una API es un sistema que permite que dos aplicaciones diferentes se comuniquen entre sí.

En este caso, la API de FacturaOne permite que un programa externo solicite determinada información al ERP y la reciba en un formato estructurado que pueda procesar automáticamente.

Por ejemplo, una empresa podría utilizarla para:

• Sincronizar clientes y artículos con otra plataforma.
• Consultar facturas emitidas desde un programa externo.
• Obtener ventas de artículos para generar estadísticas.
• Integrar FacturaOne con aplicaciones propias.
• Crear paneles de control o informes personalizados.
• Conectar el ERP con tiendas online, sistemas logísticos o herramientas de análisis.

La principal ventaja es que estas consultas pueden realizarse automáticamente, sin exportar archivos manualmente cada vez que se necesiten los datos.

Una API segura y exclusivamente de lectura

La API de FacturaOne ha sido creada como una API de solo lectura.

Esto significa que las aplicaciones conectadas pueden consultar la información autorizada, pero no pueden realizar operaciones que alteren los datos del ERP.

No se permiten operaciones para:

• Crear registros.
• Modificar clientes, artículos o documentos.
• Eliminar información.
• Confirmar o modificar facturas.
• Cambiar la configuración del sistema.

El acceso se realiza mediante un token privado, generado desde la propia cuenta de FacturaOne. Este token identifica la instalación y permite acceder únicamente a los datos asociados a esa empresa.

El token debe guardarse de forma segura y no debe incluirse en páginas web públicas, enlaces, repositorios o aplicaciones accesibles desde el navegador.

Principales datos que pueden consultarse

La API ofrece diferentes recursos para consultar la información más utilizada del ERP.

Entre sus funciones principales se encuentran:

Clientes y proveedores

Permite consultar los datos fiscales y comerciales de clientes y proveedores, como el nombre, NIF, dirección, población, provincia, teléfonos, correo electrónico o persona de contacto.

Artículos y catálogos

Se pueden consultar artículos, referencias, códigos de barras, precios, stock, familias, tipos de artículo, impuestos y otros datos relacionados con el catálogo.

Facturas emitidas

La API permite obtener facturas emitidas junto con información como:

• Número y fecha de factura.
• Cliente.
• Serie y tipo de factura.
• Estado del documento.
• Estado de cobro.
• Bases, impuestos y total.
• Facturas anuladas o sustituidas.
• Pagos asociados, cuando se soliciten.

Las facturas pueden filtrarse por fechas, cliente, comercial, serie, estado, tipo de factura o texto de búsqueda.

Venta y salida de artículos

También es posible consultar las líneas de venta procedentes de facturas y albaranes.

Esto permite conocer qué artículos se han vendido, en qué cantidad, a qué cliente, con qué precio, descuento, impuesto o comisión.

Las consultas pueden filtrarse por fechas, cliente, comercial, ruta, familia, artículo, tipo de producto o movimiento de venta y devolución.

Filtros, paginación y control de consultas

La API incluye filtros que permiten solicitar únicamente la información necesaria.

Por ejemplo, una integración puede consultar:

• Las facturas de un periodo determinado.
• Las facturas pendientes de cobro.
• Las ventas de una familia de artículos.
• Las devoluciones de un producto.
• Los clientes activos.
• Los artículos que coincidan con una referencia o código de barras.

Cuando una consulta contiene muchos resultados, la API utiliza un sistema de paginación para recuperar los datos en varias peticiones sin sobrecargar la instalación.

Además, las respuestas incluyen códigos de error e identificadores de diagnóstico que facilitan la localización de posibles incidencias durante una integración.

¿Dónde se encuentra la API de lectura en FacturaOne?

Para acceder a esta nueva función debe entrar en FacturaOne con el usuario administrador principal y seguir esta ruta:

Rueda de configuración → Preferencias del sistema → API de lectura

Una vez dentro de las preferencias, la opción API de lectura aparece en el menú situado en la parte izquierda de la pantalla.

La documentación y configuración de la API se encuentra en Preferencias del sistema, dentro de la opción «API de lectura» del menú lateral izquierdo.

Activación y generación del token

La activación se realiza directamente desde la pantalla de configuración.

El administrador principal puede generar un token y activar la API. El token se muestra una sola vez, por lo que debe copiarse y guardarse antes de abandonar la pantalla.

Desde esta misma sección también se puede:

• Comprobar si la API está activada.
• Regenerar el token.
• Desactivar el acceso.
• Consultar la dirección base de la API.
• Revisar toda la documentación.
• Copiar ejemplos de integración.

La documentación incluye ejemplos preparados para utilizar la API mediante cURL, PHP, Node.js, Postman y otros sistemas compatibles con peticiones HTTP.

Documentación incluida dentro de FacturaOne

No es necesario buscar documentación en una plataforma externa.

La propia pantalla de FacturaOne contiene una guía completa organizada mediante secciones y desplegables.

Dentro de ella se explican:

• Los recursos disponibles.
• Los filtros de cada consulta.
• Los campos devueltos.
• La autenticación.
• La paginación.
• Los códigos de error.
• Las recomendaciones de seguridad.
• Ejemplos de peticiones y respuestas.

De esta forma, el desarrollador o empresa encargada de realizar la integración dispone de toda la información necesaria dentro del propio ERP.

Coste de activación y utilización

La activación de la API y la generación del token de acceso no tienen ningún coste adicional.

El uso efectivo de la API se factura en función del consumo realizado y de las tarifas vigentes.

Esto permite mantener la API desactivada mientras no sea necesaria y activarla únicamente cuando se vaya a utilizar en una integración o desarrollo externo.

Una nueva posibilidad de integración para FacturaOne

La incorporación de esta API amplía las posibilidades de conexión de FacturaOne con otros sistemas.

Empresas, desarrolladores y proveedores tecnológicos pueden consultar información del ERP de forma segura, automatizar procesos y crear integraciones adaptadas a las necesidades de cada negocio.

Todo ello manteniendo una característica fundamental: la API solo permite consultar información y no puede modificar los datos almacenados en FacturaOne.