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 |



