Gå til hovedindhold

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

Harald Krondorfer
  • Opdateret

Den

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

kan bruges til at afslutte åbne TSE-transaktioner.

Som hovedregel bør transaktioner ikke stå åbne. Vi anbefaler, at alle åbne transaktioner lukkes inden den daglige afslutning med enten

OBS: Bemærk venligst, at annulleringer af dokumenter også registreres (skal registreres) i TSE. Derfor er det også nødvendigt at afslutte hver transaktion, der er startet med PUT /api/v1/transactions/createDocument , med "storeDocument " eller "cancelDocument ". I tilfælde af hyppige annulleringer af dokumenter kan vi ikke udelukke, at skattemyndighederne i forbindelse med en kassekontrol stiller spørgsmål om årsagerne til annulleringerne.

Resultat

Åbne TSE-transaktioner lukkes samlet med POST /api/v1/transactions/cancelDocument, uden at det er nødvendigt at lukke dem enkeltvis.

Anvendelse

Vi anbefaler, at dette endpoint kun bruges med forsigtighed og udelukkende i tilfælde af en fejl.

Opkaldet genererer først en forespørgsel til TSE om, hvilke transaktioner der er åbne. De forskellige TSE-typer (Cloud TSE, hardware TSE) returnerer ikke en komplet liste over åbne transaktioner, men kun "pakke for pakke":

  • SWISSBIT HARDWARE TSE: 8 transaktioner ad gangen,
  • fiskal Cloud TSE: 100 transaktioner ad gangen

Når TSE'en har returneret pakken med åbne transaktioner, lukkes de indeholdte transaktioner via et tomt dokument med følgende oplysninger:

  • DocumentId: Guid genereret af tjenesten
  • DocumentNr: GUID genereret af tjenesten
  • DocumentGuid: GUID genereret af tjenesten
  • DocumentType: Kvittering
  • documentTypeCaption: CancelTransaction

Hvis der er flere åbne transaktioner end ovenstående, skal endpointet kaldes mere end én gang.

Alle afsluttede transaktioner gemmes ligeledes i DSFinV-K-dataene.

Forudsætninger

  • Der er åbne (påbegyndte), dvs. ikke afsluttede, transaktioner på TSE.

Når et bestemt antal åbne transaktioner er nået, kan der ikke startes flere transaktioner på TSE, og TSE rapporterer en fejl. Du kan finde mere information herom i artiklen TSE-forbindelsesfejl.

Du kan hente antallet af åbne transaktioner via endpointet:

Eksempel:

TSE returnerer antallet af påbegyndte transaktioner i feltet "startedTransactions".

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}
Bemærk: Fungerer kun for hardware TSE'er. Grænsen for samtidigt åbne transaktioner for Fiskaly Cloud TSE er 2.000.

Formularfelter

Følgende oplysninger skal overføres:

Betegnelse Beskrivelse Eksempel
clientId

Kasseapparatets uniqueClientId (fra RetailForce systemet).

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

Svar

Mulige svar:

Kode Beskrivelse Eksempel
200

fiscalResponse – de åbne transaktioner er blevet lukket (cancelDocument)

 -
400

"Tse ikke tilsluttet" – Der er ingen TSE tilsluttet systemet eller tildelt den pågældende client.

Fejlfinding:

  • Kontroller, om TSE er forbundet til systemet
    , f.eks. med GET /api/v1/management/germany/tse
 -
404

"Klienten blev ikke fundet" – der findes ingen konfiguration på dette system under det angivne clientId

Fejlfinding:

  • Kontroller den angivne clientId
  • Kontroller, om den angivne clientId er konfigureret i middlewaren (i filen fiscalService.config.json under C:\Program Files\RetailForce\Fiscal Webservice\Config)
 -
422

"clientId blev indstillet til Guid.Empty"

Fejlfinding: 

  •  
 -
500

"Intern serverfejl" – Anden fejl.

Fejlfinding: 

  • gentag opkaldet,
  • genstart tjenesten, hvis det er nødvendigt,
  • kør CloudConnect.
 -

 

Bemærk: Uanset hvordan fejlen blev løst, anbefaler vi, at du nøje analyserer årsagen til, at TSE-transaktioner forbliver åbne. I den normale afregningsproces skal alle åbne transaktioner lukkes inden den daglige afslutning.

 

Denne artikel er oversat automatisk.

Relaterede artikler

Kommentarer

0 kommentarer

Log ind for at kommentere.

Drevet af Zendesk