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

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

può essere utilizzato per chiudere le transazioni TSE aperte.

Come regola generale, le transazioni non dovrebbero essere lasciate aperte. Si raccomanda di chiudere tutte le transazioni aperte prima della chiusura giornaliera tramite

POST /api/v1/transactions/storeDocument – qualora sia stata effettuata una vendita, oppure
POST /api/v1/transactions/cancelDocument – qualora non sia avvenuta alcuna vendita.

Attenzione: si prega di notare che anche le cancellazioni dei documenti vengono (devono essere) registrate nel TSE. Pertanto, è necessario concludere ogni transazione avviata con PUT /api/v1/transactions/createDocument tramite "storeDocument " o "cancelDocument ". In caso di frequenti annullamenti di documenti, non si può escludere che, nel corso di un controllo del registratore di cassa , le autorità fiscali possano richiedere chiarimenti in merito ai motivi di tali annullamenti.

Risultato

Le transazioni TSE aperte vengono chiuse collettivamente tramite POST /api/v1/transactions/cancelDocument, senza necessità di chiuderle singolarmente.

Utilizzo

Si raccomanda di utilizzare questo endpoint con cautela e solo in caso di errore.

La chiamata genera innanzitutto una richiesta al TSE per verificare quali transazioni siano aperte. I diversi tipi di TSE (Cloud TSE, hardware TSE) non restituiscono un elenco completo delle transazioni aperte, ma solo «pacchetto per pacchetto»:

SWISSBIT HARDWARE TSE: 8 transazioni per pacchetto,
fiskal Cloud TSE: 100 transazioni ciascuna

Una volta ricevuto il pacchetto di transazioni aperte dal TSE, tali transazioni vengono chiuse tramite un documento vuoto contenente le seguenti informazioni:

DocumentId: GUID generato dal servizio
DocumentNr: GUID generato dal servizio
DocumentGuid: GUID generato dal servizio
DocumentType: Ricevuta
documentTypeCaption: CancelTransaction

Qualora vi siano più transazioni aperte oltre a quelle sopra indicate, l’endpoint deve essere richiamato più di una volta.

Anche tutte le transazioni chiuse vengono memorizzate di conseguenza nei dati DSFinV-K.

Prerequisiti

Sul TSE sono presenti transazioni aperte (avviate), ovvero non chiuse.

Una volta raggiunto il numero massimo di transazioni aperte configurato sulla TSE, non è più possibile avviare ulteriori transazioni e la TSE restituisce un codice di errore. Per ulteriori dettagli, si consulti l’articolo “Errore di connessione alla TSE”.

È possibile recuperare il numero di transazioni aperte tramite l’endpoint:

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

Esempio:

Il TSE restituisce il numero di transazioni avviate nel campo "startedTransactions".

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

Nota: la funzionalità è disponibile esclusivamente per le TSE hardware. Il limite di transazioni aperte contemporaneamente per il Fiskaly Cloud TSE è pari a 2.000.

Campi del modulo

È necessario trasmettere i seguenti parametri:

Denominazione	Descrizione	Esempio
clientId	L'uniqueClientId del registratore di cassa (dal RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Risposte

Risposte possibili:

Codice	Descrizione	Esempio
200	fiscalResponse – le transazioni aperte sono state chiuse con successo (cancelDocument)	-
400	"TSE non connesso" - Nessun TSE è connesso al sistema o assegnato al client corrispondente. Risoluzione dei problemi: Verificare che il TSE sia correttamente connesso al sistema , ad esempio mediante la chiamata GET /api/v1/management/germany/tse	-
404	"Client non trovato" - su questo sistema non esiste alcuna configurazione con il clientId specificato Risoluzione dei problemi: Verifica del clientId specificato Verificare che il clientId specificato sia configurato nel middleware (nel file fiscalService.config.json all’interno di C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	"Il clientId è stato impostato su Guid.Empty" Risoluzione dei problemi:	-
500	"Errore interno del server" - Altro errore. Risoluzione dei problemi: ripetere la chiamata, riavviare il servizio se necessario, eseguire CloudConnect.	-

Attenzione: indipendentemente dalla modalità di risoluzione dell’errore, si raccomanda di analizzare attentamente la ragione per cui le transazioni TSE rimangono aperte. Nel normale processo di chiusura, tutte le transazioni aperte devono essere chiuse prima della chiusura giornaliera.

Questo articolo è stato tradotto automaticamente.

Risultato

Utilizzo

Prerequisiti

Campi del modulo

Risposte

Articoli correlati