GET /api/v1/transactions/document/ {clientId}/start – RetailForce

Utilizzo dell’endpoint

GET /api/v1/transazioni/documento/{clientId}/start,

il servizio fiscale genera un cosiddetto documento di avvio (documento iniziale) e lo restituisce al sistema a monte.

I documenti iniziali sono documenti specifici per ciascun Paese utilizzati per inizializzare (rendere operativa) l’unità fiscale.

Alcuni paesi ne prescrivono obbligatoriamente l’emissione, come illustrato nella tabella sottostante.

Paese	Denominazione	DocumentType
Austria	"Startbeleg" - ricevuta iniziale	[1000] = NullReceipt
Lituania	Rapporto iniziale (Z)	[99] = EndOfDay

L’endpoint GET /api/v1/transactions/document/{clientId}/start genera sempre il documento iniziale richiesto nel rispettivo Paese.

Importante: per quanto riguarda l’interfaccia standardizzata, l’inizializzazione di un client fiscale avviene sempre tramite la procedura descritta nell’articolo collegato. È pertanto necessario trasmettere un documento di avvio al servizio fiscale di ciascun paese.

Nota: in alternativa all’utilizzo dell’endpoint GET /api/v1/transactions/document/{clientId}/start, il relativo documento di avvio può essere generato anche dal sistema a monte (sistema di registrazione elettronica) stesso.

Risultato

In caso di elaborazione riuscita (codice di risposta 200), il client fiscale restituisce il documento di avvio al sistema upstream.

Utilizzo

Una tantum, nell’ambito della messa in servizio di un client fiscale.

Prerequisiti

Fiscal Middleware installato,
Client fiscale creato e configurato, tramite
- PUT /api/v1/management/clients oppure
- PUT /api/v1/management/clients/byCloud
CloudConnect eseguito con successo (solo per i sistemi integrati con RetailForce Cloud).

Campi del modulo

È necessario fornire le seguenti informazioni:

Denominazione	Descrizione	Esempio
clientId	L'uniqueClientId del registratore di cassa (dal RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
BookDate	Facoltativo: timestamp di registrazione del documento iniziale	2023-05-19T10:30:04.297Z

Risposta

Possibili risposte:

Codice	Descrizione	Esempio
200	Documento iniziale specifico per il Paese	-

Questo articolo è stato tradotto automaticamente.