Artykuł przedstawia instrukcje importu przyjęć towarów przy pomocy aplikacji Eksport danych oraz Import danych, które wykorzystują usługę Business Integration Service (BIS). Dostępne są następujące formaty eksportu oraz importu danych:
- XML
- CSV
- XLS
[inidicator]W przypadku gdy użytkownik nie wie jakiego formatu importu użyć, powinien wyeksportować plik za pomocą filtra eksportu wraz z żądanymi atrybutami.[/indicator]
Import danych magazynu
- Otwórz aplikację Import danych.
- W polu Filtr wybierz wartość RECEIPTOFGOODS. Możliwe jest wyszukiwanie po filtrze, oznaczeniu oraz jednostce biznesowej.
W oknie aplikacji widoczny jest filtr dla importu danych. - System po wybraniu filtra automatycznie przypisze następującą jednostkę biznesową: com.cisag.app.purchasing.obj.ReceiptOfGoods
- Wybrane atrybuty filtra są domyślnie zaznaczone. W sekcji Filtr można je dowolnie modyfikować.
- Wybierz przycisk [Importuj dane] na standardowym pasku narzędzi.
Pojawi się okno dialogowe Import danych. - W otwartym oknie wprowadź ustawienia dla pliku importu. Szczegółowy opis pól znajduje się w artykule Import danych.
- Uruchom import danych za pomocą przycisku [W tle].
Obszar roboczy – zakładka Filtr
Poniżej znajduje się opis dostępnych atrybutów dla poszczególnych obiektów biznesowych wprowadzanych w aplikacji Przyjęcia towaru.
Utworzenie przyjęcia towaru
W celu utworzenia nowego dokumentu przyjęcia towaru poprzez plik importu minimalnie wymagane jest zdefiniowanie poniższych atrybutów:
Atrybut |
Oznaczenie |
Potrzebny do |
Warunek/Uwaga |
InventoryOrganizationPartner |
Odbiorca dostawy |
Wszystkie typy przyjęcia towaru |
Dla struktur jednofirmowych z wyłączoną autoryzacją treści to jest automatycznie klient |
ReceiptOfGoodsType |
Rodzaj przyjęcia towaru |
Wszystkie typy przyjęcia towaru |
|
deliverySlip |
Numer dokumentu zewnętrznego |
Wszystkie typy bez przyjęcia towaru z produkcji |
|
SupplierPartner |
Partner dostawy |
Przyjęcie towaru z zakupu oraz z dystrybucji |
|
CustomerPartner |
Klient – Zamawiający |
Przyjęcie towaru ze zwrotu od klienta |
|
InvoicingOrganizationPartner |
Organizacja sprzedaży |
Przyjęcie towaru ze zwrotu od klienta |
W celu utworzenia pozycji dokumentu przyjęcia towaru poprzez plik importu minimalnie wymagane jest zdefiniowanie poniższych atrybutów:
Atrybut |
Oznaczenie |
Potrzebny do |
Item |
Artykuł |
Wszystkie typy Przyjęcia towaru |
totalQuantity |
Ilość przyjęcia |
Wszystkie typy Przyjęcia towaru |
storageArea. warehouse |
Magazyn |
Wszystkie typy bez przyjęcia pustych opakowań |
Atrybuty przy przetwarzaniu istniejącego dokumentu przyjęcia towaru
Jeżeli za pośrednictwem importu procesowane są istniejące przyjęcia towaru, należy przestrzegać opisanych reguł. W przypadku importu przyjęcia towaru do środowisk wielofirmowych oraz jednofirmowych z wyłączoną autoryzacją treści niezbędne jest wprowadzenie organizacji logistyki magazynowej. W celu odszukania dokumentu przyjęcia towaru w bazie wymagany jest jego identyfikator techniczny ReceiptOfGoods:guid, identyfikator handlowy ReceiptOfGoodsType oraz numer. Pozycje mogą być również importowane na dokument oraz usuwane z niego. W celu odszukania pozycji konieczne jest podanie identyfikatora technicznego ReceiptOfGoodsDetail:guid oraz numeru identyfikacyjnego. Zmiany na dokumencie są możliwe, jeżeli weryfikacja zmian przez system zostanie zatwierdzona.
Automatyczne zwolnienie dokumentu po zaimportowaniu
Jeżeli import został przeprowadzony poprawnie, możliwe jest automatyczne nadanie dokumentowi statusu Zwolniony dla dokumentu. Jest to szczególnie istotne, jeżeli importowane dokumenty przyjęcia towaru są wykorzystywane przez kolejne etapy zdefiniowanych procesów (np. zwrotu towarów). W tym celu należy ustawić wartość true dla atrybutu wirtualnej bazy autoRelease.
Import jednostek ładunkowych w przyjęciu towaru
Artykuły w przyjęciu towaru mogą być całkowicie lub częściowo spakowane w jednostki ładunkowe. Istnieje możliwość importu jednostek ładunkowych dla przyjęcia towaru. Zaimportowanie jednostek ładunkowych do istniejącego przyjęcia towaru jest możliwe, jeżeli dokument jest nowo utworzony. W przeciwnym razie jednostki ładunkowe są ignorowane.
Technicznie import jednostek ładunkowych jest wykonywany po zaimportowaniu wszystkich pozycji przyjęcia towaru. Po zaimportowaniu jednostek ładunkowych pozycje przyjęcia towaru są automatycznie pakowane. Jednostka ładunkowa składa się z jednej pozycji bazy UnitLoad oraz z jednej lub kilku pozycji jednostki ładunkowej UnitLoadDetail. Jednostki ładunkowe mogą być pakowane w kolejne jednostki ładunkowe. W takim przypadku kolejnym atrybutem jest UnitLoad, w przeciwnym wypadku jest to atrybut Item.
W aplikacji Konfiguracja → funkcja Wysyłka → funkcja Jednostki ładunkowe są dostępne pola Schemat numeracji oraz Schemat numeracji dla NJW. Pozwalają one ustawić dwa schematy numeracji dla jednostek ładunkowych. W przypadku importu dwóch numerów – numer z pliku importu przechowywany jest w atrybucie sscc, a numer wewnętrzny w atrybucie numer.
W celu utworzenia podstawowej jednostki ładunkowej poprzez plik importu minimalnie wymagane jest zdefiniowanie poniższych atrybutów:
Atrybut |
Oznaczenie |
Warunek/Uwaga |
number lub sscc |
Numer |
Zależy od ustawień w aplikacji Konfiguracja → funkcja Wysyłka → funkcja Jednostki ładunkowe |
StorageUnit |
Środek załadunku |
|
abc |
Klasyfikacja ABC |
|
organization |
Organizacja |
Odpowiada organizacji logistyki magazynowej dla przyjęcia towaru |
W celu utworzenia pozycji jednostki ładunkowej poprzez plik importu minimalnie wymagane jest zdefiniowanie poniższych atrybutów:
Atrybut |
Oznaczenie |
Warunek/Uwaga |
number |
Pozycja |
|
type |
Typ pozycji |
|
UnitLoad |
Jednostka ładunkowa |
Odniesienie do przynależnej jednostki ładunkowej |
W celu utworzenia pozycji artykułu zamiast jednostki ładunkowej poprzez plik importu minimalnie wymagane jest zdefiniowanie poniższych atrybutów:
Atrybut |
Oznaczenie |
Warunek/Uwaga |
item |
Artykuł |
|
identifier |
Specyfikacja |
Jeżeli artykuł jest zarządzany specyfikacją |
quantities |
Ilość |
Atrybuty dodatkowe
Poniżej znajduje się opis atrybutów dodatkowych, które są możliwe do wybrania w przypadku importu danych.
Dane podstawowe
Atrybut |
Związek |
Definicja |
autoRelease |
Automatycznie zwalnianie |
|
guid (atrybut główny) |
Techniczna identyfikacja dokumentu przyjęcia towaru (Guid) |
|
type (atrybut główny) |
Typ przyjęcia towaru (identyfikacja dla organizacji) |
|
number (atrybut główny) |
Numer przyjęcia towary (identyfikacja dla organizacji) |
|
customerData |
Dane klienta, tylko dla przyjęcia towaru ze zwrotu od klienta (opisane w rozdziale Dane dostawcy oraz Dane klienta) |
|
deliverySlip |
Numer dokumentu zewnętrznego |
|
deliverySlipDate |
Data dokumentu zewnętrznego |
|
date |
Data przyjęcia towaru |
|
deliveryData |
Dane dostawy (opisane w rozdziale Dane dostawy) |
|
storageArea.warehouse |
Magazyn |
|
inventory Organization |
Inventory OrganizationPartner |
Organizacja logistyki magazynowej |
responsible |
ResponsiblePartner |
Odpowiedzialny pracownik |
carrier |
Carrier |
Spedytor |
supplierData |
Dane dostawcy, tylko dla przyjęcia towaru z zakupu oraz dystrybucji (opisane w rozdziale Dane dostawcy oraz Dane klienta) |
|
invoicing Organization |
Invoicing OrganizationPartner |
Organizacja sprzedaży, tylko dla przyjęcia towaru ze zwrotu od klienta |
ShippingOrder |
Zlecenie dostawy, tylko dla przyjęcia towaru z dystrybucji |
|
Texts |
Tekst |
|
UnitLoads |
Jednostki ładunkowe |
Dane dostawy
Atrybut |
Związek |
Definicja |
deliveryTerms |
DeliveryTerms |
Warunek dostawy |
deliveryTermsLocation |
Lokalizacja warunku dostawy (dla Incoterms) |
|
shippingTerms |
ShippingTerms |
Warunek wysyłki |
Dane dostawy oraz Dane klienta
Atrybut supplierData odnosi się do partnera dostawy – dostawcy. Jest obsługiwany w przypadku importu przyjęcia towaru z zakupu lub dystrybucji. Atrybut customerData odnosi się do klienta. Jest obsługiwany w przypadku importu przyjęcia towaru ze zwrotu od klienta. Poniżej w tabeli zostały zebrane atrybuty dostępne dla supplierData oraz customerData.
Atrybut |
Związek |
Definicja |
addressData.city |
|
Adres: Miasto |
addressData.country |
|
Adres: Kraj |
addressData.district |
|
Adres: Dzielnica |
addressData.poBox |
|
Adres: Skrytka pocztowa |
addressData. poBoxCity |
|
Adres: Miasto skrytki pocztowej |
addressData.poBoxPostalCode |
|
Adres: Kod skrytki pocztowej |
addressData.postalCode |
|
Adres: Kod pocztowy |
addressData.region |
|
Adres: Region |
addressData.street |
|
Adres: Ulica |
customer |
CustomerPartner |
Klient |
supplier |
SupplierPartner |
Partner dostawy |
name |
|
Nazwa klienta lub nazwa partnera dostawy |
careOf |
CareOfPartner |
Do wiadomości |
careOfName |
|
Do wiadomości: Nazwa |
Dane szczegółowe pozycji
Na dokument przyjęcia towaru możliwe jest dodatnie pozycji zwykłej, pustej pozycji opakowania oraz pozycji drugiego gatunku. Dane pozycji znajdują się w atrybucie recieptDetailType. Pusta pozycja opakowania nie może posiadać odniesienia do miejsca składowania oraz pozycji zamówienia sprzedaży. Import pozycji pustych opakowań jest możliwy tylko w przypadku importu przyjęcia towaru ze zwrotu od klienta.
Poniżej w tabeli zostały zebrane atrybuty dostępne dla recieptDetailType
Atrybut |
Związek |
Definicja |
receiptDetailType |
|
Identyfikacja pozycji (typ), dostępne są poniższe wartości: · NORMAL – pozycja standardowa · EMPTIES – pozycja pustych opakowań · SECOND_QUALITY – pozycja drugiego gatunku Jeżeli atrybut nie jest zdefiniowany. Przyjmuje domyślnie wartość NORMAL. |
guid (Atrybut główny) |
|
Techniczna identyfikacja pozycji (Guid) |
number |
|
Numer pozycji |
parentGuid |
|
Techniczna identyfikacja pozycji nadrzędnej (Guid) |
subNumber |
|
Numer pozycji szczegółowej |
parentSubNumber |
|
Numer pozycji nadrzędnej |
deliverySlipDetailNumber |
|
Odniesienie |
item |
Item |
Artykuł |
owner |
Owner |
Właściciel zapasów |
storageArea.warehouse |
Magazyn |
|
sourceStorageArea. warehouse |
Źródłowe miejsce przechowywania, tylko dla przyjęcia towaru z dystrybucji |
|
totalQuantity |
|
Ilość przyjęcia (jednostka wiodąca) |
scrapQuantity |
|
Ilość złomu (jednostka wiodąca) |
totalQuantities |
|
Ilość przyjęcia (jednostka pozycji) |
scrapQuantities |
|
Ilość złomu (jednostka pozycji) |
pseudoItemDescription |
|
Nazwa pseudoartykułu. Jeżeli nie ma pseudoartykułu atrybut jest ignorowany. |
ShippingOrder |
Zlecenie dostawy – tylko dla przyjęcia towaru z dystrybucji |
|
ShippingOrderDetail |
Pozycja zlecenie dostawy – tylko dla przyjęcia towaru z dystrybucji |
|
Texts |
Teksty |
|
IdentiferAssignments |
Specyfikacje pozycji |
|
OrderAssignments |
Przypisane dokumenty |
|
SecondQualityInfo |
Dane rozliczeniowe pozycji drugiego gatunku. Opisane w rozdziale Pozycje drugiego gatunku. |
|
SubDetails |
Dane szczegółowe pozycji |
Specyfikacje
W celu zaimportowania specyfikacji przypisanych do pozycji wraz z ilościami dostępne są poniższe atrybuty:
Atrybut |
Związek |
Definicja |
guid |
|
Techniczna identyfikacja specyfikacji |
identifier |
Identifier |
Techniczna identyfikacja specyfikacji |
identifierNumber |
|
Numer specyfikacji. Dostępne, jeżeli w aplikacji Konfiguracja → funkcja Logistyka magazynowa → funkcja Specyfikacje → funkcja Ogólne parametr Użyj specyfikacji artykułu dostawcy jest nieaktywny. |
externalNumber |
|
Numer specyfikacji dostawcy |
totalQuantity |
|
Ilość przyjęcia (jednostka wiodąca) |
totalQuantities |
|
Ilość przyjęcia (jednostka pozycji) |
scrapQuantity |
|
Ilość złomu (jednostka wiodąca) |
scrapQuantities |
|
Ilość złomu (jednostka pozycji) |
secondQualityQuantity |
|
Ilość przyjęcia drugiego gatunku (jednostka wiodąca) |
secondQualityQuantities |
|
Ilość przyjęcia drugiego gatunku (jednostka pozycji) |
bestBeforeDate |
|
Termin przydatności, dotyczy tworzenia nowych partii z datą przydatności w ramach importu. Zdefiniowanie atrybutów specyfikacji jest obowiązkowe. |
Przyporządkowanie dokumentów powiązanych
Atrybut OrderAssignments pozwala na przyporządkowanie dowolnej ilości pozycji do zamówienia sprzedaży lub zamówienia zakupu. Dla przyjęć towaru ze zwrotów od klienta możliwe jest tylko przyporządkowanie ilości. Dla przyjęć towaru z dystrybucji możliwe jest określenie pozycji zlecenia dystrybucji.
W przypadku przyjęcia towaru z produkcji do pozycji możliwe jest przyporządkowanie artykułu produkcyjnego oraz produktu równoległego wraz z ilościami.
Aby pozycja wraz z przypisaniem mogła zostać zaimportowana, muszą być aktywne poniższe atrybuty:
- Dla PurchaseOrder atrybuty number i type (techniczny), ewentualnie type.code (biznesowy)
- Dla PurchaseOrderDetail atrybuty number i, jeżeli jest konieczny, subNumber
- Dla ProductionOrder atrybuty number i type (techniczny), ewentualnie typcode (biznesowy)
- Dla ProductionOrderDetail atrybuty number i, jeżeli jest konieczny, subNumber
- Dla SalesOrder atrybuty number i type (techniczny), ewentualnie typcode (biznesowy)
- Dla SalesOrderDetail atrybuty number i, jeżeli jest konieczny, subNumber dla zwykłych pozycji. Puste pozycje opakowań nie posiadają odniesienia do zamówienia sprzedaży.
- Dla DistributionOrder atrybuty number i type (techniczny), ewentualnie typcode (biznesowy)
- Dla DistributionOrderDetail atrybuty number i, jeżeli jest konieczny, subNumber
Dla pozycji przyporządkowanych do zamówienia sprzedaży, zakupu oraz zlecenia produkcyjnego konieczne jest określenie ilości za pomocą poniższych atrybutów:
Atrybut |
Związek |
Definicja |
deliveredQuantity |
|
Ilość przyjęcia (jednostka wiodąca) |
invDeliveredQuantity |
|
Ilość przyjęcia (jednostka pozycji) |
Dla pozycji przyjęcia ze zlecenia produkcyjnego możliwe jest określenie ilości złomu za pomocą poniższych atrybutów:
Atrybut |
Związek |
Definicja |
deliveredQuantity |
|
Ilość złomu (jednostka wiodąca) tylko dla przyjęcia z produkcji |
invDeliveredQuantity |
|
Ilość złomu (jednostka pozycji) tylko dla przyjęcia z produkcji |
Dla pozycji przyjęcia towaru z zakupu oraz dystrybucji możliwe jest zakończenie dostawy poprzez import z użyciem atrybutu:
Atrybut |
Związek |
Definicja |
completeOrderDetail |
|
Parametr zakończenia dostawy |
Pozycje drugiego gatunku
SecondQualityInfo zawiera dane szczegółowe pozycji drugiego gatunku. Należą do niej poniższe atrybuty:
Atrybut |
Związek |
Definicja |
priceDomestic |
|
Cena wyceny w walucie wewnętrznej |
priceOriginType |
|
Pochodzenie ceny |
priceUom |
PriceUom |
Jednostka ceny |
priceDimension |
|
Wymiar ceny |
accountOriginType |
|
Pochodzenie konta |
account |
Account |
Konto |
costCentre |
CostCentre |
Centrum kosztów |
costObjective |
CostObjective |
Jednostka kosztowa |