# Axonaut Connector PrestaShop: volledige gids

> 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…

- Pagina: <https://www.datafirefly.com/nl/documentation/connecteur-axonaut-prestashop/>
- Taal: nl
- Bijgewerkt op: 2026-08-26
- Andere talen: [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), [it](https://www.datafirefly.com/it/documentation/connecteur-axonaut-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/connecteur-axonaut-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-axonaut-prestashop/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

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

1. Open in de PrestaShop-backoffice _Modules > Modulebeheer > Een module uploaden_ en upload het ZIP-bestand van de module.
2. Klik na de installatie op _Configureren_.
3. 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.