PUT /api/v1/transactions/createDocument – RetailForce

Questo endpoint rappresenta la prima fase della trasmissione delle transazioni dal sistema di registrazione elettronico («registratore di cassa») al Servizio fiscale. Il flusso operativo si articola sempre in due fasi. Tale processo a due fasi per la trasmissione delle transazioni si basa sui requisiti dell’Ordinanza tedesca contro la manomissione dei registratori di cassa e deve essere implementato in tutti i Paesi soggetti a regime fiscale secondo i principi di un’interfaccia standardizzata. In Germania, quando viene invocato il metodo PUT /api/v1/transactions/createDocument, la transazione viene registrata nel cosiddetto Dispositivo di Sicurezza Tecnico (TSE/TSS).

Registrazione della transazione

Una transazione/un documento viene registrato nell’unità fiscale:

PUT /api/v1/transactions/createDocument e
POST /api/v1/transactions/storeDocument

Interruzione della transazione

Questo comando registra la chiusura di una transazione nell’unità fiscale:

PUT /api/v1/transactions/createDocument e
POST /api/v1/transactions/cancelDocument

Nota: tutte le transazioni avviate con PUT /api/v1/transactions/createDocument devono essere chiuse con POST /api/v1/transactions/storeDocument oppure con POST /api/v1/transactions/cancelDocument. Si prega di tenere presente listTransactions (DELETE).

Risultato

Una chiamata riuscita all’endpoint (200)

registra l’avvio di una transazione nell’unità fiscale e
restituisce una «fiscalResponse» al sistema a monte (sistema di registrazione elettronica).

Utilizzo

ogni volta che si deve inviare una nuova transazione all’unità fiscale, prima di eseguire POST /api/v1/transactions/storeDocument o POST /api/v1/transactions/cancelDocument.

Prerequisiti

Fiskal Client inizializzato

Campi del modulo

È necessario inviare le seguenti informazioni:

Denominazione	Tipo	Descrizione	Esempio
clientId	M	The uniqueClientId del registratore di cassa (dal sistema RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Il tipo di documento da registrare. Enum: [0] = Ricevuta [1] = Fattura [2] = Bolla di consegna [10] = Pagamento [11] = PayIn [12] = Fattura proforma [13] = Ordine del cliente [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Inventario [101] = Acquisto [1000] = Scontrino nullo [1100] = Varie non fiscali	-
DocumentGuid	R	Il GUID/UUID assegnato alla transazione dal sistema POS. Comportamento del campo "DocumentGuid" incluso nella richiesta: Specificando "DocumentGuid", la chiamata diventa idempotente. La funzione createDocument può essere richiamata più volte senza avviare una nuova transazione nel TSE (Technical Security Device Germany). "fiscalResponse": viene sempre restituita la STESSA risposta. Comportamento in assenza di "DocumentGuid" nella richiesta: Se non viene specificato alcun "DocumentGuid", ad OGNI chiamata a createDocument viene avviata una nuova transazione nel TSE (Germania)! "fiscalResponse": viene restituita una NUOVA risposta ad ogni chiamata. Nota: lo stesso "DocumentGuid" deve essere utilizzato anche nella successiva chiamata a POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Risposta

Risposte possibili:

Codice	Descrizione	Esempio
200	La transazione è stata avviata e viene restituita una fiscalResponse al sistema a monte.	-

Questo articolo è stato tradotto automaticamente.

Risultato

Utilizzo

Prerequisiti

Campi del modulo

Risposta

Articoli correlati