Orders
Order sync creates one e-conomic document per Shopify order when your rules allow it.
Enable order sync
Sync settings → Order → Rule sync → Enable order sync.
For orders that already existed before you enabled sync, use Bulk order import (Order settings → Bulk import).
Order trigger
Choose when the first successful sync may run:
| Trigger | Typical use |
|---|---|
| When order is paid | After payment is captured (default) |
| When order is fulfilled | After fulfillment / shipping |
| When order is updated | After order status changes and selected status filters match |
Only the trigger you select is eligible to create the document. Other order changes for the same order are ignored for document creation.
e-conomic document type
| UI choice | What gets created |
|---|---|
| Sales order (draft) | Draft sales order in e-conomic |
| Invoice | Draft invoice, or booked invoice if Auto-book invoice is enabled |
When Auto-book invoice is enabled, the app creates the invoice in the correct e-conomic sequence and books it automatically.
Confirm with your accountant which document type matches your workflow.
Optional status filters
When trigger is When order is updated, you can require the order to match:
- Financial status (e.g. Paid, Pending, Refunded — see note below)
- Fulfillment status (Unfulfilled, Partial, Fulfilled, …)
Select at least one status filter when using When order is updated. For paid and fulfilled triggers, Shopify already sends the app a dedicated event for that status.
Within one group, any selected status can match. Between financial and fulfillment groups, both group conditions must match. For example, Financial = Paid or Partially paid, and Fulfillment = Fulfilled or Partially fulfilled means the order must match one financial status and one fulfillment status.
Financial statuses like Refunded only affect whether a new sync is allowed by your filters on order updates. They do not create credit notes or reverse invoices (refunds are not supported).
One order → one document
- First matching order event creates the document and stores a link.
- Later order updates for the same order show skipped / already synced in logs.
- Edits, refunds, and cancellations on Shopify are not updated in e-conomic automatically.
What is sent to e-conomic
The app builds a document with:
- Customer / recipient — from field mappings, linked debtor, or guest default debtor number
- Line items — SKU as product number, quantity, net unit price (after Shopify line discounts)
- Shipping lines (optional) — when enabled, one line per Shopify shipping line or mapped shipping product
- Notes / references — order name, number, notes via order field mappings
- Currency — shop or presentment currency when provided
- Recipient and delivery country — Shopify's full country name when available, with country code as fallback
- VAT zone — advanced map, simple bands, customer default, or linked debtor (see VAT & shipping)
- Payment terms — order default, or from linked customer when enabled
Ensure missing products
When enabled, before posting the order document the app creates any e-conomic products missing from order lines (using SKU/title from the order). Requires a default product group.
Default mappings (orders)
Common settings:
- Layout number
- Payment terms
- Default debtor (guest checkout)
- Recipient VAT zone override
- Default shipping product and per-code shipping product map
Field mappings (orders)
Map Shopify order fields to e-conomic header targets, for example:
- Order name → references / notes
- Order number → note heading
- Order note → note text
Skip reasons in logs
| Reason | Meaning |
|---|---|
| Order sync off | Order sync is turned off |
| Trigger did not match | The order changed, but not for the trigger you selected |
| Status filters did not match | Financial or fulfillment filter was not satisfied |
| Already synced | Document already created for this order (expected on later order changes) |
Example workflows
B2C, invoice when paid
- Trigger: When order is paid
- Document: Invoice + auto-book if your process books immediately
- Filters: not needed
Ship when fulfilled, then invoice
- Trigger: When order is fulfilled
- Document: Invoice
Sync when status changes
- Trigger: When order is updated
- Document: Invoice
- Filters: financial Paid and fulfillment Fulfilled if both conditions are required