Hesabi for WooCommerce

Connect your WooCommerce store to Hesabi - Tunisian invoicing and ERP - so online orders become fiscal documents automatically.

The plugin is free. You need an active Hesabi subscription (PRO or CABINET) with API access enabled.

Features

• Automatic documents - create a facture, devis, proforma, bon de livraison, or avoir when an order reaches the status you choose
• Client sync - match or create Hesabi clients from the order (email, phone, or name)
• Catalog sync - pull products from Hesabi into WooCommerce, or push Woo products to Hesabi (matched by SKU)
• Shipping and fees - included as lines on the Hesabi document
• PDF - download the Hesabi PDF from the order screen
• Orders list - Hesabi document number column
• Manual sync - sync one order from the order screen, or several with bulk actions
• Sync log - recent successes and errors under WooCommerce → Hesabi Sync Log
• Unmapped products - report products missing a SKU or not yet linked to Hesabi
• Optional after sync - validate the invoice in Hesabi and record payment when the order is paid

Requirements

Ask Hesabi support if API access is not enabled yet. Then create a key in Hesabi: Settings → API Keys.

Installation

From the release ZIP (recommended)

1. Download the latest hesabi-woocommerce-*.zip from Releases
2. In WordPress go to Plugins → Add New → Upload Plugin
3. Choose the ZIP, install, then Activate
4. Open WooCommerce → Hesabi

From a folder

1. Unzip so you have a folder named hesabi-woocommerce
2. Upload it to /wp-content/plugins/
3. Activate under Plugins
4. Open WooCommerce → Hesabi

First setup

1. In Hesabi, open Settings → API Keys and create a key (copy it once - it is shown only at creation)
2. In WordPress, WooCommerce → Hesabi:
   • Paste the API key
   • Leave the API base URL as https://hesabi.tn/api/v1/org unless Hesabi told you otherwise
   • Click Test connection
3. Choose:
   • Document type (e.g. Invoice)
   • Trigger status (e.g. Processing) - when an order reaches this status, Hesabi creates the document
   • Fiscal options if you use invoice / credit note (timbre, FODEC, retenue)
4. Enable Create Hesabi documents when orders reach the trigger status
5. Click Save settings

Product SKUs

Hesabi matches catalog products by SKU. Before going live:

1. Give every sellable product (and variation) a unique SKU
2. Open WooCommerce → Hesabi Unmapped to see products without a SKU or not linked yet
3. Use Pull products from Hesabi or Push products to Hesabi on the settings page to align catalogs

Day-to-day use

If automatic sync is off, you can still sync orders manually once the API key is saved.

Optional: validate and payment

On WooCommerce → Hesabi, under After document sync:

• Validate invoice - validates the document in Hesabi after creation (stock and accounting follow Hesabi rules)
• Record payment - if the WooCommerce order is paid and validation succeeded, records a payment on the facture

Turn these on only if they match how you work in Hesabi.

Privacy and data

The plugin sends order and catalog data needed for invoicing to Hesabi (customer contact details, line items, amounts, SKUs), using your API key.

Nothing is sent until you configure a key and sync (automatic or manual). See Hesabi’s privacy policy: hesabi.tn/privacy.

Suggested text for your store privacy policy:

We use the Hesabi for WooCommerce plugin to create fiscal documents in Hesabi. Order and customer details required for invoicing are transmitted to Hesabi (hesabi.tn) via a secure API key.

Keep your API key private. You can revoke it anytime in Hesabi → Settings → API Keys and create a new one.

Support

• Product and help: hesabi.tn
• Integrations overview: hesabi.tn/integrations/woocommerce
• Contact: hesabi.tn/contact

License

GPL-2.0-or-later