Twinfield

Connect Twinfield to your product through Chift’s unified Accounting API.

Overview legend

See what this connector supports ↓

Introduction

Twinfield is cloud accounting software from Wolters Kluwer, used mainly in the Netherlands and the United Kingdom. It covers bookkeeping, invoicing, VAT and bank reconciliation, for businesses and for accountants working on their behalf.

Activate Twinfield

Partner keys

You can use Chift’s app, or register your own with Twinfield.

Use Chift's app

Chift creates your dedicated app in your name. Your end users see your company name, not Chift’s, on the OAuth2 consent screen. No Twinfield developer account needed.

Use your own app

Register your own OAuth 2.0 / OpenID Connect client on the Twinfield Developer Portal. Until Twinfield certifies it, an uncertified ClientId only gets 5% of the standard credit quota. See Rate limits.

If you register your own app, request these scopes:

openid twf.user twf.organisation twf.organisationUser offline_access

Set the redirect URI to:

https://chift.app/oauth2/redirect

The steps below apply if you use Chift’s app.

1. Contact your Chift Customer Success Manager

   They create your dedicated Twinfield app and give you its client_id.

2. Complete Twinfield's client details form

   Fill in Twinfield’s form with your company information and the client_id from step 1. The form sets up the €55/month certification subscription. It requires an IBAN and a signature.

   
3. Get your test environment

   Once you submit the form, Twinfield provides a test environment and a support portal, included in the certification subscription. Go through Chift for support instead of Twinfield’s portal.

4. Certification

   Twinfield certifies your app once it processes your information.

Activate Twinfield in your Chift account

In Connectors, enter your client_id and client_secret.

Connector settings

No connector-specific settings.

Test Twinfield

Environment	Test environment, provided by Twinfield
How to get it	Included in the certification subscription. You receive it after submitting the form in step 2

Vendor fees

Software editor (you)

€55/month for Twinfield’s API certification subscription, billed by Wolters Kluwer by direct debit, with a 12-month minimum term.

End user

No fees.

Connect Twinfield

Twinfield setup guide for end users

The full step-by-step, with screenshots.

Before they start, your end users need:

• a Twinfield user account
• for bank statement integration, a Twinfield role from Level 1 to Level 4

To connect, they:

• sign in with their Wolters Kluwer account and a one-time password
• authorize access, keeping every requested permission selected
• select the company to connect

Rate limits

Twinfield applies a credit-based rate limit. Query requests (GET) cost 1 credit, and all other requests cost 3 credits.

Every app Chift creates is a certified integration, with these limits:

Limit	Value
Credits per IP address	1,000 per minute
Credits per ClientId	1,000 per minute
Credits per OrganisationId	1,000 per minute
Credits per ClientId and OrganisationId combined	500 per minute
Concurrent requests per ClientId	20
Concurrent requests per ClientId and organization combined	10

When a limit is exceeded, Twinfield returns HTTP 429 Too Many Requests.

Chift automatically manages these limits to optimize performance and prevent interruptions. However, once the API rate limit is reached, Chift cannot bypass these limitations.

See Twinfield’s fair use policy.

Limitations & specificities

Journal entries

Retrieving journal entries requires both a start and end date. The range cannot exceed 3 months.

This limit is applied by Chift, not by Twinfield.

Financial entries

An entry posted in a bank or cash journal can only have a number made of digits.

Twinfield rejects an entry that would leave a balance sheet account (such as a cash book) with a negative balance.

Bank feed

The external bank statement number can be at most 10 digits.

Coverage

Troubleshooting

Specific errors for Twinfield:

Error Code	Error description	Resolution
ERROR_INVALID_BODY	Twinfield validates email formats, bank account/IBAN formats, and requires journals to be set up correctly for currency dates.	Provide a valid email, ensure the journal supports currency dates, and provide a valid bank account number or IBAN (minimum 2 characters).
ERROR_INVALID_FIELD_FORMAT_NUMBER	The entry number must contain only digits in Twinfield.	Use only numeric characters for the entry number.
ERROR_INVALID_FIELD_FORMAT_STATEMENT_NUMBER	The external bank statement ID/number can only contain a maximum of 10 digits in Twinfield.	Shorten the statement number to 10 digits or fewer.
ERROR_INVALID_PERIOD	’date_from’ and ‘date_to’ are mandatory for Twinfield journal entries retrieval. The date range must be 3 months or less.	Provide both date parameters and ensure the range doesn’t exceed 3 months.
ERROR_NEGATIVE_JOURNAL_BALANCE	A negative balance on the balance sheets is blocking the use of the ledger account in Twinfield.	Correct the negative balance in Twinfield before creating new entries.