Każdy typ dokumentu sprzedaży ma w API własny zasób. Wyjątkiem są faktura VAT i proforma: obie korzystają z /invoices.json i różnią się wartością pola kind. Pozostałe typy mają osobne ścieżki, bo mają inne pola, np. faktura korygująca wskazuje fakturę korygowaną, a faktura końcowa rozlicza wcześniejsze zaliczki.
| Dokument | Zasób | KSeF | Tworzenie w kolejce | |
|---|---|---|---|---|
Faktura VAT (kind: vat) |
/invoices |
tak | tak | tak |
Faktura proforma (kind: proforma) |
/invoices |
nie | tak | tak |
| Faktura zaliczkowa | /advance_invoices |
tak | tak | tak |
| Faktura końcowa | /final_invoices |
tak | tak | tak |
| Faktura korygująca | /corrective_invoices |
tak | tak | tak |
| Faktura marża | /margin_invoices |
tak | tak | tak |
| Faktura zaliczkowa marża | /margin_advance_invoices |
tak | tak | nie |
| Faktura końcowa marża | /margin_final_invoices |
tak | tak | nie |
| Faktura korygująca marża | /corrective_margin_invoices |
tak | tak | tak |
| Faktura OSS | /oss_invoices |
nie | tak | tak |
| Faktura korygująca OSS | /corrective_oss_invoices |
nie | tak | tak |
| Faktura wewnętrzna | /internal_invoices |
nie | nie | tak |
| Dowód wewnętrzny | /internal_evidences |
nie | tak | tak |
| Utarg dzienny | /daily_revenues |
nie | tak | tak |
| Raport fiskalny | /fiscal_reports |
nie | nie | tak |
Osobne zasoby
Typy dokumentów różnią się polami wymaganymi i regułami podatkowymi. Każdy zasób ma własny schemat w referencji API, więc walidacja i podpowiedzi w generatorach SDK obejmują tylko pola danego typu.
Ograniczenia
- Korekta to osobny dokument (
/corrective_invoices). Faktury przyjętej przez KSeF nie koryguje się przez jej edycję. - Koszty (
/documents/costs) to dokumenty zakupowe i należą do osobnego modułu.