L’interfaccia Vat Compliance può essere utilizzata per creare automaticamente la struttura organizzativa necessaria nel RetailForce portal.
A tal fine, il sistema di origine deve includere nel payload del documento le informazioni necessarie per creare le entità pertinenti.
Prerequisiti
Affinché la creazione automatica della struttura funzioni, devono essere soddisfatti i seguenti prerequisiti.
- Organizzazione creata,
- configurazione del server creata,
- configurazione creata,
- licenze assegnate,
- configurazione assegnata all’organizzazione.
Organizzazione
L’organizzazione deve già esistere nel RetailForce Cloud Portal, poiché il payload proveniente dal sistema a monte deve fare riferimento a un “OrganisationId” esistente al momento della creazione di una nuova struttura.
Nota: non è possibile creare società tramite questo meccanismo.
Configurazione del server
È necessario creare una Server Configuration che impieghi il "Tipo di connessione" corretto.
Configurazione
È necessario creare una configurazione che:
- sia associata alla Server Configuration,
- disponga di licenze assegnate,
- sia associata alla rispettiva organizzazione.
Payload dal sistema a monte
Tramite il payload proveniente dal sistema a monte è possibile creare sia un nuovo punto vendita che un nuovo terminal. A tal fine, il payload deve contenere le seguenti informazioni:
- "OrganisationId",
- Informazioni sul punto vendita,
- Informazioni sul terminale.
OrganisationId
L’“OrganisationId” deve fare riferimento all’organizzazione creata nel RetailForce Cloud Portal. È denominato anche “LicenseConsumerId” ed è reperibile nel Portale nelle proprietà dell’organizzazione.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informazioni sul punto vendita
Proprietà disponibili per la creazione di un nuovo punto vendita.
"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"
},Informazioni nella colonna "Tipo":
- M ... obbligatorio (“mandatory”)
- M* ... obbligatorio in determinati paesi o a determinate condizioni
- R ... raccomandato (“raccomandato”)
- O ... facoltativo
| Elemento | Tipo |
Descrizione | |
| Negozio |
|
Informazioni sul negozio | |
| StoreId | M |
Se è necessario creare un nuovo negozio, utilizzare il valore "00000000-0000-0000-0000-000000000000" nel primo payload e in tutti i payload successivi. | |
OrganisationId |
M |
ID dell’organizzazione; non è necessario, poiché la proprietà «OrganisationId» al di fuori dell’oggetto negozio fa già riferimento alla rispettiva organizzazione. Utilizzi sempre: "00000000-0000-0000-0000-000000000000" |
|
CompanyId |
O |
non richiesto; può essere utilizzato se è stata creata un’azienda all’interno dell’organizzazione. | |
StoreNumber |
M |
Numero del punto vendita/filiale. | |
Caption |
M |
Denominazione del punto vendita/filiale. | |
Regione fiscale |
M* |
Richiesto esclusivamente nei paesi in cui sono definite le regioni fiscali (ad es. Spagna). | |
Telefono |
O |
Informazioni di contatto del punto vendita: numero di telefono. | |
| Fax | O |
Dati di contatto del punto vendita: numero di fax. | |
O |
Dati di contatto del punto vendita: indirizzo e-mail. | ||
Data di attivazione |
M* |
Obbligatorio solo nei paesi in cui è necessario specificare la data di apertura del punto vendita (ad es. Slovenia). | |
| ClosingDate | O |
Non deve essere specificata, poiché rappresenta la data di chiusura definitiva di un locale commerciale (quando il negozio è stato chiuso definitivamente). | |
| Dati nascosti | O |
Non deve essere specificata, poiché rappresenta la data in cui il punto vendita è stato rimosso dal Portale a seguito della dismissione di tutti i terminali ad esso associati. | |
UpdatedByPrincipalId |
|
Non deve essere specificato. | |
OrariDiAperturaLunedì |
O |
Orari di apertura il lunedì. | |
Orari di apertura martedì |
O |
Orari di apertura martedì. | |
Orari di apertura del mercoledì |
O |
Orari di apertura del mercoledì. | |
Orari di apertura giovedì |
O |
Orari di apertura giovedì. | |
Orari di apertura venerdì |
O |
Orari di apertura venerdì. | |
Orari di apertura sabato |
O |
Orari di apertura sabato. | |
Orari di apertura domenica |
O |
Orari di apertura domenica. | |
ID configurazione cliente |
O |
ID della configurazione, non obbligatorio. | |
NewClientConfigurationId |
O |
ID di una nuova configurazione, non obbligatorio. | |
NewClientConfigurationValidFrom |
O |
Data a partire dalla quale una nuova configurazione diventa valida. | |
Via |
M |
Nome della via in cui è ubicato il punto vendita/la filiale. | |
StreetNumber |
M |
Numero civico del punto vendita / della filiale. | |
PostalCode |
M |
Codice postale del punto vendita/filiale. | |
Città |
M |
Città del punto vendita / della filiale. | |
CountryCode |
M |
Codice paese (ISO 3166-1 Alpha-3). | |
Parametri del punto vendita
È possibile impostare parametri opzionali relativi al punto vendita nei Paesi in cui ciò è consentito, ad esempio Francia, Slovenia, Croazia e altri.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informazioni riportate nella colonna «Tipo»:
- M ... obbligatorio (“mandatory”)
- M* ... obbligatorio in determinati paesi o a determinate condizioni
- R ... raccomandato (“raccomandato”)
- O ... facoltativo
| Elementi | Tipo |
Descrizione | |
| StoreParameters |
|
||
| ParameterName | O |
Denominazione del parametro. | |
| ParameterValue | O |
Valore del parametro. | |
| ParameterEncrypted | O |
Indicatore che specifica se il parametro è crittografato. | |
| ParameterOnlyServer | O |
Indica se il parametro viene utilizzato esclusivamente nella configurazione del server. | |
Informazioni sul terminale
"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
},Informazioni nella colonna "Tipo":
- M ... obbligatorio ("mandatory")
- M* ... obbligatorio in determinati paesi o in determinate condizioni
- R ... raccomandato («raccomandato»)
- O ... facoltativo
| Elementi | Tipo |
Descrizione | |
| Terminale |
|
Informazioni sul terminal | |
terminalId |
M |
Se è necessario creare un nuovo terminal, utilizzare il valore UUID "00000000-0000-0000-0000-000000000000" nel primo payload e in tutti i payload successivi. | |
StoreId |
M |
Utilizzare sempre "00000000-0000-0000-0000-000000000000". | |
terminalNumber |
M |
Numero del registratore di cassa all’interno del punto vendita. | |
fiscalCountry |
O |
non richiesto. | |
Didascalia |
R |
Designazione del registratore di cassa. | |
Tipo di piattaforma |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Operazione consentita esclusivamente sui terminali di prova ("IsTest": true). | |
ArchiveDate |
O |
Da non specificare; indica la data in cui il terminal è stato dismesso e archiviato. | |
ClientConfigurationId |
O |
ID della configurazione, non obbligatorio. | |
NewClientConfigurationId |
O |
ID di una nuova configurazione, non obbligatorio. | |
NewClientConfigurationValidFrom |
O |
Data a partire dalla quale una nuova configurazione diventa valida. | |
GlobalShortId |
|
ID breve globale del terminal; non può essere impostato, viene assegnato dal sistema RF. | |
Data di acquisto |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Tipo di terminale |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
UpdatedByPrincipalId |
|
Non deve essere specificato. | |
cashRegisterId |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
CashRegisterBrand |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Nome del modello del registratore di cassa |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Numero di serie del registratore di cassa |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Marca del software del registratore di cassa |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Versione del software per registratori di cassa |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Azienda del software del registratore di cassa |
M* |
Obbligatorio solo in determinati paesi (ad es. Germania) | |
Data di messa in servizio |
|
Non deve essere impostato. | |
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.