Přeskočit do hlavního obsahu

POST /api/v1/management/clients/recovery/restoreByCloud

Armir Alidema
  • Aktualizováno

Tento koncový bod umožňuje obnovení klienta v Middleware RetailForce s daty (včetně konfiguračních informací) z RetailForce Cloud.

Obnovení klienta může být nutné v případě výměny hardwaru pokladny nebo v případě hardwarových závad.

Funkce POST /api/v1/management/clients/recovery/restoreByCloud/Id je v podstatě identická s funkcí PUT /api/v1/management/clients/byCloud, avšak ta druhá může být provedena pouze jednou během počátečního uvedení klienta do provozu.

Výsledek

Úspěšné volání koncového bodu (200):

  1. Znovu stáhne konfigurační objekt pro příslušného klienta z Cloud systému a klienta podle něj nakonfiguruje.
  2. Obnoví klienta, který již byl uveden do provozu v middlewaru, a přiřadí mu odpovídající uniqueClientId terminálu z RetailForce Cloud.

Použití

Tento koncový bod se používá v případě, že je třeba obnovit klienta, který již byl jednou vytvořen a jehož ClientId je známé (například v případě změny hardwaru).

Předpoklady

  • Klient musí být již jednou vytvořen a jeho ClientId by mělo být známo.
  • V RetailForce Cloud byla vytvořena organizační struktura a konfigurační objekt a byly odpovídajícím způsobem přiřazeny.
  • Nainstalován je Fiscal Middleware.
  • Funkci RestoreByCloud lze použít pouze v případě, že:
    • je použita odpovídající licence (licenční balíček, který zahrnuje „Cloud Archive Access“),
    • je v konfiguraci (Cloud) zaškrtnuto políčko „Cloud Archive“,
    • klient již přenesl data do cloudového archivu (PŘED obnovením).
    • V Německu musí být v klientovi zaznamenáno a do cloudového archivu přeneseno alespoň jedno denní uzavření (v jakémkoli okamžiku v minulosti).

Poznámka: Funkce RestoreByCloud bude fungovat správně pouze v případě, že

  • byl middleware nově nainstalován na systému PŘED spuštěním funkce RestoreByCloud,
  • nebo (bez přeinstalace) byla před spuštěním funkce RestoreByCloud restartována fiskalizační služba (služba RetailForce).

Pole formuláře

Musí být předány následující informace:

Jméno Popis Příklady
Typ

Typ identifikace společnosti. Typ musí být také zadán a musí existovat v RetailForce Cloud.

K dispozici jsou následující typy:

[0] = DIČ,
[1] = daňové číslo,
[2] = číslo GLN,
[3] = identifikační číslo podniku,
[4] = statistická klasifikace,
[5] = číslo v obchodním rejstříku,
[6] = úřad vedoucí obchodní rejstřík,
[7] = číslo v živnostenském rejstříku

Viz také: Identifikace společnosti 

Doporučujeme používat typ [0] = DIČ jako primární identifikátor ve všech zemích (EU), i když se v dané zemi nepoužívá jako povinný identifikátor společnosti.

 [0] = DIČ
Identifikace Samotný identifikátor společnosti. Musí odpovídat informacím zadaným v RetailForce Cloud. ATU57780814
storeNumber

Číslo prodejny, ve které se pokladna nachází. Musí odpovídat údajům zadaným v RetailForce Cloud.

POZNÁMKA: ve Francii by zde mělo být uvedeno číslo SIRET (rozšíření čísla SIREN o číslo prodejny).
  • S001,
  • 12345
  • atd.
terminalNumber Číslo pokladny. Musí se shodovat s údaji zadanými v RetailForce Cloud. 0010
cloudApiKey API klíč pro ověření komunikace s Cloudem RFC_4a2abc...
cloudApiSecret Tajný klíč API pro ověření komunikace s Cloudem ypts7u5OU...

Odpověď

Možné odpovědi:

Kód Popis Příklad
200 Klient byl úspěšně obnoven a nakonfigurován. Objekt odpovědi vrací uniqueClientId obnoveného klienta. uniqueClientId musí být uložen v pokladním systému a použit pro celý další komunikační proces (týkající se klienta). b7cf6d59-cec4-4cc2-a647-01XXXX
406

Typ zadaného identifikátoru společnosti není jedinečný.

Zpracování chyby:

Použijte jeden z následujících identifikátorů společnosti:

[0] = VatNumber,
[1] = TaxNumber,
[2] = GlnNumber,
[3] = BusinessIdentificationNumber

 -

 

 

Tento článek byl přeložen automaticky.

Související články

Komentáře

0 komentářů

Prosím přihlaste se, abyste mohli napsat komentář.

Používá technologie Zendesk