iController HTTPS datalink

This site explains how to load your debtor data into iController using the iController datalink. You should already have an export (in valid format) of the debtor data from your accounting software. For each subcompany there should be a separate file.

How to load data into iController

First you should send the debtor data file for each subcompany to iController using a HTTPS POST request with the following parameters:

  • url: https://<PLATFORM>.icontroller.eu/datalink/upload/
  • secret: a shared secret for authentication, you should have received this parameter already
  • name: the name of the debtor data file. Use the name of your subcompany + '.xml'
  • contents: the contents of the debtor data file
We recommend using the curl tool to send the data. Curl is a free opensource tool specifically designed to simplify HTTP requests. Because it can be used from the command line it is very easy to automate tasks. The POST request above translates to the following curl invocation:
curl -k --data-urlencode secret=<SECRET> --data-urlencode name=<SUB-COMPANY-NAME>.xml --data-urlencode contents@<LOCAL-FILE-NAME> "https://<PLATFORM>.icontroller.eu/datalink/upload/"

After you have sent all files for each subcompany, you have to notify iController the data should be loaded into iController. You can do this by using a POST request with the following parameters:

  • url: https://<PLATFORM>.icontroller.eu/datalink/refresh/
  • secret: a shared secret for authentication, you should have received this parameter already
When using curl you can do:
curl -k --data-urlencode secret=<SECRET> "https://<PLATFORM>.icontroller.eu/datalink/refresh/"

First you should send the debtor data file for each subcompany to iController using a HTTPS POST request with the following parameters:

  • url: https://<PLATFORM>-testing.icontroller.eu/datalink/upload/
  • secret: a shared secret for authentication, you should have received this parameter already
  • name: the name of the debtor data file. Use the name of your subcompany + '.xml'
  • contents: the contents of the debtor data file
We recommend using the curl tool to send the data. Curl is a free opensource tool specifically designed to simplify HTTP requests. Because it can be used from the command line it is very easy to automate tasks. The POST request above translates to the following curl invocation:
curl -k --data-urlencode secret=<SECRET> --data-urlencode name=<SUB-COMPANY-NAME>.xml --data-urlencode contents@<LOCAL-FILE-NAME> "https://<PLATFORM>-testing.icontroller.eu/datalink/upload/"

After you have sent all files for each subcompany, you have to notify iController the data should be loaded into iController. You can do this by using a POST request with the following parameters:

  • url: https://<PLATFORM>-testing.icontroller.eu/datalink/refresh/
  • secret: a shared secret for authentication, you should have received this parameter already
When using curl you can do:
curl -k --data-urlencode secret=<SECRET> "https://<PLATFORM>-testing.icontroller.eu/datalink/refresh/"

Generate an example datalink package for your company using curl

If you want to use curl we provide a working example data link for your company. Just fill in the data below to download the datalink package. To use it just extract all contents to a separate dir and run "export.bat". It will automatically export all xml-files and csv-files in the same folder to your iController.

https://
.icontroller.eu

If you want to use curl we provide a working example data link for your company. Just fill in the data below to download the datalink package. To use it just extract all contents to a separate dir and run "export_to_testing.bat". It will automatically export all xml-files and csv-files in the same folder to your iController.

https://
-testing.icontroller.eu