A Vat Compliance interfész segítségével automatikusan létrehozható a szükséges szervezeti struktúra a RetailForce portalon.
Ehhez a forrásrendszernek a dokumentum payload-ja között tartalmaznia kell a vonatkozó entitások létrehozásához szükséges információkat.
Előfeltételek
Ahhoz, hogy a struktúra automatikus létrehozása működjön, a következő előfeltételeknek kell teljesülniük.
- Létrehozott szervezet,
- a szerverkonfiguráció létrehozva,
- a konfiguráció létrehozva,
- a licencet hozzárendelték,
- a konfigurációt hozzárendelték a szervezethez.
Szervezet
A szervezetnek már léteznie kell a RetailForce Cloud Portalon, mivel az upstream rendszerből érkező payloadnek egy meglévő „OrganisationId”-re kell hivatkoznia új struktúra létrehozásakor.
Megjegyzés: ezen a mechanizmuson keresztül nem lehet vállalatokat létrehozni.
Szerverkonfiguráció
Létre kell hozni egy olyan szerverkonfigurációt, amely a megfelelő „Csatlakozási típust” használja.
Konfiguráció
Létre kell hozni egy konfigurációt, amely:
- összekapcsolódik a szerverkonfigurációval,
- hozzárendelt licencet tartalmaz,
- a megfelelő szervezethez van rendelve.
Payload a felülről érkező rendszerből
Az upstream rendszerből érkező payload segítségével új áruház, valamint új terminal hozható létre. Ehhez a payloadnak a következő információkat kell tartalmaznia:
- "OrganisationId",
- Üzletadatok,
- Terminaladatok.
OrganisationId
Az „OrganisationId” a RetailForce Cloud Portalon létrehozott szervezetre utal. Ezt „LicenseConsumerId”-nek is nevezik, és a Portálon a szervezet tulajdonságai között található.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Üzletadatok
Egy új üzlet létrehozásához szükséges tulajdonságok.
"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"
},A „Type” oszlopban szereplő információk:
- M ... kötelező („mandatory”)
- M* ... bizonyos országokban vagy bizonyos feltételek mellett kötelező
- R ... ajánlott („ajánlott”)
- O ... opcionális
| Elem | Típus |
Leírás | |
| Bolt |
|
Tárolási információk | |
| StoreId | M |
Ha új üzletet kell létrehozni, az első ÉS az összes következő payloadban használja a „00000000-0000-0000-0000-000000000000” értéket. | |
OrganisationId |
M |
A szervezet ID-ja; ez nem szükséges, mivel a store-objektumon kívüli „OrganisationId” tulajdonság már utal a megfelelő szervezetre. Mindig használja a következőt: „00000000-0000-0000-0000-000000000000” |
|
CompanyId |
O |
nem kötelező, akkor használható, ha a szervezet alá vállalatot hoztak létre. | |
StoreNumber |
M |
Az üzlet/fiók száma. | |
Caption |
M |
Az áruház / fiók megnevezése. | |
FiscalRegion |
M* |
Csak olyan országokban kötelező, ahol adóügyi régiók léteznek (pl. Spanyolország). | |
Telefon |
O |
Az üzlet elérhetőségei: Telefonszám. | |
| Fax | O |
Az üzlet elérhetőségei: Faxszám. | |
O |
Az üzlet elérhetőségei: e-mail cím. | ||
Nyitás dátuma |
M* |
Csak azokban az országokban kötelező, ahol meg kell adni az üzlet megnyitásának dátumát (pl. Szlovénia). | |
| ClosingDate | O |
Nem szabad megadni, mivel ez az üzlethelyiség végleges bezárásának dátumát jelenti (amikor az üzletet végleg bezárták). | |
| HiddenDaten | O |
Nem szabad megadni, mivel az üzlet portálon való elrejtésének dátumát jelenti, ami azért történt, mert az összes kapcsolódó terminált leszerelték. | |
UpdatedByPrincipalId |
|
Nem szabad megadni. | |
Nyitvatartási idő hétfőn |
O |
Nyitvatartási idő hétfőn. | |
Nyitvatartás kedd |
O |
Nyitvatartás kedd. | |
Nyitvatartás szerdán |
O |
Nyitvatartás szerdán. | |
Nyitvatartás csütörtökön |
O |
Nyitvatartás csütörtökön. | |
Nyitvatartás pénteken |
O |
Nyitvatartás pénteken. | |
Nyitvatartás szombaton |
O |
Nyitvatartás szombaton. | |
Nyitvatartás vasárnap |
O |
Nyitvatartás vasárnap. | |
Ügyfélkonfigurációs azonosító |
O |
A konfiguráció ID-ja, nem kötelező. | |
Új ügyfélkonfigurációs azonosító |
O |
Egy új konfiguráció ID-ja, nem kötelező. | |
NewClientConfigurationValidFrom |
O |
Az a dátum, amelytől kezdve az új konfiguráció érvényessé válik. | |
Street |
M |
Az üzlet/fiók utcaneve. | |
StreetNumber |
M |
Az üzlet / fiók házszáma. | |
PostalCode |
M |
Az üzlet/fiók irányítószáma. | |
Város |
M |
Az üzlet / fiók városa. | |
CountryCode |
M |
Országkód (ISO 3166-1 Alpha-3). | |
StoreParameters
Opcionális áruházi paraméterek állíthatók be azokban az országokban, ahol ez lehetséges, pl. Franciaországban, Szlovéniában, Horvátországban és más országokban.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]A „Típus” oszlopban szereplő információk:
- M ... kötelező („mandatory”)
- M* ... bizonyos országokban vagy bizonyos feltételek mellett kötelező
- R ... ajánlott („ajánlott”)
- O ... opcionális
| Elemek | Típus |
Leírás | |
| StoreParameters |
|
||
| ParameterName | O |
A paraméter megnevezése. | |
| parameterValue | O |
A paraméter értéke. | |
| ParameterEncrypted | O |
Kapcsoló, amely meghatározza, hogy a paraméter titkosítva van-e. | |
| ParameterOnlyServer | O |
Kapcsolja be, ha a paramétert csak a szerverkonfigurációban használják. | |
Terminalinformációk
"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
},A „Típus” oszlopban szereplő információk:
- M ... kötelező („mandatory”)
- M* ... bizonyos országokban vagy bizonyos feltételek mellett kötelező
- R ... ajánlott („ajánlott”)
- O ... opcionális
| Elemek | Típus |
Leírás | |
| Terminal |
|
Terminal információk | |
TerminalId |
M |
Ha új terminált kell létrehozni, az első ÉS az összes következő payloadban használja a „00000000-0000-0000-0000-000000000000” értéket. | |
StoreId |
M |
Mindig használja a „00000000-0000-0000-0000-000000000000” értéket. | |
terminalNumber |
M |
Az üzleten belüli pénztárgép száma. | |
fiscalCountry |
O |
nem kötelező. | |
Caption |
R |
A pénztárgép megnevezése. | |
PlatformType |
M* |
Csak bizonyos országokban kötelező (pl. Németország). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Csak tesztterminálok esetében lehetséges („IsTest”: true). | |
ArchiveDate |
O |
Ne adja meg, jelzi, hogy a terminált mikor vonták ki a forgalomból és archiválták. | |
ClientConfigurationId |
O |
A konfiguráció ID-ja, nem kötelező. | |
NewClientConfigurationId |
O |
Az új konfiguráció ID-ja, nem kötelező. | |
NewClientConfigurationValidFrom |
O |
Az a dátum, amelytől kezdve az új konfiguráció érvényessé válik. | |
GlobalShortId |
|
A terminal globális rövid ID-je, nem állítható be, az RF-rendszer rendeli hozzá. | |
PurchaseDate |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
TerminalType |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
UpdatedByPrincipalId |
|
Nem szabad megadni. | |
CashRegisterId |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
CashRegisterBrand |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Pénztárgép modellneve |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Pénztárgép sorozatszáma |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Pénztárgép-szoftver márkája |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Pénztárgép-szoftver verziója |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Pénztárgép-szoftver gyártója |
M* |
Csak bizonyos országokban kötelező (pl. Németország) | |
Üzembe helyezés dátuma |
|
Nem szabad beállítani! | |
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.