PUT /api/v1/management/clients/ byCloud – RetailForce

Ten punkt końcowy tworzy nowego klienta w oprogramowaniu pośredniczącym Fiscal Middleware i łączy go z terminalem w RetailForce Cloud. Stanowi to pierwszy krok w procesie uruchomienia nowej kasy fiskalnej.

Wyniki

Pomyślne wywołanie punktu końcowego (200)

powoduje utworzenie nowego klienta w middleware, przypisanie mu identyfikatora uniqueClientId terminala (Cloud) oraz
pobiera obiekt konfiguracyjny z systemu Cloud oraz odpowiednio konfiguruje clienta.

Sposób użycia

Jednorazowo, w momencie uruchomienia nowej kasy fiskalnej. Ponowne wywołanie punktu końcowego dla tego samego klienta (clientId) spowoduje wygenerowanie błędu!

UWAGA : jeśli dany klient został już raz połączony z terminalem utworzonym w chmurze (przypisanie identyfikatora uniqueClientId), ponowne wywołanie punktu końcowego spowoduje wyświetlenie komunikatu o błędzie: „409 – Klient już istnieje”. Jeśli konieczne jest ponowne utworzenie klienta (np. w wyniku awarii dysku twardego itp.), należy skorzystać z punktu końcowego /api/v1/management/clients/recovery/restoreByCloud.

Wymagania wstępne

W chmurze RetailForce Cloud utworzono strukturę organizacyjną oraz obiekt konfiguracyjny i odpowiednio je przypisano
Zainstalowano oprogramowanie Fiscal Middleware

Pola formularza

Należy podać następujące informacje:

Stanowisko	Opis	Przykład
Typ	Rodzaj identyfikatora firmy. Rodzaj ten musi być również wprowadzony i znajdować się w systemie RetailForce Cloud. Dostępne są następujące typy: [0] = VatNumber, [1] = taxNumber, [2] = GLNNumber, [3] = BusinessIdentificationNumber, [4] = klasyfikacja statystyczna, [5] = numer w rejestrze handlowym, [6] = urząd prowadzący rejestr handlowy, [7] = numer w rejestrze działalności gospodarczej Zobacz także: Identyfikator firmy Zalecamy stosowanie typu [0] = VatNumber jako głównego ID we wszystkich krajach (UE), nawet jeśli nie jest on używany jako obowiązkowy ID przedsiębiorstwa w danym kraju.	[0] = VatNumber
Identyfikacja	Sam identyfikator przedsiębiorstwa. Musi być zgodny z informacjami wprowadzonymi w RetailForce Cloud.	ATU57780814
storeNumber	Numer oddziału/sklepu, w którym znajduje się kasa fiskalna. Musi być zgodny z danymi wprowadzonymi w RetailForce Cloud. UWAGA: we Francji należy podać tutaj numer SIRET (rozszerzenie numeru SIREN o numer oddziału).	S001, 12345 itp.
terminalNumber	Numer kasy fiskalnej. Musi być zgodny z danymi wprowadzonymi w RetailForce Cloud.	0010
cloudApiKey	Klucz API służący do uwierzytelniania komunikacji z Cloud	RFC_4a2abc...
cloudApiSecret	API Secret służący do uwierzytelniania komunikacji z Cloud	ypts7u5OU...

Odpowiedź

Możliwe odpowiedzi:

Kod	Opis	Przykład
200	Client został pomyślnie utworzony i skonfigurowany. Jako obiekt odpowiedzi zwracany jest identyfikator uniqueClientId. System POS musi zapisać identyfikator uniqueClientId i wykorzystywać go w całym dalszym procesie komunikacji (dotyczącym klienta).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	W RetailForce Cloud nie znaleziono organizacji o podanym ID firmy. Rozwiązywanie problemów: Proszę sprawdzić ID firmy w RetailForce Cloud oraz w kasie. Proszę utworzyć firmę (organizację lub przedsiębiorstwo) w RetailForce Cloud	-
406	Ze względu na podany typ (kod firmy) nie jest możliwe jednoznaczne przyporządkowanie (np. w przypadku użycia [6] = CommercialRegisterNumberOffice). Rozwiązywanie problemów: Proszę użyć innego typu ID (np. [0] = VatNumber)	-
409	W usłudze Fiscal Service (Fiscal Middleware) istnieje już klient o danym unikalnym identyfikatorze klienta (uniqueClientId). Rozwiązywanie problemów: Proszę użyć istniejącego klienta	-

Ten artykuł został przetłumaczony automatycznie.