Connettore Sellsy PrestaShop – Documentazione
Installare, connettere e sincronizzare PrestaShop con Sellsy tramite l'API v2.
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
- Nel back-office di PrestaShop, vai su Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e carica il file
dfsellsy.zip. - 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.
- In Sellsy, apri Menu > Impostazioni > Portale sviluppatori.
- Nella scheda API V2, clicca su Crea accesso API.
- Scegli il collaboratore collegato all’accesso (preferibilmente un amministratore, per disporre di tutti i diritti) e seleziona gli scope necessari (clienti, documenti, catalogo, pagamenti).
- 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.