Jak z objednávky vystavit fakturu jedním voláním
Faktura převezme zákazníka i položky z přijaté objednávky a objednávka se v Pohodě označí jako vyřízená. Bez ručního přenosu a bez rizika překlepu.
Když už objednávka v Pohodě je (třeba z e-shopu podle návodu Jak do Pohody naimportovat objednávku), nemusíte fakturu skládat znovu. Stačí Pohodě říct, ze které objednávky ji má vystavit. Zákazník, položky, ceny i DPH se převezmou a faktura je s objednávkou propojená — přesně jako když v Pohodě použijete přenos objednávky do faktury.
Volání
Potřebujete jediný údaj: id objednávky v Pohodě, které jste dostali při jejím vytvoření (nebo ho najdete exportem GET /api/v1/order/received).
curl -X PUT https://api.apios.cz/api/v1/invoice \
-H "X-AUTH-TOKEN: VAS_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: faktura-z-objednavky-23" \
-d '{
"order_pohoda_id": 23,
"order_id": 2026,
"date_due": "2026-11-02"
}'
Totéž volání najdete v dokumentaci se všemi parametry a můžete si ho tam rovnou vyzkoušet:
order_pohoda_id— ID objednávky v Pohodě. Jediné povinné pole.order_id— číslo objednávky ve vašem systému. Uloží se do poznámky faktury, aby bylo dohledatelné, odkud faktura vznikla.date_due— datum splatnosti. Bez něj použije Pohoda splatnost podle svého nastavení.
Odpověď obsahuje ID a číslo nové faktury:
{
"success": true,
"message": "Faktura byla úspěšně vytvořena z objednávky",
"data": {
"id": 812,
"number": "250100184",
"action_type": "link"
}
}
action_type: link znamená, že faktura vznikla propojením s objednávkou.
Další pole, která se hodí
Faktura z objednávky přijímá i tyto údaje:
| Pole | K čemu |
|---|---|
date |
Datum vystavení, výchozí je dnešek. |
date_tax |
Datum zdanitelného plnění. |
number_series |
Kód číselné řady faktur, pokud nechcete výchozí. |
sym_var |
Variabilní symbol, výchozí se odvodí z čísla faktury. |
note, int_note |
Poznámka na fakturu a interní poznámka. |
centre_id, activity_id, contract_id |
Středisko, činnost a zakázka pro analytiku. |
Typický postup v e-shopu
- Zákazník objedná →
PUT /api/v1/order/received, uložíte siid. - Sklad objednávku vychystá a vydá.
- E-shop zjistí přes
GET /api/v1/order/{id}/status, že je objednávka vydaná, a zavoláPUT /api/v1/invoicesorder_pohoda_id. - Fakturu jako PDF stáhne a pošle zákazníkovi — viz Jak poslat zákazníkovi fakturu jako PDF.
Faktura bez objednávky
Prodáváte služby nebo předplatné a objednávky v Pohodě nevedete? Fakturu můžete vystavit i samostatně, s vlastními položkami. Postup je v návodu Jak vystavit fakturu z vlastní aplikace.