PUT /api/v1/transactions/createDocument – RetailForce

Ta končna točka je prvi korak pri prenosu transakcij iz elektronskega sistema evidentiranja („blagajne“) k davčni službi. Postopek vedno obsega dva koraka. Ta dvofazni postopek prenosa transakcij temelji na zahtevah nemške uredbe o zaščiti blagajn pred nedovoljenim posegom in ga je treba izvajati v vseh državah z davčnim nadzorom v smislu standardiziranega vmesnika. V Nemčiji se ob klicu PUT /api/v1/transactions/createDocument transakcija registrira v tako imenovani tehnični varnostni napravi (TSE/TSS).

Registracija transakcije

Transakcija/dokument se registrira v fiskalni enoti:

PUT /api/v1/transactions/createDocument and
POST /api/v1/transactions/storeDocument

Prekinitev transakcije

S tem se v fiskalni enoti registrira prekinitev transakcije:

PUT /api/v1/transactions/createDocument in
POST /api/v1/transactions/cancelDocument

Opomba: vse transakcije, ki so se začele s PUT /api/v1/transactions/createDocument, je treba zaključiti bodisi s POST /api/v1/transactions/storeDocument bodisi s POST /api/v1/transactions/cancelDocument! Upoštevajte listTransactions (DELETE).

Rezultat

Uspešen klic na končno točko (200)

zazna začetek transakcije v fiskalni enoti in
vrne fiscalResponse v nadrejeni sistem (sistem za elektronsko evidentiranje).

Uporaba

vsakič, ko je treba novo transakcijo poslati v fiskalno enoto, pred klicem POST /api/v1/transactions/storeDocument ali POST /api/v1/transactions/cancelDocument.

Predpogoji

Fiskal Client mora biti inicializiran

Polja obrazca

Poslati je treba naslednje podatke:

Oznaka	Vrsta	Opis	Primer
clientId	M	UniqueClientId blagajne (iz RetailForce systema).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Vrsta dokumenta, ki ga je treba registrirati. Enum: [0] = Potrdilo [1] = Račun [2] = dobavnica [10] = Izplačilo [11] = PayIn [12] = Proforma račun [13] = Naročilo stranke [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = zaloga [101] = Nakup [1000] = Nični prejemek [1100] = Razno (ne davčno)	-
DocumentGuid	R	GUID/UUID, ki ga transakciji dodeli POS-sistem. Delovanje »DocumentGuid«, vključenega v zahtevo: Z navedbo »DocumentGuid« postane klic idempotenten. Funkcijo »createDocument« je mogoče večkrat poklicati, ne da bi se v TSE (Technical Security Device Germany) začela nova transakcija. »fiscalResponse«: vedno se vrne ISTI odgovor. Delovanje brez »DocumentGuid« v zahtevku: Če »DocumentGuid« ni določen, se ob vsakem klicu funkcije createDocument v TSE (Nemčija) začne nova transakcija! »fiscalResponse«: vsakič se vrne NOV odgovor. Opomba: isti »DocumentGuid« je treba uporabiti tudi pri naslednjem klicu na POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odgovor

Možni odgovori:

Koda	Opis	Primer
200	Transakcija se je začela in fiscalResponse je bil poslan nazaj v zgornji sistem	-

Ta članek je bil samodejno preveden.

Rezultat

Uporaba

Predpogoji

Polja obrazca

Odgovor

Sorodni sklopi