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

The

krajnja točka se koristi za

inicijalizirati fiskalnu jedinicu (klijenta),
bilo koju potrebnu fiskalnu opremu (uređaj za stvaranje potpisa, tehnički sigurnosni uređaj, kontrolna jedinica, fiskalni pisač/kutija,...) i
za registraciju elektroničkog sustava evidencije (blagajne) kod poreznih tijela. (npr. postupak registracije na FinanzOnline - Austrija)

Rezultat

U slučaju uspješne obrade (200),

odgovarajući fiskalni klijent i
sva potrebna fiskalna oprema pušta se u rad i konfigurira i
(ako je potrebno / dostupno u dotičnoj zemlji) blagajna se registrira kod porezne uprave.

Instaliran fiskalni middleware,
Fiskalni klijent je stvoren i konfiguriran, bilo putem
- PUT /api/v1/management/clients ili
- PUT /api/v1/management/clients/byCloud
cloudConnect je uspješno izvršen (samo za sustave povezane s RetailForce Cloudom).
Pokrenut je dokument; bilo putem GET /api/v1/transactions/document/{clientId}/start ili od strane samog gornjeg sustava.

Početni dokument mora biti poslan na krajnju točku.

Kada je pozvan GET /api/v1/transactions/document/{clientId}/start, početni dokument je vraćen host-sustavu kao odgovor. Sada se može poslati na POST /api/v1/management/clients/initialize krajnju točku.

Alternativno, potrebni početni dokument može stvoriti sam gornji sustav.

Mogući odgovori:

Kod	Opis	Primjer
200	Početni dokument je uspješno i bez pogrešaka prenesen i pohranjen u spremište dokumenata. Nadalje, fiscalResponse se vraća nadređenom sustavu. To bi trebalo pohraniti u dnevnik nadređenog sustava u referentne svrhe.	fiscalResponse
204	Početni dokument je uspješno prenesen i bez pogrešaka te je spremljen u dokumentStore. U nekim se zemljama pri uspješnoj puštanju u rad ne šalje fiscalResponse.	-
422	Početni dokument ne odgovara zahtjevima dotične zemlje ili u početnom dokumentu nedostaje ClientId. Rješavanje problema: Pokrenite POST /api/v1/transactions/validateDocument ili POST /api/v1/transactions/validateDocumentString za detaljniju analizu pogrešaka; Koristite GET /api/v1/transactions/document/{clientId}/start za izradu valjanog početnog dokumenta; navedi odgovarajući clientId.	-
500	Greška u validaciji u početnom dokumentu ili se klijentski ID prenesen u početnom dokumentu ne nalazi u ConfigStoreu. Rješavanje problema: Pokrenite POST /api/v1/transactions/validateDocument ili POST /api/v1/transactions/validateDocumentString za detaljniju analizu pogreške; Koristite GET /api/v1/transactions/document/{clientId}/start za stvaranje valjane početne dokumentacije; provjerite je li i clientId stvoren u sustavu (PUT /api/v1/management/clients ili PUT /api/v1/management/clients/byCloud)	-

Ovaj je članak automatski preveden.