Calling LinX with business files

When processing files with LinX, you can specify whether they should be treated as business-related by adjusting the headers in the Convert, Pivot, and Pivot Group services. Activating business categorization modifies how transactions are interpreted, ensuring that business-specific details are accurately detected and categorized.

For instance, a food purchase by an individual is typically categorized as "VOEDING EN VERSNAPERINGEN" (Food and Refreshments), but for a restaurant, it should be categorized as "INKOOP" (Stock Acquisition).

There are two methods to enable business categorization.

Method 1: Using the KvK and SBI Headers

The simplest method involves adding the KvK and SBI headers to your API call:

• KvK Header: Provide the unique integer identifier assigned by the Chamber of Commerce.
• SBI Header: Optionally include the SBI code corresponding to the business activity. If omitted, the default SBI code registered with the Chamber of Commerce will be used.

Example: Include the KvK and SBI headers in the request header as follows:

{
"KvK": "01234567",
"SBI": "0000"
}

Method 2: Using the Business Header

A more flexible option is to use the Business Header, which supports multiple IBANs and their corresponding business details. The structure of the Business Header is as follows:

Businesses:
[
	{
		"IBan": "NL69RABO0123456789",
		"KvK": "01234567",
		"SBI": "1234"
	},
	{
		"IBan": "NL69INGB0123456789",
		"KvK": "01234567"
	}
]

Key Points:

• IBAN: Specify the IBAN(s) from the input files that should be treated as business-related.
• KvK: Provide the Chamber of Commerce identifier for each IBAN.
• SBI: Optional. If not provided, the standard SBI code on record at the Chamber of Commerce will be used.

info

The business information in these headers pertains to the account owner, not the transaction counterparts.