Axonaut Connector PrestaShop: volledige gids
De Axonaut-connector voor PrestaShop installeren en configureren: API-sleutel, klantsynchronisatie, facturen/offertes, producten, cron en probleemoplossing.
De module Axonaut Connector PrestaShop (dfaxonaut, uitgever DataFirefly) synchroniseert automatisch uw klanten, bestellingen en producten tussen PrestaShop en Axonaut, de Franse beheersoftware (CRM, facturatie, offertes, cashflow). Deze gids behandelt de installatie, de configuratie, de werking van de synchronisaties en de probleemoplossing.
Vereisten
- PrestaShop 8.x of 9.x, PHP 7.4 tot 8.3.
- Een actief Axonaut-account met toegang tot API v2.
- Uw Axonaut-API-sleutel (userApiKey), beschikbaar in Axonaut onder Instellingen > Ontwikkelaars > API-sleutel.
Installatie
- Open in de PrestaShop-backoffice Modules > Modulebeheer > Een module uploaden en upload het ZIP-bestand van de module.
- Klik na de installatie op Configureren.
- Er verschijnt ook een nieuw tabblad Axonaut Connector onder Geavanceerde instellingen: het geeft toegang tot het dashboard en de logboeken.
De module installeert geen enkele Composer-afhankelijkheid bij het uitrollen: de PSR-4-autoloader is ingebouwd. Er is niets anders nodig aan serverzijde.
Configuratie
API-sleutel en verbindingstest
Plak uw Axonaut-API-sleutel in het veld Axonaut API-sleutel en sla op. Ga vervolgens naar het dashboard (Geavanceerde instellingen > Axonaut Connector) en klik op Verbinding testen: de module bevraagt het /me-endpoint van Axonaut en toont het gekoppelde account als alles klopt.
Klantsynchronisatie
Schakel Klanten synchroniseren in zodat elke accountaanmaak, accountwijziging of adreswijziging een Axonaut-bedrijf met bijbehorend contact aanmaakt of bijwerkt. De module herkent automatisch professionals (bedrijfsnaam of intracommunautair btw-nummer ingevuld) en particulieren (B2C), en stuurt het adres, het intracommunautaire btw-nummer en het bedrijfsnummer door wanneer die beschikbaar zijn.
Bestellingssynchronisatie
Schakel Bestellingen synchroniseren in en kies vervolgens:
- Modus: een Axonaut-factuur of –offerte aanmaken.
- Triggerstatussen: de bestelling wordt verzonden zodra ze voor het eerst een van de geselecteerde statussen bereikt (bijvoorbeeld “Betaling geaccepteerd”).
- Prijzen incl. btw: de eenheidsprijzen inclusief btw versturen in plaats van exclusief.
Elke doorgestuurde bestelling neemt de productregels over (referentie, btw-tarief, aantal) en voegt de verzendkosten toe als aparte regel. Een al verzonden bestelling wordt nooit gedupliceerd.
Productsynchronisatie (optioneel)
Schakel Producten synchroniseren in om uw catalogus (referentie, naam, prijs, btw, korte beschrijving) te spiegelen in de Axonaut-producten. De synchronisatie start bij elke wijziging van een productpagina.
Cron-taak
De synchronisaties worden in een wachtrij geplaatst en op de achtergrond verwerkt. In de hooks wordt een lichte inline verwerking geprobeerd, maar voor een betrouwbare werking plant u de cron-taak die in de configuratie wordt getoond:
curl -s "https://uw-winkel.tld/index.php?fc=module&module=dfaxonaut&controller=cron&token=UW_TOKEN"Aanbevolen frequentie: elke 5 tot 15 minuten. De cron verwerkt de wachtrij, ruimt voltooide items op (7 dagen) en oude logboeken (30 dagen). Het token kan opnieuw worden gegenereerd vanaf de configuratiepagina.
Genereert u het token opnieuw, werk dan de URL bij in uw taakplanner (server-cron, PrestaShop-taak of externe dienst).
Dashboard en logboeken
Het tabblad Axonaut Connector toont de tellers (in afwachting / gesynchroniseerd / mislukt) en het volledige operatielogboek, filterbaar en exporteerbaar. Er zijn twee acties beschikbaar:
- Wachtrij nu verwerken: dwingt de onmiddellijke verwerking van de wachtende items af.
- Mislukte items opnieuw proberen: plaatst items die na 5 pogingen zijn mislukt terug in de wachtrij.
Werking van de wachtrij en de herpogingen
Elke te synchroniseren entiteit (klant, bestelling, product) wordt in een wachtrij geplaatst. Bij een tijdelijke fout (netwerk, API-quotum) probeert de module automatisch tot 5 keer opnieuw en markeert het item daarna als mislukt. De fouten worden gelogd met hun melding, wat de diagnose vergemakkelijkt. De debugmodus voegt de volledige payloads en API-antwoorden toe aan de logboeken.
Probleemoplossing
- “Lege API-sleutel”: vul de sleutel in de configuratie in voordat u de verbinding test.
- HTTP-fout 401/403: de API-sleutel is ongeldig of ingetrokken. Genereer een nieuwe in Axonaut.
- Bestellingen niet verzonden: controleer of de bereikte status tot de triggerstatussen behoort en of de bestellingssynchronisatie is ingeschakeld.
- Mislukte items: open het logboek om de foutmelding te lezen, verhelp de oorzaak en klik daarna op Mislukte items opnieuw proberen.
- Er wordt niets op de achtergrond gesynchroniseerd: controleer of de cron-taak daadwerkelijk is ingepland en of het token in de URL overeenkomt met dat in de configuratie.
Technische opmerkingen
- Gebruikte API: Axonaut REST API v2, authenticatie via de header userApiKey.
- Endpoints: /me, /companies, /companies/{id}/employees, /employees/{id}, /products, /invoices, /quotations.
- Aangemaakte tabellen: dfaxonaut_map (koppelingen PrestaShop ↔ Axonaut), dfaxonaut_queue (wachtrij), dfaxonaut_log (logboeken).
- Compatibel met PrestaShop-multistore.