Skip to main content

Shopify

Available on the Shopify App Store

Frihet has a public listing on the Shopify App Store: apps.shopify.com/frihet-erp.

Connect your Shopify store to Frihet. You install the app from the Shopify App Store and, when you ask for it, Frihet imports your orders as invoices and your products into the catalog.

What Frihet does​

  • Install from the Shopify App Store — the store is linked to your Frihet account. The permissions it asks for are read-only: orders, customers, products and inventory.
  • Import Orders — turns Shopify orders into invoices numbered SHOP-{order number}. It imports up to 2,500 orders per import.
  • Import Products — brings your Shopify catalog into Frihet's products. It imports up to 2,500 products per import.
  • No duplicates — an order that was already imported is not imported again; nor is a product with the same SKU as one you already imported from Shopify.
  • Invoice status from payment — paid: Paid; pending or authorized: Sent; any other status: Draft.
  • Client — created with the name, email and billing address on the order. If you already have a client with the same email, it is reused; otherwise a client with the same name is reused.

What Frihet does not do​

  • Automatic, periodic or webhook import: it only imports when you click the button.
  • Sync configuration options: there are no checkboxes, filters or per-order logs.
  • Calculate Shopify's taxes: imported invoices and products carry a fixed 21 % VAT.
  • Import shipping or discounts as separate lines: the lines are the order's products.
  • Mark invoices as canceled or refunded, or create credit notes from refunds.
  • Update clients or products that already exist in Frihet.
  • Compare against products you created by hand in Frihet: if one has the same SKU as a Shopify product, you will have both.
  • Import orders older than 60 days.
  • Write to your store or update its inventory.

Requirements​

  • An active Shopify store
  • Permission in Shopify to install apps

Install from the Shopify App Store​

  1. Open the listing: apps.shopify.com/frihet-erp
  2. Click Install
  3. Shopify shows the permissions Frihet asks for (all read-only: orders, customers, products, inventory) and you confirm the installation
  4. You return to Frihet to sign in or create your account
  5. The store is linked to your workspace
App billing

If you install Frihet from the Shopify App Store, the app's charges are handled through Shopify, not from Frihet. In your account's plan section you will see the "Free plan on Shopify" panel and no paid plans are offered inside Frihet.

Connect from Frihet​

If you already have a Frihet account:

  1. Go to Integrations
  2. Open Shopify
  3. Click Install from Shopify App Store: Frihet's listing in Shopify opens and you follow the steps above

Import data​

Import orders​

  1. Go to Integrations and open Shopify
  2. Click Import Orders
  3. Frihet creates one invoice for each order not already imported

Import products​

  1. On the same screen, click Import Products
  2. Frihet creates one product for each Shopify product whose SKU you have not already imported from Shopify

Imported data​

Orders​

Shopify fieldFrihet field
Order numberInvoice number (SHOP-{number})
Order linesInvoice lines (description, quantity, price)
CustomerName, email and billing address
Order dateIssue date and due date
Payment statusInvoice status

Products​

Shopify fieldFrihet field
TitleName
First variant's SKUSKU (if it has none, SHOP-{id})
First variant's priceUnit price
DescriptionDescription
Product typeCategory
Active statusActive/inactive

Example​

Order in Shopify​

Order #1009
Customer: María García (maria@example.com)
Billing address: Calle Principal 42, Madrid 28001

- 1x Blue T-shirt S = €25.00
- 2x Sunglasses at €40.00 = €80.00
Shipping: €5.95
Payment: paid

In Frihet after importing​

Invoice SHOP-1009
Client: María García
- 1x Blue T-shirt S = €25.00
- 2x Sunglasses = €80.00
Subtotal: €105.00
VAT (21 %): €22.05
Total: €127.05
Status: Paid

Shipping is not imported as a line and the VAT is a fixed 21 %: check the invoice if your order had another rate or shipping costs.

Troubleshooting​

I do not see my Shopify orders​

  • Import is manual: click Import Orders
  • Orders you already imported are skipped
  • Reload Frihet (F5 or Cmd+Shift+R)
  • Check that Shopify shows as connected under Integrations

Disconnect​

Invoices and products already imported stay in Frihet. Disconnecting only stops new imports.

  1. Go to Integrations and open Shopify
  2. Click Disconnect
  3. Confirm

Can I connect several Shopify stores?​

Frihet stores a single Shopify store per account. If you have several, you need a separate Frihet account for each.

Next steps​

Previous: WooCommerce

Last updated on