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
- Należy otworzyć aplikację Import danych.
- Wyświetlić filtr dla obiektu biznesowego: com.cisag.app.sales.obj.SalesOrder
→Filtr do importowania zamówień sprzedaży zostanie otwarty.
- W razie potrzeby należy powielić lub utworzyć nowy filtr dla tego obiektu biznesowego.
- W razie potrzeby można zmienić już wybrane atrybuty filtra.
- Następnie, nacisnąć przycisk [Import danych] na standardowym pasku przycisków.
→Otworzy się okno dialogowe Import danych.
- W oknie dialogowym Import danych można wprowadzić ustawienia dla importowanego pliku. Opis pól można znaleźć w dokumentacji Import danych.
- 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.
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
|
|
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: | |
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.
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
|
Currency | Cena
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
|
Cena detaliczna
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
|
Uom | Ilość całkowita
|
transactionAccountingClassification | TransactionAccountingClassification | Klasyfikacja konta typu transakcji |
transactionTaxClassification | TransactionTaxClassification | Klasyfikacja podatkowa typu transakcji |
transferStorageArea. warehouse |
Docelowy magazyn (code) | |
transportTime
|
Czas transportu
|
|
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
|
Uom | Ilość całkowita
|
transactionAccountingClassification | TransactionAccountingClassification | Klasyfikacja konta typu transakcji |
transactionTaxClassification | TransactionTaxClassification | Klasyfikacja podatkowa typu transakcji |
transferStorageArea. warehouse |
Docelowy magazyn (code) | |
transportTime
|
Czas transportu
|
|
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
|
Currency | Cena
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
|
Cena detaliczna
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
|
Uom | Ilość całkowita
|
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)