Data details

Customers

Field	Type	Max value length	Information
Customercode	string	250	See details below
Name	string	250
Address	string	250
Postalcode	string	10
City	string	250
Country	string	2	See details below
Contact	string	250
Phone	string	20	See details below
Mobile	string	20	See details below
Email	string	250
InvoiceEmail	string	250
RegistrationNumber	string	10	See details below
Language	string	10	See details below

CustomerCode

The unique customer identifier (code) as it is stored in your administration.

Country

Customer countries can be stored with the two-digit country code. Please use these codes if you want to save the customer country. This parameter is optional. When it is omitted, we'll use the Netherlands as basic country. See complete list of country codes.

Phone / Mobile

You can use these fields the way you want, so you can use [phone] , 06 - 12345678 or 0612345678 as well.

RegistrationNumber

The company registration number as registered by the Chamber of Commerce.

Language

Allows you to preset the language to be used in the communication to the consumer. When this parameter is not provided, the default language will be used instead. More information.

Possible values: dutch english german french

Invoices

Field	Type	Max value length	Information
Customer	string	36	See details below
InvoiceNumber	string	100
InvoiceDate	date	10	Use dDD-MM-YYYY format
InvoiceDuedate	date	10	Use dDD-MM-YYYY format
InvoiceTotal	amount	10	Example: 1100.00
InvoiceBalance	amount	10	Example: 1100.00
InvoiceStatus	string	10	See details below

Customer

The unique id form your Notify administration. You can find this id with the Search customer API.

InvoiceStatus

The status of the invoice in your administration. Use concept open paid or cancelled. Important: When an invoice gets the status paid or cancelled, no further actions will been made.

InvoiceTotal / InvoiceBalance

Always use two decimals, for example 1100.00 and 0.00.

InvoiceBalance is optional. When it is omitted, InvoiceTotal will be copied.

Documents

Field	Type	Max value length	Information
Invoice	string	36	See details below
Filename	string	250	See details below
Mediatype	string	50	Example: application/pdf
Content	string	5.242.880 (5 MB)	See details below

Invoice

Use the unique id of the invoice you want the document to attach. How to find the invoice id.

Filename

Complete original file name including file extension. For example: invoice-200001.pdf

Content

PDF file content in Base64 format. See https://base64.guru/converter/encode/pdf for more information.

Payments

Field	Type	Max value length	Informayion
Invoice	string	36
Date	date	10	Example: 28-01-2021
Amount	amount	10	Example: 1100.00
Method	string	10	See details below

Method

The method used for the payment. Use banktransfer ideal bancontact sepa or creditcard. When it is omitted, we'll use the banktransfer as basic method.