Wo WooCommerce Gemiddeld

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.

Bijgewerkt Moduleversie 2.0.0

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.

Axonaut-connector voor WooCommerce – Dashboard: tellers, te behandelen documenten met wat je moet doen, laatste bewerkingen
Dashboard: tellers, te behandelen documenten met wat je moet doen, laatste bewerkingen
Kort gezegd: installeer, open WooCommerce > Axonaut, plak je API-sleutel in de assistent, kies wanneer bestellingen worden verzonden, controleer de btw-tarieven en volg daarna alles op het dashboard.

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

  1. Open in WordPress Plugins > Nieuwe toevoegen > Plugin uploaden, kies het zip-bestand, installeer en activeer.
  2. Open WooCommerce > Axonaut: de installatieassistent start.
  3. Klik in Axonaut op het moersleutelicoon rechtsboven en daarna op API, toon je API-sleutel en kopieer hem.
  4. 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).
Axonaut-connector voor WooCommerce – Installatieassistent: de API-sleutel wordt getest voordat hij wordt opgeslagen, gekoppeld account
Installatieassistent: de API-sleutel wordt getest voordat hij wordt opgeslagen, gekoppeld account

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).

Axonaut-connector voor WooCommerce – Installatieassistent: btw-tarieven gecontroleerd in Axonaut en betaalwijzen
Installatieassistent: btw-tarieven gecontroleerd in Axonaut en betaalwijzen
De sleutel wordt versleuteld opgeslagen en nooit meer volledig getoond. Je kunt hem ook definiëren in 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.
Axonaut-connector voor WooCommerce – Synchronisatieregels: document, statussen, factuurdatum, betalingen en creditnota’s
Synchronisatieregels: document, statussen, factuurdatum, betalingen en creditnota’s

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.

Axonaut-connector voor WooCommerce – Voorbeeld van de factuur vóór verzending, totalen vergeleken met WooCommerce
Voorbeeld van de factuur vóór verzending, totalen vergeleken met WooCommerce

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.
Axonaut-connector voor WooCommerce – Koppelingen: btw-tarieven, betaalwijzen, klanten en producten
Koppelingen: btw-tarieven, betaalwijzen, klanten en producten

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.

Axonaut-connector voor WooCommerce – Bestelscherm: Axonaut-factuur, zelfde totaal als WooCommerce, betaling en creditnota
Bestelscherm: Axonaut-factuur, zelfde totaal als WooCommerce, betaling en creditnota

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.

Axonaut-connector voor WooCommerce – Bestellijst met de kolom Axonaut, het factuurnummer en het filter
Bestellijst met de kolom Axonaut, het factuurnummer en het filter

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.

Axonaut-connector voor WooCommerce – Dashboard op een telefoon
Dashboard op een telefoon

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

  1. 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.
  2. 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.
  3. 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).
Axonaut-connector voor WooCommerce – Historie inhalen: analyse en voortgang, oudste bestellingen eerst
Historie inhalen: analyse en voortgang, oudste bestellingen eerst

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.

Axonaut-connector voor WooCommerce – Filterbaar logboek met gemaskeerde persoonsgegevens en CSV-export
Filterbaar logboek met gemaskeerde persoonsgegevens en CSV-export

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.

Axonaut-connector voor WooCommerce – Instellingen: versleutelde API-sleutel, totalen, privacy en Franse e-facturatie
Instellingen: versleutelde API-sleutel, totalen, privacy en Franse e-facturatie
Franse e-facturatie: Axonaut staat bij de Franse belastingdienst geregistreerd als erkend platform (plateforme agréée). Axonaut, niet deze plugin, geeft elektronische facturen uit, ontvangt en rapporteert ze. De connector verzendt de winkelgegevens die Franse e-facturen gebruiken, als je winkel ze heeft: SIRET / SIREN van zakelijke klanten, afleveradres, producttype, creditnota’s gekoppeld aan hun factuur en betalingen. De connector maakt je facturatie niet op zichzelf conform: controleer je verplichtingen met je boekhouder.

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.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support