Axonaut-connector voor WooCommerce: documentatie
Installeer en gebruik de Axonaut-connector 2.0 voor WooCommerce: installatieassistent, synchronisatieregels, koppelingen, exacte totalen, creditnota's, betalingen, historie inhalen, dashboard, logboek, WP-CLI en probleemoplossing.
Overzicht
De Axonaut-connector voor WooCommerce verzendt je WooCommerce-verkopen naar Axonaut, de Franse CRM- en facturatiesoftware: een factuur (of een offerte) voor elke bestelling, met de WooCommerce-totalen tot op de cent, een creditnota voor elke terugbetaling of annulering, de betaling, de klant met zijn contactpersoon, en de producten. Alles draait op de achtergrond: je afrekenproces wordt nooit vertraagd en een bestelling wordt nooit twee keer verzonden.
Versie 2.0 voegt een installatieassistent toe, een dashboard dat je vertelt wat je moet doen als er iets misgaat, een factuurvoorbeeld, een Axonaut-kolom in de bestellingenlijst, koppelingen voor btw en betaaltypes, historie inhalen op datumvolgorde en een filterbaar logboek met gemaskeerde persoonsgegevens, in 8 talen.

Vereisten
- WordPress 6.4 of hoger (getest tot en met 7.1), PHP 7.4 tot en met 8.5.
- WooCommerce 8.2 of hoger (getest tot en met 11.2), met HPOS of de oude opslag, klassieke afrekenpagina of afrekenblok.
- Een Axonaut-account en de bijbehorende API-sleutel.
- Een werkende WP-Cron (of server-cron), zoals voor elke WooCommerce-winkel: de wachtrij gebruikt Action Scheduler.
Installatie en installatieassistent
- Open in WordPress Plugins > Nieuwe toevoegen > Plugin uploaden, kies het zip-bestand, installeer en activeer.
- Open WooCommerce > Axonaut: de installatieassistent start.
- Klik in Axonaut op het moersleutelicoon rechtsboven en daarna op API, toon je API-sleutel en kopieer hem.
- Plak hem in de assistent en klik op Testen en opslaan. Er wordt niets opgeslagen als Axonaut de sleutel weigert; als hij werkt, wordt het gekoppelde account getoond (bedrijf, gebruiker, valuta, aantal btw-tarieven).

In de volgende stappen kies je het document (factuur of offerte), de statussen die het verzenden starten, creditnota’s en betalingen, en controleer je daarna de koppelingen: elk btw-tarief van WooCommerce wordt in je Axonaut-account opgezocht en elke betaalmethode krijgt een Axonaut-betaaltype (kaart, overschrijving, cheque, contant, automatische incasso, overig).

wp-config.php: define( 'DF_AXONAUT_API_KEY', '…' );Synchronisatieregels
- Document: factuur (betalingen en creditnota’s volgen automatisch) of offerte (een geannuleerde bestelling markeert de offerte als geweigerd).
- Startstatussen: bijvoorbeeld Afgerond voor fysieke goederen, In behandeling voor digitale producten. Bestellingen die wachten op betaling, geannuleerd, mislukt, terugbetaald of concept zijn, worden nooit gefactureerd. Elke bestelling wordt maar één keer verzonden.
- Factuurdatum: de dag waarop de factuur wordt aangemaakt (aanbevolen), of de betaaldatum als Axonaut die accepteert. Axonaut nummert facturen op datumvolgorde en weigert een factuur die eerder is gedateerd dan de laatste: dan wordt de datum van vandaag gebruikt en het logboek vermeldt dat.
- Gratis bestellingen (totaal 0) kunnen worden overgeslagen, en andere valuta’s verzonden (de nieuwe Axonaut-klant krijgt de valuta van de bestelling) of geblokkeerd.
- Betalingen, terugbetalingen en annuleringen: de betaling registreren, een creditnota aanmaken voor elke terugbetaling, een gefactureerde bestelling annuleren met een creditnota.

Totalen tot op de cent
Elke regel wordt verzonden met zijn nettoprijs na korting en het opgegeven tarief van zijn WooCommerce-belasting, nooit met een tarief dat uit afgeronde bedragen is herberekend. WooCommerce houdt regelbedragen onafgerond en rondt de btw per tarief af over de hele bestelling, terwijl Axonaut elke regel afrondt: de connector kiest de centen van elke regel (binnen 1,5 cent van het exacte bedrag) zodat het totaal excl. btw, de btw van elk tarief en het totaal incl. btw die van WooCommerce zijn. Indien nodig wordt een regel met een aantal van 2 of meer in tweeën gesplitst.
- Verzendkosten, toeslagen en negatieve toeslagen (kortingen) zijn aparte regels met hun btw.
- Kortingsbonnen worden op de regel toegelicht: prijs vóór korting, korting, couponcode.
- Het WooCommerce-bestelnummer wordt verzonden in het veld bestelnummer van de factuur, samen met het afleveradres.
- Elke factuur wordt na het aanmaken gecontroleerd; een verschil zou op het dashboard worden gemeld. Een optionele regel Afrondingscorrectie (0 % btw, maximaal 5 cent) is beschikbaar in Instellingen.
Vóór het verzenden toont de knop Voorbeeld op het bestelscherm de regels zoals Axonaut ze zal berekenen en vergelijkt de totalen met WooCommerce. Er wordt niets verzonden.

Klanten en producten
Particulieren worden B2C-klanten in Axonaut met hun contactpersoon; een bedrijfsnaam in het factuuradres levert een B2B-klant op, met het btw-nummer en het SIRET- / SIREN-nummer als je afrekenpagina dat vraagt, en elke koper wordt één keer als contactpersoon toegevoegd.
Klanten worden herkend aan hun account, hun e-mailadres of hun btw-/SIRET-nummer, nooit aan hun naam: twee personen met dezelfde naam worden nooit samengevoegd. Zakelijke klanten kunnen ook worden gekoppeld aan een bedrijf dat al in Axonaut bestaat met dezelfde naam en postcode (optie). Als een klant met een nieuw adres bestelt, wordt dit in Axonaut bijgewerkt.
Producten en variaties worden in de Axonaut-catalogus aangemaakt bij hun eerste verkoop (aanbevolen) of bij elke wijziging gesynchroniseerd, met hun SKU, prijs excl. btw, btw-tarief, categorie en type (verkoop van handelsgoederen 707 of van diensten 706). Elke factuurregel is gekoppeld aan zijn product, zodat de catalogus nooit volloopt met duplicaten. Historie inhalen > Hele catalogus synchroniseren maakt alle producten in één keer aan.
Koppelingen
- Btw-tarieven: elk WooCommerce-tarief, de klasse en het land, het verzonden tarief en of het in Axonaut bestaat. Kies alleen een Axonaut-tarief als een tarief een andere naam heeft. Een regel met meerdere WooCommerce-belastingen (gestapelde tarieven) wordt verzonden met hun som, die in Axonaut moet bestaan.
- Betaaltypes: één Axonaut-type per WooCommerce-betaalmethode.
- Klanten: koppeling aan bestaande bedrijven, contactpersonen, bijwerken van het adres, debiteurenrekening (code derde), categorie, bestelveld met het SIRET- / SIREN-nummer, vermelding voor zakelijke facturen zonder btw.
- Producten: catalogusmodus en producttypes.

Bestelscherm en bestellingenlijst
Bij elke bestelling toont het vak Axonaut de status, het factuurnummer met een link naar de PDF, het totaal in Axonaut vergeleken met WooCommerce, de betaling en de creditnota’s. Als de bestelling nog niet is verzonden, toont het waarom en wat je moet doen, met Nu naar Axonaut verzenden en Voorbeeld. Als de bestelling na de factuur is gewijzigd, corrigeert Creditnota + nieuwe factuur dit.

De bestellingenlijst krijgt een kolom Axonaut (status, nummer, PDF-link), een filter (verzonden, fout of te controleren, niet verzonden) en de bulkactie Naar Axonaut verzenden, die meldt welke bestellingen zijn geweigerd en waarom.

Creditnota’s, annuleringen en wijzigingen
Creditnota’s in Axonaut zijn facturen met negatieve aantallen die gekoppeld zijn aan de oorspronkelijke factuur. De connector maakt ze voor je aan:
- terugbetaalde artikelen, verzendkosten en toeslagen worden regel per regel gecrediteerd, met hun aantal of als bedrag;
- een terugbetaald bedrag zonder regels wordt net als de bestelling per btw-tarief verdeeld, tot op de cent;
- een terugbetaling vóór de factuur wordt direct daarna gecrediteerd; een volledig terugbetaalde bestelling wordt niet gefactureerd;
- een gefactureerde bestelling die wordt geannuleerd, krijgt een creditnota voor wat er overblijft (een exacte spiegeling van de factuur als er niets is terugbetaald);
- een bestelling die na de factuur is gewijzigd, wordt gemarkeerd: een factuur kan niet worden bewerkt, dus met één klik worden een creditnota voor de hele factuur en een nieuwe factuur op basis van de bestelling zoals die nu is aangemaakt.
Dashboard
Het dashboard toont de documenten die in 30 dagen zijn verzonden, de wachtrij, de fouten, de te controleren documenten en de verzonden creditnota’s. De lijst Af te handelen geeft voor elk document het probleem en Wat te doen, met Opnieuw proberen (of Alles opnieuw proberen). De laatste bewerkingen, de verbinding (met Verbinding testen) en de actieve regels staan op dezelfde pagina.

Betrouwbaarheid: nooit twee keer
- Elke bestelling wordt onder een vergrendeling verzonden: een handmatige verzending en de wachtrij kunnen haar nooit tegelijk verzenden.
- Als het antwoord van Axonaut wordt onderbroken (time-out, serverfout), zoekt de volgende poging eerst het document in Axonaut (zelfde klant, zelfde totaal, zelfde regels) en koppelt het. Als meerdere documenten zouden kunnen overeenkomen, wordt er niets aangemaakt en kies jij (Toch verzenden).
- Tijdelijke fouten worden opnieuw geprobeerd na 1, 5 en 15 minuten, 1, 3 en 6 uur. Als Axonaut vraagt om te vertragen, wacht de wachtrij.
- Als Axonaut de API-sleutel weigert, wordt het verzenden gepauzeerd, krijg je een melding en worden wachtende documenten automatisch verzonden zodra de sleutel werkt.
Historie inhalen
- Open Historie inhalen, kies de datums en statussen (afgerond, in behandeling, in de wacht) en klik daarna op Analyseren: je ziet de gevonden bestellingen, die al in Axonaut staan, die nog te verzenden zijn, de gevonden problemen en de geschatte tijd. Er wordt niets verzonden.
- Klik op Inhalen starten. Bestellingen worden een voor een verzonden, de oudste eerst, op de achtergrond; je kunt de pagina verlaten, pauzeren, hervatten of stoppen.
- Terugbetalingen van deze bestellingen worden direct na elke factuur als creditnota’s verzonden; betaalde bestellingen krijgen hun betaling (gedateerd op de dag van het inhalen, een beperking van de Axonaut-API).

Logboek
Het logboek toont elke bewerking met het niveau, het object en de bestelling, te filteren op niveau, object, bestelling, tekst en datums, met details (code, HTTP-status, duur). E-mailadressen, telefoonnummers, namen en adressen worden gemaskeerd en de API-sleutel wordt nooit vastgelegd. Exporteer het als CSV of leeg het; de bewaartermijn stel je in bij Instellingen.

Instellingen, privacy en Franse e-facturatie
Met Instellingen kun je de API-sleutel vervangen, testen of verwijderen, de afrondingsregel toevoegen, de bewaartermijn van het logboek instellen, de debugmodus inschakelen (verzonden en ontvangen gegevens, gemaskeerd) en kiezen wat er gebeurt als de plugin wordt verwijderd: standaard worden instellingen, koppelingen en logboek behouden, zodat een herinstallatie nooit een bestelling twee keer verzendt. Een tekst voor je privacybeleid wordt voorgesteld in Instellingen > Privacy; het logboek van een door WooCommerce geanonimiseerde bestelling wordt verwijderd.

Update vanaf versie 1.x
Installeer de zip van 2.0 over versie 1.x heen. Instellingen, API-sleutel en koppelingen tussen bestellingen en Axonaut blijven behouden: bestellingen die al zijn verzonden, worden nooit opnieuw verzonden. Terugbetalingen die met 1.x zijn gedaan, hadden geen creditnota in Axonaut (de creditnota’s van 1.x hebben Axonaut nooit bereikt): ze worden op het dashboard vermeld met een knop Creditnota verzenden.
WP-CLI en ontwikkelaars
wp axonaut status,wp axonaut test,wp axonaut sync <order_id>,wp axonaut retry,wp axonaut backfill --from=2025-01-01 --dry-run,wp axonaut products.- Filters:
df_axonaut_company_payload,df_axonaut_employee_payload,df_axonaut_document_payload,df_axonaut_product_payload,df_axonaut_credit_note_payload,df_axonaut_vat_meta_keys,df_axonaut_siret_meta_keys,df_axonaut_capability. Acties:df_axonaut_order_synced,df_axonaut_refund_synced.
Problemen oplossen
Axonaut weigert de API-sleutel
Kopieer de sleutel opnieuw uit Axonaut (moersleutelicoon > API) en plak hem in Instellingen. Wachtende documenten worden automatisch verzonden zodra de sleutel werkt.
“Het btw-tarief bestaat niet in je Axonaut-account”
Maak het tarief aan in Axonaut, of kies een bestaand Axonaut-tarief in Koppelingen > Btw-tarieven, en klik daarna op Opnieuw proberen op het dashboard.
Een bestelling wordt niet verzonden
Open de bestelling: het Axonaut-vak vermeldt waarom (status die nooit wordt gefactureerd, gratis bestelling, volledig terugbetaald, valuta) en wat je moet doen. Controleer of WP-Cron draait (WooCommerce > Status > Geplande acties, groep df-axonaut).
“Meerdere Axonaut-documenten komen overeen met deze bestelling”
Na een onderbroken antwoord heeft de connector meer dan één mogelijk document gevonden. Controleer de klant in Axonaut en klik daarna alleen op Toch verzenden als geen ervan het juiste is.