Manual

🇩🇪 Diesen Artikel auf Deutsch lesen

Automatic data import

Introduction

We of course support automated data import – it is the only way to reduce the effort of sanctions list and PEP screening to a minimum while still fully meeting your legal obligations. Two approaches have proven themselves in practice: using our API, which lends itself particularly well to online shops (see also the API documentation), and the automatic import of CSV files (more on how the CSV file should be structured / OWASP compliance), which is described below.

Scenario

You use an ERP, CRM or other business system and want to automate the upload of the CSV files, so that nobody has to keep your records in easycompliance up to date by hand.

How it works

First, make sure your software supports the automated export of CSV files. This is a basic feature of every common solution, or can at least be added afterwards via what is usually called workflows or batch runs. Save the generated CSV file wherever you like. What matters is that the file always keeps the same name and that the name contains no timestamp or similar. You can of course generate several CSV files, for example "private-customers.csv", "business-customers.csv" and "suppliers.csv". If you would like to use automatic import, please contact our customer service – they will provide your credentials and set the automatic import up for you.

Providing the file via FTPS

The generated CSV file is then uploaded to an online storage location every evening. You get access to it via FTPS, because we collect the CSV files from there automatically every night and start the import. A direct automatic import into easycompliance is not possible, and neither is us collecting the files from one of your own servers.

The easiest route is probably an automated upload using the free tool WinSCP. Every administrator knows this program, and automating file uploads with it takes only a few minutes (described by WinSCP themselves, or see below for our ready-made example configuration). You are of course free to use a different tool. Some ERP systems – particularly cloud-based ones – can even transfer the files they generate themselves.

IMPORTANT: Please upload your files by 10 p.m. (CET/CEST) so that they can still be picked up by the next import run. Otherwise they will be delayed by one day.

A note on ports and firewalls

Please make sure that ports 40000:40099 are open in your firewall, as the secure connection between you and us is handled over these ports. Also make sure your firewall does not block outbound connections.

For security reasons we use several firewalls and proxies, so it can happen that you are unable to establish an FTPS connection to us at first. In that case please contact our customer service and let us know the IP address you transfer the data from. We will then unblock that IP manually.

Automating the upload with WinSCP

We have prepared ready-made scripts for you. All you have to do is enter the FTPS credentials you received from our customer service and specify the folder on your server that holds the files to be uploaded.

Downloading the scripts and the instructions

You can download the scripts as a ZIP archive here: Go to download

The ZIP archive contains the following files:

File Description
ANLEITUNG.md Read this first. Instructions for correct use and setup (German).
easycompliance-upload.bat WinSCP execution script used by the scheduler.
easycompliance-upload.txt Configuration file in which you have to change the user name, password and path.
zeitplan-einrichten.bat Creates a scheduled Windows task that runs the upload at a set time.
zeitplan-entfernen.bat Removes that scheduled Windows task again.

Last reviewed: