# Connettore Sellsy PrestaShop – Documentazione > Guida completa al connettore Sellsy per PrestaShop 8 e 9: installazione, creazione dell'accesso API Sellsy v2, configurazione, sincronizzazione di clienti, ordini, fatture, pagamenti e note di credito, cron e risoluzione dei problemi. - Pagina: - Lingua: it - Aggiornato il: 2026-07-06 - Altre lingue: [fr](https://www.datafirefly.com/documentation/connecteur-sellsy-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/connecteur-sellsy-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/connecteur-sellsy-prestashop/index.md), [de](https://www.datafirefly.com/de/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) - Indice: ## Panoramica Il connettore Sellsy di DataFirefly collega il tuo negozio PrestaShop a **Sellsy**, la soluzione SaaS francese di CRM, fatturazione e gestione. Sincronizza automaticamente clienti, prodotti, ordini, fatture, pagamenti e note di credito da PrestaShop a Sellsy tramite l'**API Sellsy v2**. La sincronizzazione è unidirezionale: PrestaShop → Sellsy. Compatibile con PrestaShop da 8.0 a 9.x, multi-negozio. Interfaccia di amministrazione in francese e inglese. ## Installazione 1. Nel back-office di PrestaShop, vai su _Moduli > Gestore dei moduli_. 2. Clicca su _Carica un modulo_ e carica il file `dfsellsy.zip`. 3. Una volta installato, clicca su _Configura_. Il modulo crea due tabelle (`dfsellsy_link` per la corrispondenza PrestaShop ↔ Sellsy, `dfsellsy_log` per il registro) e una scheda «Sellsy Connector» nel menu Moduli. ## Creare l'accesso API in Sellsy Il connettore utilizza l'autenticazione OAuth2 (client credentials) dell'API v2. 1. In Sellsy, apri _Menu > Impostazioni > Portale sviluppatori_. 2. Nella scheda _API V2_, clicca su _Crea accesso API_. 3. Scegli il collaboratore collegato all'accesso (preferibilmente un amministratore, per disporre di tutti i diritti) e seleziona gli scope necessari (clienti, documenti, catalogo, pagamenti). 4. Salva e copia il **Client ID** e il **Client Secret**. Il Client Secret viene mostrato una sola volta. Conservalo in un luogo sicuro prima di lasciare la pagina di Sellsy. ## Configurazione del modulo Nella pagina di configurazione del modulo, inserisci: - **Client ID** e **Client Secret**: le credenziali OAuth2 create in Sellsy. Lascia vuoto il campo secret per mantenere il valore già salvato. - **Sincronizza i clienti**: crea/aggiorna un contatto Sellsy alla registrazione e all'aggiornamento di un cliente. - **Sincronizza gli ordini**: trasforma gli ordini in documenti Sellsy. - **Tipo di documento Sellsy per gli ordini**: fattura o ordine di vendita. - **Attivazione della sincronizzazione degli ordini**: alla conferma del pagamento o alla convalida dell'ordine. - **Convalida i documenti Sellsy**: convalida automaticamente fatture e note di credito dopo la creazione (altrimenti restano come bozze in Sellsy). - **Registra i pagamenti**: registra i pagamenti PrestaShop sulla fattura Sellsy (solo per il tipo fattura). - **Sincronizza i rimborsi come note di credito**: crea una nota di credito Sellsy per ogni nota di credito PrestaShop e la collega alla fattura di origine. - **Sincronizza i prodotti**: invia il catalogo agli item di Sellsy. Usa il pulsante _Prova la connessione API_ per verificare le credenziali prima di attivare le sincronizzazioni. ## Sincronizzazione dei clienti Alla registrazione o all'aggiornamento di un cliente, il modulo crea o aggiorna un contatto Sellsy. I clienti con il campo «azienda» compilato diventano **aziende** Sellsy (con il SIRET se disponibile), gli altri **privati**. Una ricerca per e-mail evita i duplicati e l'indirizzo di fatturazione principale viene inviato alla creazione. ## Sincronizzazione degli ordini In base all'attivazione scelta, un ordine convalidato o pagato diventa un documento Sellsy con le righe prodotto, le spese di spedizione e gli sconti del carrello (come riga negativa). Le aliquote IVA di PrestaShop vengono automaticamente associate alle imposte di Sellsy. Ogni ordine viene sincronizzato una sola volta (idempotenza). ## Fatture, convalida e pagamenti Quando il tipo di documento è «fattura»: - se l'opzione _Convalida i documenti_ è attiva, la fattura viene convalidata automaticamente dopo la creazione; - se l'opzione _Registra i pagamenti_ è attiva, ogni pagamento PrestaShop viene registrato sulla fattura, senza duplicati, inclusi i pagamenti parziali o multipli; - se l'ordine è stato creato alla convalida e il pagamento arriva più tardi, il modulo registra solo i nuovi pagamenti sulla fattura esistente. ## Note di credito sui rimborsi Alla generazione di una nota di credito PrestaShop, il modulo crea una nota di credito Sellsy dalle righe rimborsate (prodotti e spedizione), la convalida se l'opzione è attiva e la collega alla fattura di origine quando questa esiste in Sellsy. ## Sincronizzazione dei prodotti La sincronizzazione dei prodotti è opzionale. Una volta attivata, i prodotti vengono inviati al catalogo Sellsy alla creazione e all'aggiornamento. Puoi anche avviare una sincronizzazione massiva dalla pagina «Sellsy Connector» (a lotti di 20). ## Attività pianificate (cron) Un cron integrato consente di recuperare ciò che gli hook in tempo reale hanno mancato. Pianifica gli URL mostrati nella pagina di configurazione: - `.../module/dfsellsy/cron?token=IL_TUO_TOKEN&job=orders` - `...&job=customers` - `...&job=products` - `...&job=retry` (riprova le entità in errore non ancora collegate) Il parametro `limit` (predefinito 20, max 100) controlla la dimensione del lotto per esecuzione. ## Registro di sincronizzazione La pagina «Sellsy Connector» mostra un registro filtrabile (per entità e stato) di ogni operazione, con il messaggio restituito da Sellsy in caso di errore. Un pulsante _Riprova errori_ ripete i fallimenti con un clic. ## Risoluzione dei problemi - **«Connessione non riuscita»**: verifica il Client ID / Client Secret e che gli scope necessari siano selezionati in Sellsy. - **Un errore su un campo di documento (HTTP 422)**: alcuni account Sellsy hanno requisiti specifici (menzioni e-invoicing, campi obbligatori). Consulta il messaggio del registro per identificare il campo. - **Contatti duplicati**: il modulo cerca per e-mail prima di creare; assicurati che l'e-mail del cliente sia compilata. - **Non si sincronizza nulla**: verifica che le opzioni interessate siano attive e prova la connessione API.