Gränssnittet för momsredovisning kan användas för att automatiskt skapa den nödvändiga organisationsstrukturen i RetailForce portalen.
För att detta ska fungera måste källsystemet inkludera den information som krävs för att skapa de relevanta enheterna i dokumentets payload.
Förutsättningar
För att det automatiska skapandet av strukturen ska fungera måste följande förutsättningar vara uppfyllda.
- Organisationen måste vara skapad,
- serverkonfigurationen skapad,
- konfiguration skapad,
- licenser tilldelade,
- konfigurationen måste ha tilldelats organisationen.
Organisation
Organisationen måste redan finnas i RetailForce Cloud Portal, eftersom payloaden från uppströmsystemet måste hänvisa till ett befintligt "OrganisationId" när en ny struktur skapas.
Obs! Det går inte att skapa företag via denna mekanism.
Serverkonfiguration
En serverkonfiguration måste skapas som använder rätt ”anslutningstyp”.
Konfiguration
En konfiguration måste skapas som:
- är kopplad till serverkonfigurationen,
- har tilldelade licenser,
- är tilldelad respektive organisation.
Payload från uppströmsystemet
Via payload från uppströmsystemet kan både en ny butik och en ny terminal skapas. Därför måste payload innehålla följande information:
- "OrganisationId",
- Butiksinformation,
- Terminalinformation.
OrganisationId
"OrganisationId" ska hänvisa till den organisation som skapats i RetailForce Cloud Portal. Det kallas även "LicenseConsumerId" och finns i portalen under organisationens egenskaper.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Butiksinformation
Möjliga egenskaper för att skapa 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"
},Information i kolumnen ”Type”:
- M ... krävs ("obligatoriskt")
- M* ... krävs i vissa länder eller under vissa förutsättningar
- R ... rekommenderat ("rekommenderat")
- O ... valfritt
| Element | Typ |
Beskrivning | |
| Butik |
|
Butiksinformation | |
| StoreId | M |
Om en ny butik ska skapas, använd "00000000-0000-0000-0000-000000000000" i den första OCH i alla efterföljande payloads. | |
OrganisationId |
M |
Organisationens ID, inte nödvändigt, eftersom egenskapen "OrganisationId" utanför butiksobjektet redan hänvisar till respektive organisation. Använd alltid: "00000000-0000-0000-0000-000000000000" |
|
CompanyId |
O |
krävs inte, kan användas om ett företag har skapats under organisationen. | |
StoreNumber |
M |
Butikens/filialens nummer. | |
Caption |
M |
Butikens/filialens beteckning. | |
FiscalRegion |
M* |
Krävs endast i länder där det finns skatteregioner (t.ex. Spanien). | |
Telefon |
O |
Butikens kontaktuppgifter: Telefonnummer. | |
| Fax | O |
Butikens kontaktuppgifter: Faxnummer. | |
| E-post | O |
Butikens kontaktuppgifter: e-postadress. | |
Öppningsdatum |
M* |
Krävs endast i länder där ett öppningsdatum för butiken måste anges (t.ex. Slovenien). | |
| ClosingDate | O |
Bör inte anges, eftersom det avser det slutgiltiga stängningsdatumet för en affärslokal (när butiken stängdes för gott). | |
| Dolda uppgifter | O |
Bör inte anges, eftersom det avser det datum då butiken doldes i portalen på grund av att alla underliggande terminaler togs ur drift. | |
Uppdaterad av huvudansvarig-ID |
|
Får inte anges. | |
ÖppettiderMåndag |
O |
Öppettider måndag. | |
Öppettider tisdag |
O |
Öppettider tisdag. | |
Öppettider onsdag |
O |
Öppettider onsdag. | |
Öppettider torsdag |
O |
Öppettider torsdag. | |
Öppettider fredag |
O |
Öppettider fredag. | |
Öppettider lördag |
O |
Öppettider lördag. | |
Öppettider söndag |
O |
Öppettider söndag. | |
Klientkonfigurations-ID |
O |
Konfigurations-ID, krävs inte. | |
NewClientConfigurationId |
O |
ID för en ny konfiguration, krävs inte. | |
NewClientConfigurationValidFrom |
O |
Datum från och med vilket en ny konfiguration träder i kraft. | |
Gata |
M |
Gatunamn för butik/filial. | |
StreetNumber |
M |
Gatunummer för butik/filial. | |
PostalCode |
M |
Butikens/filialens postnummer. | |
Stad |
M |
Butikens/filialens ort. | |
CountryCode |
M |
Landskod (ISO 3166-1 Alpha-3). | |
Butiksparametrar
Valfria butiksparametrar kan anges i länder där detta är möjligt, t.ex. Frankrike, Slovenien, Kroatien och andra.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Information i kolumnen ”Typ”:
- M ... krävs ("obligatoriskt")
- M* ... krävs i vissa länder eller under vissa förutsättningar
- R ... rekommenderat ("rekommenderat")
- O ... valfritt
| Element | Typ |
Beskrivning | |
| StoreParameters |
|
||
| parameterName | O |
Parametrens beteckning. | |
| ParameterValue | O |
Parametrens värde. | |
| Parameterkrypterad | O |
Anger om parametern är krypterad. | |
| ParameterEndastServer | O |
Välj om parametern endast används i serverkonfigurationen. | |
Terminalinformation
"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
},Information i kolumnen ”Typ”:
- M ... krävs ("obligatoriskt")
- M* ... krävs i vissa länder eller under vissa förhållanden
- R ... rekommenderat ("rekommenderat")
- O ... valfritt
| Element | Typ |
Beskrivning | |
| Terminal |
|
Terminalinformation | |
TerminalId |
M |
Om en ny terminal ska skapas, använd "00000000-0000-0000-0000-000000000000" i den första OCH i alla efterföljande payloads. | |
StoreId |
M |
Använd alltid ”00000000-0000-0000-0000-000000000000”. | |
TerminalNumber |
M |
Kassanummer inom butiken. | |
fiscalCountry |
O |
krävs inte. | |
Bildtext |
R |
Beteckning på kassan. | |
Plattformstyp |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Endast möjligt för testterminaler ("IsTest": true). | |
Arkivdatum |
O |
Ange inte, anger när terminalen togs ur drift och arkiverades. | |
ClientConfigurationId |
O |
Konfigurations-ID, krävs inte. | |
NewClientConfigurationId |
O |
ID för en ny konfiguration, krävs inte. | |
NewClientConfigurationValidFrom |
O |
Datum från och med vilket en ny konfiguration träder i kraft. | |
GlobalShortId |
|
Terminalens globala korta ID, kan inte ställas in, tilldelas av RF-systemet. | |
Inköpsdatum |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Terminaltyp |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Uppdaterad av huvudmanens ID |
|
Får inte anges. | |
CashRegisterId |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassaregistermärke |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassasystemets modellnamn |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassasystemets serienummer |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassasystemets programvarumärke |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassasystemets programvaruversion |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Kassasystemets programvaruleverantör |
M* |
Endast obligatoriskt i vissa länder (t.ex. Tyskland) | |
Idriftsättningsdatum |
|
Får inte anges! | |
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.