# E-faktúra API pre ERP, e-shopy a účtovný softvér

> REST API NASIT eFaktúra pre ERP, e-shopy a účtovný softvér: import faktúr s idempotenciou, validácia EN 16931 a Peppol BIS, stav doručenia, webhooky a vyhľadanie odberateľov z RPO.

Canonical: https://faktura.nasit.sk/pre-vyvojarov
Last updated: 2026-10-26

Pripojte vystavovanie, kontrolu a doručovanie e-faktúr priamo do svojho systému. Vy pošlete dáta faktúry, my ich overíme, vytvoríme Peppol BIS dokument a dáme vám vedieť, čo sa s ním stalo.

[API plány a ceny](https://faktura.nasit.sk/cennik#api)

## Čo API vie

**Funkcie ERP API**

| 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

```
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.json
```

Kľúč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](https://faktura.nasit.sk/cennik#api).

> **Stav prevádzky:** NASIT je certifikovaný poskytovateľ doručovacej služby zapísaný v zozname Finančnej správy (PA SK ID EFSK000073). Odosielanie a príjem e-faktúr cez Peppol pre platiteľov aj neplatiteľov DPH a automatický reporting Finančnej správe pre platiteľov DPH.

## Štandardy

Dokumenty vytvárame podľa [Peppol BIS Billing 3.0](https://faktura.nasit.sk/sprievodca/format-en-16931-ubl). Viac o slovenskom štandarde rozhrania medzi softvérom a poštárom v článku [SAPI-SK](https://faktura.nasit.sk/sprievodca/sapi-sk).

## Súvisiace témy

- [SAPI-SK](https://faktura.nasit.sk/sprievodca/sapi-sk) - Čo je SAPI-SK (Standardised Access Point Interface), aké operácie definuje a čo znamená pre dodávateľov účtovného a ERP softvéru pri e-faktúre.
- [Formát e-faktúry: EN 16931 a UBL](https://faktura.nasit.sk/sprievodca/format-en-16931-ubl) - Ako vyzerá platná slovenská e-faktúra: norma EN 16931, syntax UBL 2.1, Peppol BIS Billing 3.0, povinné polia, kódy DPH a vzorový XML súbor.
- [Validátor e-faktúr](https://faktura.nasit.sk/nastroje/validator-e-faktury) - Bezplatný online validátor e-faktúr: overte UBL 2.1 XML podľa oficiálnych pravidiel OASIS, CEN EN 16931 a Peppol BIS Billing 3.0.21. Zrozumiteľný zoznam chýb, súbor neukladáme.
- [Digitálny poštár](https://faktura.nasit.sk/digitalny-postar) - NASIT eFaktúra ako digitálny poštár: vytvorte, nahrajte alebo odfoťte faktúru, skontrolujte ju podľa EN 16931 a Peppol BIS, odošlite a prijímajte e-faktúry cez Peppol. Od 0 €.
