PUT /api/v1/transactions/createDocument – RetailForce

Ez a végpont az első lépés a tranzakciók továbbításában az elektronikus nyilvántartási rendszerből („pénztárgép”) a Pénzügyi Hatóság felé. A folyamat mindig két lépésből áll. Ez a tranzakciótovábbítás kétlépcsős folyamata a német Pénztárgép-hamisítás elleni rendelet követelményein alapul, és minden adóügyi országban egységes interfész keretében kell végrehajtani. Németországban a PUT /api/v1/transactions/createDocument hívásakor egy tranzakciót regisztrálnak az úgynevezett műszaki biztonsági eszközben (TSE/TSS).

Tranzakció regisztrálása

A tranzakció/dokumentum a pénzügyi egységben kerül regisztrálásra:

PUT /api/v1/transactions/createDocument és
POST /api/v1/transactions/storeDocument

Tranzakció megszakítása

Ezzel regisztrálható a tranzakció megszakítása a pénzügyi egységben:

PUT /api/v1/transactions/createDocument és
POST /api/v1/transactions/cancelDocument

Megjegyzés: minden, a PUT /api/v1/transactions/createDocument paranccsal indított tranzakciót vagy a POST /api/v1/transactions/storeDocument, vagy a POST /api/v1/transactions/cancelDocument paranccsal kell lezárni! Kérjük, vegye figyelembe a listTransactions (DELETE) parancsot.

Eredmény

A végpont sikeres meghívása (200)

a tranzakció kezdetét rögzíti a pénzügyi egységben, és
visszaad egy fiscalResponse-t a felettes rendszernek (elektronikus nyilvántartási rendszer).

Használat

minden alkalommal, amikor új tranzakciót kell elküldeni a pénzügyi egységnek, a POST /api/v1/transactions/storeDocument vagy a POST /api/v1/transactions/cancelDocument parancsok előtt.

Előfeltételek

A Fiskal Client inicializálva

Űrlapmezők

A következő információkat kell elküldeni:

Megnevezés	Típus	Leírás	Példa
clientId	M	The uniqueClientId of the cash register (from the RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	A regisztrálandó dokumentum típusa. Enum: [0] = Nyugta [1] = Számla [2] = Szállítólevél [10] = Kifizetési bizonylat [11] = PayIn [12] = Proforma számla [13] = Vevői megrendelés [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Készlet [101] = Beszerzés [1000] = Érvénytelen nyugta [1100] = Egyéb nem pénzügyi	-
DocumentGuid	R	A POS-rendszer által a tranzakcióhoz rendelt GUID/UUID. A kérésben szereplő „DocumentGuid” viselkedése: A „DocumentGuid” megadása idempotenssé teszi a hívást. A createDocument többször is meghívható anélkül, hogy új tranzakciót indítana a TSE-ben (Technical Security Device Germany). „fiscalResponse”: mindig UGYANAZ a válasz kerül visszaadásra. A kérésben szereplő „DocumentGuid” hiányában a viselkedés: Ha nincs megadva „DocumentGuid”, akkor a createDocument minden egyes hívásakor új tranzakció indul a TSE-ben (Németország)! „fiscalResponse”: minden alkalommal ÚJ válasz kerül visszaadásra. Megjegyzés: Ugyanazt a „DocumentGuid”-et kell használni a későbbi POST /api/v1/transactions/storeDocument hívásnál is.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Válasz

Lehetséges válaszok:

Kód	Leírás	Példa
200	A tranzakció elindult, és egy fiscalResponse került visszaküldésre az upstream rendszernek	-

Ezt a cikket automatikusan lefordították.

Eredmény

Használat

Előfeltételek

Űrlapmezők

Válasz

Kapcsolódó cikkek