Přeskočit na hlavní obsah

Příkaz k úhradě

Jak vytvořit příkaz k úhradě v REST API?

Autor: Petr Pech

Příkaz k úhradě lze vytvářet přes REST API klasicky HTTP operací PUT nebo POST na evidenci /c/{firma}/prikaz-k-uhrade.


Vytvoření příkazu

Ukázka vytvoření příkazu ve formátu XML — první položka je zadána ručně (číslo účtu, částka, směrový kód), druhá uhrazuje konkrétní doklad:

<?xml version="1.0"?>
<winstrom version="1.0">
<!-- Příkazy k úhradě -->
<prikaz-k-uhrade>
<banka>code:BANKOVNÍ ÚČET</banka>
<polozky>
<!-- Položky -->
<prikaz-k-uhrade-polozka>
<buc>123456</buc>
<castka>1200.0</castka>
<smerKod>code:0100</smerKod>
</prikaz-k-uhrade-polozka>
<!-- Položka uhrazující zadaný doklad -->
<prikaz-k-uhrade-polozka>
<doklFak>code:PF1478/2020</doklFak>
</prikaz-k-uhrade-polozka>
</polozky>
</prikaz-k-uhrade>
</winstrom>

ℹ️ Seznam všech atributů hlavičky i položek najdete v evidencích prikaz-k-uhrade a prikaz-k-uhrade-polozka. Do příkazu lze zařadit jen doklady podepsané k úhradě, pokud to má firma nastaveno — viz Podpis k úhradě přes REST API.


Pokročilejší operace

Metoda

URL

Popis

GET

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

volitelně ?dat-splat-z-hlavicky=true|false

Získá soubor s elektronickým popisem příkazu k úhradě vhodný k odeslání do banky. Parametrem dat-splat-z-hlavicky lze ovlivnit nastavení volby data splatnosti z hlavičky příkazu.

GET

/c/{firma}/prikaz-k-uhrade/{id}/odeslani-fio

volitelně ?dat-splat-z-hlavicky=true|false

Provede online odeslání příkazu k úhradě — pouze Fio banka s online napojením. Parametrem dat-splat-z-hlavicky lze ovlivnit nastavení volby data splatnosti z hlavičky příkazu.

PUT / POST

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

Zruší stav odeslání příkazu.


Související

Dostali jste odpověď na svou otázku?