# Connettore Axonaut PrestaShop — Documentazione > Il modulo Connettore Axonaut PrestaShop (dfaxonaut, di DataFirefly) sincronizza automaticamente clienti, ordini e prodotti tra PrestaShop e Axonaut, il software di gestione francese (CRM, fatturazione, preventivi, tesoreria). Questa guida copre… - Pagina: - Lingua: it - Aggiornato il: 2026-07-06 - Altre lingue: [fr](https://www.datafirefly.com/documentation/connecteur-axonaut-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/connecteur-axonaut-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/connecteur-axonaut-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/connecteur-axonaut-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/connecteur-axonaut-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/connecteur-axonaut-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-axonaut-prestashop/index.md) - Indice: Il modulo **Connettore Axonaut PrestaShop** (dfaxonaut, di DataFirefly) sincronizza automaticamente clienti, ordini e prodotti tra PrestaShop e Axonaut, il software di gestione francese (CRM, fatturazione, preventivi, tesoreria). Questa guida copre installazione, configurazione, funzionamento delle sincronizzazioni e risoluzione dei problemi. ## Requisiti - PrestaShop 8.x o 9.x, PHP 7.4 fino a 8.3. - Un account Axonaut attivo con accesso all'API v2. - La tua chiave API Axonaut (userApiKey), disponibile in Axonaut in _Impostazioni > Sviluppatori > Chiave API_. ## Installazione 1. Nel back-office di PrestaShop, apri _Moduli > Gestore moduli > Carica un modulo_ e trascina il file ZIP del modulo. 2. Una volta installato, clicca su _Configura_. 3. Sotto _Parametri avanzati_ compare anche una nuova scheda _Axonaut Connector_: dà accesso alla dashboard e ai log. Il modulo non installa alcuna dipendenza Composer al deploy: l'autoloader PSR-4 è integrato. Non serve nient'altro lato server. ## Configurazione ### Chiave API e test di connessione Incolla la tua chiave API Axonaut nel campo _Chiave API Axonaut_ e salva. Poi vai nella dashboard (_Parametri avanzati > Axonaut Connector_) e clicca su _Testa connessione_: il modulo interroga l'endpoint /me di Axonaut e mostra l'account associato se tutto è corretto. ### Sincronizzazione dei clienti Attiva _Sincronizza clienti_ affinché ogni creazione di account, aggiornamento dell'account o modifica dell'indirizzo crei o aggiorni un'azienda Axonaut insieme al suo contatto. Il modulo rileva automaticamente i professionisti (ragione sociale o partita IVA intracomunitaria indicata) e i privati (B2C), e trasmette l'indirizzo, la partita IVA intracomunitaria e il numero azienda quando disponibili. ### Sincronizzazione degli ordini Attiva _Sincronizza ordini_, poi scegli: - **Modalità**: creare una _fattura_ o un _preventivo_ Axonaut. - **Stati attivatori**: l'ordine viene inviato la prima volta che raggiunge uno degli stati selezionati (ad esempio «Pagamento accettato»). - **Prezzi IVA inclusa**: inviare i prezzi unitari IVA inclusa anziché IVA esclusa. Ogni ordine inviato riporta le righe prodotto (riferimento, aliquota IVA, quantità) e aggiunge le spese di spedizione in una riga dedicata. Un ordine già inviato non viene mai duplicato. ### Sincronizzazione dei prodotti (opzionale) Attiva _Sincronizza prodotti_ per rispecchiare il tuo catalogo (riferimento, nome, prezzo, IVA, descrizione breve) nei prodotti Axonaut. La sincronizzazione si attiva a ogni aggiornamento di una scheda prodotto. ## Attività cron Le sincronizzazioni vengono messe in coda ed elaborate in background. Un leggero tentativo inline viene eseguito al volo all'interno degli hook, ma per un funzionamento affidabile pianifica l'attività cron mostrata nella configurazione: ``` curl -s "https://il-tuo-negozio.tld/index.php?fc=module&module=dfaxonaut&controller=cron&token=IL_TUO_TOKEN" ``` Frequenza consigliata: ogni 5-15 minuti. Il cron elabora la coda, ripulisce gli elementi completati (7 giorni) e i log vecchi (30 giorni). Il token può essere rigenerato dalla pagina di configurazione. Se rigeneri il token, ricordati di aggiornare l'URL nel tuo pianificatore (cron del server, attività PrestaShop o servizio esterno). ## Dashboard e log La scheda _Axonaut Connector_ mostra i contatori (in attesa / sincronizzati / falliti) e il log completo delle operazioni, filtrabile ed esportabile. Sono disponibili due azioni: - **Elabora la coda ora**: forza l'elaborazione immediata degli elementi in attesa. - **Riprova i falliti**: rimette in coda gli elementi falliti dopo 5 tentativi. ## Come funzionano la coda e i retry Ogni entità da sincronizzare (cliente, ordine, prodotto) viene messa in una coda. In caso di errore temporaneo (rete, quota API), il modulo riprova automaticamente fino a 5 volte, poi segna l'elemento come fallito. Gli errori vengono registrati con il loro messaggio, il che facilita la diagnosi. La modalità debug aggiunge ai log i payload e le risposte completi dell'API. ## Risoluzione dei problemi - **«Chiave API vuota»**: inserisci la chiave nella configurazione prima di testare la connessione. - **Errore HTTP 401/403**: la chiave API non è valida o è stata revocata. Rigenerala in Axonaut. - **Ordini non inviati**: verifica che lo stato raggiunto sia tra gli stati attivatori e che la sincronizzazione degli ordini sia attiva. - **Elementi falliti**: apri il log per leggere il messaggio di errore, correggi la causa, poi clicca su _Riprova i falliti_. - **Nulla si sincronizza in background**: verifica che l'attività cron sia pianificata e che il token dell'URL corrisponda a quello della configurazione. ## Note tecniche - API utilizzata: Axonaut REST API v2, autenticazione tramite l'header userApiKey. - Endpoint: /me, /companies, /companies/{id}/employees, /employees/{id}, /products, /invoices, /quotations. - Tabelle create: dfaxonaut_map (corrispondenze PrestaShop ↔ Axonaut), dfaxonaut_queue (coda), dfaxonaut_log (log). - Compatibile con il multistore di PrestaShop.