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ć.

![Integracije i API ključevi](https://chat.ha.co.rs/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBFZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9185cba3d9ecca39f8e9d22469a88ca40c2f2689/integracije.webp)

## Integracija i API ključ

1. Kliknite **Nova integracija**.
2. Unesite **Naziv** (npr. „WooCommerce - web prodavnica“) i izaberite **Tip**.
3. Opciono izaberite **Poslovnu lokaciju**. Tada sistem koji šalje račune ne mora da je navodi u svakom zahtevu.
4. Kliknite **Sačuvaj**.

![Forma za novu integraciju](https://chat.ha.co.rs/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBEdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--cf05c8cd9872dd5f4462eb03de14242b3b4a7f2c/integracija-nova.webp)

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

![Tab Webhookovi](https://chat.ha.co.rs/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBFUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--20c2bb8329747f3617ab1841f694347c17568364/integracije-webhook.webp)

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

![Tab Log fiskalizacije](https://chat.ha.co.rs/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBFQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--6f54a6a2a7dd7740e4f4f86d59aa7f891bce13d1/integracije-log.webp)

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**.