PUT /api/v1/transactions/createDocument – RetailForce

Ova krajnja tačka je prvi korak u prijenosu transakcija iz sistema elektronskog evidentiranja ("kase") u Poresku upravu. Proces uvijek se sastoji od dva koraka. Ovaj dvostepeni proces prijenosa transakcija zasnovan je na zahtjevima Njemačke Uredbe o zaštiti od neovlaštenih zahvata na fiskalnim registratorima (Cash Register Anti Tampering Ordinance) i mora se provoditi u svim fiskalnim zemljama u smislu standardiziranog interfejsa. U Njemačkoj, kada se pozove PUT /api/v1/transactions/createDocument, transakcija se registruje u takozvanom Tehničkom sigurnosnom uređaju (TSE/TSS).

Registracija transakcije

Transakcija/dokument se registruje u fiskalnoj jedinici:

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

Otkazivanje transakcije

Ovo registruje prekid transakcije u fiskalnoj jedinici:

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

Napomena: sve transakcije započete pozivom PUT /api/v1/transactions/createDocument moraju biti zatvorene pozivom POST /api/v1/transactions/storeDocument ili POST /api/v1/transactions/cancelDocument! Imajte na umu i listTransactions (DELETE).

Rezultat

Uspješan poziv na krajnju tačku (200)

registruje početak transakcije u fiskalnoj jedinici i
vraća fiscalResponse sistemu iznad (sistemu elektronskog evidentiranja).

Upotreba

svaki put kada se nova transakcija šalje fiskalnoj jedinici, prije POST /api/v1/transactions/storeDocument ili POST /api/v1/transactions/cancelDocument.

Preduvjeti

Fiskalni klijent inicijaliziran

Polja obrasca

Sljedeće informacije se moraju poslati:

Naznaka	Tip	Opis	Primjer
clientId	M	uniqueClientId kase (iz sistema RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4
vrsta dokumenta	M	Tip dokumenta koji se registruje. Enum: [0] = Potvrda o uplati [1] = Faktura [2] = Otpremnica [10] = Isplata [11] = Uplata [12] = ProformaFaktura [13] = Kupčeva narudžba [14] = Preliminarna potvrda prijema [80] = Dugoročna narudžba [90] = Početno stanje [98] = Provjera gotovine [99] = Kraj dana [100] = Zalihe [101] = Kupovina [1000] = NullReceipt [1100] = Razno neraspoloživo	-
documentGuid	R	GUID/UUID dodijeljen transakciji od strane POS sistema. Ponašanje "documentGuid" uključenog u zahtjev: Navodjenje "documentGuid" čini poziv idempotentnim. createDocument se može pozvati više puta bez pokretanja nove transakcije u TSE (Njemački tehnički sigurnosni uređaj). "fiscalResponse": uvijek se vraća ISTI odgovor. Ponašanje BEZ "documentGuid" u zahtjevu: Ako nije naveden "documentGuid", sa svakim pozivom createDocument pokreće se nova transakcija u TSE (Njemačka)! "fiscalResponse": svaki put se vraća NOVI odgovor. Napomena: Isti "documentGuid" se također mora koristiti u naknadnom pozivu na POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odgovor

Mogući odgovori:

Kod	Opis	Primjer
200	Transakcija je pokrenuta i vraćen je fiscalResponse sistemu iznad	-

Ovaj članak je automatski preveden.

Rezultat

Upotreba

Preduvjeti

Polja obrasca

Odgovor

Related articles