Interfejs zgodności z przepisami dotyczącymi podatku Vat może służyć do automatycznego tworzenia niezbędnej struktury organizacyjnej w RetailForce portalu.
W tym celu system źródłowy musi zawierać w payload dokumentu informacje niezbędne do utworzenia odpowiednich podmiotów.
Wymagania wstępne
Aby automatyczne tworzenie struktury działało, muszą być spełnione następujące warunki wstępne.
- Utworzono organizację,
- utworzono konfigurację serwera,
- utworzono konfigurację,
- przypisano licencje,
- konfiguracja przypisana do organizacji.
Organizacja
Organizacja musi już istnieć w RetailForce Cloud Portal, ponieważ payload przesyłany z systemu nadrzędnego musi odnosić się do istniejącego identyfikatora „OrganisationId” podczas tworzenia nowej struktury.
Uwaga: za pomocą tego mechanizmu nie można tworzyć firm.
Konfiguracja serwera
Należy utworzyć konfigurację serwera wykorzystującą prawidłowy „typ połączenia”.
Konfiguracja
Należy utworzyć konfigurację, która:
- jest powiązana z konfiguracją serwera,
- ma przypisane licencje,
- jest przypisana do odpowiedniej organizacji.
Payload z systemu nadrzędnego
Za pomocą payload z systemu nadrzędnego można utworzyć zarówno nowy punkt sprzedaży, jak i nowy terminal. W tym celu payload musi zawierać następujące informacje:
- "OrganisationId",
- Informacje o placówce,
- informacje o terminalu.
OrganisationId
Identyfikator „OrganisationId” odnosi się do organizacji utworzonej w RetailForce Cloud Portal. Nazywany jest on również „LicenseConsumerId” i można go znaleźć w portalu w sekcji właściwości organizacji.
"OrganisationId": 7417eb48-3cca-4882-88b9-df44241908d6,
Informacje o sklepie
Możliwe właściwości przy tworzeniu nowego sklepu.
"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"
},Informacje w kolumnie „Typ”:
- M … wymagane („obowiązkowe”)
- M* … wymagane w niektórych krajach lub pod pewnymi warunkami
- R ... zalecane („zalecane”)
- O … opcjonalne
| Element | Typ |
Opis | |
| Sklep |
|
Informacje o sklepie | |
| StoreId | M |
Jeśli ma zostać utworzony nowy sklep, należy użyć ciągu „00000000-0000-0000-0000-000000000000” w pierwszym ORAZ we wszystkich kolejnych payloadach. | |
OrganisationId |
M |
ID organizacji; nie jest to konieczne, ponieważ właściwość „OrganisationId” poza obiektem sklepu odnosi się już do odpowiedniej organizacji. Należy zawsze używać: „00000000-0000-0000-0000-000000000000” |
|
CompanyId |
O |
nie jest wymagany; można go użyć, jeśli firma została utworzona w ramach danej organizacji. | |
StoreNumber |
M |
Numer sklepu / oddziału. | |
Caption |
M |
Nazwa sklepu / oddziału. | |
Region podatkowy |
M* |
Wymagane wyłącznie w krajach, w których istnieją regiony podatkowe (np. w Hiszpanii). | |
Telefon |
O |
Dane kontaktowe sklepu: numer telefonu. | |
| Faks | O |
Dane kontaktowe sklepu: numer faksu. | |
O |
Dane kontaktowe sklepu: adres e-mail. | ||
Data otwarcia |
M* |
Wymagane wyłącznie w krajach, w których należy podać datę otwarcia sklepu (np. w Słowenii). | |
| ClosingDate | O |
Nie należy podawać tej informacji, ponieważ oznacza ona ostateczną datę zamknięcia lokalu (kiedy sklep został zamknięty na stałe). | |
| Dane ukryte | O |
Nie należy podawać tej wartości, ponieważ oznacza ona datę, w której sklep został ukryty w portalu z powodu wycofania z eksploatacji wszystkich powiązanych terminali. | |
UpdatedByPrincipalId |
|
Nie wolno podawać tej wartości. | |
Godziny otwarcia w poniedziałek |
O |
Godziny otwarcia w poniedziałek. | |
Godziny otwarcia we wtorek |
O |
Godziny otwarcia we wtorek. | |
Godziny otwarcia w środę |
O |
Godziny otwarcia w środę. | |
Godziny otwarcia w czwartek |
O |
Godziny otwarcia w czwartek. | |
Godziny otwarcia w piątek |
O |
Godziny otwarcia w piątek. | |
Godziny otwarcia w sobotę |
O |
Godziny otwarcia w sobotę. | |
Godziny otwarcia w niedzielę |
O |
Godziny otwarcia w niedzielę. | |
Identyfikator konfiguracji klienta |
O |
ID konfiguracji, nieobowiązkowy. | |
NewClientConfigurationId |
O |
ID nowej konfiguracji, nieobowiązkowy. | |
NewClientConfigurationValidFrom |
O |
Data, od której nowa konfiguracja staje się ważna. | |
Ulica |
M |
Nazwa ulicy, przy której znajduje się sklep/oddział. | |
StreetNumber |
M |
Numer domu sklepu / oddziału. | |
PostalCode |
M |
Kod pocztowy sklepu / oddziału. | |
Miasto |
M |
Miasto, w którym znajduje się sklep / oddział. | |
CountryCode |
M |
Kod kraju (ISO 3166-1 Alpha-3). | |
StoreParameters
W krajach, w których jest to możliwe, np. we Francji, Słowenii, Chorwacji i innych, można ustawić opcjonalne parametry sklepu.
"StoreParameters": [
{
"ParameterName": "SIRET_STOREPARAMETER",
"ParameterValue": "123456789",
"ParameterEncrypted": false,
"ParameterOnlyServer": false
}
]Informacje w kolumnie „Typ”:
- M … wymagane („obowiązkowe”)
- M* … wymagane w niektórych krajach lub pod pewnymi warunkami
- R … zalecane („zalecane”)
- O … opcjonalne
| Elementy | Typ |
Opis | |
| StoreParameters |
|
||
| ParameterName | O |
Nazwa parametru. | |
| parameterValue | O |
Wartość parametru. | |
| ParameterEncrypted | O |
Przełącznik określający, czy parametr jest zaszyfrowany. | |
| ParameterOnlyServer | O |
Przełącznik określający, czy parametr jest używany wyłącznie w konfiguracji serwera. | |
Informacje 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
},Informacje w kolumnie „Typ”:
- M … wymagane („obowiązkowe”)
- M* … wymagane w niektórych krajach lub w określonych warunkach
- R … zalecane („zalecane”)
- O … opcjonalne
| Elementy | Typ |
Opis | |
| Terminal |
|
Informacje o terminalu | |
TerminalId |
M |
Jeśli ma zostać utworzony nowy terminal, należy użyć ciągu „00000000-0000-0000-0000-000000000000” w pierwszym ORAZ we wszystkich kolejnych payloadach. | |
StoreId |
M |
Należy zawsze używać ciągu „00000000-0000-0000-0000-000000000000”. | |
terminalNumber |
M |
Numer kasy w sklepie. | |
FiscalCountry |
O |
nieobowiązkowe. | |
Caption |
R |
Oznaczenie kasy fiskalnej. | |
Typ platformy |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech). | |
IsTest |
M |
|
|
IsDisabledGetConfigurationLimit |
O |
Dostępne wyłącznie dla terminali testowych („IsTest”: true). | |
ArchiveDate |
O |
Nie należy określać; wskazuje, kiedy terminal został wycofany z eksploatacji i zarchiwizowany. | |
ClientConfigurationId |
O |
ID konfiguracji, nieobowiązkowy. | |
NewClientConfigurationId |
O |
ID nowej konfiguracji, nieobowiązkowy. | |
NewClientConfigurationValidFrom |
O |
Data, od której nowa konfiguracja staje się ważna. | |
GlobalShortId |
|
Globalny skrócony ID terminala; nie można go ustawić, jest przypisywany przez system RF. | |
PurchaseDate |
M* |
Pole obowiązkowe tylko w niektórych krajach (np. w Niemczech) | |
Typ terminala |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
UpdatedByPrincipalId |
|
Nie wolno podawać tej wartości. | |
CashRegisterId |
M* |
Pole to jest obowiązkowe wyłącznie w niektórych krajach (np. w Niemczech) | |
CashRegisterBrand |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Nazwa_modelu_kasy_fiskalnej |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Numer seryjny kasy fiskalnej |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Marka oprogramowania kasy fiskalnej |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Wersja oprogramowania kasowego |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Nazwa producenta oprogramowania kasowego |
M* |
Wymagane wyłącznie w niektórych krajach (np. w Niemczech) | |
Data uruchomienia |
|
Nie wolno ustawiać! | |
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.