Conector Sellsy PrestaShop – Documentación
Instalar, conectar y sincronizar PrestaShop con Sellsy mediante la API v2.
Presentación
El conector Sellsy de DataFirefly vincula tu tienda PrestaShop con Sellsy, la solución SaaS francesa de CRM, facturación y gestión. Sincroniza automáticamente tus clientes, productos, pedidos, facturas, pagos y abonos de PrestaShop con Sellsy mediante la API Sellsy v2. La sincronización es unidireccional: PrestaShop → Sellsy.
Compatible con PrestaShop 8.0 a 9.x, multitienda. Interfaz de administración en francés e inglés.
Instalación
- En el back-office de PrestaShop, ve a Módulos > Administrador de módulos.
- Haz clic en Subir un módulo y sube el archivo
dfsellsy.zip. - Una vez instalado, haz clic en Configurar.
El módulo crea dos tablas (dfsellsy_link para la correspondencia PrestaShop ↔ Sellsy, dfsellsy_log para el registro) y una pestaña «Sellsy Connector» en el menú Módulos.
Crear el acceso API en Sellsy
El conector utiliza la autenticación OAuth2 (client credentials) de la API v2.
- En Sellsy, abre Menú > Ajustes > Portal de desarrollador.
- En la pestaña API V2, haz clic en Crear acceso API.
- Elige el colaborador vinculado al acceso (preferiblemente un administrador, para disponer de todos los derechos) y marca los scopes necesarios (clientes, documentos, catálogo, pagos).
- Guarda y copia el Client ID y el Client Secret.
El Client Secret solo se muestra una vez. Guárdalo en un lugar seguro antes de salir de la página de Sellsy.
Configuración del módulo
En la página de configuración del módulo, introduce:
- Client ID y Client Secret: las credenciales OAuth2 creadas en Sellsy. Deja el campo secreto vacío para conservar el valor ya guardado.
- Sincronizar clientes: crea/actualiza un tercero en Sellsy al registrar y actualizar un cliente.
- Sincronizar pedidos: convierte los pedidos en documentos Sellsy.
- Tipo de documento Sellsy para los pedidos: factura o pedido de venta.
- Desencadenante de sincronización de pedidos: en la confirmación del pago o en la validación del pedido.
- Validar los documentos Sellsy: valida automáticamente facturas y abonos tras su creación (de lo contrario permanecen como borradores en Sellsy).
- Registrar pagos: registra los pagos de PrestaShop en la factura Sellsy (solo en tipo factura).
- Sincronizar reembolsos como abonos: crea un abono Sellsy por cada abono de PrestaShop y lo vincula a la factura de origen.
- Sincronizar productos: envía el catálogo a los items de Sellsy.
Utiliza el botón Probar la conexión API para verificar tus credenciales antes de activar las sincronizaciones.
Sincronización de clientes
Al registrar o actualizar un cliente, el módulo crea o actualiza un tercero en Sellsy. Los clientes con el campo «empresa» relleno se convierten en empresas de Sellsy (con el SIRET si está disponible), los demás en particulares. Una búsqueda por correo evita los duplicados, y la dirección de facturación principal se envía al crear.
Sincronización de pedidos
Según el desencadenante elegido, un pedido validado o pagado se convierte en un documento Sellsy con las líneas de producto, los gastos de envío y los descuentos del carrito (como línea negativa). Las aliquotas de IVA de PrestaShop se hacen corresponder automáticamente con los impuestos de Sellsy. Cada pedido se sincroniza una sola vez (idempotencia).
Facturas, validación y pagos
Cuando el tipo de documento es «factura»:
- si la opción Validar los documentos está activa, la factura se valida automáticamente tras su creación;
- si la opción Registrar pagos está activa, cada pago de PrestaShop se registra en la factura, sin duplicados, incluidos los pagos parciales o múltiples;
- si el pedido se creó en la validación y el pago llega más tarde, el módulo registra únicamente los nuevos pagos en la factura existente.
Abonos por reembolso
Al generar un abono en PrestaShop, el módulo crea un abono Sellsy a partir de las líneas reembolsadas (productos y envío), lo valida si la opción está activa y lo vincula a la factura de origen cuando esta existe en Sellsy.
Sincronización de productos
La sincronización de productos es opcional. Una vez activada, los productos se envían al catálogo de Sellsy al crearlos y actualizarlos. También puedes lanzar una sincronización masiva desde la página «Sellsy Connector» (por lotes de 20).
Tareas programadas (cron)
Un cron integrado permite recuperar lo que los hooks en tiempo real hayan podido perder. Programa las URL mostradas en la página de configuración:
.../module/dfsellsy/cron?token=TU_TOKEN&job=orders...&job=customers...&job=products...&job=retry(reintenta las entidades en error aún no vinculadas)
El parámetro limit (por defecto 20, máx. 100) controla el tamaño del lote por ejecución.
Registro de sincronización
La página «Sellsy Connector» muestra un registro filtrable (por entidad y estado) de cada operación, con el mensaje devuelto por Sellsy en caso de error. Un botón Reintentar errores reproduce los fallos con un clic.
Resolución de problemas
- «Conexión fallida»: verifica el Client ID / Client Secret y que los scopes necesarios estén marcados en Sellsy.
- Un error en un campo de documento (HTTP 422): algunas cuentas de Sellsy tienen requisitos específicos (menciones de e-invoicing, campos obligatorios). Consulta el mensaje del registro para identificar el campo.
- Terceros duplicados: el módulo busca por correo antes de crear; asegúrate de que el correo del cliente esté relleno.
- No se sincroniza nada: comprueba que las opciones correspondientes estén activas y prueba la conexión API.