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

The

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

kan användas för att avsluta öppna TSE-transaktioner.

Som allmän regel bör transaktioner inte lämnas öppna. Vi rekommenderar att alla öppna transaktioner avslutas före en daglig avstängning med antingen

POST /api/v1/transactions/storeDocument – om en försäljning har ägt rum, eller
POST /api/v1/transactions/cancelDocument – om ingen försäljning har ägt rum.

Observera att dokumentannulleringar också registreras (måste registreras) i TSE. Därför är det också nödvändigt att avsluta varje transaktion som inletts med PUT /api/v1/transactions/createDocument med ”storeDocument ” eller ”cancelDocument ”. Vid frekventa dokumentannulleringar kan vi inte utesluta att skattemyndigheterna kan ställa frågor om orsakerna till annulleringarna i samband med en kassaregisterkontroll .

Resultat

Öppna TSE-transaktioner avslutas samlat med POST /api/v1/transactions/cancelDocument, utan att de behöver avslutas enskilt.

Användning

Vi rekommenderar att denna ändpunkt används med försiktighet och endast i händelse av ett fel.

Anropet genererar först en förfrågan till TSE om vilka transaktioner som är öppna. De olika TSE-typerna (Cloud TSE, hardware TSE) returnerar inte en fullständig lista över öppna transaktioner, utan endast ”paket för paket”:

SWISSBIT HARDWARE TSE: 8 transaktioner åt gången,
fiskal Cloud TSE: 100 transaktioner åt gången

Efter att TSE har returnerat paketet med öppna transaktioner stängs de ingående transaktionerna via ett tomt dokument med följande information:

DocumentId: Guid genererad av tjänsten
DocumentNr: GUID genererad av tjänsten
DocumentGuid: GUID genererad av tjänsten
DocumentType: Kvitto
documentTypeCaption: CancelTransaction

Om fler än ovanstående transaktioner är öppna måste slutpunkten anropas mer än en gång.

Alla avslutade transaktioner lagras också i enlighet med detta i DSFinV-K-data.

Förutsättningar

Det finns öppna (påbörjade), dvs. inte avslutade, transaktioner på TSE.

Om ett visst antal öppna transaktioner uppnås kan inga fler transaktioner startas på TSE och TSE rapporterar ett fel. Mer information om detta finns i artikeln TSE-anslutningsfel.

Du kan hämta antalet öppna transaktioner via slutpunkten:

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

Exempel:

TSE returnerar antalet påbörjade transaktioner i fältet ”startedTransactions”.

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

Obs! Fungerar endast för hardware TSE:er. Gränsen för samtidigt öppna transaktioner för Fiskaly Cloud TSE är 2 000.

Formulärfält

Följande information måste överföras:

Beteckning	Beskrivning	Exempel
clientId	Kassans uniqueClientId (från RetailForce systemet).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Svar

Möjliga svar:

Kod	Beskrivning	Exempel
200	fiscalResponse – de öppna transaktionerna har stängts (cancelDocument)	-
400	"Tse not connected" – Ingen TSE är ansluten till systemet eller tilldelad motsvarande client. Felsökning: Kontrollera om TSE är ansluten till systemet , t.ex. med GET /api/v1/management/germany/tse	-
404	"Klienten hittades inte" – det finns ingen konfiguration på detta system under det angivna clientId Felsökning: Kontrollera det angivna clientId Kontrollera om det angivna clientId är konfigurerat i middleware (i filen fiscalService.config.json under C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	"clientId har satts till Guid.Empty" Felsökning:	-
500	"Internt serverfel" – Övrigt fel. Felsökning: Upprepa anropet, starta om tjänsten om det behövs, kör CloudConnect.	-

Observera: Oavsett hur felet löstes rekommenderar vi att du noggrant analyserar orsaken till att TSE-transaktioner förblir öppna. I den vanliga utcheckningsprocessen ska alla öppna transaktioner stängas innan den dagliga avslutningen.

Den här artikeln har översatts automatiskt.

Resultat

Användning

Förutsättningar

Formulärfält

Svar

Relaterade artiklar