Skip to main content

Shopify

Available

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

Connect your Shopify store to Frihet. Orders are automatically imported and generate invoices.

What is it for?​

With Shopify integrated:

  • Import orders — Imports Shopify orders as invoices in Frihet (prefix SHOP-)
  • Import products — Brings your Shopify catalog to Frihet
  • Automatic deduplication — Already imported orders are not duplicated
  • Client data — Email, address, and phone are automatically synchronized
  • Automatic payments — If Shopify processed the payment, Frihet marks the invoice as paid

Requirements​

  • Active Shopify store — With listed products
  • Admin access — To authorize the app
  • Frihet Pro or higher

Connect Shopify​

Step 1: Open Frihet​

  1. Go to Settings → Integrations
  2. Search for Shopify
  3. Click Connect

Step 2: Authorize in Shopify​

  1. Enter your store name (e.g.: mystore or mystore.myshopify.com)
  2. Click Connect to Shopify
  3. You will be redirected to the Shopify authorization page
  4. Log in with your Shopify account if you haven't already
  5. You will see the permissions Frihet needs:
    • Read orders
    • Read clients
    • Read products
  6. Click Install app
  7. You will automatically return to Frihet with the connection activated

Step 3: Configure Synchronization​

In Frihet, after authorizing:

  1. Choose what to synchronize:

    • ✅ New orders — Automatic
    • ✅ Create automatic invoices — Automatic
    • ⚪ Synchronize clients — Optional
    • ⚪ Synchronize products — Optional
    • ⚪ Update inventory — Optional

  2. Save changes

First Synchronization​

The first time:

  1. Frihet imports your last 100 orders (most recent)
  2. Creates clients (if they don't exist)
  3. Creates invoices for each order
  4. This takes 2-5 minutes depending on quantity

Go back to Billing → Invoices in 5 minutes and you will see your Shopify orders as invoices.

How Sync Works​

New Order in Shopify​

1. Client buys from your Shopify store
   ↓
2. Shopify processes the order
   ↓
3. Frihet detects the new order (every 15 minutes)
   ↓
4. Automatically synchronizes to Frihet:
   - Client (if new, creates it)
   - Products
   - Invoice with "Paid" status (if paid in Shopify)
   ↓
5. Appears in your Frihet listing

Synchronized Data​

DataFrom Shopify to Frihet
Order IDInvoice number
ProductsInvoice lines
Shopify PriceUnit price
QuantityQuantity
ClientName, email, shipping address
Order DateInvoice Date
PaymentMethod (card, PayPal, etc.)
ShippingIncluded as a line if applicable
TaxesCalculated according to jurisdiction

Order Statuses​

Shopify → Frihet​

Shopify StatusFrihet Status
PendingPending
ConfirmedPending
CompletedPaid ✅
CanceledCanceled
ReturnedPartially refunded

Real Example​

Client buys from your Shopify store​

Order #1009 in Shopify
Client: María García
Email: maria@example.com
Address: Calle Principal 42, Madrid 28001

Products:
- 1x Blue T-shirt S = €25.00
- 2x Sunglasses = €40.00 each = €80.00

Subtotal: €105.00
Shipping: €5.95
Taxes: €23.19 (21%)
Total paid: €134.14

Payment method: Credit card

In Frihet automatically​

Invoice #1009
Date: 10 Feb 2025
Client: María García

Lines:
- 1x Blue T-shirt S = €25.00
- 2x Sunglasses = €80.00
- Shipping = €5.95

Subtotal: €110.95
VAT (21%): €23.29 (if configured in Frihet)
Total: €134.24

Status: Paid ✅ (Shopify processed payment)

Created automatically. Without doing anything.

Advanced Configurations​

Product Mapping​

By default, Frihet imports products as a line description. You can:

  1. Go to Settings → Shopify
  2. Activate "Synchronize product catalog"
  3. Frihet creates products in your catalog
  4. Future orders use those products (with price updates)

Useful if you want to reuse products in quotes.

Include/Exclude Specific Orders​

You can tell Frihet:

  • "Do not synchronize canceled orders" — Automatically excludes
  • "Only synchronize after January 1st" — Only recent orders
  • "Exclude specific client" — Do not create an invoice for that client

Configure in Settings → Integrations → Shopify → Advanced filters

Taxes and Commissions​

Shopify can include:

  • Taxes — Synchronized as a separate line
  • App fees — You can exclude them from the invoice
  • Discounts — Deducted as a separate line

In Frihet you can adjust what to include in the final invoice.

Client Synchronization​

If you activate "Synchronize clients":

  • Each new client in Shopify is imported to Frihet
  • Email, phone, address are synchronized
  • If the client already exists, their information is updated

Useful for having a unified view of your clients.

Product Page​

With "Synchronize products" active:

  1. Frihet imports your Shopify catalog

  2. You see all products with:

    • Name
    • Price
    • SKU
    • Description

  3. You can use them in new manual invoices (not just orders)

If you change the price in Shopify, it updates automatically.

Test the Integration​

Test Order​

  1. Go to your Shopify store
  2. Place a test order (as a client)
  3. In Frihet, wait up to 15 minutes
  4. Go to Billing → Invoices
  5. You should see the created invoice

If it doesn't appear:

  • Verify that Shopify is connected ✅
  • The order in Shopify must have "Completed" status
  • Reload Frihet (F5)
  • Check Settings → Integrations → Shopify Logs

Refunds and Cancellations​

Client Cancels Order in Shopify​

  1. You change status to "Canceled" in Shopify
  2. Frihet detects it in the next synchronization
  3. The invoice is marked as "Canceled"

Process Refund in Shopify​

If you partially refund:

  1. Shopify records the refund
  2. Frihet detects it
  3. You can automatically create a credit note in Frihet
  4. Or create manually if you prefer

Limitations​

  • Shopify → Frihet (one-way synchronization)

    • Changes in Frihet do not synchronize to Shopify
    • If you edit an invoice in Frihet, Shopify is not updated

  • Does not synchronize draft orders — Only completed orders

  • No access to Shopify invoices — If Shopify generated an invoice, Frihet cannot see it

  • Inventory — Read-only, no automatic updates

Troubleshooting​

"I don't see my Shopify orders"​

  • Wait up to 15 minutes for the first synchronization
  • Orders must be in "Completed" or "Processing" status
  • Reload Frihet (F5 or Cmd+Shift+R)
  • Verify that Shopify is connected in Settings

"Duplicate invoices"​

  • Can happen if you synchronized twice
  • Delete duplicates from Billing (select multiple and "Delete")
  • Then disconnect and reconnect

"Does disconnecting delete my invoices?"​

No. Invoices already created in Frihet remain. Disconnecting only:

  • Stops new synchronizations
  • New Shopify orders are not synchronized

To disconnect:

  1. Settings → Integrations → Shopify
  2. Disconnect
  3. Confirm

"Can I connect multiple Shopify stores?"​

Currently, Frihet supports one Shopify store per account. If you have multiple:

  • Option 1: Create separate Frihet accounts (one per store)
  • Option 2: Contact support to inquire about advanced options

Next Steps​

Previous: WooCommerce