POST /api/v1/management/clients/ initialize – RetailForce

endpoint POST /api/v1/management/clients/initialize

viene utilizzato per

inizializzare l’unità fiscale (client),
di qualsiasi hardware fiscale necessario (unità di creazione della firma, dispositivo tecnico di sicurezza, unità di controllo, stampante/cassetto fiscale,...) e
per registrare il sistema di registrazione elettronica (registratore di cassa) presso le autorità fiscali. (ad es. procedura di registrazione su FinanzOnline - Austria)

Risultato

In caso di elaborazione riuscita (200),

il corrispondente client fiscale e
l’eventuale hardware fiscale necessario vengono messi in funzione e configurati e
(se necessario/disponibile nel rispettivo Paese) il registratore di cassa viene registrato presso l’autorità fiscale.

Utilizzo

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

Prerequisiti

Middleware fiscale 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).
È stato creato il documento iniziale tramite GET /api/v1/transactions/document/{clientId}/start oppure dal sistema a monte stesso.

Campi del modulo

È necessario inviare un documento di avvio all’endpoint.

Quando viene invocato il comando GET /api/v1/transactions/document/{clientId}/start, il sistema restituisce un documento iniziale al sistema host come risposta. Tale documento può quindi essere inoltrato all’endpoint POST /api/v1/management/clients/initialize.

In alternativa, il documento iniziale richiesto può essere generato direttamente dal sistema a monte.

Risposte

Risposte possibili:

Codice	Descrizione	Esempio
200	Il documento iniziale è stato trasmesso correttamente e senza errori e salvato nel documentStore. Inoltre, viene restituita una «fiscalResponse» al sistema a monte. Tale risposta deve essere archiviata nel registro del sistema a monte a scopo di riferimento.	fiscalResponse
204	Il documento iniziale è stato trasmesso con esito positivo e senza errori ed è stato salvato nel documentStore. In alcuni Paesi, in caso di messa in servizio riuscita, non viene trasmessa alcuna fiscalResponse.	-
422	Il documento di avvio non soddisfa i requisiti del Paese in questione oppure nel documento di avvio manca il clientId. Risoluzione dei problemi: Eseguire POST /api/v1/transactions/validateDocument o POST /api/v1/transactions/validateDocumentString per un'analisi più dettagliata dell'errore; utilizzare GET /api/v1/transactions/document/{clientId}/start per generare un documento di avvio valido; specificare il relativo ClientId.	-
500	Errore di convalida nel documento iniziale oppure il clientId trasmesso nel documento iniziale non è presente nel ConfigStore. Risoluzione dei problemi: Eseguire POST /api/v1/transactions/validateDocument o POST /api/v1/transactions/validateDocumentString per un'analisi più dettagliata dell'errore; Utilizzare GET /api/v1/transactions/document/{clientId}/start per creare un documento iniziale valido; verificare che il clientId sia stato correttamente provisionato nel sistema tramite PUT /api/v1/management/clients oppure PUT /api/v1/management/clients/byCloud.	-

Questo articolo è stato tradotto automaticamente.

Risultato

Utilizzo

Prerequisiti

Campi del modulo

Risposte

Articoli correlati