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
.
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ą:
.
Pavyzdys:
TSE lauke „startedTransactions“ pateikia pradėtų sandorių skaičių.
{
...
"startedTransactions": 512,
"maxStartedTransactions": 512,
...
}
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:
|
- |
| 404 |
„Client was not found“ – nurodytu clientId šioje sistemoje nėra jokios konfigūracijos Klaidos šalinimas:
|
- |
| 422 |
„clientId buvo nustatytas kaip Guid.Empty“ Klaidų šalinimas: |
- |
| 500 |
„Internal server error“ – kita klaida. Klaidų šalinimas:
|
- |
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite