# Conector Sellsy PrestaShop – Documentación > Guía completa del conector Sellsy para PrestaShop 8 y 9: instalación, creación del acceso API Sellsy v2, configuración, sincronización de clientes, pedidos, facturas, pagos y abonos, cron y resolución de problemas. - Página: - Idioma: es - Actualizado el: 2026-07-06 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/connecteur-sellsy-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/connecteur-sellsy-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/connecteur-sellsy-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/connecteur-sellsy-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/connecteur-sellsy-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/connecteur-sellsy-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-sellsy-prestashop/index.md) - Índice: ## 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 1. En el back-office de PrestaShop, ve a _Módulos > Administrador de módulos_. 2. Haz clic en _Subir un módulo_ y sube el archivo `dfsellsy.zip`. 3. 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. 1. En Sellsy, abre _Menú > Ajustes > Portal de desarrollador_. 2. En la pestaña _API V2_, haz clic en _Crear acceso API_. 3. 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). 4. 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.