Skip to main content

PUT /api/v1/transactions/createDocument

Harald Krondorfer
  • Ažurirano

Ova krajnja točka je prvi korak u prijenosu transakcija iz sustava za elektroničko evidentiranje ("blagajne") na Poreznu upravu. Proces uvijek se sastoji od dva koraka. Ovaj dvoetapni proces prijenosa transakcija temelji se na zahtjevima Njemačke Uredbe o zaštiti od neovlaštenih zahvata na blagajnama (Cash Register Anti Tampering Ordinance) i mora se provoditi u svim fiskalnim zemljama u smislu standardiziranog sučelja. U Njemačkoj, kada se pozove PUT /api/v1/transactions/createDocument, transakcija se registrira u takozvanom Tehničkom sigurnosnom uređaju (TSE/TSS).

Registracija transakcije

Transakcija/dokument se registrira u fiskalnoj jedinici:

Odustajanje od transakcije

Ovo registrira prekid transakcije u fiskalnoj jedinici:

Napomena: sve transakcije započete naredbom PUT /api/v1/transactions/createDocument moraju se zatvoriti naredbom POST /api/v1/transactions/storeDocument ili naredbom POST /api/v1/transactions/cancelDocument! Imajte na umu naredbu listTransactions (DELETE).

Rezultat

Uspješni poziv na krajnju točku (200)

  • registrira početak transakcije u fiskalnoj jedinici i
  • vraća fiscalResponse nadređenom sustavu (sustavu elektroničkog zapisa).

Upotreba

Preduvjeti

  • Fiskalni klijent inicijaliziran

Polja obrasca

Sljedeće informacije moraju biti poslane:

Naznaka Tip Opis Primjer
clientId

M

 uniqueClientId blagajne (iz sustava RetailForce). c1062c55-57c4-4ed2-9c53-aff1762326a4
vrsta dokumenta

M

Tip dokumenta koji se registrira.

Enum:

  • [0] = Potvrda o uplati
  • [1] = Račun
  • [2] = Otpremnica
  • [10] = Isplata
  • [11] = Uplata
  • [12] = Proforma račun
  • [13] = Kupčeva narudžba
  • [14] = Privremeni primitak
  • [80] = Dugoročna narudžba
  • [90] = Početno stanje
  • [98] = Provjera gotovine
  • [99] = Kraj dana
  • [100] = Zalihe
  • [101] = Kupnja
  • [1000] = NullReceipt
  • [1100] = Razno nerashodovno
 -
documentGuid

R

GUID/UUID dodijeljen transakciji od strane POS sustava.

Ponašanje "documentGuid" uključenog u zahtjev:

  • Navedenje "documentGuid" čini poziv idempotentnim.
  • createDocument se može pozvati više puta bez pokretanja nove transakcije u TSE-u (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-u (Njemačka)!
  • "fiscalResponse": svaki put se vraća NOVI odgovor.

Napomena: Isti "documentGuid" mora se također koristiti u naknadnom pozivu na POST /api/v1/transactions/storeDocument.

 b5744d8c-71ec-4ea0-a340-53070da8b5a1

Odgovor

Mogući odgovori:

Kôd Opis Primjer
200 Transakcija je pokrenuta i vraća se fiscalResponse nadređenom sustavu -

 

Ovaj je članak automatski preveden.

Povezani članci

Komentari

0 komentara

Molimo Prijavite se kako bi ostavili komentar.

Powered by Zendesk