Niniejsza dokumentacja przedstawia sposób korzystania z aplikacji Import danych w zakresie cenników sprzedaży oraz przypisanych list cen. Opisano również warunki wstępne, możliwe skutki i ograniczenia importu.
Szczegółowe informacje o aplikacji, w tym opisy pól i przycisków, znajdują się w dokumentacji Import danych.
Informacje ogólne
Import cenników oparty jest na aktualnym modelu danych przechowywanym w bazie danych repozytorium. W przypadku eksportu danych dostępnych jest więcej atrybutów niż przy imporcie, dlatego zaleca się tworzenie osobnych filtrów dla eksportu i importu.
Niektóre dane (np. wewnętrzne atrybuty pomocnicze) nie podlegają importowi.
Aby ustalić prawidłowy format pliku importu, najlepiej utworzyć przykładowy cennik w aplikacji Cenniki sprzedaży, a następnie wyeksportować go z użyciem filtra dostosowanego do importu. Otrzymany plik może posłużyć jako szablon.
Zasady obowiązujące podczas importu odpowiadają zasadom edycji danych w aplikacji. Na przykład: artykuł w istniejącym elemencie nie może być później zmieniany. Atrybuty niezgodne z kontekstem są ignorowane. Dotyczy to także określania wartości domyślnych.
Instrukcja importu cenników i list cen sprzedaży
Aby zaimportować cennik lub listę cenników, należy:
-
Otworzyć aplikację Import danych.
-
Wybrać filtr dla jednego z poniższych obiektów biznesowych:
-
com.cisag.app.sales.obj.PriceList(cenniki sprzedaży) -
com.cisag.app.sales.obj.PriceListing(listy cen sprzedaży)
-
-
W razie potrzeby skopiować lub utworzyć nowy filtr.
-
Zmodyfikować wybrane atrybuty filtra (jeśli konieczne).
-
Nacisnąć przycisk [Import danych] na pasku przycisków.
-
W oknie dialogowym Import danych określić ustawienia pliku importu (szczegóły w dokumentacji Importuj dane).
-
Uruchomić import za pomocą przycisku [W tle].
Struktura cennika sprzedaży (PriceList)
Cennik składa się z:
-
danych podstawowych (nagłówka),
-
danych pozycji (np. ceny, rabaty).
Pozycje można importować wyłącznie z przypisaniem do konkretnego cennika. Jeśli pozycja już istnieje, tworzona jest nowa wersja (chyba że dany cennik nie jest jeszcze używany).
Zależność czasowa danych
Okres ważności pozycji cennika:
-
priceListValidFrom, priceListValidUntil — wyświetlane w aplikacji.
-
validFrom, validUntil — służą do wyznaczania okresu obowiązywania obiektu definicji ceny (nie są wyświetlane). Zwykle nie należy ich używać, ponieważ wpływają na ustalanie cen historycznych.
Struktura listy cenników sprzedaży (PriceListing)
Lista cen zawiera:
-
dane podstawowe (nagłówka),
-
dane przypisania (np. przypisane cenniki, priorytety, zakresy dat).
Pozycje oraz dane podstawowe muszą być importowane oddzielnie. Przypisywane cenniki muszą istnieć już wcześniej. Istniejące pozycje nie są nadpisywane — tworzona jest ich nowa wersja.
Zależność czasowa przypisań
-
assignmentValidFrom,assignmentValidUntil— definiują okres przypisania cennika (widoczne w aplikacji). -
validFrom,validUntil— definiują wewnętrzne daty obowiązywania przypisania, niewidoczne w aplikacji. Należy ich używać wyłącznie w razie potrzeby ingerencji w historię cen.
Kolejność importu
Ze względu na zależność strukturalną należy zachować kolejność:
-
Zaimportować cenniki sprzedaży (PriceList),
-
Następnie listy cen sprzedaży (PriceListing).
Przegląd: Atrybuty
Wszystkie atrybuty dostępne do importu, wraz z relacjami klucza obcego i oznaczeniem identyfikatorów (K), przedstawione są w tabelach w kolejnych podrozdziałach dokumentacji.
Atrybuty poszczególnych obiektów biznesowych, które są dostępne do importu, są wymienione poniżej. Odpowiednia nazwa relacji jest również uwzględniona dla atrybutów klucza obcego. Pola identyfikacyjne i obowiązkowe mogą ulec zmianie i mogą zostać rozszerzone poprzez dostosowanie.
Cennik sprzedaży
Dane podstawowe: PriceList
Identyfikację cennika sprzedaży stanowi połączenie jednostki organizacyjnej oraz kodu cennika.
| Atrybut | Relacja | Opis |
classification |
klasyfikacja | Klasyfikacja cennika sprzedaży |
code (K) |
— | Kod cennika |
currency |
— | Waluta |
description |
— | Opis |
guid (K) |
— | Identyfikator techniczny — stosowany do zmiany/usunięcia istniejących danych |
organizationalUnit (K) |
— | Jednostka organizacyjna |
priceIncludingTaxes |
— | Wskaźnik: czy ceny zawierają podatek |
priceListValidFrom |
— | Data rozpoczęcia ważności |
priceListValidUntil |
— | Data zakończenia ważności |
standard |
— | Wskaźnik cennika standardowego |
type |
— | Typ cennika |
validityFixed |
— | Wskaźnik ustalonego okresu ważności |
Dane pozycji: PriceDefinitions
| Atrybut | Relacja | Opis |
customerItemNumber |
— | Numer pozycji klienta |
customerItemDescription |
— | Opis pozycji klienta |
discountItem |
DiscountItem | Pozycja rabatowa |
ean |
— | Europejski numer artykułu (EAN) |
item (K) |
— | Artykuł (element cennika) |
itemKeyType (K) |
— | Typ składnika pozycji |
itemPriceHierarchy |
— | Klasyfikacja cen artykułów |
partner (K) |
— | Partner |
partnerKeyType (K) |
— | Typ składnika partnera |
partnerPriceHierarchy |
PartnerPriceHierarchy | Klasyfikacja cen partnera |
priceCurrency |
— | Waluta wartości ceny |
priceDimension |
— | Wymiar ceny |
priceDiscountType (K) |
PriceDiscountType | Typ składnika ceny |
priceKeyUom |
PriceKeyUom | Jednostka wartości ceny |
pricelist (K) |
— | Cennik, do którego przypisana jest pozycja |
priceListValidFrom (K) |
— | Data rozpoczęcia ważności pozycji |
priceListValidUntil |
— | Data zakończenia ważności pozycji |
priceType |
— | Rodzaj wartości ceny: ilość, cena, procent |
priceUom |
PriceUom | Jednostka wymiaru ceny |
priceValue |
— | Wartość ceny |
rebateInKind |
— | Wskaźnik rabatu rzeczowego |
roundingParameters.algorithm |
— | Reguła zaokrąglania |
roundingParameters.base |
— | Podstawa zaokrąglania |
scaleCurrency |
ScaleCurrency | Waluta skali |
scaleType (K) |
— | Typ skali: ilość, cena, procent |
scaleUom |
ScaleUom | Jednostka skali |
scaleValue (K) |
— | Wartość skali |
validFrom (K) |
— | Data ważności — stosować wyłącznie w celu wpływu na ceny historyczne |
validUntil |
— | Data zakończenia ważności — jw. |
Lista cen sprzedaży
Dane podstawowe: PriceListing
| Atrybut | Relacja | Opis |
classification |
— | Klasyfikacja listy cen sprzedaży |
code (K) |
— | Kod listy cen |
currency |
— | Waluta |
description |
— | Opis |
guid (K) |
— | Identyfikator techniczny — stosowany do zmiany/usunięcia danych |
maintainingOrganisation |
MaintainingOrganisation | Organizacja odpowiedzialna |
priceIncludingTaxes |
— | Wskaźnik: czy ceny zawierają podatek |
Dane pozycji: PriceListingAssignments
| Atrybut | Relacja | Opis |
| assignmentValidFrom | — | Data rozpoczęcia ważności przypisania |
| assignmentValidUntil | — | Data zakończenia ważności przypisania |
| list (K) | — | Lista cen, do której przypisany jest cennik |
| listing (K) | — | Cennik sprzedaży |
| priority | — | Priorytet przypisania |
| validFrom (K) | — | Data ważności — używać tylko w celu ingerencji w ustalanie ceny historycznej |
| validUntil | — | Data zakończenia ważności — jw. |
