Meni Integracije (API) služi za povezivanje spoljnih sistema, kao što su WooCommerce, WHMCS, Shopify, POS ili vaš ERP, koji preko API-ja izdaju fiskalne račune. Tehnička uputstva za programere su u portalu API dokumentacija našeg centra za pomoć.
Integracija i API ključ
- Kliknite Nova integracija.
- Unesite Naziv (npr. „WooCommerce - web prodavnica“) i izaberite Tip.
- Opciono izaberite Poslovnu lokaciju. Tada sistem koji šalje račune ne mora da je navodi u svakom zahtevu.
- Kliknite Sačuvaj.
Zatim u kartici integracije kliknite Novi ključ. Ključ ima oblik fk_live_... i prikazuje se samo jednom. Kopirajte ga odmah i unesite u sistem koji povezujete. Ako ga izgubite, napravite nov.
Pravila:
- Firma može imati samo jedan aktivan API ključ, u svim integracijama zajedno.
- Rotiraj (kružna strelica) opoziva stari ključ i odmah izdaje nov.
- Opozovi (kanta) gasi ključ. Sistem koji ga koristi odmah prestaje da radi.
- Opozvan ključ se može trajno obrisati.
- Deaktiviraj gasi celu integraciju.
Webhookovi
Webhook obaveštava vaš sistem kada se promeni stanje računa, pa taj sistem ne mora sam da proverava. Kliknite Novo webhook odredište, unesite URL i izaberite događaje: fiskalizacija uspela, fiskalizacija neuspela, dokument otkazan, dokument storniran.
Tajni ključ (whsec_...) se prikazuje samo jednom. Koristi se za proveru potpisa u zaglavlju X-Finora-Signature.
Firma može imati jedan aktivan webhook. Ako isporuka ne uspe, HAFiscal pokušava ponovo. Isporuka se pokušava najviše 8 puta ukupno, u razmacima do dva sata.
Log fiskalizacije
Poslednjih 10 pokušaja fiskalizacije preko API-ja: vreme, integracija, broj narudžbine (External ID), iznos, status i fiskalni broj, ili poruka greške. Log se osvežava sam na 15 sekundi. Koristan je kada proveravate da li web prodavnica ispravno šalje račune.
Mrežni uređaji
Tab Mrežni uređaji prikazuje POS uređaje sa promenljivom IP adresom koji se javljaju preko API-ja. Uređaj koji se ne javi 30 minuta dobija status Neaktivan.