Momsoverholdelsesgrænsefladen kan bruges til automatisk at oprette den nødvendige organisationsstruktur i RetailForce portalen.
For at gøre dette skal kildesystemet indeholde de oplysninger, der kræves for at oprette de relevante enheder i dokumentets payload.
Forudsætninger
For at den automatiske oprettelse af strukturen skal fungere, skal følgende forudsætninger være opfyldt.
- Organisationen skal være oprettet,
- serverkonfigurationen skal være oprettet,
- konfiguration oprettet,
- licenser tildelt,
- konfigurationen skal være tildelt til organisationen.
Organisation
Organisationen skal allerede findes i RetailForce Cloud Portal, da payloaden fra det overordnede system skal henvise til et eksisterende "OrganisationId", når der oprettes en ny struktur.
Bemærk: Det er ikke muligt at oprette virksomheder via denne mekanisme.
Serverkonfiguration
Der skal oprettes en serverkonfiguration, der bruger den korrekte 'Forbindelsestype'.
Konfiguration
Der skal oprettes en konfiguration, som:
- er knyttet til serverkonfigurationen,
- har tildelte licenser,
- er tildelt den pågældende organisation.
Payload fra opstrømssystemet
Via payloaden fra det opstrøms system kan der oprettes en ny butik samt en ny terminal. Derfor skal payloaden indeholde følgende oplysninger:
- "OrganisationId",
- Butiksoplysninger,
- Terminaloplysninger.
OrganisationId
"OrganisationId" skal henvise til den organisation, der er oprettet i RetailForce Cloud Portal. Det kaldes også "LicenseConsumerId" og kan findes i portalen under organisationens egenskaber.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Butiksoplysninger
Mulige egenskaber til oprettelse af en ny butik.
"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"
},Oplysninger i kolonnen "Type":
- M ... påkrævet ("obligatorisk")
- M* ... påkrævet i visse lande eller under visse betingelser
- R ... anbefalet ("anbefalet")
- O ... valgfrit
| Element | Type |
Beskrivelse | |
| Butik |
|
Butiksoplysninger | |
| StoreId | M |
Hvis der skal oprettes en ny butik, skal du bruge "00000000-0000-0000-0000-000000000000" i den første OG i alle efterfølgende payloads. | |
OrganisationId |
M |
Organisationens ID, ikke nødvendigt, da egenskaben "OrganisationId" uden for butiksobjektet allerede henviser til den pågældende organisation. Brug altid: "00000000-0000-0000-0000-000000000000" |
|
CompanyId |
O |
ikke påkrævet, kan bruges, hvis der er oprettet en virksomhed under organisationen. | |
StoreNumber |
M |
Butikkens/filialens nummer. | |
Caption |
M |
Betegnelse for butikken/filialen. | |
FiscalRegion |
M* |
Kræves kun i lande, hvor der findes skatteområder (f.eks. Spanien). | |
Telefon |
O |
Butikkens kontaktoplysninger: Telefonnummer. | |
| Fax | O |
Butikkens kontaktoplysninger: Faxnummer. | |
O |
Butikkens kontaktoplysninger: e-mail-adresse. | ||
Åbningsdato |
M* |
Kræves kun i lande, hvor en butiksåbningsdato skal angives (f.eks. Slovenien). | |
| ClosingDate | O |
Bør ikke angives, da det repræsenterer den endelige lukningsdato for en forretningslokale (da butikken blev lukket for altid). | |
| Skjulte data | O |
Bør ikke angives, da det angiver den dato, hvor butikken blev skjult i portalen, fordi alle tilknyttede terminaler blev taget ud af drift. | |
UpdatedByPrincipalId |
|
Må ikke angives. | |
Åbningstider mandag |
O |
Åbningstider mandag. | |
Åbningstider tirsdag |
O |
Åbningstider tirsdag. | |
Åbningstider onsdag |
O |
Åbningstider onsdag. | |
Åbningstider torsdag |
O |
Åbningstider torsdag. | |
Åbningstider fredag |
O |
Åbningstider fredag. | |
Åbningstider lørdag |
O |
Åbningstider lørdag. | |
Åbningstider søndag |
O |
Åbningstider søndag. | |
Kundekonfigurations-id |
O |
ID for konfigurationen, ikke påkrævet. | |
NewClientConfigurationId |
O |
ID for en ny konfiguration, ikke påkrævet. | |
NewClientConfigurationValidFrom |
O |
Dato, hvorfra en ny konfiguration træder i kraft. | |
Gade |
M |
Gadenavn for butik/filial. | |
StreetNumber |
M |
Gadenummer for butik/filial. | |
PostalCode |
M |
Postnummer for butik/filial. | |
By |
M |
By, hvor butikken/filialen ligger. | |
CountryCode |
M |
Landekode (ISO 3166-1 Alpha-3). | |
Butiksparametre
Valgfri butiksparameter kan indstilles i lande, hvor dette er muligt, f.eks. Frankrig, Slovenien, Kroatien og andre.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Oplysninger i kolonnen "Type":
- M ... påkrævet ("obligatorisk")
- M* ... påkrævet i visse lande eller under visse betingelser
- R ... anbefalet ("anbefalet")
- O ... valgfrit
| Elementer | Type |
Beskrivelse | |
| StoreParameters |
|
||
| ParameterName | O |
Parameterens betegnelse. | |
| ParameterValue | O |
Parameterens værdi. | |
| ParameterKrypteret | O |
Angiver, om parameteren er krypteret. | |
| ParameterOnlyServer | O |
Skift, hvis parameteren kun bruges i serverkonfigurationen. | |
Terminaloplysninger
"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
},Oplysninger i kolonnen "Type":
- M ... påkrævet ("obligatorisk")
- M* ... påkrævet i visse lande eller under visse betingelser
- R ... anbefalet ("anbefalet")
- O ... valgfrit
| Elementer | Type |
Beskrivelse | |
| Terminal |
|
Terminaloplysninger | |
terminalId |
M |
Hvis der skal oprettes en ny terminal, skal du bruge "00000000-0000-0000-0000-000000000000" i den første OG i alle efterfølgende payloads. | |
StoreId |
M |
Brug altid "00000000-0000-0000-0000-000000000000". | |
TerminalNumber |
M |
Kasseapparatets nummer i butikken. | |
fiscalCountry |
O |
ikke påkrævet. | |
Caption |
R |
Betegnelse for kasseapparatet. | |
PlatformType |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Kun muligt for testterminaler ("IsTest": true). | |
Arkiveringsdato |
O |
Angives ikke; angiver, hvornår terminalen blev taget ud af drift og arkiveret. | |
ClientConfigurationId |
O |
Konfigurations-ID, ikke påkrævet. | |
NewClientConfigurationId |
O |
ID for en ny konfiguration, ikke påkrævet. | |
NewClientConfigurationValidFrom |
O |
Dato, hvorfra en ny konfiguration træder i kraft. | |
GlobalShortId |
|
Terminalens globale korte ID, kan ikke indstilles, tildeles af RF-systemet. | |
Købsdato |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Terminaltype |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Opdateret af hovedbruger-id |
|
Må ikke angives. | |
CashRegisterId |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseapparatets mærke |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseapparatets modelnavn |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseapparatets serienummer |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseapparatets softwaremærke |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseprogramversion |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Kasseapparatsoftwarevirksomhed |
M* |
Kun obligatorisk i visse lande (f.eks. Tyskland) | |
Idriftsættelsesdato |
|
Må ikke indstilles! | |
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.