L’interface de conformité Vat permet de créer automatiquement la structure organisationnelle nécessaire dans le RetailForce portal.
Pour ce faire, le système source doit inclure dans le payload du document les informations requises pour créer les entités concernées.
Conditions préalables
Pour que la création automatique de la structure fonctionne, les conditions préalables suivantes doivent être remplies.
- L’organisation doit avoir été créée,
- la configuration du serveur a été créée,
- configuration créée,
- des licences attribuées,
- configuration affectée à l’organisation.
Organisation
L’organisation doit déjà exister dans le RetailForce Cloud Portal, car le payload provenant du système en amont doit faire référence à un « OrganisationId » existant lors de la création d’une nouvelle structure.
Remarque : il n’est pas possible de créer des sociétés via ce mécanisme.
Configuration du serveur
Une configuration de serveur doit être créée en utilisant le « type de connexion » approprié.
Configuration
Une configuration doit être créée, qui :
- soit liée à la configuration du serveur,
- dispose de licences attribuées,
- soit affectée à l’organisation correspondante.
Payload provenant du système en amont
Grâce à la payload provenant du système en amont, il est possible de créer un nouveau point de vente ainsi qu’un nouveau terminal. Pour cela, la payload doit contenir les informations suivantes :
- "OrganisationId",
- Informations sur le point de vente,
- Informations sur le terminal.
OrganisationId
L’« OrganisationId » doit faire référence à l’organisation créée dans le RetailForce Cloud Portal. Il est également appelé « LicenseConsumerId » et figure dans le portail, dans les propriétés de l’organisation.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informations sur le magasin
Propriétés possibles pour la création d’un nouveau magasin.
"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"
},Informations dans la colonne « Type » :
- M … obligatoire (« mandatory »)
- M* … obligatoire dans certains pays ou sous certaines conditions
- R ... recommandé (« recommandé »)
- O ... facultatif
| Élément | Type |
Description | |
| Magasin |
|
Informations sur le magasin | |
| StoreId | M |
Si un nouveau magasin doit être créé, utilisez la valeur « 00000000-0000-0000-0000-000000000000 » dans la première payload ET dans toutes les payloads suivantes. | |
OrganisationId |
M |
ID de l'organisation ; ce champ n'est pas obligatoire, car la propriété « OrganisationId » située en dehors de l'objet « store » fait déjà référence à l'organisation correspondante. Veuillez toujours utiliser : « 00000000-0000-0000-0000-000000000000 » |
|
CompanyId |
O |
Non obligatoire, peut être utilisé si une entreprise a été créée sous l'organisation. | |
StoreNumber |
M |
Numéro du magasin / de la succursale. | |
Légende |
M |
Dénomination du magasin / de la succursale. | |
FiscalRegion |
M* |
Obligatoire uniquement dans les pays où il existe des régions fiscales (par exemple, l'Espagne). | |
Téléphone |
O |
Coordonnées du magasin : numéro de téléphone. | |
| Télécopieur | ou |
Coordonnées du magasin : numéro de fax. | |
| Adresse électronique | O |
Coordonnées du magasin : adresse e-mail. | |
Date de mise en service |
M* |
Obligatoire uniquement dans les pays où la date d'ouverture du magasin doit être précisée (par exemple, en Slovénie). | |
| ClosingDate | O |
Ne doit pas être indiquée, car elle correspond à la date de fermeture définitive d’un établissement (lorsque le magasin a fermé définitivement). | |
| Données masquées | O |
Ne doit pas être renseigné ; correspond à la date à laquelle le magasin a été masqué sur le portail, car tous les terminaux associés ont été mis hors service. | |
UpdatedByPrincipalId |
|
Ne doit pas être renseigné. | |
OpeningHoursMonday |
O |
Horaires d'ouverture le lundi. | |
Horaires d'ouverture le mardi |
O |
Horaires d'ouverture le mardi. | |
Horaires d'ouverture le mercredi |
O |
Horaires d'ouverture le mercredi. | |
Horaires d'ouverture le jeudi |
O |
Horaires d'ouverture du jeudi. | |
Horaires d'ouverture le vendredi |
O |
Horaires d'ouverture le vendredi. | |
Horaires d'ouverture le samedi |
O |
Horaires d'ouverture le samedi. | |
Horaires d'ouverture le dimanche |
O |
Horaires d'ouverture le dimanche. | |
ClientConfigurationId |
O |
ID de la configuration, facultatif. | |
NewClientConfigurationId |
O |
ID d'une nouvelle configuration, facultatif. | |
NewClientConfigurationValidFrom |
O |
Date à partir de laquelle la nouvelle configuration entre en vigueur. | |
Rue |
M |
Désignation de la voie dans laquelle est implanté le point de vente ou l’agence. | |
StreetNumber |
M |
Numéro de rue du magasin / de la succursale. | |
PostalCode |
M |
Code postal du magasin / de la succursale. | |
Ville |
M |
Ville du magasin / de la succursale. | |
CodePays |
M |
Code pays (ISO 3166-1 Alpha-3). | |
Paramètres du magasin
Des paramètres de magasin facultatifs peuvent être définis dans les pays où cela est possible, par exemple en France, en Slovénie, en Croatie et dans d’autres pays.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informations dans la colonne « Type » :
- M … obligatoire (« mandatory »)
- M* … obligatoire dans certains pays ou sous certaines conditions
- R ... recommandé (« recommandé »)
- O … facultatif
| Éléments | Type |
Description | |
| StoreParameters |
|
||
| ParameterName | O |
Désignation du paramètre. | |
| ParameterValue | O |
Valeur du paramètre. | |
| ParamètreChiffré | O |
Indicateur indiquant si le paramètre est chiffré. | |
| ParameterOnlyServer | O |
Indique si le paramètre est utilisé uniquement dans la configuration du serveur. | |
Informations sur le 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
},Informations dans la colonne « Type » :
- M … obligatoire (« mandatory »)
- M* ... obligatoire dans certains pays ou sous certaines conditions
- R ... recommandé (« recommandé »)
- O … facultatif
| Éléments | Type |
Description | |
| Terminal |
|
Informations sur le terminal | |
terminalId |
M |
Si un nouveau terminal doit être créé, veuillez utiliser « 00000000-0000-0000-0000-000000000000 » dans la première payload ET dans toutes les payloads suivantes. | |
StoreId |
M |
Utilisez toujours « 00000000-0000-0000-0000-000000000000 ». | |
TerminalNumber |
M |
Numéro de caisse au sein du magasin. | |
FiscalCountry |
O |
non obligatoire. | |
Légende |
R |
Désignation de la caisse enregistreuse. | |
PlatformType |
M* |
Obligatoire uniquement dans certains pays (par exemple, en Allemagne). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Cette opération n’est possible que pour les terminaux de test (« IsTest » : true). | |
ArchiveDate |
O |
Ne pas spécifier ; indique la date à laquelle le terminal a été mis hors service et archivé. | |
ClientConfigurationId |
O |
ID de la configuration, facultatif. | |
NewClientConfigurationId |
O |
ID d’une nouvelle configuration, facultatif. | |
NewClientConfigurationValidFrom |
O |
Date à partir de laquelle la nouvelle configuration entre en vigueur. | |
GlobalShortId |
|
ID court global du terminal ; ne peut pas être défini, il est attribué par le système RF. | |
Date d'achat |
M* |
Obligatoire uniquement dans certains pays (par exemple, en Allemagne) | |
Type de terminal |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
UpdatedByPrincipalId |
|
Ne doit pas être spécifié. | |
cashRegisterId |
M* |
Obligatoire uniquement dans certains pays (par exemple, en Allemagne) | |
CashRegisterBrand |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Nom du modèle de caisse |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Numéro de série de la caisse enregistreuse |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Marque du logiciel de caisse |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Version du logiciel de caisse |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Société-du-logiciel-de-caisse |
M* |
Obligatoire uniquement dans certains pays (par exemple, l'Allemagne) | |
Date de mise en service |
|
Ce champ ne doit pas être renseigné. | |
Cet article a été traduit automatiquement.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.