Puesta en marcha — FACTSYNC + SAGE 200c Conector v1.0.12 · Sage 200 ≥ 2022.01.000

Esta guía describe la secuencia completa para dejar operativa la sincronización entre Softbase8 y SAGE 200. Los pasos 0–2 (servidor SAGE) son un resumen; el detalle con capturas está en el Manual de instalación del conector. Los pasos 3–5 (Softbase8) se documentan aquí íntegramente.

1. Flujo de la puesta en marcha

Los pasos 0, 1 y 2 se realizan en el servidor donde reside SAGE 200, por parte de GironaSoft (o el cliente siguiendo el manual de instalación). Los pasos 3, 4 y 5 se realizan desde Softbase8.

---

2. Paso 0 — Verificar requisitos previos Antes de instalar

Antes de ejecutar el instalador deben cumplirse estos requisitos en el servidor del cliente:

• ⚠️ IP pública fija o DDNS apuntando siempre a la IP pública del servidor — requisito indispensable
• Sage 200 (≥ 2022.01.000) y SQL Server operativos
• Capa OEM de Sage 200 instalada y registrada en el servidor
• Credenciales del administrador de SQL Server disponibles durante la instalación
• Puerto 8443 (o el elegido) abierto en firewall y redirigido en el router
• Privilegios de administrador en el servidor Windows
• Módulo Gestor Documental de Sage 200 instalado y configurado — necesario para recuperar los PDFs de pedidos, albaranes y facturas desde Sage.

---

3. Paso 1 — Instalar el PortalClient SageConnector Servidor SAGE

Ejecutar Installer.exe en el servidor de SAGE 200, configurar la conexión SQL y arrancar la aplicación como administrador. El instalador crea automáticamente el usuario SQL del conector con los permisos mínimos necesarios.

↓ Descargar Installer.exe

---

4. Paso 2 — Generar las claves API (KEY / SECRET) Servidor SAGE

Abrir el conector como administrador, ir al apartado [Autenticación] y crear una entrada indicando un nombre identificativo y la empresa de Sage 200. La API KEY y el API SECRET se generan automáticamente. Anotarlos: son los valores que se introducirán en FACTSYNC en el paso 3.

---

5. Paso 3 — Crear la conexión FACTSYNC Softbase8

Desde el módulo FACTSYNC se da de alta una conexión de tipo sage200c y se rellenan los campos de configuración con los datos generados en el paso anterior.

• Crear conexión nueva Tipo sage200c. Nombre descriptivo (p. ej. SAGE Producción o SAGE — Empresa A si hay más de una).
• Rellenar los campos

  Campo	Valor	Notas
  SAGE_ENDPOINT	URL base de la API del conector	Sin barra final. Formato: https://<IP_o_dominio>:8443
  SAGE_USERNAME	API KEY del paso 2
  SAGE_PASSWORD	API SECRET del paso 2
  SAGE_SECTORS	Origen de sectores en Sage	sectors (defecto) / tipus_client / colectius
  SAGE_TOKEN	(gestionado automáticamente)	FACTSYNC lo rellena y renueva solo
  SAGE_EXPIRES	(gestionado automáticamente)	Marca de tiempo de expiración del token

• Guardar la conexión A partir de aquí, FACTSYNC ya puede negociar el token OAuth2 con la API del conector (flujo grant_type=client_credentials).

---

6. Paso 4 — Validar con un método de lectura Softbase8

Antes de programar nada, conviene comprobar de extremo a extremo que la conexión funciona. La forma más rápida es crear un método de lectura ligero y dispararlo manualmente con Ver original.

• Crear un método de prueba Desde la conexión, pestaña Métodos conexión → Agregar. Elegir currencies GET o sectors GET (tablas pequeñas, sin dependencias).
• Abrir el explorador de datos Botón Gestor datos de la conexión. Localizar el método en la barra lateral.
• Pulsar «Ver original» 🔍 Si la conexión está bien configurada aparecerá una tabla con los datos en bruto de SAGE. El campo SAGE_TOKEN de la conexión debe haberse rellenado automáticamente.
• Validar con «Ver transformado» 📊 Comprobar que los campos se mapean al formato Softbase como se espera (referencia en el glosario de campos).
• Importar la prueba 📥 Lanzar la importación manualmente. Si los registros se guardan correctamente, la integración está operativa de extremo a extremo.

---

7. Paso 5 — Programar la importación maestra Softbase8

Una vez validada la conexión, hay que crear el resto de métodos siguiendo el orden de dependencias: las entidades maestras antes que las que las referencian.

Escalona los métodos en minutos distintos para que cada paso termine antes de que arranque el que depende de él. Frecuencias base: clientes cada 6 h, catálogo 1 vez al día (nocturno), exportación de pedidos cada 5 min.

Orden	Métodos	Frecuencia (cron)	Notas
1	Maestros: currencies · payment_methods · sectors · employees · custom_fields · discount_lines · warehouses	Diaria, escalonados 0 2 * * * … 30 2 * * *	Sin dependencias
2	product_families → product_groups → products → product_images → translations	1 vez/día nocturna: 0 3 * * * / 20 3 * * * / 40 3 * * * / 30 4 * * * / 50 4 * * *	Respetar el orden. translations depende de products
3	cleanup_taxonomy	20 5 * * * (opcional)	Reconcilia d_items con el campo web. products ya lo ejecuta al final de su import
4	customers → addresses → contacts	Cada 6 h: 0 */6 * * * / 15 */6 * * * / 30 */6 * * *	addresses/contacts dependen de customers
5	conditions (condiciones especiales de precio)	0 6 * * *	Depende de descuentos, productos y clientes
6	stocks	*/30 * * * *	Depende de warehouses+products. Stock casi en tiempo real
7	external_documents (facturas, albaranes, pedidos)	*/15 * * * *	Solo para clientes ya sincronizados; por defecto últimos 5 días
8	Exportaciones (cola): customers/addresses POST·PUT · orders POST	*/10 * * * * · orders: */5 * * * *	Pedidos cada 5 min. Con export_customers:"Y" crea el cliente si falta

Para cada método, indicar la FRECUENCIA CRON (formato estándar 5 campos) y dejar ACTIVADO=Y. El componente que ejecuta los métodos en su hora es FSYN_cron: debe estar configurado como cron del sistema en el servidor Softbase para disparar las tareas FACTSYNC periódicamente.

Exportaciones (escritura en Sage)

Las exportaciones (clientes, direcciones y pedidos de venta) se envían hacia Sage a través de una cola que el conector procesa por lotes cada ~2 minutos. No hay método cron especial para estas: FACTSYNC encola las operaciones y el conector las procesa solo. Se recomienda probar con un registro real antes de dar la integración por finalizada:

• customers POST — Alta de cliente en Sage
• addresses POST/PUT — Alta/modificación de dirección de cliente
• orders POST — Alta de pedido de venta en Sage

---

8. Checklist final

Antes de dar la integración por entregada, verificar:

Servidor (conector)

• Se han verificado todos los requisitos previos del paso 0 (especialmente la IP pública fija y la capa OEM).
• La aplicación PortalClient SageConnector está arrancada en el servidor de SAGE y accesible desde el exterior.
• El puerto de la API (por defecto 8443) está abierto en el firewall y redirigido en el router del cliente.
• El endpoint HTTPS es accesible desde el servidor de Softbase (test con curl o navegador).
• Se han generado las claves API KEY / API SECRET (una por empresa si hay más de una).

FACTSYNC (Softbase8)

• La conexión FACTSYNC tiene SAGE_TOKEN y SAGE_EXPIRES rellenados (se renuevan solos tras la primera llamada exitosa).
• Un método currencies GET o sectors GET ejecutado manualmente importa registros sin errores.
• Todos los métodos críticos están con ACTIVADO=Y y tienen FRECUENCIA CRON configurada.
• El cron del sistema (FSYN_cron) está instalado en el servidor y se ejecuta periódicamente.
• El primer ciclo automático ha completado todas las importaciones maestras (revisar columna Última ejecución).
• Los métodos de exportación (customers POST, orders POST) se han probado con un registro real y el conector los ha procesado correctamente.
• En entornos multiempresa: hay una conexión y sus métodos por cada empresa de Sage 200.

---