# Exact Online Nl

> Exact Online NL integration via Apideck's Accounting unified API — same methods work across every connector in Accounting, switch by changing `serviceId`. Use when the user wants to read, write, or reconcile invoices, bills, payments, ledger accounts, and journal entries in Exact Online NL. Routes through Apideck with serviceId "exact-online-nl".

- Skill: `apideck-libraries/exact-online-nl` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add apideck-libraries/exact-online-nl`
- Raw SKILL.md: https://api.skillmd.com/api/skills/apideck-libraries/exact-online-nl/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Finance & Business
- License: Apache-2.0
- Author: apideck-libraries (https://skillmd.com/u/apideck-libraries)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/apideck-libraries/exact-online-nl

---


# Exact Online NL (via Apideck)

Access Exact Online NL through Apideck's **Accounting** unified API — one of 34 Accounting connectors that share the same method surface. Code you write here ports to Access Financials, Acumatica, banqUP and 30 other Accounting connectors by changing a single `serviceId` string. Apideck handles auth, pagination, rate limiting, and retries so you don't write per-tenant Exact Online NL plumbing.

> **Beta connector.** Exact Online NL is currently in beta on Apideck. Expect partial resource coverage and occasional mapping gaps. Always verify coverage (see below) and fall back to the Proxy API for unsupported operations.

## Quick facts

- **Apideck serviceId:** `exact-online-nl`
- **Unified API:** Accounting
- **Auth type:** oauth2
- **Status:** beta
- **Gotchas:** [page](https://developers.apideck.com/apis/accounting/exact-online-nl/gotchas)
- **Exact Online NL docs:** https://support.exactonline.com
- **Homepage:** https://www.exact.com/nl

## At a glance

- **Implementation difficulty:** moderate — Paid Developer Subscription + App Review Required for External Consumers
- **Vendor partnership required:** yes ([Exact Online App Store (Manage my apps)](https://apps.exactonline.com/nl/)) — Yes — registering your app requires a paid Exact Online developer subscription (per country); App Store listing is optional.
- **Apideck-managed credentials:** Available for testing — OAuth shows Apideck; production requires your own app. The only Exact Online connector with Apideck credentials.
- **Account type required:** Active Exact Online subscription on the Dutch instance
- **Consumer access level:** Any user who can authorise third-party app connections.
- **Sandbox:** available — No isolated sandbox — testing runs against live Dutch Exact Online environments.
- **Costs:** Developer subscription approx. €15/month per country (excl. VAT); no per-call charges.
- **Rate limits:** 60 requests/minute and 5,000 requests/day per app per division; Exact Online Premium raises the daily cap to 30,000.
- **Authentication:** OAuth 2.0 (Authorization Code).
- **Webhooks:** No webhooks — Exact Online has native webhooks, but Apideck does not surface them for this connector; sync by polling.

**Important to know:**

- Exact Online runs separate country instances — an app registered in one country cannot serve consumers in another. For regions beyond this instance, use exact-online (per-connection region) or exact-online-uk.
- Your app must pass Exact's review before consumers outside your own Exact instance can connect — until it does, only your own subscription can be linked, which blocks pilot consumers.
- Refresh tokens are single-use and expire after 30 days of inactivity — a dormant connection must be re-authorised by the consumer.
- Write-back is limited to transactions (invoices, bills, invoice items, payments, bill payments, journal entries); master data — customers, suppliers, ledger accounts, tax rates and credit notes — is read-only, so consumers maintain it in Exact Online.

> Facts synced from Apideck's connector metadata API — `GET /connector/connectors/exact-online-nl` (`overview` field) is the live, authoritative version.

## When to use this skill

Activate this skill when the user explicitly wants to work with **Exact Online NL** — for example, "create an invoice in Exact Online NL" or "reconcile payments in Exact Online NL". This skill teaches the agent:

1. Which Apideck unified API covers Exact Online NL (Accounting)
2. The correct `serviceId` to pass on every call (`exact-online-nl`)
3. Exact Online NL-specific auth and coverage caveats

For the full method surface (parameters, pagination, filtering), use your language SDK skill:

- [`apideck-node`](../../skills/apideck-node/), [`apideck-python`](../../skills/apideck-python/), [`apideck-dotnet`](../../skills/apideck-dotnet/), [`apideck-java`](../../skills/apideck-java/), [`apideck-go`](../../skills/apideck-go/), [`apideck-php`](../../skills/apideck-php/), or [`apideck-rest`](../../skills/apideck-rest/)

For the raw OpenAPI spec:

- **Accounting:** [https://specs.apideck.com/accounting.yml](https://specs.apideck.com/accounting.yml) · [API Explorer](https://developers.apideck.com/api-explorer?id=accounting)

## Minimal example (TypeScript)

```typescript
import { Apideck } from "@apideck/unify";

const apideck = new Apideck({
  apiKey: process.env.APIDECK_API_KEY,
  appId: process.env.APIDECK_APP_ID,
  consumerId: "your-consumer-id",
});

// List invoices in Exact Online NL
const { data } = await apideck.accounting.invoices.list({
  serviceId: "exact-online-nl",
});
```

## Portable across 34 Accounting connectors

The Apideck **Accounting** unified API exposes the same methods for every connector in its catalog. Switching from Exact Online NL to another Accounting connector is a one-string change — no rewrite, no new SDK.

```typescript
// Today — Exact Online NL
await apideck.accounting.invoices.list({ serviceId: "exact-online-nl" });

// Tomorrow — same code, different connector
await apideck.accounting.invoices.list({ serviceId: "access-financials" });
await apideck.accounting.invoices.list({ serviceId: "acumatica" });
```

This is the compounding advantage of using Apideck over integrating Exact Online NL directly: code against the unified Accounting API once, gain access to every connector in it. New connectors Apideck adds become available to your app without code changes.

## Exact Online NL via Apideck Accounting

Netherlands-specific variant of Exact Online, optimized for Dutch divisions and BTW (VAT) handling. Use this connector when the user's Exact instance is on the NL data center. Coverage mirrors [`exact-online`](../exact-online/) (same entities, same methods).

### When to use this vs `exact-online`

| User scenario | Use |
|---|---|
| User's division is in the Netherlands | `exact-online-nl` |
| User's division is in Belgium or a different EU market | `exact-online` |
| User's division is in the UK | `exact-online-uk` |
| Not sure | Ask the user; they know their Exact region |

### Entity mapping + coverage

Identical to [`exact-online`](../exact-online/). See that skill for the full mapping table and coverage highlights.

Key NL-specific behaviors:
- **BTW (VAT) handling:** Dutch 21%, 9%, 0% rates are surfaced via `tax-rates`; VAT on invoices is auto-computed based on customer type (binnenland/EU/buiten-EU).
- **SEPA integration:** bank reconciliation and direct debit integrations more common in NL; extra fields may surface on `payments`.
- **UBL e-invoicing:** mandatory for B2G invoicing in NL. Use Proxy for UBL-specific formatting endpoints.

### Auth notes

- **Type:** OAuth 2.0, managed by Apideck Vault
- **Data center:** `start.exactonline.nl`. Wrong-DC errors indicate the user picked the wrong variant at OAuth time — connection needs re-authorization against the correct variant.

### Example: list invoices updated today

```typescript
const { data } = await apideck.accounting.invoices.list({
  serviceId: "exact-online-nl",
  filter: { updated_since: new Date(new Date().setHours(0,0,0,0)).toISOString() },
});
```

## Verifying coverage

Not every Accounting operation is supported by every connector. Always verify before assuming a method works:

```bash
curl 'https://unify.apideck.com/connector/connectors/exact-online-nl' \
  -H "Authorization: Bearer ${APIDECK_API_KEY}" \
  -H "x-apideck-app-id: ${APIDECK_APP_ID}"
```

See [`apideck-connector-coverage`](../../skills/apideck-connector-coverage/) for patterns around `UnsupportedOperationError` and connector-specific fallbacks.

## Escape hatch: Proxy API

When an endpoint isn't covered by the Accounting unified API, use Apideck's Proxy to call Exact Online NL directly — Apideck injects auth headers and handles token refresh. Set `x-apideck-downstream-url` to the target endpoint on Exact Online NL's own API:

```bash
curl 'https://unify.apideck.com/proxy' \
  -H "Authorization: Bearer ${APIDECK_API_KEY}" \
  -H "x-apideck-app-id: ${APIDECK_APP_ID}" \
  -H "x-apideck-consumer-id: ${CONSUMER_ID}" \
  -H "x-apideck-service-id: exact-online-nl" \
  -H "x-apideck-downstream-url: <target endpoint on Exact Online NL>" \
  -H "x-apideck-downstream-method: GET"
```

See [Exact Online NL's API docs](https://support.exactonline.com) for available endpoints.

## Sibling connectors

Other **Accounting** connectors that share this unified API surface (same method signatures, just change `serviceId`):

[`access-financials`](../access-financials/) *(beta)*, [`acumatica`](../acumatica/) *(beta)*, [`banqup`](../banqup/) *(beta)*, [`campfire`](../campfire/) *(beta)*, [`clearbooks-uk`](../clearbooks-uk/) *(beta)*, [`digits`](../digits/) *(beta)*, [`dualentry`](../dualentry/), [`exact-online`](../exact-online/), and 25 more.

## See also

- [Accounting OpenAPI spec](https://specs.apideck.com/accounting.yml) · [API Explorer](https://developers.apideck.com/api-explorer?id=accounting)
- [`apideck-connector-coverage`](../../skills/apideck-connector-coverage/) — programmatic coverage checks
- [`apideck-best-practices`](../../skills/apideck-best-practices/) — architecture, Vault, pagination, error handling
- [`apideck-node`](../../skills/apideck-node/) — TypeScript / Node SDK patterns
- [Exact Online NL official docs](https://support.exactonline.com)