Skip to main content

WooCommerce

Available

This integration is active and ready to use on all Pro plans.

Connect your WooCommerce store to Frihet. Orders automatically synchronize and generate invoices.

What is it for?​

With WooCommerce integrated:

  • Order Sync — New orders automatically appear in Frihet
  • Automatic Invoices — They are created without any action from you
  • Client Data — Name, email, order address are imported
  • Inventory Control — Products synchronized between both platforms (optional)

Requirements​

  • WordPress with WooCommerce installed — Your online store
  • WordPress Access — Admin user or with plugin permissions
  • Frihet Pro or higher

Install connection plugin​

Step 1: Download the plugin​

  1. In WordPress, go to Plugins → Add New
  2. Search for "Frihet WooCommerce"
  3. Click Install
  4. Then Activate

Or download it manually from: frihet.io/plugins/woocommerce

Step 2: Authorize the connection​

  1. In WordPress, go to Settings → Frihet WooCommerce
  2. Click "Connect with Frihet"
  3. You will be redirected to Frihet
  4. Authorize access
  5. Automatically redirects to WordPress

Step 3: Configure what to synchronize​

In Settings → Frihet WooCommerce, choose:

  • ✅ Synchronize orders — Recommended
  • ✅ Create automatic invoices — Recommended
  • ⚪ Synchronize clients — Optional
  • ⚪ Synchronize inventory — Only if you need it

Save changes.

How sync works​

New order in WooCommerce​

1. Client buys from your store
   ↓
2. WooCommerce receives the order
   ↓
3. Plugin detects change
   ↓
4. Sends data to Frihet (in real-time)
   ↓
5. Frihet automatically creates:
   - Client (if new)
   - Invoice with the products from the order
   ↓
6. The invoice appears in your Frihet list

Synchronized data​

DataFrom WooCommerce to Frihet
Order numberInvoice number
ProductsInvoice lines
QuantityQuantity
PriceUnit price
ClientName, email, address
Order dateInvoice date
Order statusPayment status
VAT (if configured)Detailed VAT

Order and invoice statuses​

WooCommerce → Frihet​

WooCommerce StatusFrihet Status
Pending paymentPending
ProcessingPending
CompletedPaid ✅
CanceledCanceled
RefundPartial Refund

If the client marks the order as "Completed", the invoice is automatically marked as paid.

Real example​

Client buys from your store​

Order in WooCommerce:

Order #1234 - 10 Feb 2025
- 2x Product A @ €50 = €100
- 1x Product B @ €30 = €30
Total: €130 + €27,30 VAT (21%) = €157,30

Client: Juan García
Email: juan@example.com

In Frihet automatically​

Invoice created:

Invoice #1234
Date: 10 Feb 2025
Client: Juan García
- 2x Product A @ €50 = €100
- 1x Product B @ €30 = €30
Subtotal: €130,00
VAT (21%): €27,30
Total: €157,30
Status: Paid ✅

The invoice appears in your list. Without doing anything.

Advanced configurations​

Product category mapping​

If you want WooCommerce products to be created as products in Frihet:

  1. In WordPress, go to Settings → Frihet WooCommerce
  2. Activate "Synchronize products"
  3. Choose whether to synchronize inventory (stock)

This is useful if you want to reuse those products in future quotes.

Custom invoice format​

By default, Frihet uses its format. You can customize:

  1. In Frihet, go to Settings → Invoicing
  2. Modify the invoice template
  3. New WooCommerce orders use that template

Email to client​

When an invoice is created from WooCommerce:

  • ✅ WooCommerce sends order confirmation email
  • ✅ Frihet can send invoice email (if you activate it)

Both emails will go to the client. You can deactivate one in Settings to avoid duplicates.

Test the integration​

Test order​

  1. Go to your WooCommerce store
  2. Place a test order (as a client)
  3. In Frihet, go to Invoicing → Invoices
  4. You should see the invoice created automatically in the last 30 seconds

If it doesn't appear:

  • Wait 1 minute (sometimes it takes time)
  • Verify that WooCommerce → Frihet shows "Connected"
  • Check error logs in Settings → Integrations → Logs

Refunds and cancellations​

Client cancels order in WooCommerce​

  1. The status changes to "Canceled"
  2. Frihet detects the change
  3. The invoice is marked as "Canceled"

Client requests refund​

If you process a refund in WooCommerce:

  1. It is registered in the order
  2. Frihet automatically creates a credit note (if you activate it in Settings)
  3. Or you can manually create the credit note in Frihet

Limitations​

Frihet → WooCommerce:

  • Does not synchronize invoices from Frihet to WooCommerce — Only WooCommerce → Frihet
  • Edits in Frihet do not affect WooCommerce — If you change the price of an invoice in Frihet, WooCommerce is not updated
  • New products in Frihet do not go to WooCommerce — Only existing ones are synchronized

Troubleshooting​

"I don't see WooCommerce invoices in Frihet"​

  • Verify that the integration is connected ✅
  • The order must be in "Processing" status or higher
  • Wait 1-2 minutes after creating the order
  • Reload Frihet (F5)

"Why are emails duplicated?"​

  • WooCommerce sends order email
  • Frihet can also send invoice email
  • Solution: Deactivate Frihet emails for WooCommerce orders in Settings → Email

"The client does not match between WooCommerce and Frihet"​

  • WooCommerce created a new client in Frihet
  • If the client already existed, they might have been duplicated
  • Solution: Manually merge clients in Frihet

"Can I disconnect without losing invoices?"​

Yes. Already created invoices remain in Frihet. Disconnection only:

  • Stops new syncs
  • New orders in WooCommerce are no longer synchronized

To disconnect:

  1. Go to Settings → Integrations
  2. Search for WooCommerce
  3. Click Disconnect
  4. Confirm
Webhooks for e-commerce

Frihet emits webhooks on events like invoice.created and invoice.paid. Use it to synchronize your WooCommerce store with external systems or trigger automations when invoices are generated from orders.

Next steps​

Previous: Stripe Connect