Description
IFX Live Invoices for WooCommerce connects WooCommerce with the InvoiceFlowX Live API.
When an eligible WooCommerce order is created or changes status, the plugin finds the original invoice PDF, submits it to InvoiceFlowX, waits for the processed e-invoice PDF and attaches that returned ZUGFeRD/XRechnung PDF to the WooCommerce customer email.
The waiting time is configurable. If the waiting time is set to 0 seconds, WooCommerce sends the original customer email immediately and the plugin sends a second email with the InvoiceFlowX e-invoice PDF after the webhook callback arrives.
This plugin is a connector for the InvoiceFlowX software-as-a-service platform. An InvoiceFlowX account and a Live API key are required.
External services
This plugin connects to the InvoiceFlowX Live API to process invoice PDFs into ZUGFeRD/XRechnung PDFs.
The plugin sends the following data to InvoiceFlowX:
- The original WooCommerce invoice PDF.
- The WooCommerce order ID and order number.
- The WooCommerce billing name, when available.
- The configured source value
woocommerce. - The WordPress site name as a reference value.
- The WooCommerce order edit URL in the WordPress administration.
- The webhook URL of the WordPress site.
- A webhook secret value used to verify the callback signature.
- Technical request metadata required to process and return the generated invoice PDF.
The plugin does not send the InvoiceFlowX Live API key to customers. The API key is stored in the WordPress administration settings and is only used for authenticated server-to-server requests to InvoiceFlowX.
InvoiceFlowX uses the submitted PDF and order metadata to generate and return the e-invoice PDF. This plugin is a connector to that external service and requires an InvoiceFlowX account with Live API access. Depending on the selected InvoiceFlowX plan, processing may additionally require available included generations or sufficient wallet balance on the InvoiceFlowX service.
Service provider:
- InvoiceFlowX: https://www.invoiceflowx.de/
- Documentation: https://www.invoiceflowx.de/dokumentation/
- Terms: https://www.invoiceflowx.de/nutzungsbedingungen/
- Privacy policy: https://www.invoiceflowx.de/datenschutz/
Privacy
Invoice PDFs can contain personal data, business addresses, invoice line items, tax information and payment details. Site administrators must make sure that their privacy policy covers the transfer of invoice PDFs to InvoiceFlowX for e-invoice processing.
The plugin only contacts InvoiceFlowX after the administrator has installed, activated and configured the plugin with a Live API key.
The plugin does not add public-facing credits, badges or external links to the storefront.
Installation
- Upload the plugin ZIP file in WordPress under
Plugins > Add New > Upload Plugin. - Activate the plugin.
- Open
WooCommerce > IFX Live Invoices. - Enter the InvoiceFlowX endpoint, Live API key, webhook secret, original PDF folder and filename pattern.
- Set the customer email waiting time.
- Make sure the displayed webhook URL is reachable from InvoiceFlowX.
Default endpoint:
https://app.invoiceflowx.de/api/import-document.php
FAQ
-
Do I need an InvoiceFlowX account?
-
Yes. The plugin requires an InvoiceFlowX account with Live API access and a Live API key.
-
Does the plugin work without the InvoiceFlowX service?
-
No. The plugin is a service connector for InvoiceFlowX. The e-invoice conversion itself is performed by the external InvoiceFlowX service.
-
What happens if the InvoiceFlowX wallet is empty?
-
If the included API generations are used and the wallet has insufficient balance, InvoiceFlowX returns
wallet_insufficient_funds. The plugin records an order note, informs the administrator and can continue the WooCommerce email flow with the original invoice PDF as fallback. -
Can the plugin send the normal WooCommerce email immediately?
-
Yes. Set the waiting time to
0seconds. WooCommerce sends the first customer email immediately and the plugin sends a second customer email when the InvoiceFlowX e-invoice PDF is available.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“IFX Live Invoices for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “IFX Live Invoices for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.1
- Prefix all plugin-owned identifiers with the unique
ifxlifwprefix. - Harden webhook authentication, job matching and duplicate callbacks.
- Use safe WordPress HTTP requests for API upload and download.
0.1.0
- Initial release.