Import zleceń dostawy

Niniejsza dokumentacja opisuje instrukcję korzystania z aplikacji Import danych w odniesieniu do reguł dostępności. Instrukcje te zawierają ogólne procedury i funkcje specjalne, które należy wziąć pod uwagę. Użytkownik znajdzie również informacje o możliwych warunkach wstępnych i skutkach.

Opis aplikacji Import danych, który zawiera również opisy pól i przycisków, można znaleźć w dokumentacji Import danych.

Informacje ogólne

Obsługiwany jest tylko import już dostarczonych zleceń dostawy (dowodów dostawy). Interfejs importu obsługuje tworzenie i aktualizowanie zleceń dostawy. Niemniej jednak, aktualizacja zlecenia dostawy za pośrednictwem interfejsu importu jest możliwa tylko wtedy, gdy zlecenie dostawy zostało również utworzone w systemie docelowym za pośrednictwem interfejsu importu. Ponadto, zlecenie dostawy nie może być w międzyczasie zmieniane ani dalej przetwarzane.

W przypadku importu nie jest konieczne, aby w systemie docelowym znajdowały się odpowiednie zlecenia źródłowe. Jeśli zlecenia źródłowe są dostępne w systemie docelowym, zlecenie dostawy może być dalej przetwarzane po pomyślnym zaimportowaniu. Utworzone zostaną wpisy łańcucha dokumentów powiązanych. Jeśli tak nie jest, nie są tworzone żadne pozycje łańcucha dokumentów powiązanych, a zlecenie dostawy nie może być dalej przetwarzane w systemie docelowym.

Import jednostek ładunkowych w ramach importu zlecenia dostawy, analogicznie do powiadomienia o wysyłce, nie jest obsługiwany.

Import zleceń dostawy z produkcji obcej i zleceń dystrybucji nie jest obsługiwany.

Zlecenie dostawy odwołuje się do tak zwanych obiektów biznesowych hashCode w bazie. Są to technicznie powiązane grupy atrybutów, które są zawsze takie same dla wielu zleceń, a zatem oszczędzają miejsce w bazie danych i pamięci głównej poprzez ponowne wykorzystanie. Za pomocą specjalnej konwersji, obiekty biznesowe hashCode są prezentowane jako części do eksportu lub importu.

Niektóre dane zlecenia dostawy, takie jak ustawienia wydruku dokumentu i wewnętrzne atrybuty pomocnicze, nie są obsługiwane podczas importu.

Wskazówka
Jeśli użytkownik nie jest pewien, który format jest odpowiedni dla pliku importu, powinien on wykonać następujące czynności. Należy wyeksportować zlecenie dostawy z filtrem dla importu (sic) w żądanym formacie z żądanymi atrybutami. Powstały plik przykładowy może być użyty jako szablon dla generowanych plików importu.
Struktura zlecenia dostawy

Zlecenie dostawy składa się z podstawy zlecenia, zwanej dalej danymi podstawowymi, oraz n pozycji dostawy, zwanych dalej danymi pozycji. Pozycje dostawy, których artykuł posiada specyfikację, odnoszą się również do m obiektów danych specyfikacji. m to liczba różnych specyfikacji na pozycję dostawy. Pozycja zlecenia dostawy jest powiązana ze zleceniem źródłowym za pomocą obiektu danych zlecenia źródłowego.

  • Dane podstawowe – rodzaj i numer zlecenia dostawy itp.
  • Dane artykułu – numer pozycji, artykuł, ilość, magazyn wydań itp.
  • Dane specyfikacji (jeśli dotyczy) – nadany numer, artykuł, specyfikacja, ilość, magazyn wydań itp.
  • Dane zlecenia źródłowego – rodzaj i numer zlecenia, typ zlecenia, dane klienta, rabaty itp.

Dane pozycji, dane specyfikacji i dane zlecenia źródłowego nie mogą być importowane oddzielnie, ale tylko z przyporządkowaniem do wyraźnie określonej podstawy zlecenia.

Procedury

Zalecane jest zapoznanie się z poniższym sekcjami, aby dowiedzieć się, jakie wymagania należy spełnić w celu zaimportowania zlecenia dostawy i właściwej pracy z aplikacją Import danych:

  • Atrybuty wymagane do importu
  • Import zleceń dostawy

Atrybuty wymagane do importu

Użytkownik wprowadza przynajmniej następujące atrybuty dla każdego zlecenia dostawy:

  • Atrybuty identyfikacyjne
  • Atrybuty obowiązkowe

Zlecenie dostawy nie może zostać utworzone bez atrybutów identyfikacyjnych. Jeśli brakuje obowiązkowego pola, nie można zaimportować zlecenia dostawy.

Niektóre atrybuty identyfikacyjne i obowiązkowe można określić za pomocą relacji kluczy obcych (oznaczone kursywą w filtrze). Atrybuty te nie są częścią zlecenia dostawy. Jednostki biznesowe, do których odwołują się relacje klucza obcego, są identyfikowane przez ich atrybuty identyfikacyjne. Nie można ich zaimportować za pomocą importu zleceń dostawy, gdyż muszą być już wcześniej zaimportowane. Atrybuty identyfikacyjne i obowiązkowe danych podstawowych oraz danych pozycji zostały wymienione w sekcji Przegląd: Pola identyfikacyjne i obowiązkowe. Inne ważne pola zostały opisane w sekcji Przegląd: Inne ważne pola.

Import zleceń dostawy

  1. Pierwszym krokiem jest uruchomienie aplikacji Import danych.
  2. Następnie należy wyświetlić obiekt biznesowy poprzez filtr com.cisag.app.sales.obj.ShippingOrder.
  • Wyświetlony zostanie filtr importu zleceń dostawy.
  1. Wybrane atrybuty filtra zostały już podświetlone. W razie potrzeby, użytkownik nadal może dostosować atrybuty.
  2. Należy wybrać przycisk [Import danych], znajdujący się na standardowym pasku przycisków.
  • Otworzy się okno dialogowe Import danych.
  1. W tym oknie dialogowym można dokonać ustawień pliku importu. Szczegółowy opis pól można znaleźć w dokumentacji Import danych w sekcji o tej samej nazwie.
  2. Import można przeprowadzić, naciskając przycisk [W tle] lub [Natychmiast].

Przegląd: Pola identyfikacyjne i obowiązkowe

Atrybuty identyfikacyjne i obowiązkowe zostały wymienione i opisane poniżej.

Dane podstawowe

Ścieżka atrybutu Relacja klucza obcego / część / możliwe wartości Oznaczenie
number Identyfikator zlecenia dostawy
type Type Identyfikator typu zlecenia dostawy
deliverySlipNumber Numer dowodu dostawy Pole obowiązkowe, jeśli status nie jest NOT_DELIVERED
invoicingParty Organizacja sprzedaży
deliveryPartnerData Organizacja logistyki magazynowej, zobacz Dane partnera zlecenia (deliveryPartnerData)
customerData Dane klienta, zobacz Dane klienta (customerData)
deliveryData Dane dostawy, zobacz Dane dostawy (deliveryData)
invoiceRecepient InvoiceRecepient Odbiorca faktury
documentRecipient DocumentRecepient Odbiorca dowodu dostawy
documentRecipientName Nazwa odbiorcy dowodu dostawy
documentRecipientAddressData Adres odbiorcy dowodu dostawy, zobacz Dane adresowe (addressData)
status NOT_DELIVERED = nie dostarczonoCANCELED = anulowane

DELIVERED = dostarczony

INVOICED = zafakturowany

INVOICED_PARTIAL = częściowo zafakturowane

Status zlecenia dostawy
shippingStatus NONE = nie załadowano ani nie wysłanoLADED = załadowany

WYSŁANE = wysłane

Status ładowania(obsługiwane tylko wtedy, gdy funkcja Ładunki dla organizacji logistyki magazynowej została aktywowana w aplikacji Konfiguracja)
packingStatus NOT_PACKED = niezapakowanyPARTIALLY_PACKED = częściowo zapakowany

COMPLETELY_PACKED = całkowicie zapakowany

Status opakowania(obsługiwane tylko wtedy, gdy funkcja Jednostki ładunkowe dla organizacji logistyki magazynowej została aktywowana w aplikacji Konfiguracja)
heldStatus NONE = dostępne do fakturowaniaHELD_PARTIAL = częściowo zablokowane do fakturowania

HELD = zablokowane do fakturowania

Status blokady (na potrzeby fakturowania)
data Data dokumentu
kindOfPricing GROSS = BruttoNET = Netto Prezentacja ceny
triggerOfCreation SALES_ORDER = zamówienie sprzedażyDISTRIBUTION_ORDER = zlecenie dystrybucji

RETURN_OF_GOODS = zwrot towarów

EXTERNAL_PRODUCTION =

produkcja obca

Pochodzenie zlecenia dostawy
outputMethod.medium PRINTER = drukarkaEMAIL = e-mail

FAX = faks

Medium wydania dla wydruku zgodnie z szablonem dokumentu. Atrybut obowiązkowy, jeśli ma zostać wydrukowana kopia dowodu dostawy.
Dane partnera zlecenia (deliveryPartnerData)

Dane partnera zlecenia są przechowywane w bazie danych jako obiekt biznesowy hashCode i są wyświetlane jako część do eksportu/importu.

Atrybut Relacja Oznaczenie
addressData Dane adresowe, zobacz Dane adresowe (addressData)
partner Partner Partner zlecenia
name Nazwa partnera
careOf CareOfPartner Dla uwagi
careOfName Dla uwagi Imię i nazwisko
Dane klienta (customerData)

Dane klienta są przechowywane w bazie danych jako obiekt biznesowy hashCode i są wyświetlane jako część do eksportu/importu.

Atrybut Relacja Oznaczenie
addressData Dane adresowe, zobacz Dane adresowe (addressData)
customer CustomerPartner Klient
name Nazwa klienta
careOf CareOfPartner Dla uwagi
careOfName Dla uwagi Imię i nazwisko
Dane adresowe (addressData)

Dane adresowe są przechowywane w bazie danych jako obiekt biznesowy hashCode i są wyświetlane jako część do eksportu/importu.

Atrybut Relacja Oznaczenie
city Lokalizacja
country Country Kraj
district Okręg
poBox Skrytka pocztowa
poBoxCity Lokalizacja skrytki pocztowej
poBoxPostalCode Kod pocztowy skrytki pocztowej
postalCode Kod pocztowy
region Region Region
street Ulica
Dane dostawy (deliveryData)

Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy hashCode i są wyświetlane jako część do eksportu/importu.

Atrybut Relacja Oznaczenie
deliveryTerms DeliveryTerms Warunki dostawy
deliveryTermsLocation Warunki dostawy – odniesienie do lokalizacji
deliveryPriority Priorytet dostawy
deliveryRestriction Ograniczenie dostawy
shippingTerms ShippingTerms Warunki wysyłki

Dane zlecenia źródłowego

Dane zlecenia źródłowego są powiązane z danymi bazowymi poprzez relację OrderInfos. Ścieżka atrybutu wszystkich kolejnych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od prefiksu OrderInfos. Prefiks ten nie jest określony w lewej i środkowej kolumnie poniższej tabeli ze względu na brak miejsca.

Ścieżka atrybutu Relacja klucza obcego / możliwe wartości /.Part Oznaczenie
orderType Rodzaj zlecenia
orderNumber Numer zlecenia
orderDate Data zlecenia
customerAdressData Dane adresowe, zobacz Dane adresowe (addressData)
customer CustomerPartner Klient
pricingPartner.number Partner do ustalania cen

Dane pozycji

Pozycje są powiązane z danymi podstawowymi poprzez relację Details. Ścieżka atrybutu wszystkich poniższych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od prefiksu Details. Prefiks ten nie jest używany w lewej i środkowej kolumnie poniższej tabeli ze względu na brak miejsca.

Ścieżka atrybutu Relacja klucza obcego / możliwe wartości Oznaczenie
number Numer pozycji
subNumber Numer pozycji komponentu – 0, jeśli pozycja główna
item Item Artykuł
warehouse.warehouse Magazyn wydań
status NOT_DELIVERED = nie dostarczoneCANCELED = anulowane

DELIVERED = dostarczone

INVOICED = zafakturowane

INVOICED_PARTIAL = częściowo zafakturowane

Status pozycji
heldStatus NONE = udostępnione do fakturowaniaHELD_PARTIAL = częściowo zablokowane do fakturowania

HELD = zablokowane do fakturowania

Stan blokady
packingStatus NOT_PACKED = niepakowanePARTIALLY_PACKED = częściowo zapakowane

COMPLETELY_PACKED = całkowicie zapakowane

Status opakowania(obsługiwane tylko wtedy, gdy funkcja Jednostki ładunkowe dla organizacji logistyki magazynowej została aktywowana w aplikacji Konfiguracja)
additionalPosition ADDITIONAL_POS_NONE = brak dodatkowej pozycjiADDITIONAL_POS_INVOICEABLE = dodatkowa pozycja do zafakturowania

ADDTIONAL_POS_NOT_INVOICEABLE = dodatkowa pozycja, która nie może zostać zafakturowana

EMPTIES = pozycja pusta

Oznaczenie dodatkowej pozycji
order.type SALES_ORDER = zamówienie sprzedażyDISTRIBUTION_ORDER = zlecenie dystrybucji

PURCHASE_ORDER = zamówienie zakupu

Typ zlecenia dla zlecenia źródłowego
order.orderType Rodzaj zlecenia dla zlecenia źródłowego
order.number Numer zlecenia
order.detailNumber Numer pozycji
order.subNumber Szczegółowy numer pozycji
owner Owner Właściciel zapasów
taxCode TaxCode Klucz podatkowy
detailType NORMAL = normalnyFIXED_KIT = główna pozycja zestawu stałych

VARIABLE_KIT = główna pozycja zestawu zmiennych

REBATE_IN_KIND = rabat rzeczowy

CONFIGURATION_DETAIL = pozycja konfiguracji

Rodzaj pozycji
priceDimension PER_UNIT = proPER_10_UNITS = na 10

PER_100_UNITS = na 100

PER_1000_UNITS = na 1000

PER_10000_UNITS = na 10000

PER_100000_UNITS = na 100000

Wymiar ceny
priceUom Details.PriceUom Jednostka wymiaru ceny
priceRelevant Wymagane obliczenie ceny

Dane specyfikacji

Dane specyfikacji są powiązane z danymi pozycji poprzez relację identifiers. Ścieżka atrybutu wszystkich kolejnych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od następującego prefiksu:

Details.identifiers.

Prefiks ten nie jest wyświetlany w lewej i środkowej kolumnie poniższej tabeli.

Ścieżka atrybutu Relacja klucza obcego / możliwe wartości Oznaczenie
number Kolejny numer specyfikacji
item Item Artykuł
identifier Identifier Specyfikacja
warehouse.warehouse Magazyn wydań
type DELIVERY_SLIP = Zlecenie dostawy Typ zlecenia
owner Owner Właściciel zapasów

Przegląd: Inne ważne pola

Dodatkowe pola są zwykle wymagane do zaimportowania zlecenia dostawy w celu utworzenia danego zlecenia dostawy. Jeśli brakuje tych pól, to powiązane atrybuty są wypełniane (mniej lub bardziej) znaczącymi wartościami domyślnymi:

  • Wszystkie kwoty i ilości, które nie zostały wprowadzone, mają wartość 0.
  • Jednostki są ustawione zgodnie z artykułem.
  • Kombinacja walut jest ustawiona zgodnie z definicją dla organizacji logistyki magazynowej.
  • Waluta obca jest pobierana z dokumentu źródłowego, jeśli jest tam zdefiniowana. Jeśli nie można określić wartości domyślnej za pomocą dokumentu źródłowego, wówczas podejmowana jest próba przeniesienia waluty obcej z wartości brutto lub wartości netto danych podstawowych.
  • Atrybuty logiczne są ustawiane na FALSE, jeśli nie zostały określone.

Poniżej opisano inne ważne pola, które nie są obowiązkowe, ale zazwyczaj są niezbędne.

Opis części ForeignAmount i DomesticAmount można znaleźć w sekcji Atrybuty walut. Opis części Quantity można znaleźć w sekcji Atrybuty ilości.

Dane podstawowe

Ścieżka atrybutu Część Oznaczenie
taxInfo[x].netAmount ForeignAmount Netto przed opodatkowaniem dla klucza podatkowego x
taxInfo[x].netAmountDomestic DomesticAmount Netto przed opodatkowaniem w walucie lokalnej dla klucza podatkowego x
taxInfo[x].taxCode Kod podatkowy x
taxInfo[x].taxAmount ForeignAmount Kwota podatku dla klucza podatkowego x
taxInfo[x].taxAmountDomestic DomesticAmount Kwota podatku dla klucza podatkowego x w walucie lokalnej
grossValue ForeignAmount Wartość brutto
grossValueDomestic DomesticAmount Wartość brutto w walucie lokalnej
netValue ForeignAmount Wartość netto
netValueDomestic DomesticAmount Wartość netto w walucie lokalnej
openGrossValue ForeignAmount Wartość brutto ilości do zafakturowania
openGrossValueDomestic DomesticAmount Wartość brutto ilości do zafakturowania w walucie lokalnej
openNetValue ForeignAmount Wartość netto ilości do zafakturowania
openNetValueDomestic DomesticAmount Wartość netto ilości do zafakturowania w walucie lokalnej
GrossWeight Quantity Aktualna waga brutto
netWeight Quantity Aktualna waga netto
totalGrossWeight Quantity Waga brutto ilości docelowej
totalNetWeight Quantity Masa netto ilości docelowej
reportedGrossWeight Quantity Waga brutto pobranej ilości
reportedNetWeight Quantity Waga netto pobranej ilości
actualGrossWeight Quantity Waga brutto dostarczonej ilości
actualNetWeight Quantity Waga netto dostarczonej ilości
grossVolume Quantity Bieżący wolumen brutto
netVolume Quantity Bieżący wolumen netto
totalGrossVolume Quantity Wolumen brutto ilości docelowej
totalNetVolume Quantity Wolumen netto ilości docelowej
reportedGrossVolume Quantity Wolumen brutto pobranej ilości
reportedNetVolume Quantity Wolumen netto pobranej ilości
actualGrossVolume Quantity Wolumen brutto dostarczonej ilości
actualNetVolume Quantity Wolumen netto dostarczonej ilości
cashDiscountBase ForeignAmount Podstawa obliczania terminu płatności
cashDiscountBaseDomestic DomesticAmount Podstawa obliczania terminu płatności w walucie lokalnej
cashDiscountValues.value ForeignAmount Kwota rachunku gotówkowego
cashDiscountValues.valueDomestic DomesticAmount Kwota rachunku gotówkowego w walucie lokalnej
outputMethod.mediumAddress Połączenie komunikacyjne

Dane pozycji

Pozycje są powiązane z danymi podstawowymi poprzez relację Details. Ścieżka atrybutu wszystkich poniższych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od prefiksu Details. Prefiks ten nie jest używany w lewej i środkowej kolumnie poniższej tabeli ze względu na brak miejsca.

Ścieżka atrybutu Część Oznaczenie
totalQuantity Quantity Docelowa ilość w jednostce zlecenia
totalQuantities[x] Quantity Docelowa ilość w jednostce zarządzania zapasami
reportedQuantity Quantity Ilość do kompletacji w jednostce zlecenia
reportedQuantities[x] Quantity Ilość do kompletacji w jednostkach zarządzania zapasami artykułu
packedQuantities[x] Quantity Zapakowana ilość w jednostkach zarządzania zapasami artykułu
grossPrice ForeignAmount Cena brutto
grossPriceDomestic DomesticAmount Cena brutto w walucie lokalnej
netPrice ForeignAmount Cena netto
netPriceDomestic DomesticAmount Cena netto w walucie lokalnej
grossValue ForeignAmount Kwota brutto
grossValueDomestic DomesticAmount Kwota brutto w walucie lokalnej
netValue ForeignAmount Kwota netto pomniejszona o rabaty podstawowe i na pozycję
netValueDomestic DomesticAmount Kwota netto pomniejszona o rabaty podstawowe i na pozycję w walucie lokalnej
netDetailValue ForeignAmount Kwota netto pomniejszona o rabaty na pozycje
netDetailValueDomestic DomesticAmount Kwota netto pomniejszona o rabaty na pozycje w walucie lokalnej
headerDiscountValues[x].value ForeignAmount Rabaty podstawowe
headerDiscountValues[x].valueDomestic DomesticAmount Rabaty podstawowe w walucie lokalnej
detailDiscountValues[x].value ForeignAmount Rabaty na pozycje
detailDiscountValues[x].valueDomestic DomesticAmount Rabaty na pozycje w walucie lokalnej
taxValue ForeignAmount Kwota podatku
taxValueDomestic DomesticAmount Kwota podatku w walucie lokalnej
pseudoItemDescription Pseudooznaczenie artykułu1
orderedPseudoItemDescription Oznaczenie zamówionego artykułu1

Dane specyfikacji

Dane specyfikacji są powiązane z danymi pozycji poprzez relację identifiers. Ścieżka atrybutu wszystkich kolejnych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od następującego prefiksu Details.identifiers.

Prefiks ten nie jest wyświetlany w lewej i środkowej kolumnie poniższej tabeli.

Ścieżka atrybutu Część Oznaczenie
totalQuantity Quantity Docelowa ilość w jednostce zlecenia
totalQuantities[x] Quantity Docelowa ilość pozycji w jednostkach zarządzania zapasami
reportedQuantity Quantity Pobrana ilość w jednostce zlecenia
reportedQuantities[x] Quantity Wybrana ilość w jednostkach zarządzania zapasami artykułu
packedQuantities[x] Quantity Zapakowana ilość w jednostkach zarządzania zapasami artykułu
fixedQuantities[x] Quantity Stała zarezerwowana ilość w zleceniu źródłowym

Dane zlecenia źródłowego

Dane zlecenia źródłowego są powiązane z danymi pozycji poprzez relację OrderInfo. Ścieżka atrybutu wszystkich kolejnych atrybutów lub specyfikacja relacji klucza obcego musi zatem zaczynać się od następującego prefiksu:

Details.OrderInfo.

Prefiks ten nie jest wyświetlany w lewej i środkowej kolumnie poniższej tabeli ze względu na brak miejsca.

Ścieżka atrybutu Relacja klucza obcego / możliwe wartości /.Part Oznaczenie
discounts[x] SalesDiscountUse Podstawowe rabaty / dopłaty
headerDiscountValues[x].value ForeignAmount Wartość rabatu podstawowego dla ilości dostarczonej
headerDiscountValues[x].valueDomestic DomesticAmount Wartość rabatu podstawowego dla ilości dostarczonej w walucie lokalnej
detailDiscountValues.value ForeignAmount Wartość rabatu pozycji
detailDiscountValues.valueDomestic DomesticAmount Wartość rabatu pozycji w walucie lokalnej

Atrybuty ilości

Wszystkie ilości są określone jako wartość liczbowa i jednostka. Ilości muszą być importowane za pomocą części Ilość.

Ilość (Quantity)
Ścieżka atrybutu Relacja klucza obcego Oznaczenie
amount Wartość
uom Uom Jednostka

Atrybuty waluty

Wszystkie wartości zlecenia dostawy są określone (albo) w walucie obcej i (albo) w walucie lokalnej. Należy je zaimportować za pomocą części ForeignAmount lub DomesticAmount.

Waluta obca (ForeignAmount)

Ścieżka atrybutu Relacja klucza obcego Oznaczenie
amount Wartość
currency Currency Waluta

Waluta krajowa (DomesticAmount)

Ścieżka atrybutu Relacja klucza obcego Oznaczenie
amount1 Wartość1
amount2 Wartość2
amount3 Wartość3
exact Bit 0-1 = Dokładna wartość w:

1=Waluta 1

2=Waluta 2

3=Waluta 3

0 = brak dokładnej wartości

Bit 3-8 = kombinacja waluty

[1] Jeśli nie jest to pseudoartykuł, wpis jest ignorowany.

Czy ten artykuł był pomocny?