API dostop
Javni REST API z X-API-Key avtentikacijo, 25+ entitet, batch operacije, premiki zaloge, analitike (projekti) in sinhronizacija s posodobljenOd.
Nov API ključ
- "Nov ključ"
- Izberite obsege (read.* / write.*)
- Sistem generira ključ — KOPIRAJTE TAKOJ (prikazuje se SAMO ENKRAT)
- Uporabite v zunanjih sistemih kot X-API-Key header
B2B cene za spletno trgovino prek API
- Obseg read:ceniki
- GET /api/v1/ceniki/skupine → skupine kupcev in ceniki po prioriteti
- GET /api/v1/ceniki/skupine/{id}/cene → končne cene (šifra, EAN, cena, cena z DDV, količinske stopnje)
- GET /api/v1/ceniki/cena?stranka=&artikel=&kolicina= → natančna cena za kupca kot na računu
- Skupino stranki: PUT /api/v1/stranke/{id} {"skupinaKupcevId"} (write:stranke)
Zaloga in projekti prek API
- Obseg write:zaloge → POST /api/v1/zaloge/premiki (prejem / izdaja / prenos, zunanjiKljuc)
- Obseg write:analitike → POST /api/v1/analitike (šifra projekta)
- Šifro pošljite v polju analitika na dokumentih in premikih
- Več premikov naenkrat: POST /api/v1/zaloge/premiki/paket (do 200)
- Zavihek Dokumentacija prikaže vse endpointe in polja
Napake, filtri in sinhronizacija
- Vsaka napaka vrne tip in traceId (pošljite ga ob prijavi težave)
- Seznami: ?od=&do=, ?posodobljenOd= (UTC), ?vkljuciIzbrisane=true, ?stran=&limit=
- Pri 503 počakajte Retry-After in ponovite z istim zunanjiKljuc
- Webhooki: document.*, order.confirmed/delivered/cancelled, stock.movement.*, analitika.*
PDF in popravki računov prek API
- PDF: POST /api/v1/racuni/{id}/izpis → časovno omejena povezava do izpisa (enak kot v aplikaciji)
- Vsebinski popravek izdanega računa: PUT /api/v1/racuni/{id} z "vsebinskiPopravek": true (številka ostane, temeljnica in zaloga se uskladita)
- Storno: dobropis z vezo na račun (status cancelled ni dovoljen)
Drugi moduli v sklopu Integracije
Vam navodilo ni pomagalo? Pišite nam.