Račun123 API integracija: kako povezati svojo trgovino ali aplikacijo z izdajanjem računov

Ključne besede: API za račune, invoice API Slovenija, FURS fiskalizacija API, avtomatsko izdajanje računov.

API po meri (Custom API) vam omogoča, da svojo spletno trgovino, portal ali aplikacijo povežete z Račun123 in samodejno ustvarjate davčno potrjene račune za vsako naročilo.

Integracija deluje prek enostavnega webhook klica — vaš sistem pošlje podatke o naročilu, Račun123 pa iz njih ustvari račun, ga davčno potrdi (fiskalizira pri FURS) in pošlje PDF stranki.

Za razvijalce:
Podrobna tehnična dokumentacija z vsemi endpointi in primeri:
Odpri API dokumentacijo →

Na kratko:
Vaš sistem pošlje POST zahtevo na Webhook URL.
Račun123 ustvari račun → ga po potrebi davčno potrdi (FURS) → vrne PDF povezavo.

Komu je API po meri namenjen?

  • spletnim trgovinam (WooCommerce, Shopify, custom rešitve),
  • SaaS aplikacijam in naročniškim sistemom,
  • ERP, CRM in internim poslovnim sistemom,
  • agencijam in razvijalcem,
  • vsem, ki želijo avtomatizirati izdajanje davčno potrjenih računov.

Nastavitev v aplikaciji

  1. Pojdite na Nastavitve podjetja > Integracije.
  2. V razdelku API po meri aktivirajte integracijo.
  3. Kopirajte:
    • API ključ
    • Webhook URL

Kako deluje API za izdajanje računov?

  1. Vaš sistem zazna naročilo
  2. Pošlje POST zahtevo v Račun123
  3. Račun123 ustvari račun
  4. Račun se lahko samodejno davčno potrdi (fiskalizacija FURS)
  5. Stranka prejme PDF
  6. Vi dobite invoiceId, številko in PDF link

Davčno potrjevanje (FURS):
Računi se lahko samodejno fiskalizirajo ob ustvarjanju (ZOI + EOR), brez dodatnih korakov v vašem sistemu.

Končna točka (Webhook URL)

POST {webhook_url}

Avtentikacija

x-api-key: rc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Prvi test (copy-paste)

curl -X POST "{your_webhook_url}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "externalOrderId": "TEST-001",
    "customerName": "Test Customer",
    "customerEmail": "test@example.com",
    "items": [
      {
        "name": "Test Product",
        "quantity": 1,
        "unitPrice": 10.00,
        "taxRate": 22
      }
    ],
    "subtotal": 10.00,
    "tax": 2.20,
    "total": 12.20
  }'

Pomembno: idempotentnost

Isti externalOrderId ne ustvari podvojenega računa.

Pomembno: preverjanje napak

{
  "received": true,
  "error": "..."
}

Tudi HTTP 200 lahko pomeni napako — vedno preverite error.

Fiskalizacija (FURS)

  • računi se lahko samodejno davčno potrdijo
  • obravnavajo se kot gotovinski računi
  • zahtevana je nastavitev poslovnega prostora in naprave
  • če fiskalizacija ne uspe → račun se vseeno ustvari

Nadaljujte v dokumentaciji:
Za vse endpointe, primere in integracijo:
Odpri API dokumentacijo →

Email po meri in spremljanje webhook dogodkov

Poleg samega API-ja imate v Račun123 popoln nadzor nad komunikacijo in statusi vaših računov.

📧 Email po meri

Račune lahko strankam pošiljate s prilagojenim emailom.

  • vključite logotip podjetja
  • dodate QR kodo za plačilo

Tako ohranite konsistenten branding in profesionalno komunikacijo s strankami.

📡 Dnevnik webhook dogodkov

Vsak webhook klic se zabeleži — tako imate vedno pregled nad tem, kaj se dogaja.

  • status: success / error
  • čas izvedbe
  • externalOrderId / ID naročila
  • debugiranje napak

Idealno za testiranje integracije in hitro odpravljanje napak.

Tip za razvijalce:
Najprej testirajte webhook z enostavnim requestom, nato pa preverite rezultat v dnevniku —
tako najhitreje validirate integracijo.

Zaključek

API po meri omogoča, da vaš sistem samodejno izdaja davčno potrjene (fiskalizirane) račune brez ročnega dela.

Želite povezati svojo aplikacijo z Račun123 API?

Z API po meri (Custom API) lahko popolnoma avtomatizirate izdajanje računov —
od naročila do davčno potrjenega (fiskaliziranega) računa in PDF-ja za stranko.

Če potrebujete pomoč pri integraciji API-ja, nastavitvi webhookov, uporabi API ključa,
obdelavi odgovorov ali fiskalizaciji (FURS), vam z veseljem pomagamo.

📩 podpora@racun123.si ali nam pišite prek kontaktnega obrazca.

Račun123 vam pomaga API integracijo postaviti hitro, pravilno in brez skrbi glede davčnega potrjevanja.