Documentazione

Guida completa all'installazione e all'uso di Doli2Shop

Installazione

Prerequisiti

  • PHP : 7.2.5 - 8.4.x
  • Dolibarr : 18.0 - 23.x (18 LTS maintenu jusqu'à fin de son cycle LTS Dolibarr, estimé mi-2027)
  • Estensioni PHP richieste : cURL, JSON

Passaggi di installazione

  1. Scaricare il modulo

    Scarica l'ultima versione dal Shopify App Store o DoliStore.

  2. Estrarre nella cartella moduli htdocs/custom/shopifyintegration/
  3. Attivare il modulo

    Vai su Home → Impostazioni → Moduli e attiva Doli2Shop.

Configurazione

Connessione API

Inserisci le credenziali di connessione al tuo negozio Shopify.

votre-boutique.myshopify.com
Disponibile nella tua app Shopify
Disponibile nella tua app Shopify
Disponibile nella tua app Shopify

API Shopify

Creare un'applicazione Shopify

  1. Accedi al tuo admin Shopify
  2. Vai su Impostazioni → App e canali di vendita
  3. Clicca su Sviluppa app
  4. Crea una nuova app e configura gli scope API

Permessi richiesti

  • read_products - Lettura prodotti
  • write_products - Scrittura prodotti
  • read_inventory - Lettura inventario
  • write_inventory - Scrittura inventario
  • read_orders - Lettura ordini
  • read_customers - Lettura clienti

Sincronizzazione

Prodotti

I prodotti vengono sincronizzati automaticamente tra Dolibarr e Shopify, incluse varianti, immagini e prezzi.

D → S Dolibarr verso Shopify

Inventario

I livelli di stock vengono aggiornati in tempo reale su entrambe le piattaforme. Supporta stock virtuale e reale.

Attività pianificate (CRON)

Due attività CRON garantiscono la sincronizzazione automatica:

  • Sincronizzazione in tempo reale : 15 minuti
  • Sincronizzazione storica : 30 minuti

Ordini

Nota : Gli ordini vengono importati solo da Shopify a Dolibarr.

Dati importati

  • Cliente e indirizzi di spedizione/fatturazione
  • Righe ordine (prodotti, quantità, prezzi)
  • Metodo e costi di spedizione
  • Codici promozionali e sconti
  • Tasse e IVA

Risoluzione problemi

Errore di connessione all'API Shopify

Verifica che le tue credenziali API siano corrette e che il tuo negozio Shopify sia accessibile. Assicurati che le estensioni PHP cURL e JSON siano installate.

La sincronizzazione non funziona

Verifica che le attività CRON siano configurate correttamente in Dolibarr (Home → Impostazioni → Attività pianificate). Controlla i log nella diagnostica del modulo.

Differenza di stock tra Shopify e Dolibarr

Esegui una sincronizzazione completa dalla pagina di manutenzione del modulo. Verifica che il tipo di stock (virtuale/reale) sia configurato correttamente.