Interfejs za usklađenost s PDV-om može se koristiti za automatsko stvaranje potrebne organizacijske strukture u RetailForce portalu.
Za to izvorni sustav mora sadržavati informacije potrebne za stvaranje relevantnih entiteta u korisnom teretu dokumenta.
Preduvjeti
Za automatsko stvaranje strukture potrebno je ispuniti sljedeće preduvjete.
- Organizacija je stvorena,
- konfiguracija poslužitelja kreirana,
- konfiguracija kreirana,
- licence dodijeljene,
- konfiguracija dodijeljena organizaciji.
Organizacija
Organizacija mora već postojati u RetailForce Cloud Portalu, budući da payload iz nadređenog sustava mora referencirati postojeći "OrganisationId" pri stvaranju nove strukture.
Napomena: putem ovog mehanizma nije moguće stvoriti tvrtke.
Konfiguracija poslužitelja
Morate stvoriti konfiguraciju poslužitelja koja koristi ispravan 'Tip veze'.
Konfiguracija
Morate stvoriti konfiguraciju koja:
- je povezana s konfiguracijom poslužitelja,
- ima dodijeljene licence,
- je dodijeljena odgovarajućoj organizaciji.
Payload iz nadređenog sustava
Putem payloada iz nadređenog sustava može se stvoriti nova trgovina kao i novi terminal. Stoga payload mora sadržavati sljedeće informacije:
- "OrganisationId",
- informacije o trgovini,
- Informacije o terminalu.
ID organizacije
"OrganisationId" mora upućivati na organizaciju stvorenu u RetailForce Cloud Portalu. Također se naziva "LicenseConsumerId" i može se pronaći u Portalu u svojstvima organizacije.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informacije o trgovini
Moguća svojstva za stvaranje 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"
},Informacije u stupcu "Type":
- M ... obavezno ("mandatorno")
- M* ... obavezno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno ("preporučeno")
- O ... opcionalno
| Element | Vrsta |
Opis | |
| Pohrana |
|
Informacije o trgovini | |
| ID trgovine | M |
Ako se treba stvoriti nova trgovina, upotrijebite "00000000-0000-0000-0000-000000000000" u prvom AND-u i u svim sljedećim payloadima. | |
ID organizacije |
M |
ID organizacije, nije potrebno, budući da se svojstvo "OrganisationId" izvan objekta trgovine već odnosi na odgovarajuću organizaciju. Uvijek koristite: "00000000-0000-0000-0000-000000000000" |
|
ID tvrtke |
O |
nije potrebno, može se koristiti ako je tvrtka stvorena ispod organizacije. | |
Broj trgovine |
M |
Broj trgovine / podružnice. | |
Natpis |
M |
Naznaka trgovine / podružnice. | |
Fiskalna regija |
M* |
Potrebno samo u zemljama u kojima postoje fiskalne regije (npr. Španjolska). | |
Telefon |
O |
Kontaktne informacije trgovine: broj telefona. | |
| Faks | O |
Kontaktne informacije trgovine: broj faksa. | |
| E-pošta | O |
Kontaktne informacije trgovine: adresa e-pošte. | |
Datum otvaranja |
M* |
Potrebno samo u zemljama u kojima se mora navesti datum otvaranja trgovine (npr. Slovenija). | |
| Datum zatvaranja | O |
Ne bi se trebalo navoditi, jer predstavlja datum konačnog zatvaranja poslovnog prostora (kada je trgovina trajno zatvorena). | |
| HiddenDaten | O |
Ne bi se trebalo navoditi, predstavlja datum kada je trgovina skrivena u Portalu jer su svi pripadajući terminali povučeni iz uporabe. | |
Ažurirao: Primarni ID |
|
Ne smije biti navedeno. | |
RadnoVrijemePonedjeljak |
O |
Radno vrijeme ponedjeljkom. | |
Radno vrijeme utorka |
O |
Radno vrijeme utorka. | |
Radno vrijeme srijede |
O |
Radno vrijeme srijede. | |
Radno vrijeme četvrtak |
O |
Radno vrijeme četvrtak. | |
Radno vrijeme petkom |
O |
Radno vrijeme petkom. | |
Radno vrijeme subota |
O |
Radno vrijeme subote. | |
Radno vrijeme nedjelje |
O |
Radno vrijeme nedjelje. | |
ID konfiguracije klijenta |
O |
ID konfiguracije, nije obavezno. | |
ID nove konfiguracije klijenta |
O |
ID nove konfiguracije, nije obavezno. | |
NewClientConfigurationValidFrom |
O |
Datum od kojeg nova konfiguracija postaje važeća. | |
Ulica |
M |
Naziv ulice trgovine / poslovnice. | |
Broj ulice |
M |
Broj ulice trgovine / poslovnice. | |
Poštanski broj |
M |
Poštanski broj trgovine / poslovnice. | |
Grad |
M |
Grad trgovine / poslovnice. | |
Šifra države |
M |
Šifra države (ISO 3166-1 Alpha-3). | |
Parametri trgovine
Moguće je postaviti dodatni parametar trgovine u zemljama gdje je to moguće, npr. Francuska, Slovenija, Hrvatska i druge.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informacije u stupcu "Tip":
- M ... obavezno ("mandatorno")
- M* ... obavezno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno ("preporučeno")
- O ... opcionalno
| Elementi | Tip |
Opis | |
| Pohrani parametre |
|
||
| Naziv parametra | O |
Naziv parametra. | |
| Vrijednost parametra | O |
Vrijednost parametra. | |
| Šifrirani parametar | O |
Prebacite prema tome je li parametar šifriran. | |
| Parameter samo za poslužitelj | O |
Prebacite ako se parametar koristi samo u konfiguraciji poslužitelja. | |
Informacije 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
},Informacije u stupcu "Tip":
- M ... obavezno ("mandatorno")
- M* ... obavezno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno ("preporučeno")
- O ... neobavezno
| Elementi | Tip |
Opis | |
| Terminal |
|
Informacije o terminalu | |
ID terminala |
M |
Ako se treba stvoriti novi terminal, upotrijebite "00000000-0000-0000-0000-000000000000" u prvom AND-u i u svim sljedećim payloadima. | |
ID skladišta |
M |
Uvijek koristite "00000000-0000-0000-0000-000000000000". | |
Brojterminala |
M |
Broj blagajne unutar trgovine. | |
Fiskalna država |
O |
nije potrebno. | |
Natpis |
R |
Naznaka blagajne. | |
Tip platforme |
M* |
Obavezno samo u nekim zemljama (npr. Njemačka). | |
Je li test |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Moguće samo za testne terminale ("IsTest": true). | |
Datum arhiviranja |
O |
Ne navodite, označava kada je terminal povučen iz uporabe i arhiviran. | |
ID konfiguracije klijenta |
O |
ID konfiguracije, nije obavezno. | |
NewClientConfigurationId |
O |
ID nove konfiguracije, nije obavezno. | |
NewClientConfigurationValidFrom |
O |
Datum od kojeg nova konfiguracija stupa na snagu. | |
GlobalShortId |
|
Globalni kratki ID terminala, ne može se postaviti, dodjeljuje ga RF-sustav. | |
Datum kupnje |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Tip terminala |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Ažurirao glavni ID |
|
Ne smije biti navedeno. | |
CashRegisterId |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Marka blagajne |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Naziv modela blagajne |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Serijski broj blagajne |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Marka blagajničkog softvera |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Verzija blagajničkog softvera |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Tvrtka za blagajnički softver |
M* |
Obavezno samo u određenim zemljama (npr. Njemačka) | |
Datum puštanja u rad |
|
Ne smije biti postavljeno! | |
Ovaj je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.