API za račune, brez ročnega prepisovanja

Poveži ERP, CRM, SaaS, portal ali lastno aplikacijo z Račun123. Tvoj sistem pošlje dogodek, Račun123 ustvari račun, pripravi PDF in po potrebi izvede FURS fiskalizacijo.

API · Webhook · Sandbox · FURS

API za račune,
brez ročnega prepisovanja.

Poveži ERP, CRM, SaaS, portal ali lastno aplikacijo z Račun123. Tvoj sistem pošlje dogodek, Račun123 ustvari račun, pripravi PDF in po potrebi izvede FURS fiskalizacijo.

POST webhook JSON x-api-key externalOrderId PDF response
Odpri API dokumentacijo → Ustvari brezplačen račun
Live API Example
Dokumentacija → 
// request

POST {webhook_url}
x-api-key: YOUR_API_KEY

{
  "externalOrderId": "ORD-2026-0041",
  "customerName": "Podjetje d.o.o.",
  "customerEmail": "racuni@podjetje.si",
  "isPaid": true,
  "fiscalize": true,
  "items": [
    {
      "name": "Storitev",
      "quantity": 1,
      "unitPrice": 500.00,
      "taxRate": 22
    }
  ],
  "total": 610.00
}

// response

{
  "received": true,
  "invoiceNumber": "R-2026-0041",
  "pdfUrl": "https://...",
  "zoi": "a7e35f...",
  "eor": "12345678-..."
}
Enostaven tok

Od dogodka v tvojem sistemu do računa.

Račun naj nastane tam, kjer nastane poslovni dogodek. Brez dodatnega ročnega koraka in brez prepisovanja podatkov.

01

Dogodek

Naročilo, plačilo, rezervacija, članarina ali drug dogodek nastane v tvoji aplikaciji.

02

POST request

Sistem pošlje podatke v Račun123 prek Webhook URL-ja in API ključa.

03

Račun123

Račun se ustvari in po potrebi v istem toku tudi davčno potrdi.

04

Rezultat

Nazaj dobiš podatke o računu, številko dokumenta in PDF povezavo.

Za razvijalce

Dovolj preprosto za prvi test. Dovolj robustno za produkcijo.

API tok je namenjen sistemom, kjer mora biti izdaja računa predvidljiv del obstoječe poslovne logike.

KEY

API ključ

Vsak request avtenticiraš z API ključem v x-api-key headerju.

ID

Idempotentnost

externalOrderId poveže račun s tvojim dogodkom in preprečuje podvajanje pri ponovnem klicu.

DEV

Sandbox

Integracijo najprej pripraviš in preveriš v testnem toku, preden jo uporabiš v produkciji.

PDF

Rezultat nazaj v sistem

Po ustvarjenem računu lahko svoj workflow nadaljuješ z ID-jem, številko dokumenta in PDF povezavo.

LOG

Webhook dnevnik

Klici so zabeleženi, zato lahko preveriš status, čas izvedbe, externalOrderId in morebitno napako.

FURS

Fiskalizacija

Če primer poslovanja zahteva davčno potrjevanje, lahko račun v istem toku pridobi tudi ZOI in EOR.

Primeri

Najpogostejši API scenariji.

Nekaj osnovnih vzorcev, ki pokrijejo večino začetnih integracij. Za celoten seznam polj in možnosti uporabi tehnično dokumentacijo.

Osnovna izdaja računa

JSON
POST {webhook_url}

{
  "externalOrderId": "ORDER-10452",
  "customerName": "Primer d.o.o.",
  "customerEmail": "info@primer.si",
  "items": [
    {
      "name": "Licenca",
      "quantity": 1,
      "unitPrice": 49.00,
      "taxRate": 22
    }
  ],
  "subtotal": 49.00,
  "tax": 10.78,
  "total": 59.78
}

Račun + FURS

JSON
{
  "externalOrderId": "PAY-88341",
  "customerName": "Kupec",
  "isPaid": true,
  "fiscalize": true,

  "items": [
    {
      "name": "Izdelek",
      "quantity": 2,
      "unitPrice": 25.00,
      "taxRate": 22
    }
  ],

  "total": 61.00
}

Uspešen odgovor

RESPONSE
{
  "received": true,
  "invoiceNumber": "R-2026-0088",
  "pdfUrl": "https://...",
  "zoi": "a7e35f...",
  "eor": "12345678-..."
}

Preverjanje napak

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

//
// Ne preverjaj samo HTTP statusa.
//
// Vedno preveri tudi vrednost
// polja "error" v odgovoru.
//
Poglej vsa polja in primere →
Pred produkcijo

Šest stvari, ki jih je vredno urediti pravilno.

Integracija naj bo varna pred ponovnimi dogodki.

Plačilni sistemi, webhooki in background jobi lahko isti dogodek pošljejo več kot enkrat. Zato za vsak poslovni dogodek uporabi stabilen externalOrderId.

  • ✓ Za isto naročilo vedno pošlji isti externalOrderId.
  • ✓ Shrani povezavo med svojim ID-jem dogodka in ustvarjenim računom.
  • ✓ Ne obravnavaj samo HTTP status kode — preveri tudi odgovor API-ja.

Production checklist

  • 01 API ključ hrani samo na strežniški strani.
  • 02 Vsakemu dogodku dodeli stabilen externalOrderId.
  • 03 Validiraj response in polje error.
  • 04 Napake beleži skupaj z ID-jem naročila.
  • 05 Pred produkcijo preveri tok v testnem okolju.
  • 06 Za FURS preveri pravilne fiskalne nastavitve podjetja.
FURS integracija

Tvoj sistem pošlje račun. Račun123 lahko uredi fiskalni tok.

Ni ti treba v lastni aplikaciji ponovno graditi celotne uporabniške logike za izdajo računov. Kadar je davčno potrjevanje potrebno, lahko Račun123 v istem procesu izvede tudi fiskalizacijo računa.

fiscalize true
invoice created ✓
ZOI generated ✓
EOR received ✓
PDF ready ✓
Kje se uporablja

API, ko standardna integracija ni dovolj.

Če že imaš sistem, v katerem nastajajo poslovni dogodki, ga ni treba prilagajati programu za račune. Račun lahko priključiš na obstoječi proces.

ERP

ERP in CRM sistemi

Račun ustvariš neposredno iz interne poslovne logike, kjer že obstajajo kupec, postavke in naročilo.

SaaS

SaaS in naročnine

Izdajo računa sproži uspešno plačilo, aktivacija naročnine ali drug dogodek v aplikaciji.

SHOP

Spletne trgovine po meri

Za trgovine, kjer WooCommerce ali Shopify plugin ne pokrije specifičnega procesa.

APP

Portali in interne aplikacije

Rezervacijski sistemi, članske platforme, marketplace rešitve in drugi lastni workflowi.

Dokumentacija

Od prvega requesta do produkcije.

API DOCUMENTATION

Tehnična API dokumentacija

Parametri, requesti, response-i in tehnični primeri za implementacijo.

→ GUIDE

API vodič

Aktivacija integracije, API ključ, webhook, prvi test in osnovni tok.

→ CUSTOM API

API po meri

Primeri uporabe za ERP, CRM, SaaS, portale in kompleksnejše procese.

→ INTEGRATIONS

Vse integracije

Preveri tudi pripravljene povezave, preden razviješ lastno integracijo.

→ WOOCOMMERCE

WooCommerce

Za standardne WordPress trgovine lahko uporabiš že pripravljeno povezavo.

→ SHOPIFY

Shopify

Za Shopify prodajni tok je na voljo namenska integracija.

→
FAQ

Kratki odgovori za razvijalce.

Za konkretne parametre in aktualno strukturo requestov vedno uporabi tehnično API dokumentacijo.

Kako se povežem z Račun123 API?

V Račun123 aktiviraš API po meri, pridobiš API ključ in Webhook URL ter iz svojega sistema pošlješ POST zahtevo s podatki za račun.

Kako preprečim podvojene račune?

Uporabi stabilen externalOrderId. Isti externalOrderId ne ustvari podvojenega računa.

Ali lahko račun davčno potrdim prek API-ja?

Da. Če je fiskalizacija vključena in ima podjetje pravilno nastavljeno davčno blagajno, lahko Račun123 v istem toku izvede tudi davčno potrjevanje.

Kaj se zgodi, če fiskalizacija ne uspe?

Račun se lahko vseeno ustvari, zato mora integracija pravilno obravnavati vrnjeni rezultat in preveriti stanje fiskalizacije.

Ali dobim PDF nazaj v svoj sistem?

Da. API tok omogoča povratni rezultat z informacijami o ustvarjenem računu in PDF povezavo, ki jo lahko uporabiš v nadaljnjem procesu.

Ali je API namenjen samo spletnim trgovinam?

Ne. Primeren je tudi za ERP, CRM, SaaS, rezervacijske sisteme, portale, interne aplikacije in druge rešitve po meri.

API za račune in avtomatsko izdajanje računov

Račun123 API za račune je namenjen razvijalcem in podjetjem, ki želijo svojo spletno trgovino, ERP, CRM, SaaS aplikacijo ali lasten portal povezati z avtomatizirano izdajo računov.

Poslovni dogodek nastane v vašem sistemu, podatki se prek webhook povezave prenesejo v Račun123, kjer se ustvari račun in pripravi PDF dokument. Kadar je za posamezen način poslovanja potrebno davčno potrjevanje, se lahko v isti proces vključi tudi FURS fiskalizacija z ZOI in EOR.

Za standardne spletne trgovine so na voljo pripravljene WooCommerce in Shopify integracije, za lastne aplikacije, kompleksnejše procese ter povezave z ERP ali CRM sistemi pa je namenjen Custom API.

Ready to build

Tvoj sistem že pozna naročilo. Naj Račun123 naredi račun.

Aktiviraj API po meri, vzemi API ključ in Webhook URL ter pošlji prvi testni request.

Začni brezplačno Odpri dokumentacijo
Račun123
Mobilna aplikacija
Namesti aplikacijo Račun123
Prenesi aplikacijo