ȘTERGE /api/v1/management/germany/ {clientId}/TSE/listTransactions – RetailForce

Comanda

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

poate fi utilizat pentru a închide tranzacțiile TSE deschise.

Ca regulă generală, tranzacțiile nu ar trebui lăsate deschise. Recomandăm ca toate tranzacțiile deschise să fie închise înainte de închiderea zilnică, fie prin

POST /api/v1/transactions/storeDocument – dacă a avut loc o vânzare, sau
POST /api/v1/transactions/cancelDocument – dacă nu a avut loc nicio vânzare.

Atenție: vă rugăm să rețineți că anulările documentelor sunt (trebuie să fie) înregistrate și în TSE. Prin urmare, este necesar ca fiecare tranzacție inițiată cu PUT /api/v1/transactions/createDocument să fie încheiată cu „storeDocument ” sau „cancelDocument ”. În cazul anulărilor frecvente ale documentelor, nu putem exclude posibilitatea ca autoritățile fiscale să pună întrebări cu privire la motivele anulărilor în cursul unei inspecții a casei de marcat .

Rezultat

Tranzacțiile TSE deschise sunt închise colectiv cu comanda POST /api/v1/transactions/cancelDocument, fără a fi necesară închiderea lor individuală.

Utilizare

Vă recomandăm să utilizați acest punct final cu precauție și numai în cazul apariției unei erori.

Apelul generează mai întâi o interogare către TSE pentru a afla care sunt tranzacțiile deschise. Diferitele tipuri de TSE (Cloud TSE, hardware TSE) nu returnează o listă completă a tranzacțiilor deschise, ci doar „pachet cu pachet”:

SWISSBIT HARDWARE TSE: câte 8 tranzacții,
fiskal Cloud TSE: câte 100 de tranzacții

După ce TSE a returnat pachetul de tranzacții deschise, tranzacțiile conținute sunt închise printr-un document gol, cu următoarele informații:

DocumentId: Guid generat de serviciu
DocumentNr: GUID generat de serviciu
DocumentGuid: GUID generat de serviciu
DocumentType: Chitanță
documentTypeCaption: Anulare tranzacție

Dacă sunt deschise mai multe tranzacții decât cele menționate mai sus, punctul final trebuie apelat de mai multe ori.

Toate tranzacțiile închise sunt, de asemenea, stocate corespunzător în datele DSFinV-K.

Condiții prealabile

Există tranzacții deschise (începute), adică neînchise, pe TSE.

Dacă se atinge un anumit număr de tranzacții deschise, nu mai pot fi inițiate alte tranzacții pe TSE, iar TSE raportează o eroare. Puteți găsi mai multe informații despre acest lucru în articolul Eroare de conexiune TSE.

Puteți obține numărul de tranzacții deschise prin intermediul punctului de capăt:

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

Exemplu:

TSE returnează numărul de tranzacții inițiate în câmpul „startedTransactions”.

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

Notă: funcționează numai pentru hardware TSE-urile. Limita de tranzacții deschise simultan pentru Fiskaly Cloud TSE este de 2.000.

Câmpuri ale formularului

Trebuie transmise următoarele informații:

Denumire	Descriere	Exemplu
clientId	UniqueClientId al casei de marcat (din RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Răspunsuri

Răspunsuri posibile:

Cod	Descriere	Exemplu
200	fiscalResponse - tranzacțiile deschise au fost închise cu succes (cancelDocument)	-
400	„TSE neconectat” – Niciun TSE nu este conectat la sistem sau alocat clientului corespunzător. Depanare: Verificați dacă TSE este conectată la sistem , de exemplu: cu GET /api/v1/management/germany/tse	-
404	„Clientul nu a fost găsit” – nu există nicio configurație pe acest sistem sub clientId-ul specificat Depanare: Verificarea clientId-ului specificat Verificați dacă clientId-ul specificat este configurat în middleware (în fișierul fiscalService.config.json din C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	„clientId a fost setat la Guid.Empty” Depanare:	-
500	„Eroare internă a serverului” – Altă eroare. Depanare: repetați apelul, repornirea serviciului, dacă este necesar, executați CloudConnect.	-

Atenție: Indiferent de modul în care a fost rezolvată eroarea, vă recomandăm să analizați cu atenție motivul pentru care tranzacțiile TSE rămân deschise. În cadrul procesului obișnuit de închidere, toate tranzacțiile deschise trebuie închise înainte de închiderea zilnică.

Acest articol a fost tradus automat.

Rezultat

Utilizare

Condiții prealabile

Câmpuri ale formularului

Răspunsuri

Articole conexe