Šis galinis taškas yra pirmasis žingsnis perduodant sandorius iš elektroninės registravimo sistemos („kasos aparato“) į „Fiskal Service“. Procesas visada susideda iš dviejų žingsnių. Šis dviejų etapų sandorių perdavimo procesas yra pagrįstas Vokietijos KassenSichV reikalavimais ir, siekiant standartizuotos sąsajos, turi būti vykdomas visose fiskalinėse šalyse. Vokietijoje, kai iškviečiamas PUT /api/v1/transactions/createDocument, sandoris registruojamas vadinamojoje techninėje saugumo įrangoje (TSE).
Sandorio registravimas
Čia sandoris / dokumentas registruojamas fiskalinėje sistemoje:
- PUT /api/v1/transactions/createDocument ir
- POST /api/v1/transactions/storeDocument
Sandorio nutraukimas
Čia sandorio nutraukimas registruojamas fiskalinėje vienetoje:
- PUT /api/v1/transactions/createDocument ir
- POST /api/v1/transactions/cancelDocument
Pastaba: visos operacijos, pradėtos naudojant PUT /api/v1/transactions/createDocument, privalo būti užbaigtos naudojant POST /api/v1/transactions/storeDocument arba POST /api/v1/transactions/cancelDocument! Atkreipkite dėmesį į listTransactions (DELETE).
Rezultatas
Sėkmingas galinio taško iškvietimas (200)
- užregistruoja sandorio pradžią fiskalinėje vienetoje ir
- grąžina fiscalResponse į pirminę sistemą (elektroninę registravimo sistemą).
Naudojimas
- kiekvieną kartą, kai reikia nusiųsti naują sandorį į fiskalinį įrenginį, prieš POST /api/v1/transactions/storeDocument arba POST /api/v1/transactions/cancelDocument.
Reikalavimai
- Fiskalinis klientas inicijuotas
Formos laukeliai
Reikia perduoti šią informaciją:
| Pavadinimas | Tipas | Aprašymas | Pavyzdžiai |
| clientId | M |
Kaso aparato unikalus identifikatorius (iš „RetailForce“ sistemos) | c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| documentType | M |
Registruotino dokumento tipas. Enum:
|
- |
| dokumentoGuid | R |
GUID / UUID, kuris sandoriui priskiriamas kasos sistemos. Elgesys, kai užklausime nurodytas „documentGuid“:
Elgesys BE „documentGuid“ užklausime:
Dėmesio: tas pats „documentGuid“ turi būti naudojamas ir vėlesniame POST /api/v1/transactions/storeDocument iškvietime. |
b5744d8c-71ec-4ea0-a340-53070da8b5a1 |
Atsakymas
Galimi atsakymai:
| Kodas | Aprašymas | Pavyzdys |
| 200 | Sandoris pradėtas, o fiscalResponse grąžinamas į pirminę sistemą | - |
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite