Vmesnik za skladnost z Vat se lahko uporabi za samodejno ustvarjanje potrebne organizacijske strukture v RetailForce portalu.
Za to mora izvorni sistem v payload dokumenta vključiti podatke, potrebne za ustvarjanje ustreznih entitet.
Predpogoji
Da bi samodejno ustvarjanje strukture delovalo, morajo biti izpolnjeni naslednji pogoji.
- Ustanovljena organizacija,
- ustvarjena konfiguracija strežnika,
- ustvarjena konfiguracija,
- dodeljene licence,
- konfiguracija mora biti dodeljena organizaciji.
Organizacija
Organizacija mora že obstajati v RetailForce Cloud Portalu, saj mora podatkovni paket iz nadrejenega sistema pri ustvarjanju nove strukture sklicevati na obstoječo »OrganisationId«.
Opomba: prek tega mehanizma ni mogoče ustvarjati podjetij.
Konfiguracija strežnika
Ustvariti je treba konfiguracijo strežnika, ki uporablja pravilni »tip povezave«.
Konfiguracija
Ustvariti je treba konfiguracijo, ki:
- je povezana s konfiguracijo strežnika,
- ima dodeljene licence,
- je dodeljena ustrezni organizaciji.
Payload iz nadrejenega sistema
Prek payloada iz nadrejenega sistema je mogoče ustvariti novo trgovino in nov terminal. Zato morajo podatki vsebovati naslednje informacije:
- "OrganisationId",
- podatke o trgovini,
- podatke o terminalu.
OrganisationId
»OrganisationId« se nanaša na organizacijo, ustvarjeno v RetailForce Cloud Portalu. Imenuje se tudi »LicenseConsumerId« in ga najdete v portalu v lastnostih organizacije.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Podatki o trgovini
Možne lastnosti za ustvarjanje nove trgovine.
"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"
},Podatki v stolpcu »Type«:
- M ... obvezno („mandatory“)
- M* ... obvezno v nekaterih državah ali pod določenimi pogoji
- R ... priporočeno („priporočeno“)
- O ... neobvezno
| Element | Vrsta |
Opis | |
| Trgovina |
|
Podatki o trgovini | |
| StoreId | M |
Če je treba ustvariti novo trgovino, uporabite »00000000-0000-0000-0000-000000000000« v prvem IN v vseh naslednjih payloadih. | |
OrganisationId |
M |
ID organizacije, ni nujno, saj se lastnost »OrganisationId« zunaj objekta trgovine že nanaša na zadevno organizacijo. Vedno uporabite: »00000000-0000-0000-0000-000000000000« |
|
CompanyId |
O |
ni obvezno, se lahko uporabi, če je bilo podjetje ustvarjeno pod organizacijo. | |
StoreNumber |
M |
Številka trgovine/podružnice. | |
Caption |
M |
Oznaka trgovine / podružnice. | |
Fiskalna regija |
M* |
Obvezno le v državah, kjer obstajajo davčne regije (npr. Španija). | |
Telefon |
O |
Kontaktni podatki trgovine: telefonska številka. | |
| Faks | O |
Kontaktni podatki trgovine: številka faksa. | |
| E-pošta | O |
Kontaktni podatki trgovine: e-poštni naslov. | |
Datum odprtja |
M* |
Obvezno le v državah, kjer je treba navesti datum odprtja trgovine (npr. v Sloveniji). | |
| ClosingDate | O |
Ne sme biti naveden, saj predstavlja končni datum zaprtja poslovnih prostorov (ko je bila trgovina za vedno zaprta). | |
| Skriti podatki | O |
Ne sme biti naveden, saj predstavlja datum, ko je bila trgovina skrita v portalu, ker so bili vsi pripadajoči terminali izključeni iz uporabe. | |
UpdatedByPrincipalId |
|
Ne sme biti navedeno. | |
DelovniČasPonedeljek |
O |
Delovni čas v ponedeljek. | |
DelovniČasTorek |
O |
Delovni čas v torek. | |
Delovni čas v sredo |
O |
Odpiralni čas v sredo. | |
Delovni čas v četrtek |
O |
Delovni čas v četrtek. | |
Delovni čas v petek |
O |
Delovni čas v petek. | |
Delovni čas v soboto |
O |
Odpiralni čas v soboto. | |
Delovni čas v nedeljo |
O |
Delovni čas v nedeljo. | |
ID konfiguracije stranke |
O |
ID konfiguracije, ni obvezno. | |
ID nove konfiguracije stranke |
O |
ID nove konfiguracije, ni obvezno. | |
NewClientConfigurationValidFrom |
O |
Datum, od katerega naprej velja nova konfiguracija. | |
Ulica |
M |
Ime ulice, na kateri se nahaja trgovina/podružnica. | |
StreetNumber |
M |
Številka ulice trgovine/podružnice. | |
PostalCode |
M |
Poštna številka trgovine/podružnice. | |
Mesto |
M |
Mesto trgovine/podružnice. | |
CountryCode |
M |
Koda države (ISO 3166-1 Alpha-3). | |
Parametri trgovine
V državah, kjer je to mogoče, npr. v Franciji, Sloveniji, na Hrvaškem in drugod, je mogoče nastaviti neobvezne parametre trgovine.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informacije v stolpcu »Vrsta«:
- M … obvezno („mandatory“)
- M* ... obvezno v nekaterih državah ali pod določenimi pogoji
- R ... priporočeno („priporočeno“)
- O ... neobvezno
| Elementi | Vrsta |
Opis | |
| Parametri shranjevanja |
|
||
| ParameterName | O |
Oznaka parametra. | |
| ParameterValue | O |
Vrednost parametra. | |
| ŠifriranParameter | O |
Preklopnik, ki določa, ali je parameter šifriran. | |
| ParameterOnlyServer | O |
Preklopite, če se parameter uporablja samo v konfiguraciji strežnika. | |
Podatki o terminalu
"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
},Podatki v stolpcu »Tip«:
- M ... obvezno („mandatory“)
- M* ... obvezno v nekaterih državah ali pod določenimi pogoji
- R ... priporočeno („priporočeno“)
- O ... neobvezno
| Elementi | Vrsta |
Opis | |
| Terminal |
|
Podatki o terminalu | |
terminalId |
M |
Če je treba ustvariti nov terminal, uporabite »00000000-0000-0000-0000-000000000000« v prvem IN v vseh naslednjih payloadih. | |
StoreId |
M |
Vedno uporabite »00000000-0000-0000-0000-000000000000«. | |
terminalNumber |
M |
Številka blagajne v trgovini. | |
FiscalCountry |
O |
ni obvezno. | |
Caption |
R |
Oznaka blagajne. | |
PlatformType |
M* |
Obvezno le v nekaterih državah (npr. Nemčija). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Možno le za testne terminale („IsTest“: true). | |
Datum arhiviranja |
O |
Ne navajajte, označuje, kdaj je bil terminal izključen iz uporabe in arhiviran. | |
ClientConfigurationId |
O |
ID konfiguracije, ni obvezno. | |
NewClientConfigurationId |
O |
ID nove konfiguracije, ni obvezno. | |
NewClientConfigurationValidFrom |
O |
Datum, od katerega naprej velja nova konfiguracija. | |
GlobalShortId |
|
Globalna kratka ID številka termina, ni mogoče nastaviti, jo dodeli sistem RF. | |
Datum nakupa |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
TerminalType |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
UpdatedByPrincipalId |
|
Ne sme biti navedeno. | |
cashRegisterId |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
CashRegisterBrand |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
Ime modela blagajne |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
Serijska številka blagajne |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
Znamka programske opreme za blagajno |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
Različica programske opreme za blagajno |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
Podjetje, ki je razvilo programsko opremo za blagajno |
M* |
Obvezno le v nekaterih državah (npr. Nemčija) | |
DatumZagon |
|
Ne sme biti nastavljeno! | |
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.