Cómo conectar Sage Active con WooCommerce: integración vía API para empresas en la nube

Si tu empresa usa Sage Active y quieres conectar tu gestión con una tienda WooCommerce, tienes una buena noticia: este es uno de los escenarios de integración más limpios del ecosistema Sage. A diferencia de Sage 50 — que vive en un servidor local y no expone una API accesible desde internet — Sage Active es una solución 100% cloud con una API pública moderna pensada precisamente para que aplicaciones externas se conecten a ella.

Eso cambia las reglas del juego. No hace falta instalar agentes en servidores, ni acceder a bases de datos locales, ni montar puentes frágiles que se rompen en cada actualización. La integración se hace contra una API documentada y estable, y eso se traduce en menos riesgo, menos mantenimiento imprevisto y un proyecto más predecible.

En este artículo vemos qué API tiene Sage Active exactamente, qué datos se pueden sincronizar con WooCommerce y cuáles no, cómo es la arquitectura de una integración bien hecha, y qué decisiones de negocio conviene cerrar antes de empezar.

TL;DR — lo esencial en 5 puntos:

• Sage Active es la solución cloud de Sage para pymes y autónomos. Al ser nativa en la nube, tiene una API pública moderna a la que conectarse directamente.
• La API de Sage Active es GraphQL (no REST) y usa autenticación OAuth 2.0. Está disponible para la legislación española. Esto importa: los conectores genéricos pensados solo para REST no sirven tal cual.
• La API expone los objetos que necesita una integración de ecommerce: productos (con precios, impuestos y stock), clientes, y documentos de venta (pedidos, albaranes, facturas).
• El alcance de la integración lo marca la API: se sincroniza lo que la API permite. Para una operativa de pyme estándar, eso cubre lo esencial. Para gestión de almacén compleja multi-ubicación, Sage Active no es la herramienta — lo serían Sage 200 o X3.
• Una integración Sage Active ↔ WooCommerce bien hecha parte de un rango aproximado de 3.500€-10.000€, más limpio y predecible que el de Sage 50 por no requerir infraestructura on-premise.

Qué es Sage Active y por qué su integración es distinta

Sage Active es la apuesta cloud nativa de Sage para autónomos y pymes. No es una versión «en la nube» de un programa de escritorio: está construida desde cero como aplicación web, y eso se nota en cómo se integra con el resto del mundo.

La diferencia clave con Sage 50 es arquitectónica:

• Sage 50 vive en un servidor local sobre SQL Server. No expone API pública. Integrarlo requiere un SDK con un agente instalado en la máquina o acceder a la base de datos directamente. Complejo y con riesgo en cada actualización.
• Sage Active vive en la nube de Sage y ofrece una API pública documentada. La integración se hace por HTTPS contra esa API, sin tocar infraestructura del cliente. Más limpio y mantenible.

La consecuencia práctica: Con Sage Active, la conversación deja de ser «cómo accedo técnicamente al ERP» (que con Sage 50 es la mitad del problema) y pasa a ser «qué datos sincronizo y con qué lógica de negocio». Es un punto de partida mucho mejor: el esfuerzo se concentra en resolver el negocio, no en pelearse con la fontanería.

Qué API tiene Sage Active realmente (y por qué el matiz importa)

Aquí es donde conviene ser preciso, porque hay un detalle técnico que diferencia un proyecto bien planteado de uno que arranca con expectativas equivocadas.

Es una API GraphQL, no REST

La mayoría de ecommerce y conectores del mercado están pensados para APIs REST, donde cada recurso tiene su URL y se consulta con GET, POST, PUT y DELETE. La API pública de Sage Active funciona distinto: es GraphQL.

En GraphQL, en lugar de muchas URLs, hay un único punto de entrada y el cliente describe exactamente qué datos quiere. Las operaciones de lectura se llaman queries (equivalente conceptual a un GET) y las de escritura se llaman mutations (crear, actualizar o eliminar). Tiene ventajas reales:

• Pides exactamente los campos que necesitas, ni más ni menos — menos datos por la red, respuestas más rápidas.
• Puedes traer varios objetos relacionados en una sola petición, reduciendo el número de llamadas.
• El esquema está fuertemente tipado y es autodocumentado, lo que reduce errores de integración.

¿Por qué esto importa para tu proyecto? Que la API sea GraphQL significa que un conector genérico de «Sage a WooCommerce» pensado para REST no encaja directamente. La integración requiere construir las queries y mutations específicas contra el esquema de Sage Active. No es más difícil — es distinto, y exige a quien lo desarrolle saber trabajar con GraphQL. Es justo el tipo de detalle que conviene confirmar al elegir proveedor.

Autenticación OAuth 2.0 y consentimiento por permisos

El acceso a la API se asegura con OAuth 2.0. Tu aplicación de integración obtiene un token de acceso y debe solicitar solo los permisos (scopes) que realmente necesita. Si la integración solo va a leer datos de Sage para llevarlos a la web, no debería pedir permiso de escritura. Es una buena práctica de seguridad que conviene exigir: mínimo privilegio necesario.

Disponible para legislación española y en evolución activa

La API pública de Sage Active está disponible para los entornos de Francia, España y Alemania, así que la legislación española está cubierta. Conviene saber también que la API evoluciona de forma activa — Sage publica actualizaciones y nuevas colecciones de referencia con regularidad. Esto es bueno (la plataforma mejora) pero implica que una integración debe construirse de forma que las actualizaciones de la API se absorban sin romper nada.

Qué se puede sincronizar con WooCommerce (y qué no)

Este es el corazón del artículo, y el principio que lo gobierna es simple y honesto: se sincroniza lo que la API de Sage Active expone. Si la API no ofrece una funcionalidad, la integración tampoco puede ofrecerla. Cualquier proveedor serio te dirá esto desde el principio.

Lo que la API de Sage Active sí expone

Según su documentación, la API trabaja con los objetos que una integración de ecommerce necesita:

• Productos. La entidad de productos incluye código, nombre, códigos de impuesto, tasas de descuento y niveles de stock, y puede asociarse a modelos de precios (tarifa estándar, descuentos, precios escalonados). Es la base para sincronizar el catálogo hacia WooCommerce.
• Clientes y organizaciones. Altas y actualizaciones de clientes, con sus datos fiscales válidos. Permite que un cliente que compra en la web quede registrado correctamente en Sage Active.
• Documentos de venta. Presupuestos, pedidos, albaranes y facturas. Un pedido de WooCommerce puede convertirse en el documento correspondiente dentro de Sage Active.
• Formas y condiciones de pago, tipos de documento, impuestos. Los elementos necesarios para que los documentos generados sean correctos fiscalmente.

Dirección típica de la sincronización

Dato	Dirección habitual
Catálogo de productos	Sage Active → WooCommerce (Sage como origen del producto y su precio).
Stock	Sage Active → WooCommerce (el nivel de stock de Sage es el que ve el cliente).
Precios y tarifas	Sage Active → WooCommerce.
Pedidos	WooCommerce → Sage Active (la venta nace en la web y se registra en Sage).
Clientes	WooCommerce → Sage Active (alta automática del cliente que compra).
Facturas	Generadas en Sage Active (sistema fiscal de referencia).

Lo que NO esperes de Sage Active

Aquí está la honestidad que diferencia un proyecto bien planteado. Sage Active es una solución de gestión y contabilidad para pymes y autónomos — no un ERP de logística avanzada. Por tanto:

• No esperes gestión de almacén compleja multi-ubicación, con bins, ubicaciones físicas y trazabilidad por lote. Eso es territorio de Sage 200 o Sage X3.
• No esperes lógica de fabricación (MRP), escandallos o producción. No es su ámbito.
• El stock que sincroniza es el nivel de producto que Sage Active gestiona, adecuado para operativa de venta estándar, no para logística de gran complejidad.

El principio rector, dicho claro. Atacamos la API y sincronizamos lo que la API permite. Si Sage Active no expone una funcionalidad por su API, nosotros tampoco podemos ofrecerla — y preferimos decírtelo antes de empezar que descubrirlo a mitad de proyecto. Para una pyme con operativa de venta normal, lo que la API ofrece cubre lo necesario. Para logística compleja, la conversación correcta es subir a Sage 200 o X3, no forzar Sage Active.

Arquitectura de una integración Sage Active ↔ WooCommerce

Una integración robusta entre ambos sistemas se compone de estas piezas:

• WooCommerce con su REST API activada, que es por donde el conector lee pedidos y escribe productos y stock.
• Sage Active con una aplicación registrada en su portal de desarrollador y los permisos OAuth 2.0 concedidos.
• Un middleware / conector (alojado en la nube) que orquesta la sincronización: traduce entre el GraphQL de Sage Active y el REST de WooCommerce, aplica la lógica de negocio, gestiona la cola de pedidos y registra errores.

Lo importante: todo vive en la nube. No hay servidores del cliente que mantener, ni agentes locales, ni dependencia de que un ordenador de la oficina esté encendido. Es la gran ventaja frente a Sage 50.

Lo que distingue una integración seria de un apaño

• Cola y reintentos. Si Sage Active o WooCommerce no responden en un momento dado, los pedidos se encolan y se reintentan, no se pierden.
• Gestión de errores y alertas. Cuando una sincronización falla, hay registro consultable y aviso al equipo. La API distingue entre errores de negocio, de validación y de autorización — una buena integración los trata de forma diferenciada.
• Idempotencia. Que un mismo pedido no se duplique en Sage si la sincronización se reintenta. Suena obvio; es de los fallos más comunes cuando no se diseña bien.
• Respeto de los límites de la API. La API pagina los resultados y tiene límites de volumen por petición. La integración debe respetarlos para no ser bloqueada ni degradar el rendimiento.

Qué decidir antes de empezar

Como en cualquier integración, el coste y el éxito del proyecto se deciden antes de tocar tecnología. Las preguntas a cerrar:

1. ¿Dónde nace el producto: en Sage Active o en WooCommerce?

Lo habitual es que el producto y su precio nazcan en Sage Active y se publiquen en la web. Pero la parte de marketing (fotos, descripciones largas, SEO de la ficha) suele vivir mejor en WooCommerce. La regla práctica: datos comerciales y fiscales desde Sage; contenido enriquecido en WooCommerce. Hay que mapear qué campo manda en cada caso.

2. ¿Quién emite la factura?

En España la factura tiene implicaciones fiscales. Lo natural con Sage Active es que la factura legal se genere ahí, ya que es el sistema de gestión. WooCommerce muestra al cliente la confirmación del pedido. Conviene decidirlo desde el inicio para no acabar con dos numeraciones.

3. ¿Cada cuánto debe sincronizarse el stock?

¿Necesitas stock casi en tiempo real o una sincronización cada X minutos es suficiente? Para la mayoría de pymes, una sincronización frecuente por eventos o cada pocos minutos cubre de sobra. Definirlo evita sobre-ingeniería innecesaria.

4. ¿Qué pasa con un cliente que ya existe?

Cuando alguien compra en la web, ¿se crea siempre como cliente nuevo en Sage Active o se busca primero por NIF/email para evitar duplicados? Esta regla hay que definirla explícitamente.

Errores y cosas a tener en cuenta:

1. Asumir que un conector REST genérico funcionará

Al ser la API de Sage Active GraphQL, los conectores genéricos pensados para REST no encajan directamente. Verifica siempre que quien desarrolle la integración trabaja específicamente contra la API GraphQL de Sage Active, no contra un supuesto endpoint REST que no existe como tal.

2. Pedir más permisos OAuth de los necesarios

Por seguridad, la aplicación debe solicitar solo los scopes que usa. Una integración que solo lee de Sage no debería tener permiso de escritura. Revisa los permisos concedidos.

3. No prever la evolución de la API

La API de Sage Active se actualiza con regularidad. Una integración bien construida aísla las llamadas a la API en una capa propia, de modo que un cambio en la API se absorba en un punto y no obligue a reescribir todo. Pregunta cómo se ha previsto esto.

4. Confundir Sage Active con otros productos Sage

«Sage» es una familia, no un producto. Una integración para Sage Active no sirve para Sage 50, ni para Sage 200, ni para Sage X3 — cada uno tiene una arquitectura y una vía de integración distintas. Asegúrate de que el proyecto es específico para tu producto.

Sage Active vs Sage 50, 200 y X3: Cuál encaja contigo

Producto	Arquitectura	Vía de integración	Para quién
Sage Active	100% cloud	API pública GraphQL + OAuth 2.0	Autónomos y pymes con operativa de venta estándar
Sage 50	Local (SQL Server)	SDK con agente local o BBDD directa	Pymes con Sage 50 ya implantado
Sage 200	On-premise u opción cloud	COM / SQL / API limitada	Empresas medianas con gestión avanzada
Sage X3	Cloud / on-premise	API REST + SOAP	Grupos y empresas complejas

Si estás empezando o tu operativa es la de una pyme de venta estándar, Sage Active es probablemente la opción más sencilla de integrar y mantener. Si tu logística es compleja o tu volumen es muy alto, la conversación correcta puede ser otro producto de la familia — y en ese caso la integración se plantea de forma distinta.

Qué perfil de empresa encaja mejor

• Pymes y autónomos que ya usan Sage Active (o están migrando a él) como sistema de gestión y facturación.
• Negocios con catálogo de complejidad media y operativa de venta estándar, sin logística multi-almacén sofisticada.
• Empresas que valoran tener todo en la nube, sin servidores propios que mantener.
• Quien quiere una integración predecible y mantenible, no un desarrollo frágil que dependa de un servidor local encendido.

Resumen

• Sage Active es cloud nativo y tiene API pública: su integración con WooCommerce es de las más limpias del ecosistema Sage.
• La API es GraphQL con OAuth 2.0 y cubre la legislación española. No es REST — ojo con los conectores genéricos.
• Se sincroniza lo que la API expone: productos (con precio, impuestos y stock), clientes y documentos de venta. Suficiente para operativa de pyme estándar.
• Sage Active no es para logística compleja. Si la necesitas, la conversación es Sage 200 o X3, no forzar Sage Active.
• Una integración seria incluye cola, reintentos, gestión de errores e idempotencia, y aísla la API para absorber sus actualizaciones.

¿Necesitas ayuda con tu integración?

En Nubeas Web construimos integraciones contra la API de Sage Active con un principio claro: sincronizamos lo que la API permite, te decimos desde el principio qué entra y qué no, y entregamos una integración mantenible que no depende de servidores locales.

Si después de leer esto tienes dudas sobre tu caso concreto —qué se puede sincronizar en tu operativa, qué arquitectura encaja o qué presupuesto necesitas— estamos a tu disposición para revisar tu proyecto. Tanto si solo buscas una segunda opinión técnica como si quieres que nos encarguemos de la integración de principio a fin, escríbenos y lo vemos contigo, sin compromiso.

Puedes conocer cómo trabajamos las conexiones entre ERP y ecommerce en nuestra página de integraciones ERP.

¿Usas Sage Active y quieres conectarlo con WooCommerce? Cuéntanos tu operativa y te decimos exactamente qué se puede sincronizar vía API, con qué arquitectura y qué presupuesto realista necesitas. Estamos disponibles para revisar tu proyecto y resolver tus dudas → Ver nuestros servicios de integraciones ERP.

Preguntas frecuentes: