Artykuł opisuje instrukcje korzystania z aplikacji Import danych w odniesieniu do faktur sprzedaży.
Zawiera informacje o możliwych warunkach wstępnych, skutkach i ograniczeniach.
Informacje ogólne
Import faktur sprzedaży umożliwia tworzenie i aktualizowanie faktur sprzedaży, przy czym aktualizacja jest jednak możliwa tylko wtedy, gdy faktura sprzedaży została również utworzona w systemie docelowym za pomocą importu.
Zakłada się również, że faktura sprzedaży nie została w międzyczasie zmieniona ani przetworzona.
Faktury sprzedaży z dokumentu gotówkowego nie mogą być importowane.
Nie jest konieczne, aby import miał odpowiednie zamówienia źródłowe w systemie docelowym. Natomiast, jeśli zamówienia źródłowe istnieją w systemie docelowym generowane są wpisy łańcucha dokumentów powiązanych.
Jeśli plik importu zawiera tylko atrybuty obowiązkowe i identyfikacyjne generowana jest faktura zerowa.
Struktura faktury sprzedaży
Faktura sprzedaży składa się z nagłówka i pozycji:
- Dane nagłówka: Rodzaj i numer faktury sprzedaży itp.
 - Dane pozycji: Numer pozycji, artykuł, ilość, cena itp.
 
Danych pozycji nie można importować osobno. Jest to możliwe wyłącznie w odniesieniu do faktury, która została wyraźnie zidentyfikowana przez dane podstawowe.
Instrukcja: Import faktur sprzedaży
Aby zaimportować faktury sprzedaży, należy:
- Otworzyć aplikację Import danych.
 - Wyświetlić filtr dla obiektu biznesowego:
 
com.cisag.app.sales.obj.CustomerInvoice
→Otwarty zostanie filtr importu faktur sprzedaży.
- Zduplikować lub utworzyć nowy filtr dla tego obiektu biznesowego, jeśli jest to potrzebne.
 - W razie potrzeby zmienić już wybrane atrybuty filtra.
 - Nacisnąć przycisk [Import danych] na standardowym pasku narzędzi.
→Otworzy się okno dialogowe Import danych. - W oknie dialogowym Import danych można dokonać ustawień pliku importu. Opis pól znajduje się w dokumentacji Import danych.
 - Nacisnąć przycisk [W tle]
 
→Import zostanie wykonany.
Wymagania wstępne:
Muszą zostać zdefiniowane atrybuty importu. W tym celu należy wybrać co najmniej następujące atrybuty dla każdej faktury sprzedaży:
- Atrybuty identyfikacyjne
 - Atrybuty obowiązkowe
 
Bez atrybutów identyfikacyjnych faktura sprzedaży nie może zostać wygenerowana w systemie. Jeśli brakuje danych w polu obowiązkowym, faktura sprzedaży nie może zostać zaimportowana.
Niektóre atrybuty identyfikacyjne i obowiązkowe można określić za pomocą relacji klucza obcego (rozpoznawalne przez kursywę w filtrze). Atrybuty te nie są częścią faktury sprzedaży . Obiekty biznesowe, do których odwołują się są identyfikowane przez ich atrybuty identyfikacyjne. Nie można ich zaimportować za pomocą importu faktur sprzedaży: muszą już istnieć. Atrybuty identyfikacyjne i obowiązkowe atrybuty danych podstawowych i pozycji zostały podsumowane w rozdziale Przegląd: Identyfikacja i atrybuty obowiązkowe. Pozostałe istotne pola zostały opisane w rozdziale Przegląd: Pozostałe istotne atrybuty.
Przegląd: Identyfikacja i atrybuty obowiązkowe
Poniżej wymieniono wymagane atrybuty poszczególnych obiektów biznesowych.
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 przez konfigurację.
Atrybuty identyfikacyjne (atrybuty klucza) są oznaczone literą (K).
Dane podstawowe
| Ścieżka atrybutu | Relacja klucza obcego/ Powiązanie/ Możliwe wartości | Opis | 
| Number (K) | Identyfikacja faktury sprzedaży | |
| Type (K) | Type | 
 Identyfikacja rodzaju faktury sprzedaży Wskazówka W przypadku faktury dla konsumenta końcowego, funkcja Ceny klienta końcowego musi być aktywowana w Konfiguracji.  | 
| customer | CustomerPartner | 
 Odbiorca faktury Wskazówka W przypadku faktury dla konsumenta końcowego, klient musi być konsumentem końcowym.  | 
| invoicingParty | InvoicingParty | Płatnik | 
| status | 
 CANCELED = anulowana COMPLETED = nieanulowana INVALID = nieważna  | 
Status faktury | 
| data | Data dokumentu | |
| valuationDate | Data waluty | |
| paymentMethod | PaymentMethod | Metoda płatności | 
| paymentTerms | PaymentTerms | Warunki płatności | 
| paymentStatus | 
 NONE = niezapłacone PARTIAL = częściowo zapłacone COMPLETE = nie zapłacono  | 
Status płatności | 
| kindOfPricing | 
 GROSS = brutto, NET = netto  | 
Reprezentacja ceny | 
| currency | Currency | Waluta | 
| positionSorting | 
 COMPANY = według ustawień w Konfiguracji ORDER = zgodnie z zamówieniami DELIVERYSLIP = zgodnie z dokumentami dostawy  | 
Sortowanie pozycji | 
| triggerOfCreation | 
 SALES_ORDER = zamówienie sprzedaży DISTRIBUTION_ORDER = zlecenie dystrybucji INVENTORY_TRANSACTION = transakcja magazynowa  | 
Pochodzenie faktury sprzedaży | 
| outputMethod.medium | 
 PRINTER = Drukarka EMAIL = E-mail FAX = Faks EDI = EDI FILE = Plik  | 
Nośnik wyjściowy | 
| 
 outputMethod. mediumAddress  | 
 Adres nośnika (adres e-mail, nazwa drukarki itp.)  | 
Dane faktury
Dla każdego zamówienia źródłowego faktury sprzedaży należy zaimportować obiekt danych faktury:
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| OrderInfo.orderType | Rodzaj zamówienia źródłowego | |
| OrderInfo.orderNumber | 
 Numer zamówienia źródłowego  | 
Relacje między zamówieniami
Jeśli faktura sprzedaży dotyczy fakturowania jednego lub więcej zamówień dostawy i te relacje dokumentów mają być widoczne w łańcuchu dokumentów w systemie docelowym, te relacje zamówień muszą zostać zaimportowane.
W tym celu należy określić następujące atrybuty.
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| 
 OrderReferences.shippingOrder.number  | 
Numer dowodu dostawy | |
| 
 OrderReferences.shippingOrder.type  | 
Rodzaj zlecenia dostawy | 
Dane pozycji
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Opis | 
| 
 Details.number (K)  | 
Numer pozycji | |
| 
 Details.subNumber (K)  | 
Numer elementu -0, jesli to element podstawowy | |
| 
 Details.ean  | 
 Europejski numer artykułu (EAN) Więcej informacji można znaleźć w dokumentacji: Importowanie pozycji przy użyciu numeru EAN  | 
|
| 
 Details.item  | 
Details.Item | Artykuł | 
| 
 Details.quantity.amount  | 
Ilość | |
| 
 Details.quantity.uom  | 
Details.quantity.Uom | Jednostka miary | 
| 
 Details.taxCode  | 
Details.TaxCode | Kod podatkowy | 
| 
 Details.detailType  | 
 NORMAL = Normalny FIXED_KIT = Główny element stałego zestawu VARIABLE_KIT = Główny element zmiennego zestawu REBATE_IN_KIND = Rabat naturalny CONFIGURATION_DETAIL = element konfiguracji  | 
Rodzaj pozycji | 
| 
 Details.priceDimension  | 
 PER_UNIT = na 1 PER_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 | 
| 
 Details.priceUom  | 
Details.PriceUom | Jednostka dla wymiaru ceny | 
| 
 Details.itemPriceClasification  | 
 Klasyfikacja ceny pozycji Klasyfikacja musi być określona, jeśli rabaty między pozycjami są obliczane dla pozycji.  | 
|
| 
 Details.deliveryCustomer 
  | 
 Details.DeliveryCustomer  | 
Odbiorca dostawy | 
| 
 Details.referenceOrder.orderType 
  | 
Rodzaj zamówienia źródłowego | |
| 
 Details.referenceOrder.orderNumber  | 
 Numer zamówienia źródłowego  | 
|
| 
 Details.referenceOrder.detailNumber  | 
Numer pozycji zamówienia zamówienia źródłowego | |
| 
 Details.referenceOrder.subDetailNumber  | 
Numer pozycji szczegółowej zamówienia źródłowego | |
| 
 Details.retailNetValueForeignAmount  | 
 Całkowita kwota netto (w tym podatki) Wskazówka To pole jest obowiązkowe dla faktur dla klientów końcowych.  | 
Poniższa tabela zawiera obowiązkowe pola, które należy również wprowadzić w przypadku faktur dla klientów końcowych.
| Ścieżka atrybutu | Relacja klucza obcego/możliwe wartości | Nazwa | 
| 
 Details.retailNetValue  | 
ForeignAmount | 
 Całkowita kwota netto (w tym podatki)  | 
| Details.netValue | ForeignAmount | 
 Kwota netto Wskazówka Jeśli kwota netto nie jest określona, jest ona automatycznie obliczana jako różnica między całkowitą kwotą netto w tym podatkami a kwotą podatku.  | 
| Details.taxValue | ForeignAmount | 
 Kwota podatku Wskazówka Jeśli kwota podatku nie jest określona, jest ona automatycznie obliczana jako różnica między całkowitą kwotą netto, w tym podatkami, a kwotą netto.  | 
Relacje między zamówieniami
Jeśli faktura sprzedaży dotyczy fakturowania jednego lub więcej zleceń dostawy i jeśli relacje dokumentów mają być widoczne w systemie docelowym w łańcuchu dokumentów, muszą także zostać zaimportowane.
W tym celu należy określić następujące atrybuty.
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| 
 Details.OrderReferencesces. shippingOrderDetail.orderType  | 
 Rodzaj zlecenia wysyłki  | 
|
| 
 Details.OrderReferencesces. shippingOrderDetail.orderNumber  | 
Numer dokumentu dostawy | |
| 
 Details.orderReferences. shippingOrderDetail.detailNumber  | 
Numer pozycji | |
| 
 Details.OrderReferences. shippingOrderDetail.subDetailNumber  | 
Numer pozycji szczegółowej | 
Przegląd: Pozostałe istotne atrybuty
Dodatkowe dane są zwykle wymagane do zaimportowania faktury sprzedaży w celu utworzenia „znaczącej” faktury sprzedaży . Jeśli brakuje tych danych, powiązane atrybuty są wypełniane wartościami domyślnymi. Na przykład wszystkie kwoty faktur, które nie zostały określone, mają wartość 0. Inne ważne pola zostały opisane poniżej,
Dane podstawowe
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| taxInfo[x].netAmount | ForeignAmount | 
 Netto przed opodatkowaniem dla kodu podatkowego x. Wskazówka Dane nie mogą być określone dla faktur klientów końcowych.  | 
| 
 taxInfo[x].netAmountDomestic  | 
DomesticAmount | 
 Netto przed opodatkowaniem w walucie lokalnej dla kodu podatkowego x. Wskazówka Dane nie mogą być określone dla faktur klientów końcowych.  | 
| taxInfo[x].taxCode | Kod podatkowy x | |
| taxInfo[x].taxAmount | ForeignAmount | 
 Kwota podatku dla kodu podatkowego x. Wskazówka Dane nie mogą być określone dla faktur klientów końcowych.  | 
| 
 taxInfo[10].taxAmountDomestic  | 
DomesticAmount | 
 Kwota podatku dla klucza podatkowego x w walucie lokalnej. Wskazówka Dane nie mogą być określone dla faktur klientów końcowych.  | 
| 
 grossAmount  | 
ForeignAmount | 
 Kwota brutto  | 
| 
 grossAmountDomestic  | 
DomesticAmount | 
 Kwota brutto w walucie lokalnej  | 
| 
 netAmount  | 
ForeignAmount | 
 Kwota netto Wskazówka Wartość jest określana automatycznie dla faktury klienta końcowego i nie może być określona w pliku importu.  | 
| 
 netAmountDomestic  | 
DomesticAmount | 
 Kwota netto w walucie lokalnej Wskazówka Wartość jest określana automatycznie dla faktury klienta końcowego i nie może być określona w pliku importu.  | 
Dane pozycji
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| Details.grossPrice | ForeignAmount | Cena brutto | 
| 
 Details.grossPriceDomestic  | 
DomesticAmount | Cena brutto w walucie lokalnej | 
| Details.netPrice | ForeignAmount | Cena netto | 
| 
 Details.netPriceDomestic  | 
DomesticAmount | Cena netto w walucie lokalnej | 
| Details.grossValue | ForeignAmount | Kwota brutto | 
| 
 Details.grossValueDomestic  | 
DomesticAmount | Kwota brutto w walucie lokalnej | 
| 
 Details.netValue  | 
ForeignAmount | Kwota netto pomniejszona o rabaty nagłówka i rabaty pozycji | 
| 
 Details.netValueDomestic  | 
DomesticAmount | Kwota netto pomniejszona o rabaty nagłówka i pozycji w walucie lokalnej. | 
| 
 Details.netDetailValue  | 
ForeignAmount | Kwota netto pomniejszona o rabaty nagłówka i pozycji. | 
| 
 Details.netDetailValue.Domestic  | 
DomesticAmount | 
 Kwota netto pomniejszona o rabaty pozycji w walucie lokalnej  | 
| 
 Details.taxRate  | 
Stawka podatku | |
| 
 Details.taxValue  | 
ForeignAmount | Kwota podatku | 
| 
 Details.taxValueDomestic  | 
DomesticAmount | Kwota podatku w walucie lokalnej | 
| 
 Details.statisticRelevant  | 
true/false | 
 Jeśli pozycje faktur sprzedaży mają być uwzględnione w raporcie statystycznym, to pole musi być ustawione na wartość „true”. Należy pamiętać, że przygotowanie danych statystycznych spowoduje błąd, jeśli artykuł pozycji faktury nie jest pozycją artykułem sprzedaży.  | 
| 
 Details.quantities[x].amount  | 
Ilość jednostki miary x | 
 Pola te są brane pod uwagę podczas przygotowywania raportów statystycznych. Należy je określić, jeśli Details.statisticRelevant ma wartość „true”.  | 
| 
 Details.quantities[x].uom  | 
Details.quantity.Uom | 
 Jednostka miary x. Te dane są brane pod uwagę podczas przygotowywania raportów statystycznych. Należy je określić, jeśli Details.statisticRelevant ma wartość „true”.  | 
Atrybuty wymienione w poniższej tabeli są istotne tylko dla faktur użytkownika końcowego.
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| 
 Details.retailGrossPrice  | 
ForeignAmount | Cena brutto z podatkami | 
| 
 Details.retailGrossPriceDomestic  | 
DomesticAmount | 
 Cena brutto z podatkami w walucie lokalnej  | 
| 
 Details.retailNetPrice  | 
ForeignAmount | Cena netto z podatkami | 
| 
 Details.retailNetPriceDomestic  | 
DomesticAmount | 
 Cena netto z podatkami w walucie lokalnej  | 
| 
 Details.retailGrossValue  | 
ForeignAmount | 
 Całkowita kwota brutto (w tym podatki)  | 
| 
 Details.retailGrossValueDomestic  | 
DomesticAmount | 
 Całkowita kwota brutto (w tym podatki) w walucie lokalnej  | 
| 
 Details.retailNetValueue  | 
ForeignAmount | 
 Całkowita kwota netto (w tym podatki)  | 
| 
 Details.retailNetValueDomestic  | 
DomesticAmount | 
 Całkowita kwota netto (w tym podatki) w walucie lokalnej Wskazówka Rabaty nie są importowane dla faktur klientów końcowych.  | 
Atrybuty walutowe
Wszystkie kwoty faktur podawane są w walucie obcej lub lokalnej. Należy je zaimportować przy użyciu następujących atrybutów:
- ForeignAmount
 - DomesticAmount
 
Waluta obca (ForeignAmount)
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| amount | Wartość | |
| currency | Waluta | 
Waluta krajowa (DomesticAmount)
| Ścieżka atrybutu | Relacja klucza obcego/ Możliwe wartości | Nazwa | 
| 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 walut  | 
                        


