Imports

​

Basics

• HTTP
• JSON
• Base64 encoding for binary files.
• UTF-8 encoding for data files.
• SSL is required. Use at least TLSv1.2.
• Files are processed daily, usually around 01:00 AM. The actual time can be found in the import settings of the specific administration.
• If no data file is available for the automatic import a notification is added to the import page.
• Any PDF files of the original invoices are linked based on the file name. The file name must contain the exact invoice number of the invoice. Example: 141234.PDF can be linked to invoice 141234. In order to link the files properly, a setting on the Payt side must be made by the implementation specialist or the service desk.
• In the Import tab of the relevant administration within Payt, linking based on supplied CSV files and automatic import must be enabled. The administration code must also be entered directly.
• When using the FTP/SFTP integration, it is also possible to provide files in a zip archive. These archives will automatically be unarchived in the same directory. Note: only files are unarchived, directories within the zip archive will be ignored.
• When using the HTTP endpoints, it is also possible to provide gzipped files. Files with a .gz extension will automatically be decompressed before further processing. Make sure the extension of the original file is intact (e.g. 20220728.csv.gz will be decompressed and processed as 20220728.csv).

​

Endpoints

​

Format of the data

• Accept-Charset: UTF-8
• Accept: application/json
• Content-Type: application/json

{
  "file": {
    "filename": "20190414.csv",
    "base64_data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iajw8L0NvbnETCETERA..."
  },
  "administration_code": "ADM_2"
}

{
  "file": {
    "filename": "20190414.csv",
    "base64_data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iajw8L0NvbnETCETERA..."
  },
  "administration_code": "ADM_2",
  "import_token": "4e1243bd22c66e76c2ba9eddc1f91394e57f9f83"
}

{
  "file": {
    "filename": "20190414.csv",
    "base64_data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iajw8L0NvbnETCETERA..."
  },
  "administration_id": 1337,
  "import_token": "4e1243bd22c66e76c2ba9eddc1f91394e57f9f83"
}