Rozhranie Vat Compliance možno použiť na automatické vytvorenie potrebnej organizačnej štruktúry v RetailForce portal.
Na tento účel musí zdrojový systém obsahovať informácie potrebné na vytvorenie príslušných entít v payloadu dokumentu.
Predpoklady
Aby automatické vytvorenie štruktúry fungovalo, musia byť splnené nasledujúce predpoklady.
- Vytvorená organizácia,
- vytvorená konfigurácia servera,
- vytvorená konfigurácia,
- pridelené licencie,
- konfigurácia priradená k organizácii.
Organizácia
Organizácia už musí existovať v RetailForce Cloud Portal, pretože payload zo zdrojového systému musí pri vytváraní novej štruktúry odkazovať na existujúce „OrganisationId“.
Poznámka: prostredníctvom tohto mechanizmu nie je možné vytvárať spoločnosti.
Konfigurácia servera
Je potrebné vytvoriť konfiguráciu servera, ktorá používa správny „typ pripojenia“.
Konfigurácia
Je potrebné vytvoriť konfiguráciu, ktorá:
- je prepojená s konfiguráciou servera,
- má pridelené licencie,
- je priradená k príslušnej organizácii.
Payload z nadradeného systému
Prostredníctvom payloadu z nadradeného systému je možné vytvoriť nový obchod, ako aj nový terminal. Na tento účel musia dáta obsahovať nasledujúce informácie:
- "OrganisationId",
- Informácie o predajni,
- Informácie o termináli.
OrganisationId
„OrganisationId“ sa vzťahuje na organizáciu vytvorenú v RetailForce Cloud Portal. Nazýva sa tiež „LicenseConsumerId“ a v portáli ju nájdete vo vlastnostiach organizácie.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informácie o predajni
Možné vlastnosti pre vytvorenie novej predajne.
"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"
},Informácie v stĺpci „Type“:
- M ... povinné („mandatory“)
- M* ... povinné v určitých krajinách alebo za určitých podmienok
- R ... odporúčané („odporúčané“)
- O ... voliteľné
| Prvok | Typ |
Popis | |
| Obchod |
|
Informácie o obchode | |
| StoreId | M |
Ak sa má vytvoriť nový obchod, použite „00000000-0000-0000-0000-000000000000“ v prvom aj vo všetkých nasledujúcich payloadoch. | |
OrganisationId |
M |
ID organizácie, nie je potrebné, keďže vlastnosť „OrganisationId“ mimo objektu obchodu už odkazuje na príslušnú organizáciu. Vždy použite: „00000000-0000-0000-0000-000000000000“ |
|
CompanyId |
O |
nie je povinné, možno použiť, ak bola spoločnosť vytvorená pod organizáciou. | |
StoreNumber |
M |
Číslo predajne / pobočky. | |
Caption |
M |
Názov predajne / pobočky. | |
Fiskálny región |
M* |
Vyžaduje sa len v krajinách, kde existujú daňové regióny (napr. Španielsko). | |
Telefón |
O |
Kontaktné údaje predajne: telefónne číslo. | |
| Fax | O |
Kontaktné údaje predajne: Faxové číslo. | |
O |
Kontaktné údaje predajne: e-mailová adresa. | ||
Dátum otvorenia |
M* |
Vyžaduje sa len v krajinách, kde je potrebné uviesť dátum otvorenia predajne (napr. Slovinsko). | |
| ClosingDate | O |
Nemalo by sa uvádzať, keďže ide o konečný dátum ukončenia prevádzky obchodných priestorov (keď bola predajňa natrvalo zatvorená). | |
| Skryté údaje | O |
Nemalo by sa uvádzať, predstavuje dátum, kedy bol obchod skrytý v portáli, pretože všetky príslušné terminály boli vyradené z prevádzky. | |
UpdatedByPrincipalId |
|
Nesmie byť uvedené. | |
Otváracie hodiny v pondelok |
O |
Otváracie hodiny v pondelok. | |
Otváracie hodiny v utorok |
O |
Otváracie hodiny v utorok. | |
Otváracie hodiny v stredu |
O |
Otváracie hodiny v stredu. | |
Otváracie hodiny vo štvrtok |
O |
Otváracie hodiny vo štvrtok. | |
Otváracie hodiny v piatok |
O |
Otváracie hodiny v piatok. | |
Otváracie hodiny v sobotu |
O |
Otváracie hodiny v sobotu. | |
Otváracie hodiny v nedeľu |
O |
Otváracie hodiny v nedeľu. | |
ID konfigurácie klienta |
O |
ID konfigurácie, nie je povinné. | |
ID novej konfigurácie klienta |
O |
ID novej konfigurácie, nie je povinné. | |
NewClientConfigurationValidFrom |
O |
Dátum, od ktorého nadobúda nová konfigurácia platnosť. | |
Ulica |
M |
Názov ulice, na ktorej sa nachádza predajňa/pobočka. | |
StreetNumber |
M |
Číslo ulice predajne / pobočky. | |
PostalCode |
M |
PSČ predajne / pobočky. | |
Mesto |
M |
Mesto, v ktorom sa nachádza predajňa / pobočka. | |
CountryCode |
M |
Kód krajiny (ISO 3166-1 Alpha-3). | |
StoreParameters
V krajinách, kde je to možné, napr. vo Francúzsku, Slovinsku, Chorvátsku a ďalších, je možné nastaviť voliteľné parametre predajne.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informácie v stĺpci „Typ“:
- M ... povinné („mandatory“)
- M* ... povinné v určitých krajinách alebo za určitých podmienok
- R ... odporúčané („odporúčané“)
- O ... voliteľné
| Prvky | Typ |
Popis | |
| StoreParameters |
|
||
| ParameterName | O |
Označenie parametra. | |
| ParameterValue | O |
Hodnota parametra. | |
| ParameterEncrypted | O |
Prepínač, či je parameter šifrovaný. | |
| ParameterOnlyServer | O |
Prepína, či sa parameter používa iba v konfigurácii servera. | |
Informácie o termináli
"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
},Informácie v stĺpci „Typ“:
- M ... povinné („mandatory“)
- M* ... povinné v určitých krajinách alebo za určitých podmienok
- R ... odporúčané („odporúčané“)
- O ... voliteľné
| Prvky | Typ |
Popis | |
| Terminal |
|
Informácie o termináli | |
terminalId |
M |
Ak sa má vytvoriť nový terminal, použite „00000000-0000-0000-0000-000000000000“ v prvom aj vo všetkých nasledujúcich payloadoch. | |
StoreId |
M |
Vždy použite „00000000-0000-0000-0000-000000000000“. | |
terminalNumber |
M |
Číslo pokladnice v predajni. | |
FiscalCountry |
O |
nie je povinné. | |
Caption |
R |
Označenie pokladnice. | |
Typ platformy |
M* |
Povinné len v určitých krajinách (napr. Nemecko). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Možné len pre testovacie terminály („IsTest“: true). | |
ArchiveDate |
O |
Neuvádzajte, označuje, kedy bol terminal vyradený z prevádzky a archivovaný. | |
ClientConfigurationId |
O |
ID konfigurácie, nie je povinné. | |
NewClientConfigurationId |
O |
ID novej konfigurácie, nie je povinné. | |
NewClientConfigurationValidFrom |
O |
Dátum, od ktorého nadobúda nová konfigurácia platnosť. | |
GlobalShortId |
|
Globálne skrátené ID terminálu, nemožno nastaviť, prideľuje ho systém RF. | |
PurchaseDate |
M* |
Povinné len v určitých krajinách (napr. Nemecko) | |
Typ terminálu |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
UpdatedByPrincipalId |
|
Nesmie byť uvedené. | |
cashRegisterId |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
CashRegisterBrand |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Názov modelu pokladnice |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Sériové číslo pokladne |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Značka softvéru pokladne |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Verzia softvéru pokladne |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Spoločnosť poskytujúca softvér pre pokladnice |
M* |
Povinné len v niektorých krajinách (napr. Nemecko) | |
Dátum uvedenia do prevádzky |
|
Nesmie byť nastavené! | |
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.