Čo API vie
| Oblasť | Popis |
|---|---|
| Import faktúr | POST /api/v1/erp/companies/{company}/invoices s povinnou hlavičkou Idempotency-Key – opakovaný identický požiadavok nevytvorí duplikát. |
| Stav | Čítanie faktúr, revízií a stavu doručenia. |
| Odberatelia | Vyhľadanie uložených odberateľov a firiem z verejného registra RPO, doplnenie DIČ. |
| Webhooky | Podpísané notifikácie o doručení, chybe a zmene stavu. |
| Kontrakt | Strojovo čitateľná špecifikácia OpenAPI na /api/v1/erp/openapi.json. |
Bezpečnosť
- Kľúče viazané na jeden pracovný priestor, posielané iba v hlavičke
Authorization: Bearer. - Najmenšie potrebné oprávnenia:
invoices:write,invoices:read,counterparties:read. - Ukladáme iba solené hashe kľúčov, predvolená platnosť 90 dní, okamžité zrušenie.
- Obmedzenie počtu požiadaviek podľa IP, kľúča a pracovného priestoru.
- Serverovo prepočítané sumy a striktné schémy požiadaviek.
Príklad
curl --fail-with-body \
--request POST \
--url "https://faktura.nasit.sk/api/v1/erp/companies/${COMPANY}/invoices" \
--header "Authorization: Bearer ${FAKTURA_API_KEY}" \
--header "Idempotency-Key: ${ERP_INVOICE_ID}" \
--header "Content-Type: application/json" \
--data-binary @invoice.jsonKľúče vytvoríte v aplikácii v časti Nastavenia → Integrácie. Plný prístup k API je súčasťou plánu Growth a samostatných API plánov – pozrite cenník.
Stav prevádzky: NASIT eFaktúra je v procese akreditácie za certifikovaného poskytovateľa doručovacej služby. Produkčné odosielanie a príjem cez Peppol zapneme až po dokončení akreditácie a zápise do zoznamu Finančnej správy. Dovtedy môžete e-faktúry v aplikácii vytvárať, kontrolovať a pripravovať.
Štandardy
Dokumenty vytvárame podľa Peppol BIS Billing 3.0. Viac o slovenskom štandarde rozhrania medzi softvérom a poštárom v článku SAPI-SK.