Instalación y configuración de WooSyncFS

WooSyncFS conecta FacturaScripts directamente con tu tienda WooCommerce mediante su API REST propia, sin intermediarios ni cuotas por bloque. Importa pedidos, sincroniza productos por SKU y envía el stock de FacturaScripts a la tienda.

Requisitos

FacturaScripts 2025 o superior y PHP 8.0 o superior, con la extensión cURL activa.
La instalación de FacturaScripts debe ser accesible online para poder conectar con la tienda.
Una clave y un secreto de la API REST de WooCommerce con permisos de Lectura/Escritura.

1. Generar las claves en WooCommerce

En tu WordPress ve a WooCommerce → Ajustes → Avanzado → API REST → Añadir clave. Crea una clave con permisos de Lectura/Escritura y copia la Consumer key (ck_...) y el Consumer secret (cs_...).

2. Configurar la conexión

Instala y activa el plugin en FacturaScripts. Entra en el panel WooCommerce (menú Administrador) e introduce la URL de la tienda (por ejemplo https://tutienda.com, sin /wp-json), la Consumer key y el Consumer secret. Deja la versión de la API en wc/v3. Pulsa Guardar y luego Probar conexión: debe indicar "Conexión correcta con la tienda WooCommerce".

3. Importar pedidos

En el bloque Pedidos indica los estados de WooCommerce que quieres importar, separados por comas (por ejemplo processing,completed). Opcionalmente fija serie, forma de pago, almacén, agente y un prefijo de referencia. Marca "Crear el cliente si no existe" para dar de alta automáticamente el cliente a partir de los datos de facturación del pedido. Pulsa "Sincronizar pedidos". Cada pedido se crea una sola vez (es idempotente): volver a sincronizar no duplica pedidos ya importados, solo actualiza su estado.

4. Sincronizar productos por SKU

Los productos se identifican por SKU = referencia: el SKU de WooCommerce debe coincidir con la referencia en FacturaScripts. Activa "Sincronización de productos" y elige si quieres crear los que falten, actualizar el precio y/o actualizar la descripción desde la tienda. Pulsa "Sincronizar productos". Los productos sin SKU se omiten.

5. Enviar stock a la tienda

Activa "Enviar stock de FacturaScripts a la tienda" y, si lo deseas, indica el almacén de origen (déjalo vacío para sumar el stock de todos los almacenes). Pulsa "Enviar stock": se envía el stock disponible de FacturaScripts a los productos de la tienda que tengan SKU.

6. Sincronización automática (cron)

Marca "Activar cron" y elige qué sincronizar automáticamente (pedidos, productos, stock) y el intervalo mínimo en minutos. Requiere tener configurado el cron de FacturaScripts en tu servidor.

Registro

La pestaña Registro guarda un histórico de cada sincronización (creados, actualizados, omitidos, errores) para facilitar el seguimiento y la resolución de incidencias.