Import zamówień sprzedaży

Niniejsza dokumentacja opisuje instrukcje korzystania z aplikacji Import danych w odniesieniu do zamówień sprzedaży. Instrukcje te zawierają ogólne instrukcje i specjalne funkcje, które należy wziąć pod uwagę. Informują także 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

Import zamówień sprzedaży jest zasadniczo oparty na bieżącym 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 zdefiniowanie oddzielnych filtrów dla eksportu i importu.

Relacje 1:1 są zazwyczaj oparte na technicznym atrybucie GUID w modelu danych. W zależności od przypadku użycia, do importu można użyć technicznego atrybutu GUID lub klucza funkcjonalnego z obiektu docelowego (zwykle kodu lub numeru). W przypadku niektórych obiektów biznesowych wymagana jest organizacja do konwersji klucza biznesowego na klucz techniczny. Odpowiednia organizacja zwykle nie znajduje się bezpośrednio w źródle importu, ale jest określana za pośrednictwem kontekstu dokumentu. Więcej informacji na ten temat można znaleźć w rozdziale Przegląd: Atrybuty.

Obiekty biznesowe kodu skrótu są przywoływane zarówno w nagłówku, jak i w pozycji zamówienia sprzedaży. Są to technicznie powiązane grupy atrybutów, które są zawsze takie same dla wielu zamówień i dlatego oszczędzają miejsce w bazie danych i pamięci głównej poprzez ponowne użycie. Korzystając ze specjalnej konwersji, obiekty biznesowe kodu skrótu są reprezentowane jako części do eksportu lub importu.

Niektóre dane zamówień sprzedaży, takie jak lokalne wartości walut, konfiguracje artykułów i ich elementy konfiguracji, a także wewnętrzne atrybuty pomocnicze nie mogą być importowane.

Jeśli nie ma pewności, który format jest odpowiedni dla pliku importu, należy wykonać następujące czynności: Wprowadzić przykładowe zamówienie sprzedaży za pomocą aplikacji Zamówienia sprzedaży i wyeksportować ją za pomocą filtra do importu w żądanym formacie z żądanymi atrybutami. Wynikowy plik przykładowy może zostać użyty jako szablon dla generowanych plików importu.

Podczas importowania obowiązują te same zasady, co podczas edycji za pośrednictwem aplikacji. Na przykład, artykuł w zapisanym elemencie nie może być później zmieniany. Wartości atrybutów są ignorowane, jeśli nie można ich przyjąć w bieżącym kontekście. Ta sama logika jest stosowana przy określaniu wartości domyślnej, więc import i aplikacja zachowują się identycznie. To samo dotyczy kontroli.

Instrukcja: Import zamówień sprzedaży

  1. Należy otworzyć aplikację Import danych.
  2. Wyświetlić filtr dla obiektu biznesowego: com.cisag.app.sales.obj.SalesOrder

→Filtr do importowania zamówień sprzedaży zostanie otwarty.

  1. W razie potrzeby należy powielić lub utworzyć nowy filtr dla tego obiektu biznesowego.
  2. W razie potrzeby można zmienić już wybrane atrybuty filtra.
  3. Następnie, nacisnąć przycisk [Import danych] na standardowym pasku przycisków.

→Otworzy się okno dialogowe Import danych.

  1. W oknie dialogowym Import danych można wprowadzić ustawienia dla importowanego pliku. Opis pól można znaleźć w dokumentacji Import danych.
  2. Na koniec, należy nacisnąć przycisk [W tle].

→Import zostanie wykonany.

Tworzenie nowych zamówień sprzedaży

Minimalne wymagane atrybuty dla obiektu podstawowego:

Opis atrybutu Atrybut
Organizacja sprzedaży

(w systemach jednostanowiskowych z nieaktywnymi uprawnieniami do treści jest to automatycznie klient)

invoicingPartyData.Partner
Rodzaj zamówienia sprzedaży type
Klient customerData.CustomerPartner

Opcjonalnie można również przenieść numer (number) za pomocą importu. W takim przypadku numer określony za pomocą schematu numeracji zgodnie z rodzajem jest ignorowany. Ponadto należy zastosować odpowiednie konwencje, aby upewnić się, że numer przypisany za pomocą importu nie pasuje do numeru, który został już przypisany lub ma zostać przypisany automatycznie w przyszłości.

Minimalne wymagane atrybuty dla obiektu Artykuł:

Opis atrybutu Atrybut
Artykuł Item
Całkowita ilość totalQuantity
Pochodzenie ceny

(jeśli różni się od wartości domyślnej zgodnie z rodzajem i jeśli pochodzenie ceny jest Ręczne, cena brutto w walucie zgodnie z nagłówekim, jeśli dotyczy)

 priceOriginType i grossPrice

Opcjonalnie można również przypisać numer (number) do pozycji za pomocą importu.

Odpowiedni minimalny XML z atrybutami funkcjonalnymi i dwoma pozycjami ma na przykład następującą zawartość:

<?xml version="1.0" encoding="UTF-8"?>

<semiramis xmlns="com.cisag.app.sales.obj.SalesOrder" xsi:schemaLocation="com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd" created="2005-01-28T16:25:49.378Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<SalesOrder xmlns="com.cisag.app.sales.obj.SalesOrder">

<invoicingPartyData>

<partner>00000</partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<Details>

<Item>4711</Item>

<totalQuantity>

<amount>10</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>11</amount>

<Currency>EUR</Currency>

</grossPrice>

</details>

<details>

<Item>4712</Item>

<totalQuantity>

<amount>20</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>12</amount>

<Currency>EUR</Currency>

</grossPrice>

</Details>

</SalesOrder>

</semiramis>

W tym przykładzie pozostałe atrybuty są dodawane przy użyciu wartości domyślnych zgodnie z danymi podstawowymi itp.

Można również zaimportować dodatkowe wartości i użyć atrybutów technicznych zamiast atrybutów funkcjonalnych. Listę atrybutów można znaleźć w rozdziale Przegląd: Atrybuty.

Wskazówka
Waluta różniąca się od wartości wiodącej dla ceny brutto jest ignorowana.

Jeśli pozycja zostanie utworzona, nie można jej anulować z tym samym importem (przypadek „canceled==true” nie jest dostępny). Jeśli trzeba anulować nową pozycję, należy wykonać dwa importy. W pierwszym należy utworzyć element ze wszystkimi danymi (bez atrybutu canceled), a w drugim anulować element, ustawiając atrybut canceled na true. Należy pamiętać, że wszelkie dalsze zmiany tego elementu są ignorowane w drugim imporcie.

Funkcje specjalne podczas przetwarzania zamówienia

Podczas przetwarzania istniejącego zamówienia należy zwrócić uwagę na następujące kwestie: Podczas importowania zamówień sprzedaży w systemach wielostanowiskowych i systemach jednostanowiskowych z aktywowanymi uprawnieniami merytorycznymi wymagana jest organizacja sprzedaży. Podczas edycji istniejącego zamówienia organizacja sprzedaży jest zawsze pobierana z dokumentu zapisanego w nagłówku danych. Każda inna organizacja sprzedaży w źródle importu jest w tym przypadku ignorowana.

Aby znaleźć zamówienie sprzedaży zapisane w bazie danych, wymagana jest jego identyfikacja techniczna (SalesOrder:guid) lub funkcjonalna (Type [lub type] i number).

Wszystkie opcje importu mogą być używane dla pozycji – w szczególności usuwanie. Identyfikacja techniczna (SalesOrderDetail:guid) lub funkcjonalna (number) jest również wymagana do znalezienia zapisanej pozycji.

Zmiany za pomocą importu są możliwe tylko wtedy, gdy żadna weryfikacja tego nie uniemożliwia.

W przypadku anulowanych pozycji i pozycji, które zostały anulowane podczas importu (atrybut canceled jest ustawiony na true), żadne dalsze dane nie są przesyłane z pliku importu.

Jeśli znacznik anulowania zostanie usunięty dla pozycji szczegółowej, znacznik anulowania zostanie również usunięty dla odpowiedniej pozycji podstawowej. Należy pamiętać, że wartości pozycji podstawowej nie są przesyłane z pliku importu. Można jednak wyświetlić dane dla pozycji podstawowej jako dodatkowy blok po pozycjach szczegółowych.

Na przykład w poniższym pliku XML anulowanie zostanie anulowane w pozycji szczegółowej 10-10 zamówienia sprzedaży 100-123456789, a jednocześnie pole Numer referencyjny w pozycji podstawowej zostanie ustawione na tekst „abc„:

<?xml version="1.0" encoding="UTF-8"?><semiramis xmlns="com.cisag.app.sales.obj.SalesOrder" xsi:schemaLocation="com.cisag.app.sales.obj.SalesOrder SalesOrder. xsd" created="2011-11-04T15:10:45.999Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" nlsMode="SINGLE_LANGUAGE" dateTimeMode="COMPACT">

<SalesOrder xmlns="com.cisag.app.sales.obj.SalesOrder">

<number>123456789</number>

<type>

<code>100</code>

</type>

<details>

<numer>10</numer>

<SubDetails>

<numer>10</numer>

<subNumber>10</subNumber>

<canceled>false</canceled>

</subDetails>

</Details>

<Details>

<numer>10</numer>

<reference>abc</reference>

</Details>

</SalesOrder>

</semiramis>

Alternatywnie można również cofnąć anulowanie dla pozycji nagłówka, ale spowoduje to automatyczne usunięcie znacznika anulowania ze wszystkich pozycji szczegółowych w tej pozycji.

Automatyczne zwolnienie po imporcie

Jeśli import został przeprowadzony pomyślnie, przetworzone zamówienie sprzedaży może zostać zwolnione automatycznie po zaimportowaniu. Opcja ta jest szczególnie przydatna w połączeniu ze statusem otwarcia W trakcie realizacji (patrz typ). Zapobiega to wykorzystaniu w kolejnych dokumentach zamówienia sprzedaży, które nie zostało jeszcze w pełni zaimportowane. Podczas wydania zamówienie sprzedaży ma status Nieprawidłowe, więc nie można go użyć również w tym kroku.

W przypadku tej funkcji należy ustawić atrybut bazy wirtualnej autoRelease na wartość true dla odpowiedniej instancji.

Jeśli ta funkcja jest aktywna i nie ma innych błędów, w dzienniku komunikatów wyświetlany jest dodatkowy komunikat informacyjny informujący, że zamówienie sprzedaży zostało automatycznie zwolnione. Jeśli nie było to możliwe, pojawi się ostrzeżenie.

Wskazówki dotyczące importowania starszych danych

Istnieją następujące wskazówki dotyczące importowania starszych danych:

  • Należy upewnić się, że wszystkie dane podstawowe zostały poprawnie przeniesione. Pozwoli to uniknąć niepotrzebnego przetwarzania błędów dla zamówień.
  • Należy ustawić funkcje w aplikacji Konfiguracja i odpowiednie typy – przynajmniej tymczasowo na czas przesyłania danych – tak, aby osiągnąć najwyższą możliwą prędkość importu. Na przykład dezaktywuj zapytanie o dostępność, sprawdzanie limitu kredytowego itp. Zapisywanie tymczasowych rekordów dostępności jest automatycznie dezaktywowane podczas importu – nawet jeśli funkcja jest aktywna w aplikacji Konfiguracja.
  • Jeśli istnieje potrzeba uniknięcia określania nowych cen i rabatów podczas importu, należy przełączyć odpowiednie pochodzenie na Ręczne i przenieś wartości bezpośrednio z systemu źródłowego.
  • Należy wyłączyć automatyczny wybór kontraktu
  • Podczas importu nie można wpływać na ilość dostarczoną i zafakturowaną. Dlatego warto sfinalizować i zafakturować wszystkie zlecenia dostawy i prowizje w starym systemie. Jeśli potwierdzenia zamówień i faktury pro forma są nadal nieuregulowane, należy je również utworzyć w starszym systemie. Następnie można zaimportować otwarte ilości dostaw dla zamówień, które nie zostały jeszcze zrealizowane, jako całkowitą ilość dla nowych pozycji w systemie docelowym. Następnie można zlecić nowemu systemowi wygenerowanie zleceń dostawy, faktur itp.

Przegląd: Atrybuty

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 konfigurację.

W przypadku niektórych obiektów biznesowych do konwersji kluczy funkcjonalnych na klucze techniczne wymagana jest organizacja. Na listach atrybutów jest to oznaczone następującymi uwagami w kolumnie Atrybut.

  • Organizacja sprzedaży (zawsze zgodnie z nagłówkiem)
  • Firma (zawsze zgodnie z nagłówkiem)
  • Kraj dla firmy (zawsze zgodnie z nagłówkiem)
  • Organizacja logistyki magazynowej (zgodnie z nagłówkiem lub pozycją)
  • Atrybuty identyfikacyjne (atrybuty kluczowe) są oznaczone literą (K).

Dane podstawowe

Zamówienie sprzedaży (SalesOrder)
Atrybut Relacja Objaśnienie
autoRelease Automatyczne zwolnienie (atrybut wirtualny),Więcej informacji w rozdziale Automatyczne zwolnienie po imporcie
calculateTaxData Ustal podatek

Wskazówka
Jeśli pozycje już istnieją, tego atrybutu nie można już importować.
classification1 (organizacja sprzedaży) Classification1 Klasyfikacja 1
classification2 (organizacja sprzedaży) Classification2 Klasyfikacja 2
classification3 (organizacja sprzedaży) Classification3 Klasyfikacja 3
classification4 (organizacja sprzedaży) Classification4 Klasyfikacja 4
classification5 (organizacja sprzedaży) Classification5 Klasyfikacja 5
commissionAllowed Podlega prowizji
commissionAmount Wartość prowizji
commissionPercentage Procent prowizji
confirmationRequired Wymagane potwierdzenie
customerData Dane klienta. Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)
customerOrderData.purchaseOrder Zewnętrzny numer dokumentu
customerOrderData.date Data zewnętrznego dokumentu
date Data wprowadzenia
deliveryCustomerData Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)
deliveryData Więcej informacji w rozdziale Dane dostawy (deliveryData)
deliveryPartnerData.
careOf
DeliveryPartnerData.CareOfPartner Dostawa: Osoba kontaktowa
deliveryPartnerData.
careOfName
Dostawa: Nazwa osoby kontaktowej
DetailGroups Grupa pozycji sprzedażyWięcej informacji w rozdziale Grupy pozycji sprzedaży (DetailGroups)
detailPurchasingDataOrigin Pochodzenie danych zamówienia dla pozycji
discountOriginType Pochodzenie rabatu

Wskazówka
Ten atrybut nie może być zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
discounts[0..3] Rabaty od 1 do 4
freightCostEnabled Obliczanie kosztów transportu

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
guid (K) Identyfikacja techniczna dla zmiany/usunięcia już zapisanych danych. Usunięcie już zapisanych danych – jeśli są znane.
intrastatData Więcej informacji w rozdziale:

Dane Intrastat (intrastatData)

invoiceCustomerData Więcej informacji w rozdziale Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)
invoicingData Więcej informacji w rozdziale Dane faktury (invoicingData)
invoicingPartyData.careOf invoicingPartyData.
CareOfPartner
Organizacja sprzedaży: Osoba kontaktowa
invoicingPartyData.
careOfName
Organizacja sprzedaży: Nazwa osoby kontaktowej
invoicingPartyData.partner invoicingPartyData.
Partner
Organizacja sprzedaży
kindOfPricing Wyświetlanie ceny

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówień. Dane w pliku importu są ignorowane podczas importu.
noClassificationDiscounts Brak rabatów pozycji
noOrderValueDiscounts Brak rabatów od wartości zamówienia
number (K) Numer (identyfikacja funkcjonalna)Opcjonalny w przypadku nowego utworzenia – w przeciwnym razie określany automatycznie.Obowiązkowe, jeśli guid nie został określony podczas zmiany/usuwania.
orderDeliveryData Więcej informacji w rozdziale Dane dostawy zamówienia (orderDeliveryData)
outputSettings Więcej informacji w rozdziale Ustawienia wydania (outputSettings)
ownerOrigin Pochodzenie właściciela zapasów
payee PayeePartner Partner płatności

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
priceDate Czas kalkulacji

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
priceListing PriceListing Cennik

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
priceValidityDate Data odniesienia dla określenia ceny

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
pricingPartnerRelation Zastosowanie relacji partnera

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
purchaseOrderType PurchaseOrderType Rodzaj zamówienia sprzedaży
purchasingOrganisation PurchasingOrganisation Organizacja zakupów
purchasingReference Powiązania zakupowe
requestDate.value Preferowana data
responsible ResponsiblePartner Odpowiedzialny pracownik
reviewDate Data ponownego złożenia wniosku
salesRepresentatives [0..2] SalesRepresentatives [0..2] Przedstawiciele (od 1 do 3)
status Status ogólny (tylko Zwolnione lub Zablokowane)

Wskazówka
Ten atrybut nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.
storageAreaDefault Wartość domyślna dla magazynu
supplier SupplierPartner Dostawca
taxRegister TaxRegister Rejestr VAT
transactionAccountingClassification TransactionAccountingClassification Klasyfikacja konta typu transakcji
transferStorageArea.
warehouse
Docelowy magazyn (code)
TextAssignments Załączniki plików/teksty. Więcej informacji w rozdziale Teksty (TextAssignments)
type (K) Type Typ (identyfikacja techniczna)Obowiązkowe, jeśli guid nie został określony podczas zmiany/usuwania.
useDetailGroups Użyj grup elementów

Wskazówka
Jeśli elementy już istnieją, tego atrybutu nie można już importować.
valuationDate Data waluty
Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)

Dane klienta w trzech zastosowaniach są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu. To samo dotyczy danych adresowych. Następujące nazwy części zostały przypisane analogicznie do nazw atrybutów technicznych:

  • customerData Klient
  • deliveryCustomerData Odbiorca dostawy
  • invoiceCustomerData Odbiorca faktury

Następujące atrybuty istnieją zatem raz na użycie.

Atrybut Relacja Objaśnienie
addressData.city Adres – miasto
addressData.country addressData.Country Adres – kraj
addressData.district Adres – dzielnica
addressData.poBox Adres – skrytka pocztowa
addressData.poBoxCity Adres – skrytka pocztowa (miasto)
addressData.poBoxPostalCode Adres – kod pocztowy skrytki
addressData.postalCode Adres – kod pocztowy
addressData.region addressData.Region Adres – region
addressData.street Adres – ulica
customer CustomerPartner Klient

Wskazówka
Dla zastosowań

Klient (customerData) i Odbiorca faktury (invoiceCustomerData), atrybut ten nie może zostać zmieniony przez import dla istniejących pozycji zamówienia. Dane w pliku importu są ignorowane podczas importu.

careOf CareOfPartner Osoba kontaktowa
careOfName Nazwa osoby kontaktowej
name Nazwa klienta
Dane Intrastat (intrastatData)

Dane Intrastat są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Wyjaśnienie relacji atrybutów

Atrybut Relacja Objaśnienie
port
(Kraj, firma)
Port Port (lotniczy)
statisticalMethod

(Kraj, firma)

StatisticalMethod Metoda statystyczna
transactionType

(Kraj, firma)

TransactionType Typ transakcji
transportMode

(Kraj, firma)

TransportMode Rodzaj transportu
Dane dostawy (deliveryData)

Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Wyjaśnienie relacji atrybutów

Atrybut Relacja Objaśnienie
deliveryPriority Priorytet dostawy
deliveryRestriction Ograniczenie dostawy
deliveryTerms DeliveryTerms Warunki dostawy
deliveryTermsLocation Warunki dostawy z odniesieniem do lokalizacji
shippingTerms ShippingTerms Warunki wysyłki
 Dane faktury (invoicingData)

Niektóre dane faktury są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.

Atrybut Relacja Objaśnienie
currency Waluta

Wskazówka
Ten atrybut nie może być zmieniony przez import dla istniejących pozycji zamówień. Dane w pliku importu są ignorowane podczas importu.
paymentMethod (Firma) PaymentMethod Forma płatności
paymentTerms (Firma) PaymentTerms Warunki płatności
summaryInvoiceCode SummaryInvoiceCode Symbol faktury zbiorczej
Dane dostawy zamówienia (orderDeliveryData)

Dane dostawy zamówienia są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
carrier Carrier Spedytor
storageArea.warehouse Magazyn (code)
Ustawienia wyjściowe (outputSettings)

Ustawienia wyjściowe są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
confirmation.medium Medium potwierdzenia zamówienia
confirmation.mediumAddress Adres medium potwierdzenia zamówienia
containerLabel.medium Medium etykiety załadunku
containerLabel.mediumAddress Adres medium etykiety załadunku
invoice.medium Medium faktury
invoice.mediumAddress Adres medium faktury
proformaInvoice.medium Medium faktury proforma
proformaInvoice.mediumAddress Adres medium faktury proforma
shipping.medium Medium dokumentu wysyłki
shipping.mediumAddress Adres medium dokumentu wysyłki
Grupy pozycji sprzedaży (DetailGroups)

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
baseInstance Wartość (guid)

Wskazówka
Wartość musi być zgodna ze specyfikacją atrybutu type. Jeśli wybrano tam wartość Manual, wartość nie jest używana.
baseInstanceIdValue
Wskazówka
Ponieważ identyfikator guid zwykle nie jest znany, można również zaimportować wartość jako ciąg znaków. Wartość musi być zgodna ze specyfikacją atrybutu type. Jeśli wybrano tam wartość Manual, wartość nie jest używana.
code Grupa
description Oznaczenie
sequence Sekwencja
type Typ

Więcej informacji w rozdziale Dopuszczalne wartości dla type

Dozwolone wartości dla type

W atrybucie type należy przechowywać nazwę implementacji następującego kontraktu haka:

com.cisag.app.sales.detailgroup.hook.SalesDetailGroupDataType.

Następujące implementacje już istnieją:

Nazwa implementacji haka Opis
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeManualImpl Ręcznie
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeAssortmentClassificationImpl Klasyfikacja asortymentu
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesDetailGroupClassificationImpl Klasyfikacja grup pozycji sprzedaży
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesItemClassification1Impl Klasyfikacja artykułów sprzedaży 1
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesItemClassification2Impl Klasyfikacja artykułów sprzedaży 2
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesItemClassification3Impl Klasyfikacja artykułów sprzedaży 3
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesItemClassification4Impl Klasyfikacja artykułów sprzedaży 4
com.cisag.app.sales.detailgroup.log.SalesDetailGroupDataTypeSalesItemClassification5Impl Klasyfikacja artykułów sprzedaży 5
Teksty (TextAssignments)

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
code Moduł tekstowy (opcjonalnie)
document Dokument
sequence Kolejny numer
text Tekst w języku (Używane tylko wtedy, gdy nie określono modułu tekstowego. Więcej informacji w rozdziale Tekst).
type Typ tekstu
text

Poniższy przykład zawiera dwa podstawowe teksty. Tekst nagłówka odwołuje się do modułu tekstowego „TXT1”, a drugi tekst zawiera wolny tekst stopki dla języków de i en:

<?xml version="1.0" encoding="UTF-8"?>

<semiramis xmlns="com.cisag.app.sales.obj.SalesOrder" xsi:schemaLocation="com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd" created="2005-12-28T07:36:29.729Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<SalesOrder xmlns="com.cisag.app.sales.obj.SalesOrder">

<invoicingPartyData>

<partner>00000</partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<TextAssignments>

<code>TXT1</code>

<sequence>10</sequence>

<document index="0">ORDER_CONFIRMATION</document>

<document index="1">PICKING_SLIP</document>

<document index="2">DELIVERY_SLIP</document>

<document index="3">CUSTOMER_INVOICE</document>

<document index="4">PROFORMA_INVOICE</document>

<document index="5">SHIPPING_LOAD</document>

<document index="6">PRODUCTION_ORDER</document>

<type>HEADER</type>

</TextAssignments>

<TextAssignments>

<code></code>

<sequence>20</sequence>

<document index="0">ORDER_CONFIRMATION</document>

<document index="1">PICKING_SLIP</document>

<document index="2">DELIVERY_SLIP</document>

<document index="3">CUSTOMER_INVOICE</document>

<document index="4">PROFORMA_INVOICE</document>

<document index="5">SHIPPING_LOAD</document>

<document index="6">PRODUCTION_ORDER</document>

<type>FOOTER</type>

<text>

<language>en</language>

<text>To jest przykładowy tekst.</text>

<contentType>text/plain</contentType>

</text>

<text>

<language>en</language>

<text>To jest przykładowy tekst.</text>

<contentType>text/plain</contentType>

</text>

</TextAssignments>

</SalesOrder>

</semiramis>

Można również użyć różnych opcji formatowania tekstów. Jeśli potrzebne są przykłady określonego formatowania, najlepiej jest utworzyć przykładowy dokument z żądanym formatowaniem tekstu i wyeksportować go.

Wskazówka
Teksty są zwykle importowane z pliku importu, a wszelkie wartości domyślne z danych podstawowych partnera itp. są ignorowane. Jeśli właściwość jednostki com.cisag.app.general.order.bi.applyAllwaysTextDefaults ma wartość true, wartości domyślne są zawsze określane i łączone z wszelkimi istniejącymi tekstami w pliku importu. Należy pamiętać, że numery wierszy tekstu muszą być odpowiednio wybrane, a wynikiem jest tylko jeden wiersz tekstu z jednym tekstem pozycji.

Dane pozycji (pozycje podstawowe)

Pozycje zamówienia sprzedaży (SalesOrderDetail)
Atrybut Relacja Objaśnienie
account Account Konto przychodów
accountOriginType Rodzaj konta przychodów
automaticContractSelection Automatyczny wybór kontraktu
canceled Anulowane
Należy zwrócić uwagę na
rozdziały:

commissionAllowed Podlega prowizji
commissionPercentage Procent prowizji
contractDetail SalesContractDetail Pozycja kontraktu
contractHeader SalesContract Kontrakt
costCentre CostCentre Centrum kosztów
costObjective CostObjective Jednostka kosztów
costOfGoods Koszt towarów. Nieużywany w przypadku zestawów pozycji podstawowych.
customerItemNumber Numer artykułu klienta. Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
deliveryCustomerData Więcej informacji można znaleźć w dokumentacji Dane dostawy klienta (deliveryCustomerData)
deliveryCustomerTax
IdentificationNumber
Identyfikator podatku od sprzedaży
deliveryData Więcej informacji można znaleźć w rozdziale Dane dostawy (deliveryData)
deliveryDate Termin dostawy
deliveryPartnerData.careOf Partner dostawy: Osoba kontaktowa
deliveryPartnerData.careOfName Partner dostawy: Nazwa osoby kontaktowej
deliveryStatus Status dostawy
detailGroup DetailGroup Grupa pozycji sprzedaży
discounts[0..3] Rabaty od 1 do 4
dispoDate Data ponownego opracowania
ean Europejski numer artykułu (EAN)Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
grossPrice

  • grossPrice.amount
  • grossPrice.Currency
Currency Cena

  • Wartość
  • Waluta
Wskazówka
Używane tylko dla dokumentów niebędących dokumentami użytkownika końcowego (patrz także retailGrossPrice).
guid (K)  Identyfikacja techniczna (pozycja) do zmiany/usunięcia już zapisanych danych – jeśli jest znana.
intrastatData Więcej informacji w rodziale: Dane Intrastat (intrastatData)
item Artykuł
netCode Brak rabatu podstawowego
noCashDiscountEnabled Brak rabatu gotówkowego
noClassificationDiscounts Brak rabatów pozycji
noOrderValueDiscounts Brak rabatu od wartości zamówienia
number (K) Numer pozycji (identyfikacja funkcjonalna)Opcjonalny w przypadku nowego utworzenia – w przeciwnym razie określany automatycznie.Obowiązkowe, jeśli guid nie został określony podczas zmiany/usuwania.
orderDeliveryData Więcej informacji w rozdziale Dane dostawy zamówienia (orderDeliveryData)
originalInvoiceDetail OriginalInvoiceDetail Pierwotna pozycja faktury
originalInvoiceHeader OriginalInvoice Oryginalna faktura
owner Owner Aktualny właściciel
ownerGroupUsage Zezwolenie na wielu właścicieli zapasów
ownerOrigin Pochodzenie właściciela
preferredDate.value Preferowana data
priceDimension Wymiar ceny
priceOriginType Pochodzenie ceny
priceUom Jednostka ceny
pseudoItemDescription Opis pseudoartykułuTylko dla pseudoartykułów. Specyfikacja jest ignorowana dla wszystkich innych pozycji.
purchaseOrderDetail PurchaseOrderDetail Pozycja zamówienia zakupu
purchaseOrderHeader PurchaseOrder Zamówienie zakupu
purchasingDataOrigin Pochodzenie danych zamówienia
purchasingOrganisation Purchasing Organisation Organizacja zakupów
purchasingReference Połączenie zamówienia
reference Odniesienie
referenceNumber Odniesienie do pozycji
retailGrossPrice

  • retailGrossPrice.amount
  • retailGrossPrice.currency
Cena detaliczna

  • Cena
  • Waluta
Wskazówka
Używane tylko dla dokumentów klienta końcowego (grossPrice).
shippingDate Termin wysyłki
Wskazówka
W zależności od ustawień podstawowych można
można zaimportować datę wysyłki lub czas transportu (transportTime).
Więcej informacji
można znaleźć w artykułach:

status Status ogólny (tylko Zwolnione lub Zablokowane.
storageAreaDefault Wartość domyślna magazynu
supplier SupplierPartner Dostawca
TextAssignments Załączniki plików/tekstyWięcej informacji w rozdziale Teksty (TextAssignments)
totalQuantity

  • totalQuantity.amount
  • totalQuantity.uom
Uom Ilość całkowita

  • Ilość
  • Jednostka  miary
transactionAccountingClassification TransactionAccountingClassification Klasyfikacja konta typu transakcji
transactionTaxClassification TransactionTaxClassification Klasyfikacja podatkowa typu transakcji
transferStorageArea.
warehouse
Docelowy magazyn (code)
transportTime

  • transportTime.amount
  • transportTime.uom
Czas transportu

  • Ilość
  • Jednostka miary

Wskazówka
W zależności od ustawień podstawowych można
datę wysyłki lub czas transportu.
Więcej informacji
można znaleźć w artykułach:

uomObligation Obowiązująca jednostka
uomObligationOrigin Pochodzenie obowiązywania jednostek
Dane dostawy klienta (deliveryCustomerData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)

Dane intrastat (intrastatData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane Intrastat (intrastatData).

Dane dostawy (deliveryData)

Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są reprezentowane jako część do eksportu/importu.

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
deliveryTerms DeliveryTerms Warunki dostawy
deliveryTermsLocation Warunki dostawy z odniesieniem do lokalizacji
shippingTerms ShippingTerms Warunki wysyłki
Dane dostawy zamówienia (orderDeliveryData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane dostawy zamówienia (orderDeliveryData)

Dane pozycji (towary bezpłatne)

Pozycje zamówienia sprzedaży (SalesOrderDetail)

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
account Account Konto przychodów
accountOriginType Rodzaj konta przychodów
canceled Anulowane
Należy zwrócić uwagę na
rozdziały:

commissionAllowed Podlega prowizji
commissionPercentage Procent prowizji
costCentre CostCentre Centrum kosztów
costObjective CostObjective Jednostka kosztów
costOfGoods Koszt towarów. Nieużywany w przypadku zestawów pozycji podstawowych.
customerItemNumber Numer artykułu klienta. Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
deliveryCustomerData Więcej informacji można znaleźć w dokumentacji Dane dostawy klienta (deliveryCustomerData)
deliveryCustomerTax
IdentificationNumber
Identyfikator podatku od sprzedaży
deliveryData Więcej informacji można znaleźć w rozdziale Dane dostawy (deliveryData)
deliveryDate Termin dostawy
deliveryPartnerData.careOf Partner dostawy: Osoba kontaktowa
deliveryPartnerData.careOfName Partner dostawy: Nazwa osoby kontaktowej
deliveryStatus Status dostawy
detailGroup DetailGroup Grupa pozycji sprzedaży
dispoDate Data ponownego opracowania
ean Europejski numer artykułu (EAN)Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
guid (K)  Identyfikacja techniczna (pozycja) do zmiany/usunięcia już zapisanych danych – jeśli jest znana.
identifier
Identifier Specyfikacja
intrastatData Więcej informacji w rodziale: Dane Intrastat (intrastatData)
item Artykuł
orderDeliveryData Więcej informacji w rozdziale Dane dostawy zamówienia (orderDeliveryData)
owner Owner Aktualny właściciel
ownerGroupUsage Zezwolenie na wielu właścicieli zapasów
ownerOrigin Pochodzenie właściciela
preferredDate.value Preferowana data
pseudoItemDescription Opis pseudoartykułuTylko dla pseudoartykułów. Specyfikacja jest ignorowana dla wszystkich innych pozycji.
purchaseOrderDetail PurchaseOrderDetail Pozycja zamówienia zakupu
purchaseOrderHeader PurchaseOrder Zamówienie zakupu
purchasingDataOrigin Pochodzenie danych zamówienia
purchasingOrganisation Purchasing Organisation Organizacja zakupów
purchasingReference Połączenie zamówienia
reference Odniesienie
shippingDate Termin wysyłki
Wskazówka
W zależności od ustawień podstawowych można
można zaimportować datę wysyłki lub czas transportu (transportTime).
Więcej informacji
można znaleźć w artykułach:

status Status ogólny (tylko Zwolnione lub Zablokowane.
storageAreaDefault Wartość domyślna magazynu
storageUnit StorageUnit Jednostka magazynowa
subNumber (K) Numer pozycji szczegółowej (identyfikacja funkcjonalna), opcjonalny dla nowego elementu. W przeciwnym razie jest określany automatycznie.
Obowiązkowe, jeśli guid
nie został określony podczas zmiany/usuwania.
supplier SupplierPartner Dostawca
TextAssignments Załączniki plików/tekstyWięcej informacji w rozdziale Teksty (TextAssignments)
totalQuantity

  • totalQuantity.amount
  • totalQuantity.uom
Uom Ilość całkowita

  • Ilość
  • Jednostka  miary
transactionAccountingClassification TransactionAccountingClassification Klasyfikacja konta typu transakcji
transactionTaxClassification TransactionTaxClassification Klasyfikacja podatkowa typu transakcji
transferStorageArea.
warehouse
Docelowy magazyn (code)
transportTime

  • transportTime.amount
  • transportTime.uom
Czas transportu

  • Ilość
  • Jednostka miary

Wskazówka
W zależności od ustawień podstawowych można
datę wysyłki lub czas transportu.
Więcej informacji
można znaleźć w artykułach:

uomObligation Obowiązująca jednostka
uomObligationOrigin Pochodzenie obowiązywania jednostek
Dane dostawy klienta (deliveryCustomerData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)

Dane intrastat (intrastatData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane Intrastat (intrastatData).

Dane dostawy (deliveryData)

Dane dostawy są przechowywane w bazie danych jako obiekt biznesowy z kodem skrótu i są wyświetlane jako część eksportu/importu.

Wyjaśnienie relacji atrybutów:

Atrybut Relacja Objaśnienie
deliveryTerms DeliveryTerms Warunki dostawy
deliveryTermsLocation Warunki dostawy z odniesieniem do lokalizacji
shippingTerms ShippingTerms Warunki wysyłki
Dane dostawy zamówienia (orderDeliveryData)

trybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane dostawy zamówienia (orderDeliveryData)

Dane pozycji (komponenty)

Pozycje zamówienia sprzedaży (SalesOrderDetail)
Atrybut Relacja Objaśnienie
account Account Konto przychodów
accountOriginType Rodzaj konta przychodów
automaticContractSelection Automatyczny wybór kontraktu
canceled Anulowane
Należy zwrócić uwagę na
rozdziały:

costCentre CostCentre Centrum kosztów
costObjective CostObjective Jednostka kosztów
costOfGoods Koszt towarów. Nieużywany w przypadku zestawów pozycji podstawowych.
customerItemNumber Numer artykułu klienta. Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
deliveryStatus Status dostawy
detailGroup DetailGroup Grupa pozycji sprzedaży
discounts[0..3] Rabaty od 1 do 4
ean Europejski numer artykułu (EAN)Więcej informacji można znaleźć w dokumentacji Importowanie pozycji dokumentu przy użyciu EAN
grossPrice

  • grossPrice.amount
  • grossPrice.Currency
Currency Cena

  • Wartość
  • Waluta
Wskazówka
Używane tylko dla dokumentów niebędących dokumentami użytkownika końcowego (patrz także retailGrossPrice).
guid (K)  Identyfikacja techniczna (pozycja) do zmiany/usunięcia już zapisanych danych – jeśli jest znana.
Identifier Identifier Specyfikacja
intrastatData Więcej informacji w rodziale: Dane Intrastat (intrastatData)
item Artykuł
netCode Brak rabatu podstawowego
noCashDiscountEnabled Brak rabatu gotówkowego
noClassificationDiscounts Brak rabatów pozycji
noOrderValueDiscounts Brak rabatu od wartości zamówienia
priceDimension Wymiar ceny
priceOriginType Pochodzenie ceny
priceUom Jednostka ceny
pseudoItemDescription Opis pseudoartykułuTylko dla pseudoartykułów. Specyfikacja jest ignorowana dla wszystkich innych pozycji.
purchaseOrderDetail PurchaseOrderDetail Pozycja zamówienia zakupu
purchaseOrderHeader PurchaseOrder Zamówienie zakupu
reference Odniesienie
retailGrossPrice

  • retailGrossPrice.amount
  • retailGrossPrice.currency
Cena detaliczna

  • Cena
  • Waluta
Wskazówka
Używane tylko dla dokumentów klienta końcowego (grossPrice).
status Status ogólny (tylko Zwolnione lub Zablokowane.
subNumber (K)

Numer pozycji szczegółowej (identyfikacja funkcjonalna), opcjonalny dla nowego elementu. W przeciwnym razie jest określany automatycznie.
Obowiązkowe, jeśli guid
nie został określony podczas zmiany/usuwania.
TextAssignments Załączniki plików/tekstyWięcej informacji w rozdziale Teksty (TextAssignments)
totalQuantity

  • totalQuantity.amount
  • totalQuantity.uom
Uom Ilość całkowita

  • Ilość
  • Jednostka  miary
transactionAccountingClassification TransactionAccountingClassification Klasyfikacja konta typu transakcji
transactionTaxClassification TransactionTaxClassification Klasyfikacja podatkowa typu transakcji
transferStorageArea.
warehouse
Docelowy magazyn (code)
uomObligation Obowiązująca jednostka
uomObligationOrigin Pochodzenie obowiązywania jednostek
Dane Intrastat (intrastatData)

Atrybuty odpowiadają atrybutom w nagłówku. Więcej informacji w rozdziale: Dane Intrastat (intrastatData)

Czy ten artykuł był pomocny?