2app Klarna to e-conomic

Help

Everything you need to connect Klarna, map your e-conomic accounts, run syncs, and troubleshoot errors in Klarna to e-conomic.

Getting started

Install the app from the e-conomic Marketplace. You will be redirected here to finish setup in three steps:

  1. Connect e-conomic — we use e-conomic's secure grant-token model. Your e-conomic password is never stored.
  2. Connect Klarna — add your Settlements API username (UID) and password. Choose environment (live or playground) and region.
  3. Map accounts — choose your cashbook journal, fee, net, difference (rounding), and optional clearing account.

When setup is complete, the Home dashboard shows a green status banner and you can run your first sync.

Home dashboard

Home is your overview after login. The status banner at the top reflects the current state of your setup and sync:

  • All good — last sync completed successfully. Use Process settlements when you want to fetch new Klarna payouts.
  • Sync in progress — a sync is running. The banner updates automatically while payments are imported.
  • Needs attention — a failed sync or payments that are not yet resolved. Open Sync or Activity with the Needs attention filter.
  • e-conomic access lost — reconnect in Settings before syncing again.
  • Setup checklist — shown until e-conomic, Klarna, account mapping, and your first sync are complete.

When Klarna is connected, the settlements card shows sync status, pending payments, or the time of the last import. Below the banner you will see connection status, sync statistics (last 30 days), the next scheduled run (if enabled), and a table of recent sync runs. Click any run to open its detail page.

Home dashboard overview
The settlements card shows Klarna import status and links to Sync.

Connections

e-conomic

The app needs permission to read invoices and create cashbook vouchers in your e-conomic agreement. After you log in, open Settings → Connections.

  • Reconnect — use this if e-conomic access was revoked or expired.
  • Disconnect — removes the grant token from this app. Uninstalling from the Marketplace also revokes access immediately.

Klarna

In the Klarna Merchant Portal, create Settlements API credentials (username / UID and password). Paste them in Settings → Connections (or during onboarding). Credentials are encrypted after saving. See also the Settlements API documentation.

Settings Connections tab with Klarna credentials
Settings → Connections — Settlements API username, password, environment and region.

Accounting mapping

Each synced Klarna settlement line becomes a balanced cashbook voucher in e-conomic:

  • Gross — customer payment matched to a booked invoice, or posted to a clearing account when invoice matching is off.
  • Fee — Klarna fees from the payout (FEE rows attached to the related SALE/RETURN).
  • Net — payout amount deposited to your bank (sale minus fees).
  • Difference — when invoice gross ≠ payment gross (rounding), or a small DKK FX rounding line on non-DKK settlements.

From Klarna we import SALE, RETURN, and related types (refunds, credits, fee refunds). Standalone FEE rows are folded into the related sale. Holdbacks, releases, and other non-payment types are skipped.

Invoice matching mode

Choose how payments without a booked invoice are handled:

  • Require booked invoice — matches Klarna merchant_reference to the e-conomic invoice Other reference field. If your shop does not put the order/invoice id there, use flexible mode instead.
  • Allow payments without invoice — unmatched gross amounts post to a clearing account you choose. Useful when not every payment has an invoice yet.

Accounts to map

  • Cashbook journal — where vouchers are created.
  • Difference account — small rounding when payment gross ≠ invoice gross, or a DKK FX rounding line on non-DKK settlements.
  • Fee account — Klarna transaction fees per settlement line.
  • Net / bank account — the net settlement amount deposited to your bank.
  • Clearing account — only required in flexible invoice mode.

Account numbers depend on your chart of accounts. If you are unsure, ask your accountant before saving.

Settings Accounting tab with journal and account mapping
Settings → Accounting — invoice matching mode, journal, difference, fee, and net accounts.

Sync

Open Sync in the app to fetch and post Klarna settlements. The app works in two steps:

  1. Ingest settlements — Klarna payouts (from the Settlements API or CSV upload) are imported; sale, return, and related payment lines become settlement rows.
  2. Post to e-conomic — each payment is turned into a cashbook voucher using your account mapping.

Already-imported payments are skipped automatically — re-running a sync does not create duplicates in e-conomic. You can also upload a settlement CSV manually when needed.

Process settlements

Click Process settlements to poll Klarna payouts and post new lines. Use Advanced to limit by sale date, or upload a settlement CSV.

Sync page with Process settlements button and CSV import
Sync — Process settlements polls Klarna and posts vouchers. Use CSV import if you need to re-import.

Scheduled sync

In Settings → Schedule, choose daily or weekly automatic sync and the time of day. The Home dashboard shows when the next run is due.

Activity

The Activity page shows your payment timeline and sync history in one place. Filters and paging update instantly without reloading the whole page.

Activity page with payment list and status filters
Activity — filter by status, search references, and Retry or Resolve failed payments.

Filters and search

  • All — individual payments plus sync history below.
  • Sync history — hide payments and show only the list of sync jobs.
  • Needs attention — payments that failed and still need your action.
  • Search — type a payment or settlement reference; results update as you type.

Payments

Each row is one payment from a Klarna settlement report. You see the reference, status, time, and settlement batch. Use Payload to inspect raw payment, settlement, and e-conomic voucher data when troubleshooting. Actions appear on failed or synced payments:

  • Retry — try again to post this payment to e-conomic (for example after you booked the missing invoice). A short confirmation toast appears when done; the list refreshes automatically.
  • Resolve — hide the error when you handled it outside the app (for example, entered the voucher manually in e-conomic).
  • Resolve all — available on the Needs attention filter to clear every open error at once.
  • Force retry — on already-synced or skipped payments only. Use with care: this may create a duplicate voucher in e-conomic. The app asks you to confirm first.

Sync history

The table at the bottom lists each sync job with scope (all reports or a date filter), trigger (manual, scheduled, or CSV import), and result counts. Click a row to open the sync run page with every payment in that job and a Retry processing option when errors occurred.

The Home banner counts only unresolved errors — successfully retried or manually resolved payments no longer increase the attention count.

Settings

Settings is organised in tabs on the left (or a dropdown on mobile). Switch tabs without leaving the page; the URL updates so you can bookmark a section (for example ?tab=schedule). When you save a form, changes are sent in the background and a toast notification confirms success or shows an error.

Connections
Connect, reconnect, or disconnect e-conomic and Klarna.
Accounting
Invoice matching mode and account mapping.
Schedule
Automatic sync frequency and time.
General
Company display name and timezone.
Notifications
Email alerts when a sync has errors or warnings.
Security
Change your login password.

Sidebar tip: use the arrow at the bottom of the left menu to collapse it. Your preference is remembered on this browser.

Troubleshooting

"e-conomic access lost" on Home

Reconnect in Settings → Connections. Make sure you select the same agreement number as before.

Payment failed — no matching invoice

Ensure the e-conomic invoice Other reference equals the Klarna merchant_reference, then Retry in Activity. Or switch to flexible invoice mode and map a clearing account in Settings → Accounting.

No settlements arriving

Confirm Settlements API credentials in Settings → Connections (correct environment and region), then run Process settlements for the payout date range. You can also upload a settlement CSV on Sync.

Klarna connection test fails

Verify the Settlements API username and password in the Klarna Merchant Portal. Use playground credentials with environment Playground, and live credentials with Live. Pick the correct region (Europe, North America, or Oceania).

Settlement download failed

Usually the username/password cannot call the Settlements API. Update credentials in Settings, then Process settlements again.

Payment gross does not match invoice

Small differences are posted to your Difference account (configured in Settings → Accounting). If the gap is large, check that the booked invoice gross matches the Klarna SALE amount.

Payment failed — e-conomic API error

Open the payment or sync run in Activity and read the error message shown on the line. Common causes: wrong journal, missing voucher number series for the accounting year, or invalid account numbers.

Retry does not fix the problem

Fix the underlying issue in e-conomic or your mapping first, then retry the individual payment. If you already fixed it manually in e-conomic, use Resolve instead of force retry.

Duplicate voucher in e-conomic

This can happen if you used Force retry on a payment that was already synced. Delete or correct the duplicate in e-conomic, then use Resolve on the line in Activity if needed.

Non-DKK settlement does not balance in e-conomic

Klarna payouts may be in EUR, NOK, or other currencies. The app posts amounts in that currency and adds a small DKK line on your Difference account when e-conomic FX rounding leaves a few øre unbalanced (up to 1.00 DKK). If the error mentions a larger DKK residual, check the voucher lines in Activity → Payload.

Page looks outdated after an action

Activity and Settings refresh their content automatically after retry, resolve, or save. If something still looks wrong, hard-refresh the browser (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).

Forgot your password?

Use Forgot password? on the login page.

Still need help?

Email us at info@2app.dk — we normally reply within 24 hours. See also our Support page.