Abby

This plugin automatically creates invoices in Abby when orders are placed in HikaShop. Abby is a French invoicing and accounting SaaS for freelancers and small businesses. The plugin handles contact/organization creation, invoice line items with VAT, and invoice finalization via the Abby REST API.

• Automatically creates invoices in Abby when orders reach configured statuses (e.g. "confirmed", "shipped").
• Auto-detects the Abby VAT code from the HikaShop tax rate: 20%, 10%, 8.5%, 5.5%, 2.1%, or 0%.
• Creates contacts in Abby from the customer's billing address (name, email, phone, address).
• Optionally creates organizations (companies) in Abby when the customer has a company name, linking the invoice to the organization.
• Finds existing contacts/organizations by name to avoid duplicates.
• Invoice line items include product name, unit price (HT), quantity, and VAT code.
• Shipping and payment fees are added as separate invoice lines when applicable.
• Order discounts/coupons are applied as an invoice-level discount.
• Invoice date is set to the order creation date.
• Configurable payment delay (at reception, 7 days, 30 days, etc.).
• Auto-finalize option: invoices can be finalized automatically or left as drafts for review in Abby.
• Duplicate prevention: orders that have already been exported to Abby are skipped.
• Abby invoice ID displayed in the backend order details page.
• Debug mode for logging all API requests and responses.
• Compatible with Abby test mode for safe testing before going live.

• 1) Download the plugin on our website via the download link provided to you after the purchase.
• 2) Install it on your Joomla website via the extension manager and via the "Install plugin" button of System>Plugins on WordPress.
• 3) Enable the plugin in Extensions > Plugins.
• 4) Configure your Abby API key. You can get it from your Abby account under Settings > Integrations.
• 5) Select the default product type (sale of goods or service delivery) and VAT code.
• 6) Choose the payment delay and whether invoices should be auto-finalized.
• 7) In HikaShop, go to System > Order statuses and configure which statuses should trigger invoice creation in the "Abby" column.

• API Key: Your Abby API key (starts with suk_). Get it from Settings > Integrations in your Abby account.
• Product type: "Sale of goods" or "Service delivery". Applied to all product lines in the invoice.
• VAT code: Fallback VAT code when the tax rate cannot be auto-detected. The plugin automatically maps HikaShop tax rates (20%, 10%, 5.5%, etc.) to the corresponding Abby VAT codes.
• Payment delay: Payment terms for the invoice (at reception, 7/15/30/45/60 days, end of month, etc.).
• Auto-finalize: When enabled, invoices are finalized immediately after creation. When disabled, they remain as drafts in Abby for manual review.
• Create organizations: When enabled and the customer has a company name, the plugin creates an organization in Abby and links the invoice to it instead of the individual contact.
• Debug mode: Logs all API requests and responses to the HikaShop log file for troubleshooting.

• If an invoice export fails (API error, network issue, etc.), the error is logged in the HikaShop log file with the full request and response details. Enable debug mode for even more detailed logging.
• To retry a failed export, change the order status to a non-exportable status (e.g. "created") and then back to an exportable status (e.g. "confirmed"). This will retrigger the invoice creation.
• If an invoice was already successfully created in Abby, changing the status back and forth will not create a duplicate. The plugin stores the Abby invoice ID in the order and skips orders that have already been exported.

• This plugin is compatible with all the editions of HikaShop
• Requires the PHP cURL extension
• Compatible with PHP 7.4 minimum
• Compatible with Joomla 3.x, 4.x, 5.x
• An Abby account with API access is required
• No limit of time
• No limit of use

1.0.0 on the 21st of March 2026

• Initial release of the plugin.