Rozhraní pro dodržování předpisů o Vat lze použít k automatickému vytvoření potřebné organizační struktury v portálu RetailForce.
K tomu je nutné, aby zdrojový systém zahrnoval v datové části dokumentu informace potřebné k vytvoření příslušných entit.
Předpoklady
Aby automatické vytváření struktury fungovalo, musí být splněny následující předpoklady.
- Musí být vytvořena organizace a
- vytvořená konfigurace serveru,
- vytvořená konfigurace,
- přiřazené licence,
- konfigurace přiřazena k organizaci.
Organizace
Organizace již musí existovat v portálu RetailForce Cloud, protože při vytváření nové struktury musí data z nadřazeného systému odkazovat na existující „OrganisationId“.
Poznámka: prostřednictvím tohoto mechanismu není možné vytvářet společnosti.
Konfigurace serveru
Je nutné vytvořit konfiguraci serveru, která používá správný „typ připojení“.
Konfigurace
Je nutné vytvořit konfiguraci, která:
- je propojena s konfigurací serveru,
- má přiřazené licence,
- je přiřazena k příslušné organizaci.
Datová náplň z nadřazeného systému
Prostřednictvím dat z nadřazeného systému lze vytvořit nový obchod i nový terminál. Data proto musí obsahovat následující informace:
- "OrganisationId",
- informace o prodejně,
- informace o terminálu.
OrganisationId
„OrganisationId“ odkazuje na organizaci vytvořenou v portálu RetailForce Cloud. Nazývá se také „LicenseConsumerId“ a najdete jej v portálu ve vlastnostech organizace.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informace o prodejně
Možné vlastnosti pro vytvoření nové prodejny.
"Store": {
"StoreId": "00000000-0000-0000-0000-000000000000"
"OrganisationId": "00000000-0000-0000-0000-000000000000",
"CompanyId": null,
"StoreNumber": "003",
"Caption": "Teststore 003",
"FiscalRegion": null,
"Telephone": null,
"Fax": null,
"EMail": null,
"OpeningDate": null,
"ClosingDate": null,
"HiddenDate": null,
"UpdatedByPrincipalId": null,
"OpeningHoursMonday": null,
"OpeningHoursTuesday": null,
"OpeningHoursWednesday": null,
"OpeningHoursThursday": null,
"OpeningHoursFriday": null,
"OpeningHoursSaturday": null,
"OpeningHoursSunday": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"Street": "Av. Gustave Eiffel",
"StreetNumber": "-",
"PostalCode": "75007",
"City": "Paris",
"CountryCode": "FRA"
},Informace ve sloupci „Type“:
- M ... povinné („mandatory“)
- M* ... povinné v určitých zemích nebo za určitých podmínek
- R ... doporučeno („doporučeno“)
- O ... volitelné
| Prvek | Typ |
Popis | |
| Obchod |
|
Informace o obchodě | |
| StoreId | M |
Pokud má být vytvořena nová prodejna, použijte „00000000-0000-0000-0000-000000000000“ v prvním i ve všech následujících datových blocích. | |
OrganisationId |
M |
ID organizace, není nutné, protože vlastnost „OrganisationId“ mimo objekt obchodu již odkazuje na příslušnou organizaci. Vždy použijte: „00000000-0000-0000-0000-000000000000“ |
|
CompanyId |
O |
není povinné, lze použít, pokud byla společnost vytvořena pod danou organizací. | |
Číslo prodejny |
M |
Číslo prodejny / pobočky. | |
Popisek |
M |
Název prodejny / pobočky. | |
FiscalRegion |
M* |
Vyžadováno pouze v zemích, kde existují daňové regiony (např. Španělsko). | |
Telefon |
O |
Kontaktní údaje obchodu: Telefonní číslo. | |
| Fax | O |
Kontaktní údaje obchodu: Faxové číslo. | |
O |
Kontaktní údaje obchodu: e-mailová adresa. | ||
Datum otevření |
M* |
Vyžadováno pouze v zemích, kde je nutné uvést datum otevření obchodu (např. Slovinsko). | |
| ClosingDate | O |
Nemělo by se uvádět, jelikož představuje konečné datum uzavření provozovny (kdy byla prodejna definitivně uzavřena). | |
| Skryté údaje | O |
Nemělo by být zadáno, představuje datum, kdy byl obchod na portálu skryt, protože všechny podkladové terminály byly vyřazeny z provozu. | |
UpdatedByPrincipalId |
|
Nesmí být zadáno. | |
OpeningHoursMonday |
O |
Otevírací doba v pondělí. | |
Otevírací doba v úterý |
O |
Otevírací doba v úterý. | |
Otevírací doba ve středu |
O |
Otevírací doba ve středu. | |
Otevírací doba ve čtvrtek |
O |
Otevírací doba ve čtvrtek. | |
Otevírací doba v pátek |
O |
Otevírací doba v pátek. | |
Otevírací doba v sobotu |
O |
Otevírací doba v sobotu. | |
Otevírací doba v neděli |
O |
Otevírací doba v neděli. | |
ID konfigurace klienta |
O |
ID konfigurace, není povinné. | |
NewClientConfigurationId |
O |
ID nové konfigurace, není povinné. | |
NewClientConfigurationValidFrom |
O |
Datum, od kterého je nová konfigurace platná. | |
Ulice |
M |
Název ulice, na které se nachází obchod/pobočka. | |
Číslo ulice |
M |
Číslo ulice obchodu / pobočky. | |
PostalCode |
M |
PSČ prodejny / pobočky. | |
Město |
M |
Město, ve kterém se nachází obchod / pobočka. | |
CountryCode |
M |
Kód země (ISO 3166-1 Alpha-3). | |
StoreParameters
V zemích, kde je to možné, lze nastavit volitelné parametry prodejny, např. ve Francii, Slovinsku, Chorvatsku a dalších.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informace ve sloupci „Typ“:
- M … povinné („mandatory“)
- M* ... povinné v určitých zemích nebo za určitých podmínek
- R ... doporučeno („doporučeno“)
- O ... volitelné
| Prvky | Typ |
Popis | |
| StoreParameters |
|
||
| Název_parametru | O |
Označení parametru. | |
| Hodnota_parametru | O |
Hodnota parametru. | |
| ParameterEncrypted | O |
Přepínač určující, zda je parametr šifrován. | |
| ParameterOnlyServer | O |
Přepínač určuje, zda je parametr použit pouze v konfiguraci serveru. | |
Informace o terminálu
"Terminal": {
"TerminalId": "00000000-0000-0000-0000-000000000000",
"StoreId": "00000000-0000-0000-0000-000000000000",
"TerminalNumber": "009",
"FiscalCountry": null,
"Caption": "Testterminal 003/009",
"PlatformType": null,
"IsTest": true,
"IsDisabledGetConfigurationLimit": null,
"ArchiveDate": null,
"ClientConfigurationId": null,
"NewClientConfigurationId": null,
"NewClientConfigurationValidFrom": null,
"GlobalShortId": null,
"PurchaseDate": null,
"TerminalType": null,
"UpdatedByPrincipalId": null,
"CashRegisterId": null,
"CashRegisterBrand": null,
"CashRegisterModelname": null,
"CashRegisterSerialNumber": null,
"CashRegisterSoftwareBrand": null,
"CashRegisterSoftwareVersion": null,
"CashRegisterSoftwareCompany": null,
"CommissioningDate": null
},Informace ve sloupci „Typ“:
- M … povinné („mandatory“)
- M* ... povinné v určitých zemích nebo za určitých podmínek
- R ... doporučeno („doporučeno“)
- O ... volitelné
| Prvky | Typ |
Popis | |
| Terminál |
|
Informace o terminálu | |
TerminalId |
M |
Pokud má být vytvořen nový terminál, použijte „00000000-0000-0000-0000-000000000000“ v prvním i ve všech následujících datových blocích. | |
StoreId |
M |
Vždy použijte „00000000-0000-0000-0000-000000000000“. | |
Číslo terminálu |
M |
Číslo pokladny v dané prodejně. | |
Fiskální země |
O |
není povinné. | |
Popisek |
R |
Označení pokladny. | |
Typ platformy |
M* |
Povinné pouze v některých zemích (např. v Německu). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Možné pouze pro testovací terminály („IsTest“: true). | |
ArchiveDate |
O |
Nezadává se, udává, kdy byl terminál vyřazen z provozu a archivován. | |
ClientConfigurationId |
O |
ID konfigurace, není povinné. | |
NewClientConfigurationId |
O |
ID nové konfigurace, není povinné. | |
NewClientConfigurationValidFrom |
O |
Datum, od kterého je nová konfigurace platná. | |
GlobalShortId |
|
Globální krátké ID terminálu, nelze nastavit, je přiřazeno systémem RF. | |
PurchaseDate |
M* |
Povinné pouze v některých zemích (např. Německo) | |
Typ terminálu |
M* |
Povinné pouze v některých zemích (např. Německo) | |
UpdatedByPrincipalId |
|
Nesmí být zadáno. | |
CashRegisterId |
M* |
Povinné pouze v některých zemích (např. v Německu) | |
CashRegisterBrand |
M* |
Povinné pouze v některých zemích (např. Německo) | |
Název modelu pokladny |
M* |
Povinné pouze v některých zemích (např. v Německu) | |
Sériové číslo pokladny |
M* |
Povinné pouze v některých zemích (např. v Německu) | |
Značka softwaru pokladny |
M* |
Povinné pouze v některých zemích (např. Německo) | |
Verze pokladního softwaru |
M* |
Povinné pouze v některých zemích (např. Německo) | |
Společnost poskytující software pro pokladny |
M* |
Povinné pouze v některých zemích (např. Německo) | |
Datum uvedení do provozu |
|
Nesmí být zadáno! | |
Tento článek byl přeložen automaticky.
Komentáře
0 komentářů
Prosím přihlaste se, abyste mohli napsat komentář.