Preskoči na glavno vsebino

Príkaz na úhradu

Ako vytvoriť príkaz na úhradu v REST API?

Avtor: Petr Pech

Príkaz k úhrade je možné vytvárať cez REST API klasicky HTTP operáciou PUT alebo POST na evidenciu /c/{firma}/prikaz-k-uhrade.


Vytvorenie príkazu

Ukážka vytvorenia príkazu vo formáte XML — prvá položka je zadaná ručne (číslo účtu, suma, smerový kód), druhá uhrádza konkrétny 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>

ℹ️ Zoznam všetkých atribútov hlavičky aj položiek nájdete v evidenciách prikaz-k-uhrade a prikaz-k-uhrade-polozka. Do príkazu je možné zaradiť len doklady podpísané na úhradu, pokiaľ to má firma nastavené — pozri Podpis k úhrade cez REST API.


Pokročilejšie operácie

Metóda

URL

Popis

GET

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

voliteľne ?dat-splat-z-hlavicky=true|false

Získa súbor s elektronickým popisom príkazu k úhrade vhodný na odoslanie do banky. Parametrom dat-splat-z-hlavicky je možné ovplyvniť nastavenie voľby dátumu splatnosti z hlavičky príkazu.

GET

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

voliteľne ?dat-splat-z-hlavicky=true|false

Vykoná online odoslanie príkazu k úhrade — iba Fio banka s online napojením. Parametrom dat-splat-z-hlavicky je možné ovplyvniť nastavenie voľby dátumu splatnosti z hlavičky príkazu.

PUT / POST

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

Zruší stav odoslania príkazu.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?