PS PrestaShop PrestaShop Intermediate

Axonaut PrestaShop Connector — Documentation

Install and configure the Axonaut connector for PrestaShop: API key, customer sync, invoices/quotes, products, cron and troubleshooting.

Updated Module version 1.0.0

The Axonaut PrestaShop Connector module (dfaxonaut, by DataFirefly) automatically syncs your customers, orders and products between PrestaShop and Axonaut, the French business-management software (CRM, invoicing, quotes, cash flow). This guide covers installation, configuration, how the syncs work and troubleshooting.

Requirements

  • PrestaShop 8.x or 9.x, PHP 7.4 to 8.3.
  • An active Axonaut account with API v2 access.
  • Your Axonaut API key (userApiKey), found in Axonaut under Settings > Developers > API key.

Installation

  1. In the PrestaShop back office, open Modules > Module Manager > Upload a module and drop the module ZIP file.
  2. Once installed, click Configure.
  3. A new Axonaut Connector tab also appears under Advanced Parameters: it gives access to the dashboard and logs.

The module installs no Composer dependency at deploy time: the PSR-4 autoloader is built in. Nothing else is required on the server.

Configuration

API key and connection test

Paste your Axonaut API key into the Axonaut API key field and save. Then go to the dashboard (Advanced Parameters > Axonaut Connector) and click Test connection: the module calls Axonaut’s /me endpoint and shows the linked account if everything is correct.

Customer sync

Enable Sync customers so that every account creation, account update or address change creates or updates an Axonaut company together with its contact. The module automatically detects businesses (company name or intra-community VAT set) and individuals (B2C), and transmits the address, intra-community VAT and company number when available.

Order sync

Enable Sync orders, then choose:

  • Mode: create an Axonaut invoice or a quote.
  • Trigger states: the order is pushed the first time it reaches one of the selected states (for example “Payment accepted”).
  • Tax-included prices: send unit prices tax included rather than tax excluded.

Each pushed order carries over the product lines (reference, VAT rate, quantity) and adds shipping as a dedicated line. An order already pushed is never duplicated.

Product sync (optional)

Enable Sync products to mirror your catalog (reference, name, price, VAT, short description) into Axonaut products. The sync fires whenever a product is updated.

Cron task

Syncs are queued and processed in the background. A light inline attempt runs on the fly inside the hooks, but for reliable operation, schedule the cron task shown in the configuration:

curl -s "https://your-store.tld/index.php?fc=module&module=dfaxonaut&controller=cron&token=YOUR_TOKEN"

Recommended frequency: every 5 to 15 minutes. The cron processes the queue, purges completed items (7 days) and old logs (30 days). The token can be regenerated from the configuration page.

If you regenerate the token, remember to update the URL in your scheduler (server cron, PrestaShop task or external service).

Dashboard and logs

The Axonaut Connector tab shows the counters (pending / synced / failed) and the full, filterable and exportable operation log. Two actions are available:

  • Process queue now: forces immediate processing of pending items.
  • Retry failed items: re-queues items that failed after 5 attempts.

How the queue and retries work

Each entity to sync (customer, order, product) is placed in a queue. On a temporary error (network, API quota), the module retries automatically up to 5 times, then marks the item as failed. Errors are logged with their message, which makes diagnosis easier. Debug mode adds the full API payloads and responses to the logs.

Troubleshooting

  • “API key is empty”: enter the key in the configuration before testing the connection.
  • HTTP 401/403 error: the API key is invalid or revoked. Regenerate it in Axonaut.
  • Orders not pushed: check that the reached state is among the trigger states and that order sync is enabled.
  • Failed items: open the log to read the error message, fix the cause, then click Retry failed items.
  • Nothing syncs in the background: check that the cron task is scheduled and that the URL token matches the one in the configuration.

Technical notes

  • API used: Axonaut REST API v2, authentication via the userApiKey header.
  • Endpoints: /me, /companies, /companies/{id}/employees, /employees/{id}, /products, /invoices, /quotations.
  • Tables created: dfaxonaut_map (PrestaShop ↔ Axonaut mapping), dfaxonaut_queue (queue), dfaxonaut_log (logs).
  • PrestaShop multistore compatible.
Was this page helpful?

Still stuck? Contact support