Questa guida vi accompagna da zero a un negozio Shopify collegato a Dolibarr, con una licenza attiva e le sincronizzazioni impostate. Corrisponde a Doli2Shop 2.6.3 e alle versioni successive. Calcolate un'ora, di cui dieci minuti su Shopify. Le schermate mostrano un negozio dimostrativo fittizio: i nomi, i domini e i numeri che vedrete nel vostro sistema saranno i vostri.

I passaggi, in ordine:

  1. i prerequisiti;
  2. l'installazione del pacchetto e l'attivazione del modulo;
  3. il collegamento del negozio Shopify;
  4. la licenza;
  5. la procedura guidata di configurazione;
  6. il senso della sincronizzazione;
  7. lo stock (reale o virtuale) e la posizione Shopify;
  8. le attività pianificate;
  9. i controlli finali;
  10. che cosa succede quando la licenza termina.

1. Prerequisiti

Elemento Requisito
Dolibarr versione da 18 a 24
PHP 7.4 come minimo. Il limite massimo dipende dal vostro Dolibarr: al massimo PHP 8.1 con Dolibarr 18, al massimo PHP 8.5 con Dolibarr 23 e 24
Database MySQL 5.7 o successivo, oppure MariaDB 10.3 o successivo
Indirizzo di Dolibarr in HTTPS (obbligatorio: Shopify rifiuta di rimandare la connessione a un indirizzo HTTP)
Account Dolibarr un account amministratore: le schermate del modulo gli sono riservate
Shopify un negozio e un account autorizzato a installarvi un'applicazione
Pianificatore il modulo Dolibarr «Processi pianificati» attivo, con il suo innesco di sistema in funzione (vedere la sezione 8)

Doli2Shop si appoggia ai moduli Dolibarr Prodotti, Terze parti, Ordini cliente, Magazzino e Categorie: Dolibarr li attiva insieme a lui se non lo sono già.

2. Installare il pacchetto e attivare il modulo

Avete ricevuto un file .zip (e-mail di conferma DoliStore). Ci sono due modi per installarlo.

Da Dolibarr. Andate in Home → Impostazioni → Moduli/Applicazioni, aprite la scheda Trova app/moduli esterni... e rilasciate il file .zip. Se Dolibarr rifiuta (installazione dall'applicazione bloccata, o cartella custom non dichiarata), usate il secondo modo.

A mano. Decomprimete l'archivio nella cartella htdocs/custom/ del vostro server: dovete ottenere htdocs/custom/doli2shop/. Il file conf/conf.php di Dolibarr deve dichiarare questa cartella:

$dolibarr_main_url_root_alt='/custom';
$dolibarr_main_document_root_alt='/percorso/verso/htdocs/custom';

Poi attivate il modulo:

  1. Tornate in Home → Impostazioni → Moduli/Applicazioni.
  2. Digitate doli2shop nel campo di ricerca.
  3. Sulla scheda del modulo, portate l'interruttore su «attivo».
  4. Fate clic sull'icona a forma di ingranaggio della scheda per aprire la configurazione.

Il modulo non ha una voce nel menu di sinistra di Dolibarr: l'ingranaggio di questo elenco è sempre il vostro punto d'ingresso. Arrivate a una barra di schede; la prima è Assistente.

3. Collegare il negozio Shopify

Potete collegare il negozio in due modi che portano allo stesso risultato: dalla scheda Assistente (passaggio 1) oppure dalla scheda Negozi.

Procedura guidata, passaggio 1, prima del collegamento

Prima del collegamento, il passaggio 1 mostra Non connesso e il pulsante Connetti il mio negozio Shopify. Nella scheda Negozi, il pulsante equivalente si chiama Connetti un negozio (via Shopify).

Elenco dei negozi, un negozio collegato

  1. Fate clic sul pulsante. Se il vostro Dolibarr non è in HTTPS, il modulo rifiuta e lo dice: correggete l'indirizzo ($dolibarr_main_url_root in conf/conf.php) prima di riprovare.
  2. Lasciate Dolibarr per una pagina di doli2shop.ptitetete.org che annuncia quattro passaggi. Fate clic su «Installa Doli2Shop».
  3. Su Shopify: accedete al vostro account, scegliete il negozio se ne avete più di uno, leggete i permessi richiesti e approvateli. Shopify mostra questi permessi da sé; verificate che l'indirizzo del browser sia davvero quello di Shopify prima di approvare. L'applicazione è presentata anche su https://apps.shopify.com/doli2shop.
  4. Shopify vi rimanda automaticamente a Dolibarr. Il modulo registra le credenziali del negozio, individua la sua posizione di stock e registra i webhook (le notifiche che Shopify invia a Dolibarr). Un messaggio «Connesso con successo a il-vostro-negozio.myshopify.com!» lo conferma.

Per verificare: nella scheda Negozi, il negozio è elencato con il suo dominio Shopify; nella procedura guidata, il passaggio 1 mostra Connesso a seguito dal dominio, con la data di connessione e l'identificativo della posizione. Per ricollegare un negozio (token scaduto, permessi cambiati), usate il pulsante di riconnessione della stessa riga o del passaggio 1: la configurazione già fatta viene conservata.

4. Attivare la licenza

La licenza si gestisce negozio per negozio.

Scheda del negozio, sottoscheda Licenza

  1. Nella scheda Negozi, fate clic su Modifica sulla riga del negozio, poi sulla sottoscheda Licenza.
  2. Sotto Attiva una licenza DoliStore, inserite il vostro numero seriale, nel formato SI-YYYY-XXXX-XXXX (quello dell'e-mail di conferma DoliStore; le lettere diventano maiuscole automaticamente), poi fate clic su Attiva questa licenza. Il modulo ha bisogno del dominio Shopify del negozio: un negozio non ancora collegato (sezione 3) non può ricevere una licenza.
  3. Il messaggio «Licenza DoliStore attivata con successo» conferma l'attivazione e Stato licenza passa a Licenza valida.
  4. In qualsiasi momento, Verifica ora interroga il server delle licenze e aggiorna lo stato e la data dell'ultimo controllo.

Da sapere:

  • Prova. Una prova è un numero seriale SI-… di breve durata, rilasciato dal manutentore: si attiva esattamente come una licenza normale e termina come essa (sezione 10).
  • Negozio predefinito. Il primo negozio collegato è il negozio predefinito. Finché il server delle licenze non annuncia una data di arresto, non è bloccato: la schermata Salute lo mostra come Esente (negozio predefinito) e questa sottoscheda riporta la dicitura mai bloccata. Leggete questa dicitura insieme alla sezione 10: superata la data di arresto annunciata dal server, il negozio predefinito si ferma come gli altri.
  • Edizione Community. L'edizione Community, gratuita e pubblicata con licenza libera, non contiene alcun sistema di licenza: funziona senza chiave, la schermata Salute mostra Edizione Community (gratuita) e il supporto tecnico è riservato ai soci.
  • Server delle licenze irraggiungibile. Il modulo mostra Impossibile verificare la licenza in questo momento e riprova da solo. Per il negozio predefinito, la sincronizzazione continua finché l'ultimo controllo riuscito risale a meno di 14 giorni (termine predefinito); trascorso questo termine, si ferma fino al ritorno del server. Un negozio secondario viene sincronizzato solo quando la sua licenza ha potuto essere verificata: un'interruzione prolungata del server lo mette in pausa, poi riprende da solo.
  • Mai verificata. Un negozio predefinito la cui licenza non ha mai potuto essere verificata con successo non viene bloccato, anche se il server resta irraggiungibile.

5. La procedura guidata di configurazione

La scheda Assistente ha sei passaggi. Ricorda il passaggio a cui eravate, e un pulsante permette di ricominciare dall'inizio.

Passaggio Titolo Che cosa vi si imposta
1 Connessione Shopify il collegamento descritto nella sezione 3
2 Configurazione Dolibarr Magazzino predefinito e Utente CRON / Webhook (obbligatori), poi Categoria clienti Shopify e Mappatura tipo terza parte B2B/B2C
3 Ordini il prefisso degli ordini, il termine di consegna, Origine ordine, Condizioni di pagamento, il conto bancario per i pagamenti e i trattamenti automatici (bolle di spedizione, fatture, pagamenti)
4 Spedizione Mappatura dei metodi di spedizione, per negozio
5 Pagamento Mappatura metodi di pagamento, per negozio
6 Attivazione il controllo finale, l'attivazione dei webhook e delle attività pianificate

Punti di attenzione:

  • Al passaggio 2 il magazzino è indispensabile: senza magazzino predefinito, lo stock non viene scalato quando arriva un ordine Shopify, e nulla ve lo segnala. Queste impostazioni sono comuni a tutti i negozi; si modificano solo dal negozio predefinito.
  • Ai passaggi 4 e 5, le corrispondenze sono proprie di ciascun negozio. Se ne avete più di uno, scegliete prima il negozio nel selettore Configura negozio, poi impostate le sue corrispondenze.
  • Al passaggio 6, il modulo controlla la connessione, il magazzino e l'utente, e mostra Webhook registrati e CRON attivi. I pulsanti Attivare i webhook e Attivare i CRON correggono un contatore incompleto; Terminare la configurazione chiude la procedura segnalando ciò che manca ancora.

6. Il senso della sincronizzazione

La scheda Direzioni di sincronizzazione decide, tipo di dati per tipo di dati, chi scrive presso chi.

Schermata Direzioni di sincronizzazione

Le prime cinque righe (Sincronizzazione prodotti, Sincronizzazione ordini, Sincronizzazione pagamenti, Sincronizzazione spedizioni e Sincronizzazione stock) si impostano con un senso: Shopify verso Dolibarr, Dolibarr verso Shopify o Bidirezionale. Nessuna sincronizzazione è proposta di default solo per i prodotti; per ordini, pagamenti, spedizioni e stock compare solo se questa impostazione è già salvata. La sesta riga, Strategia di risoluzione dei conflitti, non è un senso: propone cinque strategie per decidere quale lato prevale quando lo stesso dato è cambiato su entrambi (priorità a Shopify, a Dolibarr, alla modifica più recente, alla più vecchia, o risoluzione manuale).

Che cosa sapere prima di salvare:

  • Gli stock: finché nulla è stato salvato in questa schermata, il senso mostrato e applicato è Dolibarr verso Shopify. Dolibarr è il riferimento dello stock (rifornimenti, produzione, inventario) e Shopify non vi scrive.
  • I prodotti: non c'è alcun senso preselezionato. L'elenco mostra Seleziona direzione di sincronizzazione: scegliete un senso, poi salvate. Finché non ne scegliete uno, nessuno viene salvato.
  • Ordini, pagamenti, spedizioni: funziona solo il senso Shopify verso Dolibarr. Il senso Dolibarr verso Shopify non è ancora implementato per questi tre tipi: un'impostazione che lo include viene salvata ma resta senza effetto, e la schermata lo annuncia con un avviso. Per le spedizioni, il senso mostrato per impostazione predefinita è Bidirezionale: scegliete Shopify verso Dolibarr.
  • I pagamenti e le spedizioni dipendono dagli ordini: non interrompete la sincronizzazione degli ordini se volete le altre.

Fate clic su Salva in fondo alla schermata per convalidare le sei righe.

7. Stock reale o virtuale, posizione Shopify

Queste impostazioni sono proprie di ciascun negozio: scegliete prima il negozio interessato nel selettore di negozio mostrato in cima alla schermata.

Reale o virtuale. Nella scheda Sincronizzazione prodotti, la casella Sincronizza scorte attiva l'invio dello stock a Shopify. La casella Usa Stock Virtuale per Shopify, che si può spuntare solo se la prima lo è, invia a Shopify lo stock virtuale (stock reale, meno gli ordini dei clienti, più gli ordini ai fornitori) invece dello stock reale. Lo stock virtuale è consigliato: evita di vendere ciò che è già promesso.

Posizione. Shopify gestisce lo stock per posizione. Il modulo individua la posizione al momento del collegamento (sezione 3). Per verificarla o cambiarla: scheda Negozi, Modifica sulla riga del negozio, sottoscheda Spedizione, campo ID posizione Shopify. L'identificativo si legge nell'amministrazione di Shopify, nelle impostazioni delle posizioni.

8. Le attività pianificate

Doli2Shop lavora soprattutto con le attività pianificate di Dolibarr. Si trovano in Home → Strumenti di amministrazione → Processi pianificati; filtrate sul modulo doli2shop.

Attività pianificate del modulo

Dolibarr esegue queste attività solo se il suo pianificatore viene a sua volta innescato regolarmente (una riga di crontab sul server). Il comando da usare è mostrato nella configurazione del modulo «Processi pianificati» (ingranaggio della sua scheda, nell'elenco dei moduli). Senza questo innesco non gira nulla, anche se le attività sono «pianificate».

Attive fin dall'installazione:

Attività Ruolo
Doli2ShopWebhookProcess elabora i webhook ricevuti da Shopify
Doli2ShopOrdersCatchup recupera gli ordini che un webhook potrebbe aver perso
Doli2ShopFulfillmentCatchup recupera le spedizioni perse
Doli2ShopStockPushQueueProcess invia a Shopify le variazioni di stock
Doli2ShopTokenRefresh rinnova il token di connessione prima della scadenza
Doli2ShopWebhookHealthCheck controlla i webhook e li registra di nuovo se necessario
Doli2ShopHeartbeat invio giornaliero delle metriche del modulo

Attività dei prodotti. Doli2ShopProductsExport e Doli2ShopProductsImport sono inattive all'installazione. Dalla versione 2.6.3, salvare il senso dei prodotti (sezione 6) imposta queste due attività secondo il senso scelto, per i negozi collegati e con licenza. Succede solo quando lo stato atteso cambia, e un'attività che avete messo in pausa di proposito non viene mai riattivata. Dopo il salvataggio, verificate il loro stato nell'elenco delle attività pianificate: la schermata mostra un negozio dimostrativo collegato e con licenza dove sono già pianificate.

Da attivare a mano secondo le necessità (inattive all'installazione):

Attività Da attivare se
Doli2ShopOrdersHistoricalImport importate lo storico degli ordini di un negozio già in servizio
Doli2ShopHistoricalCleanup avete avviato questa importazione storica (pulizia successiva)
Doli2ShopAlertCheck volete avvisi via e-mail in caso di errori ripetuti

9. Verificare l'installazione

La scheda Salute & Diagnostica raccoglie i controlli. Comprende in particolare Riepilogo per negozio (connessione, webhook attivi, stato della licenza di ciascun negozio), Verifiche di sistema, Stato del modulo, Connettività API Shopify e Attività pianificate. Un indicatore colorato sulla scheda segnala un peggioramento.

Passatela in rassegna dopo l'installazione: connessione Shopify riuscita, webhook attivi, attività attive, nessun diritto mancante. In caso di dubbio, la procedura «Inviare al supporto il registro del modulo e le esportazioni JSON» (https://doli2shop.ptitetete.org/it/documentation/support-export) vi dice che cosa trasmetterci.

Per collegare il modulo a un Dolibarr già popolato (prodotti, terze parti e ordini esistenti), seguite la «Procedura di messa in produzione» (https://doli2shop.ptitetete.org/it/documentation/go-live) prima di attivare le sincronizzazioni.

10. Quando la licenza termina

Quanto segue descrive il negozio predefinito. Un negozio secondario non ha periodo di tolleranza: viene sincronizzato solo finché la sua licenza è valida, e la sua sincronizzazione si ferma non appena non lo è più.

  1. Licenza scaduta: modalità degradata. Il modulo mostra La tua licenza è scaduta!. La sincronizzazione continua a funzionare, ma supporto e download sono disabilitati.
  2. Sessanta giorni di tolleranza. Dopo la scadenza, la sincronizzazione prosegue ancora per 60 giorni. Il modulo mostra allora La sincronizzazione si interromperà a breve e, quando il server delle licenze fornisce la data, il giorno in cui tutto si fermerà. Senza questa data, nessun giorno di arresto viene mostrato.
  3. Arresto. Superata la data, compare Sincronizzazione interrotta (licenza): tutta la sincronizzazione con Shopify si ferma, compreso il recupero degli ordini. I vostri ordini Shopify non arrivano più in Dolibarr finché la licenza non viene rinnovata.

Rinnovate la licenza prima dell'arresto: la sincronizzazione riprende non appena la nuova licenza è attivata (sezione 4). Se nessuna licenza è mai stata collegata a un negozio, il modulo lo indica con Nessuna licenza è collegata a questo negozio.

← Torna alla documentazione