REST API

API ZA FISKALIZACIJU · REST

Svoj sajt ili aplikacija?
Jedan API poziv po računu.

Prodavnica, SaaS ili aplikacija pravljena po meri povezuje se direktno: pošaljete stavke i iznos, a u odgovoru stižu broj računa, QR kod i link za proveru. Bez modula i bez SDK-a — radi iz svakog jezika koji šalje HTTP zahtev. Integracija je besplatna, plaćate samo izdate račune.

Otvorite dokumentaciju
  • Odobren ESIR · ИБ 1609
  • JSON preko HTTPS-a
  • Besplatan test ključ
POST /api/racuni
Kupac plaća

Zahtev

{
  "transactionId": "porudzbina-1042",
  "paymentType": "Card",
  "items": [
    { "name": "Majica", "quantity": 1, "unitPrice": 2400,
      "totalAmount": 2400, "labels": ["Ђ"] }
  ]
}

Odgovor

Kliknite „Pošalji zahtev" da vidite šta API vraća.

Od ključa do prvog računa

  1. 01

    Zatražite test ključ

    Ključ koji počinje sa fapi_test_ radi odmah — probni računi bez poreske obaveze i bez naplate.

  2. 02

    Pošaljite prvi račun

    POST /api/racuni sa zaglavljem Authorization: Bearer i stavkama porudžbine u JSON-u.

  3. 03

    Prikažite račun kupcu

    Ubacite qrKod i verifikacija iz odgovora u svoju potvrdu porudžbine i mejl kupcu.

  4. 04

    Pređite na pravi ključ

    Kad ubacite bezbednosni element, test ključ zamenite pravim (fapi_live_). Kod ostaje isti.

Šta dobijate kroz API

  • Sve vrste računa

    Promet, avans, zatvaranje avansa, refundacija i račun za obuku — svaki je jedan poziv.

  • Bez duplih računa

    Pošaljite svoj transactionId: ponovljen zahtev vraća isti račun, a ne izdaje drugi.

  • Kombinovano plaćanje

    Niz payments nosi više načina plaćanja na jednom računu, na primer vaučer i karticu.

  • PIB kupca

    Kad kupuje firma, polje buyerId („10:PIB") stavlja njen PIB na fiskalni račun.

  • Test i pravi ključ

    Isti kod radi u probi i uživo — menja se samo ključ. Probni računi se ne naplaćuju.

  • Čitanje i potrošnja

    GET /api/racuni/{id} vraća izdat račun, GET /api/usage potrošnju i trošak u mesecu.

Šta vam treba

Otvorite dokumentaciju
Jezik
bilo koji koji šalje HTTPS zahtev — PHP, Node.js, Python, .NET…
Format
REST, JSON u telu zahteva i odgovora
Autentikacija
zaglavlje Authorization: Bearer i vaš API ključ
Valuta
dinar (RSD)
Nalog
FiskalAPI ključ — test ključ je besplatan

Pitanja o povezivanju preko API-ja

Odobren ESIR · ИБ 1609

API, dokumentacija, test ključ i pomoć pri povezivanju su besplatni. Plaćate samo izdate fiskalne račune, stepenasto od 9 do 1,5 dinara po računu, bez pretplate.

Ne. API je običan REST sa JSON-om, pa radi iz svakog jezika i okruženja koje ume da pošalje HTTPS zahtev. Primeri poziva su u javnoj dokumentaciji, bez naloga.

Ako šaljete svoj transactionId, ponovljen zahtev vraća isti račun sa oznakom "ponovljen": true — drugi račun se ne izdaje. Isti transactionId sa izmenjenim stavkama ili iznosom API odbija.

Tada API vraća 502 sa "statusRacuna": "nepoznato", jer račun je možda već izdat. Ne ponavljajte automatski: dok se slučaj ne razreši, isti transactionId dobija 409, a ne drugi račun.

Vi, svojim mejlom i sa svog domena. U odgovoru stižu qrKod i link verifikacija — ubacite ih u potvrdu porudžbine. Adresu iz polja kupac.email API ne koristi za slanje.

POST /api/racuni/refundacija sa brojem prvog računa u polju referentDocumentNumber. Izdat račun se nikad ne menja — povraćaj je uvek nov dokument.

Pročitajte i

Povežite svoj sistem još danas

Zatražite besplatan test ključ i pošaljite prvi probni račun za par minuta.

Fiskalizacija online prodavnice