A
- POST /api/v1/management/clients/initialize
végpontot használjuk a
- a pénzügyi egység (client) inicializálására,
- bármely szükséges adóügyi hardvert (aláírás-készítő egység, műszaki biztonsági eszköz, vezérlőegység, adóügyi nyomtató/doboz stb.) és
- az elektronikus nyilvántartási rendszer (pénztárgép) adóhatóságnál történő regisztrációjára szolgál. (pl. regisztrációs folyamat a FinanzOnline-on – Ausztria)
Eredmény
Sikeres feldolgozás esetén (200)
- a megfelelő adóügyi client és
- az esetlegesen szükséges adóügyi hardverek üzembe helyezésre és konfigurálásra kerülnek, és
- (ha szükséges / az adott országban elérhető) a pénztárgépet bejegyzik az adóhatóságnál.
Használat
- Egyszeri, a fiskális client üzembe helyezésének részeként.
Előfeltételek
- Telepített fiskális middleware,
- Fiscal Client létrehozva és konfigurálva, akár a
- PUT /api/v1/management/clients, vagy
- PUT /api/v1/management/clients/byCloud
- A CloudConnect parancs sikeres végrehajtása (csak a RetailForce Cloudhoz csatlakozó rendszerek esetében).
- A Start dokumentum létrehozásra került; akár a GET /api/v1/transactions/document/{clientId}/start parancs segítségével, akár maga az upstream rendszer által.
Űrlapmezők
A kezdő dokumentumot el kell küldeni a végponthoz.
A GET /api/v1/transactions/document/{clientId}/start hívásakor a rendszer válaszként visszaküldött egy kezdő dokumentumot a gazdaszervernek. Ezt most el lehet küldeni a POST /api/v1/management/clients/initialize végponthoz.
Alternatív megoldásként a szükséges kezdő dokumentumot maga a felülről érkező rendszer is létrehozhatja.
Válaszok
Lehetséges válaszok:
| Kód | Leírás | Példa |
| 200 |
A kezdő dokumentum hiba nélkül, sikeresen továbbításra került, és elmentésre került a documentStore-ba. Ezen felül egy fiscalResponse kerül visszaküldésre az upstream rendszernek. Ezt referenciacélokra az upstream rendszer naplójában kell tárolni. |
fiscalResponse |
| 204 |
A kezdő dokumentum sikeresen és hiba nélkül került továbbításra, és elmentésre került a documentStore-ba. Egyes országokban a sikeres üzembe helyezés után nem kerül továbbításra fiscalResponse. |
- |
| 422 |
A kezdő dokumentum nem felel meg az adott ország követelményeinek, vagy hiányzik belőle a clientId. Hibaelhárítás:
|
- |
| 500 |
Érvényesítési hiba a kezdő dokumentumban, vagy a kezdő dokumentumban továbbított clientId nem található a ConfigStore-ban. Hibaelhárítás:
|
- |
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.