Preskoči na glavno vsebino

Stiahnutie príkazu na úhradu cez API

Príklad URL adresy

Avtor: Petr Pech

Elektronický príkaz na úhradu, ktorý sa inak z aplikácie ukladá do súboru pre internetové bankovníctvo, je možné stiahnuť aj cez REST API.


Stiahnutie súboru

GET /c/{firma}/prikaz-k-uhrade/{id}/stazeni

Jednotlivé časti adresy:

Časť adresy

Význam

{firma}

Strojový identifikátor firmy.

prikaz-k-uhrade

Označenie evidencie.

{id}

Identifikátor príkazu na úhradu — interné číslo, kód alebo externý identifikátor.

stazeni

Endpoint, ktorý vráti samotný súbor.

Odpoveďou je binárny súbor (application/octet-stream) vo formáte, ktorý je nastavený na bankovom účte — pole Formát el. bank. pre príkazy (elBanFormatPrikaz). Voliteľný parameter ?dat-splat-z-hlavicky=true prevezme dátum splatnosti z hlavičky príkazu namiesto z jednotlivých položiek.

⚠️ Stiahnuť je možné len príkaz v stave Neodoslané. Stiahnutím sa príkaz prepne do stavu Odoslané a každý ďalší pokus skončí chybou 400 so stránkou „Operáciu nemožno vykonať". Ak chcete súbor stiahnuť znovu, zrušte najprv odoslanie: PUT /c/{firma}/prikaz-k-uhrade/{id}/zrusit-odeslani.


Ďalšie operácie s príkazom

Operácia

Adresa

Vytvorenie príkazu

PUT /c/{firma}/prikaz-k-uhrade — hlavička s bankovým účtom a položkami; položka môže namiesto čísla účtu odkazovať priamo na hradený doklad cez doklFak.

Odoslanie do Fio banky

GET /c/{firma}/prikaz-k-uhrade/{id}/odeslani-fio — iba pre Fio banku s online napojením.

Zrušenie stavu odoslania

PUT /c/{firma}/prikaz-k-uhrade/{id}/zrusit-odeslani

💡 Príkaz na úhradu je možné cez API aj celý vytvoriť — v položkách stačí uviesť doklFak s odkazom na hradenú faktúru a sumu aj účet si Flexi doplní z dokladu.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?