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

Povzetek

končna točka POST /api/v1/management/clients/initialize

se uporablja za

inicializacijo fiskalne enote (clienta),
vse potrebne fiskalne naprave (enota za ustvarjanje podpisov, tehnična varnostna naprava, krmilna enota, fiskalni tiskalnik/skrinjica,...) ter
za registracijo elektronskega sistema evidentiranja (blagajne) pri davčnih organih. (npr. postopek registracije na FinanzOnline – Avstrija)

Rezultat

V primeru uspešne obdelave (200)

se ustrezna fiskalna stranka in
vsaka potrebna fiskalna oprema začnejo delovati in so konfigurirani,
(če je to potrebno / na voljo v zadevni državi) se blagajna registrira pri davčnem organu.

Uporaba

Enkratno, v okviru zagona fiskalnega klienta.

Predpogoji

nameščena fiskalna middleware programska oprema,
ustvarjen in konfiguriran fiskalni client, bodisi prek
- PUT /api/v1/management/clients ali
- PUT /api/v1/management/clients/byCloud
uspešno izveden CloudConnect (samo za sisteme, povezane z RetailForce Cloud).
Uvodni dokument je bil ustvarjen; bodisi prek GET /api/v1/transactions/document/{clientId}/start bodisi s strani samega nadrejenega sistema.

Polja obrazca

Za končno točko je treba poslati začetni dokument.

Ko je bil poklican GET /api/v1/transactions/document/{clientId}/start, je bil začetni dokument vrnjen gostiteljskemu sistemu kot odgovor. Ta se zdaj lahko pošlje na končno točko POST /api/v1/management/clients/initialize.

Alternativno lahko zahtevani začetni dokument ustvari sam nadrejeni sistem.

Odgovori

Možni odgovori:

Koda	Opis	Primer
200	Začetni dokument je bil uspešno in brez napak poslan ter shranjen v documentStore. Poleg tega se sistemu na višji ravni vrne odgovor fiscalResponse. Ta se mora shraniti v dnevnik sistema na višji ravni za referenčne namene.	fiscalResponse
204	Začetni dokument je bil uspešno in brez napak poslan ter shranjen v documentStore. V nekaterih državah se ob uspešnem zagonu ne pošlje noben odgovor fiscalResponse.	-
422	Začetni dokument ne ustreza zahtevam zadevne države ali v njem manjka clientId. Odpravljanje težav: Za podrobnejšo analizo napake izvedite POST /api/v1/transactions/validateDocument ali POST /api/v1/transactions/validateDocumentString ; Uporabite GET /api/v1/transactions/document/{clientId}/start za ustvarjanje veljavnega začetnega dokumenta; navedite ustrezno clientId.	-
500	Napaka pri preverjanju veljavnosti v začetnem dokumentu ali pa clientId, poslan v začetnem dokumentu, ni najden v ConfigStore. Odpravljanje težav: Za podrobnejšo analizo napake izvedite POST /api/v1/transactions/validateDocument ali POST /api/v1/transactions/validateDocumentString ; Uporabite GET /api/v1/transactions/document/{clientId}/start za ustvarjanje veljavnega začetnega dokumenta; preverite, ali je bil clientId ustvarjen tudi v sistemu (PUT /api/v1/management/clients ali PUT /api/v1/management/clients/byCloud)	-

Ta članek je bil samodejno preveden.

Rezultat

Uporaba

Predpogoji

Polja obrazca

Odgovori

Sorodni sklopi