Import bankovního pohybu
POST /bank_transaction
Přenese nový pohyb do systému. Součástí importu je automatický pokus o spárování s existujícími doklady.
Pravidla pro spárování
Zkouší se v tomto pořadí, dokud se nenajde jednoznačný kandidát:
- Sedí variabilní symbol i částka (přesně, nebo v rámci tolerance kolem 10 %) — plná shoda.
- Sedí jen variabilní symbol, částka je mimo toleranci — částečná shoda.
- Bez variabilního symbolu na pohybu se zkouší jen přesná shoda částky — vždy částečná shoda, nikdy plná.
Tolerance kolem 10 % neplatí, když shoda přišla přes variabilní symbol (body 1 a 2) — spáruje se i doklad, jehož zbývající částka k úhradě je mimo tohle pásmo. Přísně se dodržuje, jen když se páruje podle částky bez variabilního symbolu (bod 3).
Pohyb musí mít vyplněný bank_account, jinak se o spárování ani
nepokusí — s bankovním účtem na dokladu se ale neporovnává.
Hodnoty závislé na směru pohybu
U příchozího pohybu (payment_type in) je protistranou
zákazník a s poli counterparty,
account_entry_type a vat_type se zachází stejně jako
u platby přijaté; u odchozího pohybu je
protistranou dodavatel a pravidla odpovídají
platbě vydané.
Požadavek
Odpovědi
- 200Pohyb byl importován, vrací se jeho detail.
- 400Požadavek je špatně sestavený nebo neprošel validací — chybí povinné pole, hodnota má špatný formát, tělo není platný JSON.
- 401Chybí hlavička X-Auth-Key nebo je API klíč neplatný.
- 402Firma nemá k volání nárok kvůli tarifu — buď je vyčerpaná [kvóta dotazů](/limity#vycerpana-kvota), nebo zdroj patří k modulu, který firma nemá aktivovaný.
- 403Uživatel nemá k operaci oprávnění, nebo ji nelze provést — účetní období či období DPH je uzavřené, doklad je vázaný na jiný záznam.
Datové typy
Tělo požadavku: BankTransactionParams
Tělo odpovědi: 200 — BankTransactionDetail
Chybové odpovědi mají tvar Error, viz Chyby a jak je číst.