FacturaScripts es uno de los software de facturación y contabilidad para pymes más populares en el ecosistema hispanohablante, desarrollado bajo licencia libre GNU LGPLv3. El Conector FacturaScripts de Bentian ERP Bridge se comunica con el motor mediante la API REST v3 oficial, permitiendo sincronizar artículos, precios con IVA, stock disponible y descargar pedidos de WooCommerce o PrestaShop directamente al circuito de ventas de FacturaScripts.
1. Arquitectura API REST v3 de FacturaScripts
A diferencia de las conexiones directas a base de datos que pueden omitir triggers o cálculos de costes, la API REST v3 de FacturaScripts procesa los documentos a través de sus controladores oficiales (ApiCreateDocument, Calculator y BusinessDocumentCode). Esto garantiza:
- Numeración correlativa automática: Se genera el código de serie oficial (ej.
PED2026A1) sin saltos. - Actualización de stock físico y reservado: Las líneas restan existencias inmediatamente (
actualizastock = -cantidad). - Asignación de formas de pago: Mapeo directo con las formas de pago de FacturaScripts (
CONT,TARJETA,TRANS).
2. Activación y Token API en config.php
Para habilitar el acceso a la API REST v3 con permisos completos, basta con añadir una línea al archivo config.php de tu instalación de FacturaScripts:
define('FS_API_KEY', 'tu_clave_secreta_api_bentian');
Cualquier petición con la cabecera Token: tu_clave_secreta_api_bentian o X-Auth-Token tendrá acceso autorizado inmediato.
3. Lectura de Productos, Variantes y Existencias
Bentian consulta de forma no invasiva los recursos:
GET /api/3/productos: Lista de referencias, descripciones, tarifas e impuestos.GET /api/3/variantes: Códigos de barras y precios específicos por variante.GET /api/3/stocks: Existencias disponibles en el almacén principal (ALG).
4. Inyección de Pedidos con /api/3/crearPedidoCliente
El conector envía la orden web mediante una llamada POST a /api/3/crearPedidoCliente incluyendo el cliente, la serie (A), el almacén (ALG), la divisa (EUR), la forma de pago y el array de líneas con sus SKUs, cantidades y precios unitarios.
5. Paso a Paso en Bentian ERP Bridge
En el panel de control del Agente Bentian:
- Selecciona FacturaScripts en la lista de proveedores ERP.
- Indica la URL base de tu instalación (ej.
http://127.0.0.1:8096o tu dominio HTTPS). - Introduce la clave API en el campo de contraseña.
- Guarda y pulsa «Probar Conexión». El agente verificará la comunicación en menos de 2 segundos.