Import przyjęć towaru

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]

Wskazówka
Import oraz eksport przyjęć towarów jest realizowany za pośrednictwem atrybutów opisanych w tabelach przedstawionych w dalszej części artykułu.

Import danych magazynu

  1. Otwórz aplikację Import danych.
  2. 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.
  3. System po wybraniu filtra automatycznie przypisze następującą jednostkę biznesową: com.cisag.app.purchasing.obj.ReceiptOfGoods
Wskazówka
W systemie są dostępne predefiniowane filtry np. OPERATIONDATACOLLECTION, z których użytkownik może skorzystać, wybierając przycisk [Pomoc uzupełniania wartości]Filtr importu może zostać zdefiniowany na nowo za pomocą przycisku [Nowy].
  1. Wybrane atrybuty filtra są domyślnie zaznaczone. W sekcji Filtr można je dowolnie modyfikować.
  2. Wybierz przycisk [Importuj dane] na standardowym pasku narzędzi.
    Pojawi się okno dialogowe Import danych.
  3. W otwartym oknie wprowadź ustawienia dla pliku importu. Szczegółowy opis pól znajduje się w artykule Import danych.
  4. Uruchom import danych za pomocą przycisku [W tle].
Uwaga
Jeżeli w wyszukiwanych przez użytkownika filtrach system nie odnajdzie odpowiedniej jednostki biznesowej, wówczas przy pomocy przycisku [Wyszukaj] w oknie dokowanym należy wyszukać interesujący użytkownika obszar i dopiero wtedy zapisać taki filtr jako nowy. Należy pamiętać, że zestaw dostępnych filtrów nie zawiera w sobie wszystkich jednostek biznesowych, lecz jedynie część z nich jako wartości predefiniowane. Pozostałe jednostki biznesowe muszą zostać wyszukane i zapisane jako nowy filtr.

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

 
Wskazówka
Dla przyjęcia towaru z produkcji atrybuty InventoryOrganizationPartner oraz ReceiptOfGoodsType są wystarczające do utworzenia nowego dokumentu.
Wskazówka
Możliwe jest również zaimportowanie numeru dokumentu. W takim przypadku automatycznie nadany numer zgodny ze schematem numeracji będzie ignorowany.

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ń

Wskazówka
Jeżeli magazyn został zdefiniowany na nagłówku przyjęcia towaru, to jest przyjmowany jako magazyn domyślny dla pozycji przyjęcia towaru, Wyjątkiem są pozycje 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.

Uwaga
W celu obsługi pustych opakowań oraz pozycji drugiego gatunku należy aktywować odpowiednie funkcje w aplikacji Konfiguracja.

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

Uwaga
Atrybut secondQualityQuantity nie może zostać zaimportowany, ponieważ jest on automatycznie ustalane pod czas importu artykułów drugiego gatunku. Atrybut owner może zostać zaimportowany tylko dla przyjęć towaru typu zwrot od klienta.
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.

Uwaga
Jeżeli dla pozycji przyjęcia towaru nie została zaimportowana specyfikacja podczas importu, system spróbuje zaimportować specyfikację z dokumentu, do którego przyporządkowana jest pozycja przyjęcia towaru.
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
Uwaga
Jeżeli przyjęcie towaru ze zwrotu od klienta odnosi się do dokumentu zwrotu od klienta, to powiązanie z zamówieniem sprzedaży będzie wynikać z dokumentu zwrotu od klienta.
Wskazówka
Jeżeli przyporządkowanie dokumentu ma zostać zmienione, możliwe jest wykorzystanie odniesienia do pozycji lub skorzystanie z atrybutu guid przyporządkowania.

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

Czy ten artykuł był pomocny?