V desktopové aplikaci i ve webovém rozhraní existuje služba pro aktualizaci informací v adresáři o dané firmě z ARESu. Funkce v API má totožnou funkčnost jako v desktopové aplikaci, u dané firmy tedy aktualizuje DIČ a bankovní spojení. Nedochází k aktualizaci firem. V tomto návodu si ukážeme, jak službu využít v rámci REST API Flexi.
Služba je dostupná na adrese /adresar/aktualizovat-vse.json, analogicky pro XML.
Ve volání je možné využít filtry, jak je uvedeno v dokumentaci filtrace:
/adresar/(id eq 720)/aktualizovat-vse.json
Příklady použití
1. Aktualizovat vše
Toto volání je obdobou uživatelské služby "Aktualizovat vše". Toto volání provede aktualizaci nad kompletním adresářem, jak je evidován v ABRA Flexi.
Volání provádíme pomocí metody HTTP metody GET:
GET https://demo.flexibee.eu/c/demo/adresar/aktualizovat-vse.json
2. Aktualizovat konkrétní firmu
Toto volání je obdobou uživatelské služby "Aktualizovat z internetu". Volání provede aktualizaci vybraného adresářového záznamu dle filtru. Aktualizuje DIČ a bankovní spojení firmy. Nedochází k aktualizaci adresy firmy.
Opět jsme použili metodu GET, volání můžeme omezit dle zmíněných filtrů, ukážeme si příklad na omezení dle kódu firmy:
GET https://demo.flexibee.eu/c/demo/adresar/(kod ='ABRA')/aktualizovat-vse.json
Výstup
Výstup obsahuje standardní návratové hodnoty a informaci o počtu změněných záznamů a souhrn jejich ID:
{
"winstrom": {
"@version": "1.0",
"success": "true",
"stats": {
"created": "0",
"updated": "2",
"deleted": "0",
"skipped": "0",
"failed": "0"
},
"results": [
{
"id": "813"
},
{
"id": "807"
}
]
}
}