Skip to main content

Update of Companies from ARES via API

How to perform "Update All" and "Update from Internet" services via API?

Written by Petr Pech

Both the desktop application and the web interface include a service for updating company information in the address book from ARES. The API function has the same functionality as in the desktop application — it updates the VAT number and bank account details for the given company. Company addresses are not updated. This guide shows how to use the service within the Flexi REST API.

The service is available at the address /adresar/aktualizovat-vse.json, and analogously for XML.

The call supports filters as described in the filtering documentation:

/adresar/(id eq 720)/aktualizovat-vse.json

Usage Examples

1. Update All

This call is the equivalent of the user-facing "Update All" action. It performs an update across the entire address book as recorded in ABRA Flexi.

The call is made using the HTTP GET method:

2. Update a Specific Company

This call is the equivalent of the user-facing "Update from the Internet" action. It updates the selected address book record based on a filter. It updates the company's VAT number and bank account details. The company's address is not updated.

Again, we used the GET method. The call can be restricted using the filters mentioned above — here is an example of filtering by company code:

GET https://demo.flexibee.eu/c/demo/adresar/(kod ='ABRA')/aktualizovat-vse.json

Output

The output contains the standard return values along with information about the number of changed records and a summary of their IDs:

{
"winstrom": {
"@version": "1.0",
"success": "true",
"stats": {
"created": "0",
"updated": "2",
"deleted": "0",
"skipped": "0",
"failed": "0"
},
"results": [
{
"id": "813"
},
{
"id": "807"
}
]
}
}
Did this answer your question?