Interfața de conformitate Vat poate fi utilizată pentru a crea automat structura organizațională necesară în RetailForce portal.
Pentru aceasta, sistemul sursă trebuie să includă informațiile necesare pentru crearea entităților relevante în payload-ul documentului.
Condiții prealabile
Pentru ca crearea automată a structurii să funcționeze, trebuie îndeplinite următoarele condiții prealabile.
- Organizația a fost creată,
- a fost creată configurația serverului,
- configurare creată,
- licențele au fost atribuite,
- configurarea trebuie să fie atribuită organizației.
Organizație
Organizația trebuie să existe deja în RetailForce Cloud Portal, deoarece payload-ul transmis de la sistemul din amonte trebuie să facă referire la un „OrganisationId” existent atunci când se creează o nouă structură.
Notă: nu este posibilă crearea de companii prin acest mecanism.
Configurația serverului
Trebuie creată o configurație de server care utilizează „tipul de conexiune” corect.
Configurare
Trebuie creată o configurație care:
- este legată de configurația serverului,
- are licențe alocate,
- este atribuită organizației respective.
Payload din sistemul din amonte
Prin intermediul payload-ului de la sistemul din amonte se poate crea atât un nou magazin, cât și un nou terminal. Pentru aceasta, payload-ul trebuie să conțină următoarele informații:
- "OrganisationId",
- Informații despre magazin,
- Informații despre terminal.
OrganisationId
„OrganisationId” se referă la organizația creată în RetailForce Cloud Portal. Este denumit și „LicenseConsumerId” și poate fi găsit în portal, în proprietățile organizației.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informații despre magazin
Proprietăți posibile pentru crearea unui nou magazin.
"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"
},Informații din coloana „Type”:
- M ... obligatoriu („mandatory”)
- M* ... obligatoriu în anumite țări sau în anumite condiții
- R ... recomandat („recomandat”)
- O ... opțional
| Element | Tip |
Descriere | |
| Magazin |
|
Informații despre magazin | |
| StoreId | M |
Dacă trebuie creat un magazin nou, utilizați „00000000-0000-0000-0000-000000000000” în primul ȘI în toate payload-urile următoare. | |
OrganisationId |
M |
ID-ul organizației; nu este necesar, deoarece proprietatea „OrganisationId” din afara obiectului magazin se referă deja la organizația respectivă. Utilizați întotdeauna: „00000000-0000-0000-0000-000000000000” |
|
CompanyId |
O |
nu este obligatoriu, poate fi utilizat dacă o companie a fost creată sub organizație. | |
StoreNumber |
M |
Numărul magazinului / sucursalei. | |
Caption |
M |
Denumirea magazinului / sucursalei. | |
Regiune fiscală |
M* |
Obligatoriu numai în țările în care există regiuni fiscale (de exemplu, Spania). | |
Telefon |
O |
Informații de contact ale magazinului: Număr de telefon. | |
| Fax | O |
Date de contact ale magazinului: Număr de fax. | |
O |
Informații de contact ale magazinului: adresa de e-mail. | ||
Data deschiderii |
M* |
Obligatoriu numai în țările în care trebuie specificată data deschiderii magazinului (de exemplu, Slovenia). | |
| ClosingDate | O |
Nu trebuie specificată, deoarece reprezintă data finală de închidere a unui spațiu comercial (momentul în care magazinul a fost închis definitiv). | |
| Date ascunse | O |
Nu trebuie specificată, reprezintă data la care magazinul a fost ascuns în Portal deoarece toate terminalele aferente au fost scoase din funcțiune. | |
UpdatedByPrincipalId |
|
Nu trebuie specificat. | |
ProgramDeLucruLuni |
O |
Programul de lucru de luni. | |
Program de lucru marți |
O |
Program marți. | |
Program miercuri |
O |
Programul de lucru miercuri. | |
Program de lucru joi |
O |
Programul de joi. | |
Program de lucru vineri |
O |
Program de lucru vineri. | |
Programul de sâmbătă |
O |
Programul de lucru sâmbătă. | |
Program duminică |
O |
Programul de lucru duminică. | |
ID-ul configurației clientului |
O |
ID-ul configurației, nu este obligatoriu. | |
NewClientConfigurationId |
O |
ID-ul unei noi configurații, opțional. | |
NewClientConfigurationValidFrom |
O |
Data de la care o nouă configurație devine valabilă. | |
Street |
M |
Numele străzii pe care se află magazinul/sucursala. | |
StreetNumber |
M |
Numărul străzii magazinului / sucursalei. | |
PostalCode |
M |
Codul poștal al magazinului / sucursalei. | |
Oraș |
M |
Orașul în care se află magazinul / sucursala. | |
CountryCode |
M |
Codul țării (ISO 3166-1 Alpha-3). | |
ParametriMagazin
Se pot seta parametri opționali ai magazinului, în țările în care acest lucru este posibil, de exemplu Franța, Slovenia, Croația și altele.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informații din coloana „Tip”:
- M ... obligatoriu („mandatory”)
- M* ... obligatoriu în anumite țări sau în anumite condiții
- R ... recomandat („recomandat”)
- O ... opțional
| Elemente | Tip |
Descriere | |
| StoreParameters |
|
||
| ParameterName | O |
Denumirea parametrului. | |
| ParameterValue | O |
Valoarea parametrului. | |
| ParameterEncrypted | O |
Comutator care indică dacă parametrul este criptat. | |
| ParameterOnlyServer | O |
Comutator care indică dacă parametrul este utilizat numai în configurația serverului. | |
Informații despre terminal
"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
},Informații din coloana „Tip”:
- M ... obligatoriu („mandatory”)
- M* ... obligatoriu în anumite țări sau în anumite condiții
- R ... recomandat („recomandat”)
- O ... opțional
| Elemente | Tip |
Descriere | |
| Terminal |
|
Informații despre terminal | |
terminalId |
M |
Dacă trebuie creat un terminal nou, utilizați „00000000-0000-0000-0000-000000000000” în primul ȘI în toate payload-urile următoare. | |
StoreId |
M |
Utilizați întotdeauna „00000000-0000-0000-0000-000000000000”. | |
terminalNumber |
M |
Numărul casei de marcat din cadrul magazinului. | |
FiscalCountry |
O |
nu este obligatoriu. | |
Caption |
R |
Denumirea casei de marcat. | |
Tipul platformei |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Posibil numai pentru terminalele de testare („IsTest”: true). | |
ArchiveDate |
O |
Nu se specifică; indică momentul în care terminalul a fost scos din funcțiune și arhivat. | |
ClientConfigurationId |
O |
ID-ul configurației, nu este obligatoriu. | |
NewClientConfigurationId |
O |
ID-ul unei noi configurații, opțional. | |
NewClientConfigurationValidFrom |
O |
Data de la care o nouă configurație devine valabilă. | |
GlobalShortId |
|
ID scurt global al terminalului, nu poate fi setat, este atribuit de sistemul RF. | |
DataAchiziției |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
TipTerminal |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
UpdatedByPrincipalId |
|
Nu trebuie specificat. | |
cashRegisterId |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
CashRegisterBrand |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
Numele modelului casei de marcat |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
Număr de serie casă de marcat |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
Marca software-ului casei de marcat |
M* |
Obligatoriu doar în anumite țări (de exemplu, Germania) | |
Versiunea software-ului pentru casa de marcat |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
Compania-producătoare-a-software-ului-pentru-casă-de-marfă |
M* |
Obligatoriu numai în anumite țări (de exemplu, Germania) | |
Data punerii în funcțiune |
|
Nu trebuie setată! | |
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.