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

Con l’endpoint

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

vengono restituite le transazioni TSE aperte.

Transazioni aperte

Si tratta di transazioni che sono state create o avviate tramite createDocument (PUT /api/v1/transactions/createDocument), ma non sono ancora state chiuse con un’operazione storeDocument (POST /api/v1/transactions/storeDocument) o con un’operazione cancelDocument (POST /api/v1/transactions/cancelDocument).

Tali transazioni risultano visibili nell’esportazione DSFinV-K. In caso di verifica del registratore di cassa da parte delle autorità fiscali, le transazioni aperte possono generare ulteriori quesiti e il revisore richiederà una spiegazione dettagliata in merito.

Attenzione: il numero di transazioni aperte consentite è limitato. L’hardware TSE di swissbit consente 512 transazioni aperte contemporaneamente, mentre il Fiskaly Cloud TSE ne consente 2.000. Se viene aperta una 513ª o una 2.001ª transazione, il TSE restituisce un errore. Vedi anche: Errore di connessione TSE .

Si raccomanda di chiudere le transazioni aperte e di configurare il processo del sistema di registrazione elettronica in modo che le transazioni possano essere messe in attesa, ma debbano essere chiuse al più tardi entro la fine della giornata.

Le transazioni aperte possono essere chiuse anche tramite il comando

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

Risultati

Elenco delle transazioni aperte non ancora completate

Utilizzo

se necessario (funzione opzionale del registratore di cassa)

Prerequisiti

L’endpoint restituisce un risultato solo se il client corrispondente è stato configurato per l’utilizzo nell’ambito della normativa KassenSichV in Germania.

Campi del modulo

È necessario fornire le seguenti informazioni:

Denominazione	Descrizione	Esempio
clientId	Identificativo univoco del cliente (uniqueClientId)	3fa85f64-5717-4562-b3fc-2c963f66afa6

Risposta

Risposte possibili:

Codice	Descrizione	Esempio
200	Il client restituisce nella risposta un elenco delle transazioni aperte. Il valore restituito è il fiscalDocumentNumber della transazione aperta Attenzione: i TSE restituiscono le transazioni aperte solo a pacchetti (SWISSBIT HARDWARE TSE: 8, Cloud TSE: 100 transazioni aperte per richiesta). Pertanto, se il numero di transazioni aperte supera tale valore, è necessario chiudere innanzitutto le transazioni specificate per poterne visualizzare altre.	[ 4, 5, 9, 8, 11, 12, 14, 15, 18, 24, 29, 57, 198, 220, 321, 525, 724 ]
422	Nella richiesta non è stato specificato alcun clientId. Risoluzione dei problemi: Specificare il clientId corretto	-
500	Errore interno: impossibile elaborare la richiesta. Risoluzione dei problemi: Contattare il supporto RetailForce	-

SWISSBIT HARDWARE TSE

Il numero totale di transazioni aperte presso SWISSBIT HARDWARE TSE può essere recuperato tramite l’endpoint GET /api/v1/management/germany/tse.

Questo articolo è stato tradotto automaticamente.