Povezivanje sa ESIR-om

Krajnji korisnik povezuje ESIR (ili drugi POS) sa L-PFR-om preko lokalnog HTTP API-ja. L-PFR mora biti pokrenut u okviru AnyBiz desktop aplikacije; BE kartica ubačena i otključana PIN-om.

Osnovni URL

http://127.0.0.1:8989/api/v3/

API je dostupan samo na lokalnoj petlji (127.0.0.1), ne na mreži.

Endpoint-i

Metod	Putanja	Opis
`GET`	`/api/v3/attention`	Provera dostupnosti (HTTP 200)
`GET`	`/api/v3/status`	Status uređaja (GSC, PIN, audit, stope, make/model…)
`POST`	`/api/v3/pin`	Unos PIN-a; telo = JSON string npr. `"1234"`; odgovor = string koda (`0100`, `2100`…)
`POST`	`/api/v3/invoices`	Potpisivanje računa
`GET`	`/api/v3/invoices/{requestId}`	Preuzimanje sačuvanog odgovora po RequestId
`GET`	`/api/v3/environment-parameters`	Parametri okruženja (zahteva prisutnu karticu)

Zaglavlja

Zaglavlje	Upotreba
`RequestId`	Idempotentnost za `POST /invoices` i kasniji `GET /invoices/{requestId}`
`Accept-Language`	Jezik journal-a: `sr…` → ćirilica; inače engleski

Oblik greške

{
  "ErrorCode": "1300",
  "ErrorMessage": "Smart Card is not present"
}

Minimalni primer

Provera da L-PFR radi:

GET http://127.0.0.1:8989/api/v3/attention

Status:

GET http://127.0.0.1:8989/api/v3/status

Unos PIN-a:

POST http://127.0.0.1:8989/api/v3/pin
Content-Type: application/json

"1234"

Odgovor (primer): "0100".

Potpis računa (skraćeno — stvarno telo prati InvoiceData šemu):

POST http://127.0.0.1:8989/api/v3/invoices
Content-Type: application/json
RequestId: 550e8400-e29b-41d4-a716-446655440000
Accept-Language: sr-RS

{ "invoiceType": 0, "transactionType": 0, "payment": […], "items": […] }

Uspešan odgovor uključuje broj računa, journal i verificationQRCode.