Aktualizace firem z ARES přes API

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"
      }
   ]
 }
}