Pereiti prie pagrindinio turinio

PUT /api/v1/transactions/createDocument

Harald Krondorfer
  • Atnaujintas

Š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:

Sandorio nutraukimas

Čia sandorio nutraukimas registruojamas fiskalinėje vienetoje:

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

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:

  • [0] = Kvit
  • [1] = Sąskaita
  • [2] = Pristatymo lapas
  • [10] = Išmoka
  • [11] = Įmoka
  • [12] = Proforma sąskaita
  • [13] = Kliento užsakymas
  • [14] = Preliminari kvita
  • [80] = Ilgalaikis užsakymas
  • [90] = Pradinis balansas
  • [98] = Grynųjų pinigų čekis
  • [99] = Dienos pabaiga
  • [100] = Atsargos
  • [101] = Pirkimas
  • [1000] = Nulinis kvitas
  • [1100] = Įvairūs neapmokestinami
 -
dokumentoGuid

R

GUID / UUID, kuris sandoriui priskiriamas kasos sistemos.

Elgesys, kai užklausime nurodytas „documentGuid“: 

  • Nurodžius „documentGuid“, iškvietimas tampa idempotentinis.
  • „createDocument“ galima iškviesti keletą kartų, nepradedant naujos transakcijos TSE (Technische Sicherheitseinrichtung Deutschland).
  • „fiscalResponse“: visada bus grąžintas TAS PATS atsakymas.

Elgesys BE „documentGuid“ užklausime:

  • jei „documentGuid“ nenurodytas, KIEKVIENO „createDocument“ iškvietimo metu TSE (Vokietija) pradedama nauja transakcija!
  • „fiscalResponse“: visada bus grąžinamas NAUJAS atsakymas.

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ą -

 

Susiję straipsniai

Komentarai

0 komentarų

Tam, kad paliktumėte komentarus prisijunkite

Powered by Zendesk