Connecting WooCommerce
Connect your WooCommerce store to FiscoBridge and every paid order is fiscalized automatically, typically within minutes. The fiscal number and verification link are written on the order, and your buyer is emailed a link to the fiscal receipt — or the PDF itself, with the free plugin.
Before You Start
- Your store address must use HTTPS. Stores on plain HTTP cannot be connected.
- You need administrator access to the store's WordPress admin, because you approve the connection there.
- You need the PFX certificate issued by your tax authority. It is uploaded during setup and signs every receipt.
- You need an available integration seat on your plan. Each connected store uses one seat — see Invoice limits and usage.
Connect Your Store
- Go to Integrations → My Integrations in the sidebar
- Click Create Integration to open the New Integration page, then click Connect store on the WooCommerce card
- Upload your PFX certificate and enter its password
- Enter your Store address, for example
https://shop.example.com, and choose whether to use Training mode - Click Connect store. You are sent to your own WordPress admin screen
- Review the request and click Approve
You do not copy any keys by hand — WooCommerce hands FiscoBridge its access key during the approval. Once approved, the integration appears in your list with status Active and the WooCommerce settings dialog opens. There you choose when orders are fiscalized (see When Orders Are Fiscalized) and match your tax rates to fiscal tax labels.
Tax Labels
Every tax rate in WooCommerce must be matched to a fiscal tax label, otherwise an order that uses it is not fiscalized.
- On the My Integrations page, open the ⋮ menu on the WooCommerce integration and choose Settings
- For each WooCommerce tax rate listed, choose the fiscal tax label with the same rate. Each label shows its rate, for example Label D (15%). A label with a different rate is refused when you save
- Choose a label for items without tax
Add or change a rate in WooCommerce later and the new rate shows up as unmapped in the WooCommerce settings dialog (⋮ → Settings) until you choose its label. An order that uses an unmapped rate is not fiscalized; FiscoBridge adds a private note to that order naming the rate. Once you save the missing label, FiscoBridge fiscalizes that order automatically.
When Orders Are Fiscalized
Each store has a setting for the order status that triggers fiscalization:
- Processing (default) — the order is fiscalized when it is paid
- Completed — the order is fiscalized when you mark it Completed
The order is normally fiscalized within minutes of reaching that status. You can change the setting later from the ⋮ menu → Settings; it applies to orders from then on.
Cash on delivery: WooCommerce moves cash-on-delivery orders to Processing before any money is taken. They are fiscalized at that point, not when the cash is collected.
When an order is fiscalized, FiscoBridge adds a private order note with the fiscal number and a Verify link to the tax authority. Only you and your staff can see it.
What the Buyer Receives
Without the plugin, WooCommerce emails the buyer a note on the order with a link to the A4 fiscal receipt. The link is valid for 30 days.
With the optional free plugin (see Installing the Plugin), your store instead sends a "Your fiscal receipt" email with the PDF attached. The receipt is also shown on the order's thank-you page and in the buyer's My Account area.
The buyer is never shown a failure. If an order cannot be fiscalized, only you see why (see Troubleshooting).
Refunds and Cancellations
A WooCommerce refund, full or partial, becomes a fiscal refund that references the original fiscal receipt.
Important: Each fiscal receipt can be refunded only once. Put everything into a single refund. If you refund the same order again later, FiscoBridge adds a note to the order but does not issue a second fiscal refund.
Cancelling an order that has already been fiscalized issues a full fiscal refund. If a partial refund was already fiscalized for that order, cancelling it issues nothing further, because the receipt has already been refunded once; FiscoBridge adds a note to the order instead.
A refund recorded with a zero amount (for example, one that only returns items to stock) is ignored.
Training Mode
Training mode lets you test the whole flow with training invoices. No payment details are needed to install and test. Buyers are never emailed in training mode, so you can place test orders safely. Turn training mode off in the ⋮ menu → Settings when you are ready, and choose a paid plan to go live.
Orders fiscalized in training mode are not fiscalized again after you switch training mode off. Only orders paid after the switch get real fiscal receipts. Refunds of a training order stay training documents.
Installing the Plugin
The plugin FiscoBridge for WooCommerce is optional and free.
- Download fiscobridge-for-woocommerce.zip
- In WordPress admin, go to Plugins → Add New Plugin → Upload Plugin
- Choose the zip file, click Install Now, then Activate
Nothing else needs configuring. Receipts for orders fiscalized from then on use the email, thank-you page and My Account display described above.
Troubleshooting
When fiscalization fails, FiscoBridge adds a private note to the order. Typical causes are a reached invoice limit, an inactive subscription, a tax label mismatch, or a rejection from the tax authority. See Troubleshooting failed invoices for what each message means.
FiscoBridge cannot reach your store
Failures that reach your store appear as a private note on the order. If FiscoBridge cannot reach the store at all — the access key was revoked, the WordPress user that approved the connection was deleted, or a firewall, Cloudflare rule or WordPress security plugin blocks requests to /wp-json/ — no note can be written and orders stop being fiscalized.
Check from time to time that new paid orders carry a FiscoBridge note. If they do not, allow requests from FiscoBridge to /wp-json/ if something blocks them, then click Reconnect on the integration on the My Integrations page and approve the request again.
Orders stopped arriving
WooCommerce can switch a webhook off after repeated failures. FiscoBridge turns it back on automatically, and it also checks for missed orders every few minutes, so orders paid in the meantime are picked up.
Disconnecting
Choosing Remove from the ⋮ menu on the integration stops fiscalization for the store. To also remove FiscoBridge's access from the store, revoke the key in WordPress admin under WooCommerce → Settings → Advanced → REST API.