Cómo conectar tu tienda Shopify con FacturaScripts (guía paso a paso)

Qué hace ShopifySyncFS

Trae los pedidos de tu tienda Shopify a FacturaScripts como pedidos de cliente, sincroniza los productos por SKU y envía el stock de FacturaScripts a la tienda. Sin plataformas intermedias ni cuotas de terceros: hablas directamente con la API de Shopify desde tu propio FacturaScripts.

1. Crear la app en Shopify (2 minutos)

Necesitas un token de acceso de la Admin API. En tu panel de Shopify:

1. Configuración > Apps y canales de venta > Desarrollar apps.
2. Pulsa Crear una app, ponle un nombre (por ejemplo, "FacturaScripts") y guarda.
3. En Configuración > Admin API integration, marca estos permisos (scopes):
   • read_orders — para importar los pedidos.
   • read_products — para leer productos y variantes.
   • read_inventory y write_inventory — para enviar tu stock a la tienda.
   • read_locations — para saber a qué ubicación enviar ese stock.
4. Guarda, pulsa Instalar app y copia el Admin API access token (empieza por shpat_). Ojo: Shopify solo te lo enseña una vez.

2. Configurar el plugin

Instala ShopifySyncFS desde el panel de FacturaScripts y entra en Admin > Shopify:

• Dominio de la tienda: mitienda.myshopify.com (puedes pegar la URL completa, el plugin la limpia).
• Token de acceso: el shpat_... que acabas de copiar.
• Pulsa Probar conexión. Si todo va bien verás el aviso verde y, además, las ubicaciones de tu tienda con su id (te sirve para el apartado de stock).

3. Pedidos

• Estados de pago a importar: por defecto paid,partially_paid. Si trabajas con contrareembolso o transferencia puedes añadir pending.
• Serie, forma de pago, almacén y agente: opcionales; si los dejas vacíos se usan los valores por defecto de tu empresa.
• Crear el cliente si no existe: el plugin busca primero por NIF y luego por email; si no lo encuentra, da de alta el cliente con su dirección de facturación.
• Generar la factura automáticamente: crea la factura de cliente en cuanto entra el pedido, usando el mecanismo estándar de FacturaScripts (estado del pedido que genera factura).

Un detalle importante: el plugin entiende si tus precios de Shopify llevan los impuestos incluidos (taxes_included) y guarda siempre la base imponible correcta en FacturaScripts. También reparte los descuentos por línea y añade los gastos de envío como una línea más.

¿Y el NIF?

Shopify no tiene un campo de NIF nativo. El plugin lo busca en los note_attributes del pedido (donde lo dejan la mayoría de apps de facturación española), en la empresa del billing y en los metafields del cliente. Si tu tienda lo guarda con otro nombre, escríbenos y lo añadimos.

4. Productos y stock

• Productos: se identifican por SKU = referencia. Cada variante de Shopify con SKU se trata como una referencia de FacturaScripts. Puedes crear los que falten y actualizar precio y descripción.
• Stock: al revés. El plugin lee tu stock en FacturaScripts (de un almacén concreto o de todos) y lo escribe en la ubicación de Shopify que elijas. Solo escribe cuando el número cambia, así no gastas peticiones de más.

5. Sincronización automática

En la tarjeta Sincronización automática activas lo que quieras que corra solo (pedidos, productos, stock) y el intervalo mínimo en minutos. Necesitas tener configurado el cron de FacturaScripts en tu servidor. Cada ejecución queda anotada en la pestaña Registro, junto con los avisos y errores.

Preguntas rápidas

¿Funciona con Shopify Plus? Sí, usa la misma Admin API.

¿Me va a duplicar pedidos? No. Cada pedido de Shopify queda mapeado con su pedido de FacturaScripts; si vuelves a sincronizar, se omite (y si cambió de estado, se actualiza).

¿Puedo probar sin tocar mi contabilidad? Sí: deja desactivada la factura automática, importa y revisa los pedidos antes de facturar.

¿Y si tengo varias tiendas? De momento una por instalación. Si lo necesitas, dínoslo: ya tenemos el multi-tienda funcionando en nuestro plugin de PrestaShop y lo traeríamos aquí.

¿Alguna duda o algo que no encaje con tu tienda? Escríbenos y lo miramos.