Skip to main content

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

Harald Krondorfer
  • Ažurirano

The

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

krajnja točka može se koristiti za zatvaranje otvorenih TSE transakcija.

Kao opće pravilo, transakcije ne bi trebale ostajati otvorene. Preporučujemo da se sve otvorene transakcije zatvore prije dnevnog zatvaranja pomoću

Napomena: imajte na umu da se poništavanje dokumenata također (mora) evidentirati u TSE-u. Stoga je također potrebno završiti svaku transakciju započetu metodom PUT /api/v1/transactions/createDocument pomoću "storeDocument " ili "cancelDocument ". U slučaju čestih otkazivanja dokumenata, ne možemo isključiti mogućnost da porezne vlasti postave pitanja o razlozima otkazivanja tijekom inspekcije blagajne .

Rezultat

Otvorene TSE transakcije zatvaraju se zajedno putem POST /api/v1/transactions/cancelDocument, bez potrebe za njihovim pojedinačnim zatvaranjem.

Upotreba

Preporučujemo oprezno korištenje ovog krajnjeg čvora i to samo u slučaju pogreške.

Poziv prvo generira upit TSE-u o tome koje su transakcije otvorene. Različite vrste TSE-a (Cloud TSE, Hardware TSE) ne vraćaju potpuni popis otvorenih transakcija, već samo "paket po paket":

  • swissbit Hardware TSE: po 8 transakcija,
  • fiskal Cloud TSE: 100 transakcija svaki

Nakon što je TSE vratio paket otvorenih transakcija, sadržane transakcije zatvaraju se putem praznog dokumenta, sa sljedećim informacijama:

  • ID dokumenta: Guid generiran od strane usluge
  • DocumentNr: Guid generiran od strane usluge
  • DocumentGuid: Guid generiran od strane usluge
  • Tip dokumenta: Potvrda
  • Opis vrste dokumenta: Otkazati transakciju

Ako je više od navedenih transakcija otvoreno, krajnja točka se mora pozvati više puta.

Sve zatvorene transakcije također se odgovarajuće pohranjuju u podatke DSFinV-K.

Preduvjeti

  • Na TSE-u postoje otvorene (pokrenute), tj. nezatvorene transakcije.

Ako se dosegne određeni broj otvorenih transakcija, na TSE-u se više ne mogu pokretati nove transakcije i TSE prijavljuje pogrešku. Više informacija o tome možete pronaći u članku Tse connection error.

Možete dohvatiti broj otvorenih transakcija putem krajnje točke:

Primjer:

TSE vraća broj započetih transakcija u polju "startedTransactions".

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}
Napomena: radi samo za hardverske TSE-ove. Ograničenje istovremeno otvorenih transakcija za fiskaly Cloud TSE je 2.000.

Polja obrasca

Sljedeće informacije moraju biti prenesene:

Naznaka Opis Primjer
clientId

uniqueClientId blagajne (iz sustava RetailForce).

 c1062c55-57c4-4ed2-9c53-aff1762326a4

Odgovori

Mogući odgovori:

Kôd Opis Primjer
200

fiscalResponse - otvorene transakcije su uspješno zatvorene (otkažiDokument)

 -
400

"Tse nije povezan" - Nijedan TSE nije povezan sa sustavom ili dodijeljen odgovarajućem klijentu.

Rješavanje problema:

  • Provjera je li TSE povezan sa sustavom
    npr.: GET /api/v1/management/germany/tse
 -
404

"Klijent nije pronađen" - na ovom sustavu ne postoji konfiguracija za navedeni clientId

Rješavanje problema:

  • Provjera navedenog clientId-a
  • Provjerite je li navedeni clientId konfiguriran u middlewareu (u datoteci fiscalService.config.json u C:\Program Files\RetailForce\Fiscal Webservice\Config)
 -
422

"clientId je postavljen na Guid.Empty"

Rješavanje problema: 

  •  
 -
500

"Unutarnja pogreška poslužitelja" - Druga pogreška.

Rješavanje problema: 

  • ponovite poziv,
  • ponovno pokrenite uslugu ako je potrebno,
  • izvršite cloudConnect.
 -

 

Pažnja: Bez obzira na to kako je pogreška riješena, preporučujemo da pažljivo analizirate razlog zašto TSE transakcije ostaju otvorene. U uobičajenom procesu naplate sve otvorene transakcije trebaju biti zatvorene prije dnevnog zatvaranja.

 

Ovaj je članak automatski preveden.

Povezani članci

Komentari

0 komentara

Molimo Prijavite se kako bi ostavili komentar.

Powered by Zendesk