Niniejszy dokument opisuje korzystanie z aplikacji Import danych w kontekście danych dotyczących dokumentów szybkiej rejestracji sprzedaży.
Dokument opisuje warunki wstępne, instrukcje importu, zawiera informacje o tym, na co należy zwrócić uwagę oraz informuje o możliwych efektach importu.
Informacje ogólne
Import dokumentu szybkiej rejestracji sprzedaży zasadniczo opiera się na aktualnym modelu danych, który jest przechowywany w bazie danych repozytorium. W przypadku eksportu danych dostępnych jest więcej atrybutów, niż w przypadku importu danych. Dlatego sensowne jest ustawienie oddzielnych filtrów dla eksportu i importu. Relacje 1:1 są zwykle oparte na technicznym atrybucie GUID w modelu danych. W zależności od aplikacji podczas importu można użyć technicznego atrybutu GUID lub klucza technicznego z obiektu docelowego (zwykle kod lub numer). W przypadku niektórych obiektów biznesowych organizacja jest odpowiedzialna za konwersję kluczy biznesowych na klucze techniczne (organizacja) konieczna. Odpowiednia organizacja zwykle nie znajduje się bezpośrednio w źródle importu, ale jest określana poprzez kontekst dokumentu. Więcej informacji można znaleźć w rozdziale Przegląd atrybutów. Obiekty biznesowe z kodem skrótu są przywoływane na podstawie dokumentu szybkiej rejestracji sprzedaży. Są to technicznie powiązane grupy atrybutów, które są zawsze takie same dla wielu dokumentów i dzięki temu pozwalają zaoszczędzić miejsce w bazie danych i pamięci głównej poprzez ich ponowne wykorzystanie. Dzięki specjalnej konwersji obiekty biznesowe z kodem skrótu są wyświetlane jak części do eksportu lub importu. Niektóre dane z dokumentów szybkiej rejestracji sprzedaży, takie jak pola stanu i wewnętrzne atrybuty pomocnicze nie mogą być importowane. Jeśli nie ma pewności, jaki format pliku importu jest odpowiedni, należy postąpić w następujący sposób:
Wprowadzić przykładowy dokument za pomocą aplikacji Dokumenty szybkiej rejestracji sprzedaży i wyeksportować go za pomocą filtra importu w żądanym formacie i z żądanymi atrybutami. Wyjściowy plik przykładowy może zostać użyty jako szablon dla tworzonych plików importowych. Przy imporcie obowiązują te same zasady, co przy edycji za pośrednictwem aplikacji. Na przykład: artykuł nie może znajdować się w zapisanej pozycji. Wartości atrybutów są ignorowane, jeśli nie można ich przyjąć w bieżącym kontekście. Tę samą logikę stosuje się również przy ustalaniu sugerowanej wartości, dzięki czemu import i aplikacja zachowują się identycznie.
Instrukcja importu dokumentów szybkiej rejestracji sprzedaży
Aby zaimportować dokumenty szybkiej rejestracji sprzedaży, należy:
1. Otworzyć aplikację Importuj dane.
2. Wyświetlić filtr lub filtr dla tego obiektu biznesowego: com.cisag.app.sales.obj.SalesRapidDocument
→ Otworzy się filtr umożliwiający import dokumentów szybkiej rejestracji sprzedaży.
Jeśli to konieczne, należy zduplikować filtr. W razie potrzeby można zmienić wybrane już atrybuty filtra.
3. Na standardowym pasku przycisków należy wybrać przycisk [Importuj dane].
→ Otworzy się okno dialogowe Import danych.
4. W oknie dialogowym Import danych można dokonać ustawień pliku importu. Opis pól znajduje się w artykule Import danych.
5. Po dokonaniu niezbędnych zmian należy wybrać przycisk [W tle].
→ Import zostanie wykonany.
Przegląd atrybutów
Poniżej wymieniono atrybuty poszczególnych obiektów biznesowych, które można zaimportować. W przypadku atrybutów klucza obcego uwzględniana jest również odpowiednia nazwa relacji. Pola identyfikacyjne i obowiązkowe mogą ulec zmianie i można je rozszerzyć poprzez konfigurację. Atrybuty identyfikacyjne (atrybuty kluczowe) są oznaczone literą (K).
Dane podstawowe
Dokumenty szybkiej rejestracji sprzedaży (SalesRapidDocument)
Identyfikacja dokumentu szybkiej rejestracji sprzedaży składa się z rodzaju dokumentu szybkiej rejestracji sprzedaży oraz numeru utworzonego za pomocą schematu numeracji przypisanego do danego rodzaju dokumentu.
| Atrybut | Relacja | Wyjaśnienie |
| afterTransfer | Po przejęciu | |
| autoConfirmWarnings | Automatyczne zatwierdzanie ostrzeżeń | |
| customerData | Informacje w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) | |
| customerOrderData.purchaseOrder | Numer dokumentu zewnętrznego | |
| customerOrderData.date.value | Data dokumentu zewnętrznego | |
| CustomerProposal.Type.code | Rodzaj oferty sprzedaży
|
|
| date | Data wpisu | |
| deliveryCustomerData | Informacje w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) | |
| deliveryData | Informacje w rozdziale Dane dostawy (deliveryData) | |
| discountOriginType | Pochodzenie rabatu
|
|
discounts[0..3]
|
DiscountType | Rabaty od 1 do 4
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży z pozycjami dokumentów, atrybut ten można zmienić poprzez import tylko wtedy, gdy ceny zostaną ustalone z opóźnieniem w zależności od rodzaju dokumentu. |
| guid (K) | Identyfikator techniczny umożliwiający zmianę lub usunięcie danych, które zostały już zapisane, jeśli są znane. | |
| invoiceCustomerData | Informacje w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData) | |
| invoicingData | Informacje w rozdziale Dane faktury (invoicingData) | |
| invoicingPartyData | Informacje w rozdziale Dane organizacji sprzedaży (invoicingPartyData) | |
| number (K) | Numer (identyfikator techniczny).
Obowiązkowe, jeżeli przy wprowadzaniu zmian/usuwaniu danych nie podano identyfikatora Guid. Opcjonalne dla nowych obiektów – w innym razie zostanie ustalony automatycznie. |
|
| payee | PayeePartner | Płatnik
|
| priceDate | Data kalkulacji
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży z pozycjami dokumentów, atrybut ten można zmienić poprzez import tylko wtedy, gdy ceny zostaną ustalone z opóźnieniem w zależności od rodzaju dokumentu. |
|
| priceListing | Lista cenników
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży ten atrybut można zmienić poprzez import wyłącznie, jeśli dokument nie ma powiązanych pozycji. |
|
| priceValidityDate | Data ustalenia ceny
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży z pozycjami dokumentu, ten atrybut można zmienić poprzez import tylko wtedy, gdy ceny zostaną ustalone z opóźnieniem w zależności od rodzaju dokumentu. |
|
| pricingPartnerRelation | Użycie partnera
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży z pozycjami dokumentu, ten atrybut można zmienić poprzez import tylko wtedy, gdy ceny zostaną ustalone z opóźnieniem w zależności od rodzaju dokumentu. |
|
| requestDate.value | Preferowana data | |
| RequestForProposal.Type.code | Rodzaj zapytania ofertowego sprzedaży
|
|
| responsible | ResponsiblePartner | Odpowiedzialny pracownik |
| SalesOrder.Type.code | Rodzaj zamówienia sprzedaży
|
|
| salesRepresentatives[0:2] | SalesRepresentatives | Do trzech przedstawicieli |
| shippingDate | Data wysyłki | |
| storageArea.warehouse | Magazyn
Wskazówka Magazyny można importować tylko w przypadku dokumentów, dla których aktywny jest parametr Wykorzystanie magazynu w zależności od rodzaju dokumentu.[/inidicator] |
|
| targetOrderType | Docelowy rodzaj dokumentu | |
| TextAssignments | Załączniki/Teksty
Informacja w rozdziale Teksty (TextAssignments) |
|
| type (K) | Typ (identyfikator techniczny)
Obowiązkowe, jeżeli przy wprowadzaniu zmian/usuwaniu nie podano identyfikatora Guid. |
Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)
Dane klientów w trzech rolach są przechowywane w bazie danych jako obiekt biznesowy HashCode i prezentowane jako obiekt do eksportu/importu. To samo dotyczy danych adresowych. Analogicznie do nazw atrybutów technicznych, nadano następujące nazwy jednostek:
- customerData Klient
- deliveryCustomerData Odbiorca dostawy
- invoiceCustomerData Odbiorca faktury
Następujące atrybuty występują raz na jedną rolę partnera.
| Atrybut | Relacja | Wyjaśnienie |
| addressData.city | Adres – miasto | |
| addressData.country | addressData.Country | Adres – kraj |
| addressData.district | Adres – rejon | |
| addressData.poBox | Adres – skrytka pocztowa | |
| addressData.poBoxCity | Adres – miasto skrytki pocztowej | |
| addressData.poBoxPostalCode | Adres – kod pocztowy skrytki pocztowej | |
| addressData.postalCode | Adres – kod pocztowy | |
| addressData.region | addressData.Region | Adres – region |
| addressData.street | Adres – ulica | |
| customer | CustomerPartner | Klient |
| name | Nazwa klienta | |
| careOf | CareOfPartner | Opiekun |
| careOfName | Nazwa opiekuna |
Dane dostawy (deliveryData)
Dane dotyczące dostawy są przechowywane w bazie danych jako obiekt biznesowy HashCode i prezentowane jako obiekt do eksportu/importu.
| Atrybut | Relacja | Wyjaśnienie |
| deliveryTerms | DeliveryTerms | Warunki dostawy |
| deliveryTermsLocation | Warunki dostawy z informacją o lokalizacji | |
| shippingTerms | ShippingTerms | Warunki wysyłki |
Dane faktury (invoivingData)
Niektóre dane dotyczące faktur są przechowywane w bazie danych jako obiekt biznesowy HashCode i prezentowane jako obiekt do eksportu/importu.
| Atrybut | Relacja | Wyjaśnienie |
| currency | Currency | Waluta
W przypadku istniejących dokumentów szybkiej rejestracji sprzedaży ten atrybut można zmienić poprzez import tylko wtedy, gdy nie istnieją jeszcze żadne pozycje dokumentu. |
| paymentMethod (Firma) | PaymentMethod | Sposób płatności
|
| paymentTerms (Firma) | PaymentTerms | Warunki płatności
|
Dane organizacji sprzedaży (invoicingPartyData)
Niektóre dane dotyczące organizacji sprzedaży są przechowywane w bazie danych jako obiekt biznesowy HashCode i prezentowane jako obiekt do eksportu/importu.
| Atrybut | Relacja | Wyjaśnienie |
| partner | Partner | Partner
|
| careOf | CareOfPartner | Opiekun |
| careOfName | Nazwa opiekuna |
Teksty (TextAssignments)
| Atrybut | Relacja | Wyjaśnienie |
| code | Element tekstowy (opcjonalny) | |
| document | Dokument | |
| sequence | Numer | |
| text | Teksty według języka
(Używane tylko wtedy, gdy nie określono modułu tekstowego. Informacje w rozdziale Tekst) |
|
| type | Rodzaj tekstu |
Tekst
| Atrybut | Relacja | Wyjaśnienie |
| contentType | Rodzaj zawartości | |
| language | Język | |
| text | Tekst |
Możliwe jest także zastosowanie różnego formatowania tekstów. Jeśli potrzebny jest przykład określonego formatowania, najlepiej utworzyć przykładowy dokument z preferowanym formatowaniem tekstu i wyeksportować go.
Zwykle teksty są importowane z pliku importu, a wszelkie sugerowane wartości z danych podstawowych partnera itp. są ignorowane. Jeśli jednostka ServerProperty com.cisag.app.general.order.bi.applyAllwaysTextDefaults ma wartość true, wówczas sugerowane wartości są zawsze ustalane i łączone z dowolnymi tekstami, które mogą znajdować się w pliku importu. Z jednej strony należy zaznaczyć, że numeracja wierszy tekstu musi być odpowiednio dobrana, a z drugiej strony, że efektem będzie tylko jedna linijka tekstu z tekstem artykułu.
Pozycje dokumentu szybkiej rejestracji sprzedaży (SalesRapidDocumentDetail)
| Atrybut | Relacja | Wyjaśnienie |
| customerItemNumber | Numer artykułu klienta
Dodatkowe informacje znajdują się w artykule Import pozycji dokumentu przy pomocy numeru EAN. |
|
discounts[0..3]
|
|
Rabaty od 1 do 4
|
| ean | European Article Number – Europejski Kod Towarowy
Dodatkowe informacje znajdują się w artykule Import pozycji dokumentu przy pomocy numeru EAN. |
|
grossPrice
|
Currency | Cena brutto
Można używać wyłącznie w przypadku wpływów konsumenckich innych niż detaliczne. |
| guid (K) | Identyfikator techniczny (Pozycja) pozwalający usunąć istniejące dane, jeśli te są znane. | |
| item | Item | Artykuł |
| netCode | Brak rabatów nagłówka
|
|
| number (K) | Numer (identyfikator funkcjonalny).
Obowiązkowy w przypadku nowego elementu, w innym wypadku określany automatycznie. Obowiązkowy, jeśli guid nie został określony podczas zmiany/usuwania. |
|
| noCashDiscountEnabled | Brak zniżki
|
|
| noClassificationDiscounts | Brak rabatów na wszystkie pozycje
|
|
| noOrderValueDiscounts | Brak rabatów od wartości zamówienia
|
|
| priceDimension | Wymiar ceny
|
|
| priceOriginType | Pochodzenie ceny
|
|
| priceUom | PriceUom | Cena jednostkowa
|
| pseudoItemDescription | Opis pseudoartykułów
|
|
retailGrossPrice
|
Currency | Cena brutto z podatkami
Dotyczy tylko dokumentów dla klientów końcowych (patrz także grossPrice) |
| TextAssignments | Załączniki/Teksty
Informacja w rozdziale Teksty (TextAssignments) |
|
| totalQuantity.amount | Całkowita ilość | |
| totalQuantity.uom | Uom | Całkowita ilość w jednostce |
| uomObligation | Obowiązywanie jednostek
|
|
| uomObligationOrigin | Pochodzenie obowiązywania jednostek
|
