Metoda
- POST /api/v1/management/clients/initialize
służy do
- zainicjowania jednostki fiskalnej (klienta),
- wszelkiego wymaganego sprzętu fiskalnego (urządzenie do tworzenia podpisu, techniczne urządzenie zabezpieczające, jednostka sterująca, drukarka/moduł fiskalny itp.) oraz
- do zarejestrowania elektronicznego systemu rejestracji (kasy fiskalnej) w organach skarbowych. (np. proces rejestracji w serwisie FinanzOnline – Austria)
Wynik
W przypadku pomyślnego przetworzenia (200),
- odpowiedni klient fiskalny oraz
- wszelki wymagany sprzęt fiskalny zostają uruchomione i skonfigurowane, a
- (w razie potrzeby / o ile jest to możliwe w danym kraju) kasa fiskalna zostaje zarejestrowana w urzędzie skarbowym.
Zastosowanie
- Jednorazowe, w ramach uruchomienia klienta fiskalnego.
Wymagania wstępne
- Zainstalowane middleware do celów fiskalnych,
- utworzony i skonfigurowany client fiskalny, za pośrednictwem
- PUT /api/v1/management/clients, albo
- PUT /api/v1/management/clients/byCloud
- pomyślne wykonanie polecenia CloudConnect (dotyczy wyłącznie systemów podłączonych do RetailForce Cloud).
- Utworzono dokument początkowy; za pomocą żądania GET /api/v1/transactions/document/{clientId}/start lub przez sam system nadrzędny.
Pola formularza
Do punktu końcowego należy przesłać dokument początkowy.
Po wywołaniu metody GET /api/v1/transactions/document/{clientId}/start dokument początkowy został zwrócony do systemu hosta w odpowiedzi. Można go teraz przesłać do punktu końcowego POST /api/v1/management/clients/initialize.
Alternatywnie wymagany dokument początkowy może zostać utworzony przez sam system nadrzędny.
Odpowiedzi
Możliwe odpowiedzi:
| Kod | Opis | Przykład |
| 200 |
Dokument początkowy został pomyślnie przesłany bez błędów i zapisany w documentStore. Ponadto do systemu nadrzędnego zwracana jest odpowiedź fiskalna (fiscalResponse). Należy ją zapisać w dzienniku systemu nadrzędnego w celach referencyjnych. |
fiscalResponse |
| 204 |
Dokument początkowy został pomyślnie przesłany bez błędów i zapisany w documentStore. W niektórych krajach po pomyślnym uruchomieniu nie jest przesyłana żadna odpowiedź fiscalResponse. |
- |
| 422 |
Dokument startowy nie spełnia wymagań danego kraju lub w dokumencie startowym brakuje identyfikatora clientId. Rozwiązywanie problemów:
|
- |
| 500 |
Wystąpił błąd walidacji w dokumencie początkowym lub identyfikator clientId przesłany w dokumencie początkowym nie został znaleziony w ConfigStore. Rozwiązywanie problemów:
|
- |
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.