Installare PrestaShop

Prerequisiti

Prima di iniziare l'installazione, si assicuri che:

• Stia utilizzando PrestaShop 1.6 o versione successiva — sono supportate tutte le versioni dalla 1.6 fino alle più recenti release 8.x e 9.x (si consiglia di mantenere il suo negozio aggiornato)
• Disponga dell'accesso al back office di amministrazione
• Il suo sito sia accessibile tramite HTTPS

Generare una chiave di accesso API in PrestaShop

Per utilizzare l'API Webservice di PrestaShop con Order Invoicer, deve prima attivare la funzionalità e poi generare una chiave di accesso sicura.

1. Attivare il Webservice

1. Acceda al back office di PrestaShop con le sue credenziali di amministratore
2. Vada su Parametri avanzati > Webservice (indicato come Web service su PrestaShop 1.6)
3. Attivi l'opzione Abilita il webservice di PrestaShop selezionando "Sì"
4. Clicchi su Salva per applicare le modifiche

Importante: l'attivazione del webservice è necessaria affinché Order Invoicer possa recuperare i suoi ordini e i dati dei clienti.

2. Creare una chiave di accesso sicura

1. Sempre in Parametri avanzati > Webservice, clicchi su Aggiungi nuova chiave webservice
2. Configuri la chiave con le seguenti impostazioni:

Configurazione di base

• Chiave: clicchi su Genera per ottenere una chiave univoca di 32 caratteri (oppure ne inserisca una personalizzata)
• Descrizione della chiave: aggiunga una descrizione chiara (ad es. "Order Invoicer - Integrazione Sellsy")
• Stato: attivi la chiave selezionando "Abilitata"

Permessi richiesti

Order Invoicer verifica questi permessi alla connessione e rifiuta la configurazione se ne manca qualcuno. Selezioni almeno Visualizza (GET) per ciascuna delle risorse seguenti:

• ✅ addresses — indirizzi di fatturazione e spedizione
• ✅ carriers — corrieri utilizzati negli ordini
• ✅ combinations — combinazioni di prodotti (taglie, colori, ecc.)
• ✅ countries — paesi degli indirizzi dei clienti
• ✅ currencies — valute degli ordini
• ✅ customers — clienti
• ✅ order_details — righe degli ordini
• ✅ order_payments — pagamenti degli ordini
• ✅ order_slip — note di credito / rimborsi
• ✅ orders — ordini
• ✅ products — prodotti
• ✅ shops — negozi (necessario per identificare la sua installazione)
• ✅ taxes — imposte applicate agli ordini

Suggerimento: nella schermata di PrestaShop, utilizzi il link Seleziona tutto in cima alla colonna Visualizza (GET) per risparmiare tempo, quindi deselezioni solo le risorse a cui non desidera dare accesso.

Permessi opzionali

Necessari solo se utilizza queste funzionalità:

• stock_availables — Visualizza + Modifica (PUT) se sincronizza lo stock dal suo strumento di fatturazione a PrestaShop
• customer_threads, customer_messages, contacts — Visualizza + Aggiungi (POST) se desidera che Order Invoicer crei ticket di assistenza clienti in occasione di eventi di fatturazione
• groups — Visualizza (GET) se utilizza i gruppi di clienti PrestaShop come griglie tariffarie e desidera sincronizzarli sui suoi clienti (mostrati sugli ordini). Senza questo permesso la sincronizzazione funziona comunque — i gruppi vengono semplicemente omessi.
• tax_rule_groups, tax_rules — Visualizza (GET) per registrare l'aliquota IVA effettivamente applicata dal suo negozio, invece di dedurla dagli importi dell'ordine. Senza questi permessi la sincronizzazione funziona comunque — l'aliquota viene dedotta dai totali.

Configurazione multistore (se applicabile)

• Associazione negozio: in modalità multistore, scelga i negozi a cui la chiave dà accesso
• Se ha più negozi, selezioni solo quelli che desidera collegare

3. Clicchi su Salva per creare la chiave

3. Recuperare i dettagli di connessione

Dopo aver creato la chiave, prenda nota dei seguenti dettagli:

• L'URL del suo negozio: https://your-store.com
• Chiave API: la chiave generata (32 caratteri)

Importante: conservi queste informazioni in modo sicuro. Le serviranno per configurare il connettore in Order Invoicer.

Verificare la configurazione

Test dell'API

Per verificare che la sua chiave funzioni, richieda una singola risorsa con essa — passi la chiave nel parametro di query ws_key:

https://your-store.com/api/orders?ws_key=YOUR_KEY&limit=1

Dovrebbe ottenere una risposta XML contenente un ordine. Se ottiene:

• 401 o 403: la chiave è disattivata oppure non dispone del permesso Visualizza (GET) su quella risorsa — verifichi nuovamente lo stato della chiave e i suoi permessi.
• Un errore su https://your-store.com/api/ (la radice): questo da solo non significa che la chiave sia difettosa. In molte installazioni la radice del webservice restituisce un errore 500 o una pagina HTML anche quando gli endpoint delle singole risorse funzionano correttamente, quindi provi sempre una risorsa specifica come mostrato sopra anziché il semplice URL /api/.

Risoluzione dei problemi comuni

Errore "Webservice non abilitato"

• Verifichi che il webservice sia abilitato in Parametri avanzati
• Riavvii la cache di PrestaShop se necessario

Errore "Chiave API non valida"

• Verifichi che la chiave sia composta esattamente da 32 caratteri
• Si assicuri che la chiave sia attiva
• Verifichi i permessi concessi

Errore "Accesso negato"

• Verifichi che l'URL del suo negozio sia corretto
• Si assicuri che il suo sito sia accessibile tramite HTTPS
• Verifichi i permessi della chiave API

Errore "Permessi mancanti: …" Order Invoicer indica esattamente quali risorse mancano. Torni alla chiave del webservice e selezioni Visualizza (GET) per ciascuna delle risorse elencate, quindi riavvii la configurazione.

Assistenza

Se incontra difficoltà:

1. Consulti la sezione sulla risoluzione dei problemi qui sopra
2. Consulti la documentazione ufficiale di PrestaShop
3. Contatti la nostra assistenza: contact@orderinvoicer.com

Passaggi successivi

Una volta configurata la chiave e creato il connettore in Order Invoicer:

• Installi il modulo PrestaShop per una sincronizzazione degli ordini quasi istantanea (opzionale).
• Disattivi le fatture di PrestaShop affinché il suo strumento di fatturazione gestisca la numerazione delle fatture.