DELETE /api/v1/management/germany/ {clientId}/tse/listTransactions – RetailForce

Galutinis taškas

DELETE /api/v1/management/germany/{clientId}/tse/listTransactions

gali būti naudojamas atviroms TSE transakcijoms uždaryti.

Iš esmės sandoriai neturėtų likti neužbaigti. Rekomenduojame prieš dienos uždarymą visus neužbaigtus sandorius užbaigti naudojant

POST /api/v1/transactions/storeDocument – jei pardavimas įvyko, arba
POST /api/v1/transactions/cancelDocument – jei pardavimas neį vyko

Dėmesio: atkreipkite dėmesį, kad TSE taip pat (privalo) registruoti dokumentų nutraukimus. Todėl būtina kiekvieną su PUT /api/v1/transactions/createDocument pradėtą sandorį užbaigti ir su „storeDocument “ arba „cancelDocument “. Esant dažniems dokumentų nutraukimams, negalime atmesti galimybės, kad finansų administracijos institucijų atliekant kasos patikrinimą gali kilti klausimų dėl nutraukimo priežasčių.

Rezultatas

Neužbaigtos TSE operacijos uždaromos vienu POST /api/v1/transactions/cancelDocument, nereikia jų uždaryti po vieną.

Naudojimas

Rekomenduojame naudoti šį galinį tašką atsargiai ir tik esant klaidai.

Šis iškvietimas pirmiausia sukuria užklausą TSE, kokios operacijos yra atviros. Įvairūs TSE tipai (Cloud TSE, Hardware TSE) negrąžina išsamaus atvirų operacijų sąrašo, o tik „paketais“:

„swissbit“ aparatinės TSE: po 8 sandorius
„fiskal“ „Cloud TSE“: po 100 sandorių

Kai TSE grąžina atvirų sandorių paketą, jame esantys sandoriai uždaromi per tuščią dokumentą, kuriame pateikiama ši informacija:

DocumentId: paslaugos sugeneruotas GUID
DocumentNr: paslaugos sugeneruotas GUID
DocumentGuid: paslaugos sukurtas GUID
DocumentType: kvitas
DocumentTypeCaption: CancelTransaction

Jei yra daugiau nei nurodyta aukščiau, galutinis taškas turi būti iškviečiamas atitinkamai dažniau.

Visos užbaigtos transakcijos taip pat atitinkamai išsaugomos DSFinV-K duomenyse.

Sąlyga

TSE yra atvirų (pradėtų), t. y. neužbaigtų, sandorių.

Pasiekus tam tikrą atvirų sandorių skaičių, TSE nebegalima pradėti jokių naujų sandorių, o TSE grąžina klaidos pranešimą. Daugiau informacijos apie tai rasite straipsnyje „Tse connection error“.

Atvirų sandorių skaičių galite sužinoti per galinį tašką:

GET /api/v1/management/germany/{clientId}/tse/listTransactions

Pavyzdys:

TSE lauke „startedTransactions“ pateikia pradėtų sandorių skaičių.

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Pastaba: veikia tik su aparatinės įrangos TSE. Fiskaly Cloud TSE vienu metu atvirų sandorių riba yra 2 000.

Formos laukeliai

Reikia pateikti šią informaciją:

Pavadinimas	Aprašymas	Pavyzdžiai
clientId	Kaso aparato unikalus identifikatorius (iš „RetailForce“ sistemos)	c1062c55-57c4-4ed2-9c53-aff1762326a4

Atsakymas

Galimi atsakymai:

Kodas	Aprašymas	Pavyzdys
200	fiscalResponse – nebaigtos operacijos buvo sėkmingai užbaigtos (cancelDocument)	-
400	„Tse not connected“. Nėra TSE, prijungto prie sistemos arba priskirto atitinkamam klientui. Klaidų šalinimas: Patikrinkite, ar TSE yra prijungta prie sistemos, pvz.: su GET /api/v1/management/germany/tse	-
404	„Client was not found“ – nurodytu clientId šioje sistemoje nėra jokios konfigūracijos Klaidos šalinimas: Patikrinkite nurodytą clientId Patikrinkite, ar nurodytas clientId yra sukonfigūruotas tarpinėje programinėje įrangoje (failo fiscalService.config.json, esančio C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	„clientId buvo nustatytas kaip Guid.Empty“ Klaidų šalinimas:	-
500	„Internal server error“ – kita klaida. Klaidų šalinimas: pakartokite užklausą, jei reikia, paleiskite paslaugą iš naujo, vykdykite „cloudConnect“.	-

Dėmesio: nepriklausomai nuo to, kaip buvo pašalinta klaida, rekomenduojame atidžiai išanalizuoti priežastį, dėl kurios TSE sandoriai lieka atviri. Įprastiniame kasos procese visi atviri sandoriai turėtų būti uždaryti prieš dienos pabaigą.

Rezultatas

Naudojimas

Sąlyga

Formos laukeliai

Atsakymas

Susiję straipsniai