XL128 – Przykłady zastosowania API w produkcji

Spis treści

Utworzenie technologii TP

Aby utworzyć technologię za pomocą API udostępnione są następujące funkcje:

XLNowaTechnologia
XLNowaCzynnoscTechnologia
XLNowaFunkcjaCzynnoscTechnologia
XLNowyZasobCzynnoscTechnologia

Dodanie Technologii produkcji XLNowaTechnologia

Funkcja umożliwia dodanie nowej technologii do Systemu na podstawie przekazanej struktury XLProdTechnologiaInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Kod – ustalony kod technologii

Wpisując Kod technologii jest przepisywana wartość w polu Nazwa. Automatycznie również zostaje dodana jednostka oraz ilość np. 1 szt. Wpisując w TwrKod zostanie uzupełnione pole Produkt na technologii zakładka Ogólne.

Uzupełnienie Kodu, Nazwy i Produktu na technologii

Aby uzupełnić stawki na technologii zakładka Koszty należy uzupełnić pola :

StawkaStala – uzupełni stawkę stałą na operacji
StawkaIlosc – uzupełni stawkę za ilość
StawkaIloscM – mianownik stawki za ilość
StawkaCzas – uzupełni stawkę za czas
StawkaCzasM – mianownik stawki za czas
StawkaCzasMJedn – jednostka mianownika za czas 0- sekundy, 1-minuty, 2-godziny, 3-dni, 4-tygodni

Stawka stała, Stawka il., Stawka czas

Dodanie operacji XLNowaCzynnoscTechnologia

Funkcja umożliwia dodanie operacji do technologii na podstawie przekazanej struktury XLProdTechnologiaCzynnoscInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Kod – ustalony kod operacji
Nazwa – Ustalona nazwa operacji
IDTechnologii – ID utworzonej wcześniej technologii (PTE_ID CDN.ProdTechnologia)

Przy tworzeniu operacji do technologii możemy uzupełnić np. ilość, czas planowany, rozliczeniowy. Czy dana operacja ma być wymagana, czy można stosować dowolne materiały, czy może być podzielona na wiele terminów. Aby uzupełnić te pola należy użyć:

CzasPlanowany – czas planowany dla operacji
CzasPlanowanyJedn – jednostka czasu planowanego 0-sekundy, 1-minuty, 2-godziny, 3-dni, 4-tygodnie
CzasRozliczeniowy – czas rozliczeniowy operacji
CzasRozliczeniowyJedn- jednostka czasu rozliczeniowego
Wamagana – czy operacja ma być wymagana
DowolneZasoby – czy można dodawać dowolne materiały do operacji

Dodanie operacji z uzupełnieniem czasu planowanego i rozliczeniowego, zaznaczeniu parametru wymagana oraz dowolne materiały

Dodanie gniazda roboczego XLNowaFunkcjaCzynnoscTechnologia

Za pomocą danej funkcji można dodać gniazdo robocze do operacji w technologii, funkcja działa na podstawie przekazanej struktury XLProdTechnologiaFunkcjaInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
IdTechnologiaCzynnosc – ID utworzonej wcześniej operacji w technologii (PTC_ID CDN.ProdTechnologiaCzynnosci)
IdFunkcji/KodFunkcji – ID gniazda roboczego (PFU_ID CDN.ProdFunkcje)

Za pomocą funkcji można ustawić parametr Zmienna, Podrzędne oraz ilość zasobów. Należy uzupełnić:

Wszystkie – podrzędna na tak
LiczbaObiektow – liczba zasobów
Zmienna – zmienne zasoby na tak

Dodanie gniazda roboczego do operacji w technologii

Dodanie do operacji w Technologii produkcji XLNowyZasobCzynnoscTechnologia

Za pomocą danej funkcji można dodać materiał lub produkt do operacji w technologii, funkcja działa na podstawie przekazanej struktury XLProdTechnologiaZasobInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Kod – kod zasobu (materiału, produktu)
IdTechnologiaCzynnosc – ID utworzonej wcześniej operacji w technologii (PTC_ID CDN.ProdTechnologiaCzynnosci)

Za pomocą funkcji można dodać np. materiał, produkt, materiał pomocniczy, półprodukt, zmiennik, można również wskazać odpowiedni magazyn, ilość, określić koszt.

Aby dodać składniki do operacji w technologii należy skorzystać z:

Kod – kod towaru
Nazwa – nazwa towaru
TwrKod – kod kartoteki towarowej (bez uzupełnionego pola zostanie dodany wirtualny składnik)
Ilosc – ilość towaru
TypZasobu – 0-produkt, 1-surowiec, 2-materiał pomocniczy
Zamiennik – Id zasobu dla którego jest to zamiennik
TechnologiaZasob – Id produktu z innej operacji (aby dodać półprodukt)
Koszt – typ kosztu 0-rzeczywisty, 1-ewidencyjny, 2-ważony, 3-cena zakupu
MagNumer – GIDNumer magazynu

Dodanie materiałów, produktów do operacji w technologii

Utworzenie Zlecenia Produkcyjnego ZP

Aby utworzyć Zlecenie Produkcyjne za pomocą API udostępnione są następujące funkcje:

XLNoweZlecenieProd
XLDodajDoZleceniaProd
XLZamknijZlecenieProd

Dodanie nowego Zlecenia Produkcyjnego XLNoweZlecenieProd

Za pomocą danej funkcji można dodać nowe Zlecenie Produkcyjne, funkcja działa na podstawie przekazanej struktury XLZlecenieProdInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API

Aby do zlecenia produkcyjnego dodać kontrahenta, uzupełnić rezerwuj zasoby, priorytet rezerwacji czy zlecenia:

KntNumer/KntDNumer – GID kontrahenta głównego/docelowego
KntTyp/KntDTyp – typ kontrahenta głównego/docelowego
RezerwujZasoby – 0-rezerwuj zasoby, 1-nie rezerwuj zasobów, -1-ustawienia z definicji dokumentu
PriorytetRez -10 wysoki, 20-standardowy, 30-niski
PriorytetZlc -10 wysoki, 20-standardowy, 30-niski

Dodanie Zlecenia Produkcyjnego

Dodanie elementu/procesu do Zlecenia Produkcyjnego XLNoweZlecenieProd

Za pomocą danej funkcji można dodać element/proces do Zlecenia Produkcyjnego, funkcja działa na podstawie przekazanej struktury XLZlecenieProdElemInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Typ – dodanie elementu/procesu
TwrNumer/Towar – GIDNumer towaru/ kod towaru

Aby dodać element/proces należy uzupełnić wartości tj:

Typ – element zlecenia 14343, proces 14344
Technologia – Id technologii
TwrTyp – GIDTyp towaru
TwrNumer – GIDNumer towaru
IdZlecenia – Id zlecenia produkcyjnego
PlanowacOd – wartość<0-planowac na zadany termin, 0-od teraz, wartość>0-planowac od zadanego terminu
Ilosc – ilość towaru

Dodanie elementu zlecenia produkcyjnego

Dodany element zlecenia produkcyjnego

Dodanie procesu do zlecenia produkcyjnego

Planowanie/przeplanowanie/rozliczanie/zamykanie Zlecenia Produkcyjnego XLZamknijZlecenieProd

Za pomocą danej funkcji można zaplanować, przeplanować, rozliczyć oraz zamknąć Zlecenie Produkcyjne, funkcja działa na podstawie przekazanej struktury XLZlecenieProdZamknijInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Id – Id zlecenia produkcyjnego

Aby zaplanować zlecenie należy uzupełnić wartości:

Akcja – 3-planowanie, 4-planowanie całościowe, 5-przeplanowywanie, 6-rozliczanie, 7-zamknięcie

1024 – Planowanie zgrubne

1280 – Planowanie uproszczone

1536 – Planowanie szczegółowe

1792 – Planowanie wszystkie zasoby

2048 – Planowanie całościowe zgrubne

2304 – Planowanie całościowe uproszczone

2560 – Planowanie całościowe szczegółowe

2816 – Planowanie całościowe wszystkie zasoby

4096 – Przeplanowywanie zgrubne

4352 – Przeplanowywanie uproszczone

4608 – Przeplanowywanie szczegółowe

4864 – Przeplanowywanie wszystkie zasoby

8192 – Przeplanowywanie konfliktów zgrubne

8448 – Przeplanowywanie konfliktów uproszczone

8704 – Przeplanowywanie konfliktów szczegółowe

8960 – Przeplanowywanie konfliktów wszystkie zasoby

16896 – Dobierz zasoby szczegółowo

17152 – Dobierz zasoby wszystkie

8 – Zamknięcie niezrealizowanego zlecenia

9 – Zamknięcie bez rozliczenia

10 – Zamknięcie niezrealizowanego zlecenia bez rozliczenia

16 – Aktualizacja rezerwacji

Id -Id zlecenia

Zaplanowanie zlecenia produkcyjnego

Realizacja Zlecenia Produkcyjnego XL

Aby zrealizować Zlecenie Produkcyjne za pomocą API udostępnione są następujące funkcje:

XLDodajCzynnoscDoProcesuProd
XLDodajZasobDoProcesuProd
XLDodajObiektDoCzynnosciProd
XLDodajTerminDoProcesuProd
XLDodajRealizacjeOperacjiProd
XLProdZmienIloscRealizacji
XLProdRealizacjaZmianaPZA

Dodanie realizacji operacji do procesu XLDodajCzynnoscDoProcesuProd

Funkcja na podstawie przekazanej struktury ProdCzynnoscProcesuInfo dodaje operację do procesu produkcyjnego.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
Proces – Id procesu produkcyjnego
TechnologiaCzynnosc/Realizuje – Id operacji w technologii, Id operacji realizowanej

Aby wykonać realizację operacji należy uzupełnić następujące pola:

Proces – Id procesu produkcyjnego
TechnologiaCzynnosc/Realizuje – Id operacji w technologii, Id operacji realizowanej
CzyGenerowacRezerwacje – czy generować rezerwacje
CzyPrzenosicZasobyITerminy – czy przepisywać zasoby

0 – dodaj 1 termin bez zasobów,

1 – dodaj termin i przepisz zasoby,

2 – realizuj termin (pierwszy znaleziony) bez zasobów,

3 – realizuj termin (pierwszy znaleziony) i przepisz zasoby,

4 – realizuj wszystkie terminy bez zasobów,

5 – realizuj wszystkie terminy i przepisz zasoby,

6 – realizuj pozostałe terminy bez zasobów,

7 – realizuj pozostałe terminy i przepisz zasoby

Ilosc – uruchamiana ilość

Realizacja pierwszej operacji zlecenia bez dodania zasobów

Realizacja pierwszej operacji zlecenia z dodaniem zasobów

Dodanie zasobu do realizacji XLDodajZasobDoProcesuProd

Funkcja na podstawie przekazanej struktury ProdZasobCzynnoscInfo dodaje zasób do realizacji.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
IdCzynnosci – Id operacji na zleceniu

Aby dodać zasób na zrealizowaną operacje należy uzupełnić opla:

IdCzynnosci – Id operacji zrealizowanej
TechnologiaZasob – Id zasobu w technologii
TypZasobu – 0 – produkt, 1 – surowiec, 2 – materiał pomocniczy
Ilosc – pobrana lub wydana ilość

Dodanie zasobu typu surowiec na realizację

Dodanie Zasobu z gniazda roboczego XLDodajObiektDoCzynnosciProd

Funkcja na podstawie przekazanej struktury ProdObiektCzynnoscInfo dodaje obiekt do operacji.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
IdCzynnosci – Id operacji na zleceniu
IdFunkcji – Id gniazda roboczego
IdObiektu – Id obiektu

Aby dodać zasób z gniazda roboczego na realizacje należy uzupełnić:

IdCzynnosci – Id operacji zrealizowanej
IdFunkcji – Id gniazda roboczego
IdObiektu – Id obiektu-zasobu

Dodanie obiektu zasobu na realizację

Dodanie terminu do realizacji XLDodajTerminDoProcesuProd

Funkcja na podstawie przekazanej struktury ProdTerminCzynnoscInfo dodaje termin do operacji.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
IdCzynnosci – Id operacji realizacji na zleceniu
TerminOd – termin rozpoczęcia
TerminDo – termin zakończenia

Aby dodac kolejny termin do operacji należy uzupełnić pola:

IdCzynnosci – Id operacji realizowanej
TerminOd – termin rozpoczęcia (format daty np. 871947322)
TerminDo – termin zakończenia (format daty np. 871947322)
CzasRozliczeniowy – czas rozliczeniowy w sekundach

Dodanie terminu na realizację

Dodanie realizacji operacji XLDodajRealizacjeOperacjiProd

Funkcja umożliwia dodanie realizacji na zleceniu.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API

Aby dodać realizację na zlecenie należy uzupełnić pola:

OperacjaId – Id operacji na zleceniu
Akcja – 0 – dodanie zakończonej realizacji wg domyślnego sposobu z konfiguracji MES,1 – rozpoczęcie realizacji, 2 – zakończenie realizacji
Tryb – uwzględniany, jeśli dodawane jest rozpoczęcie realizacji; w pozostałych przypadkach – tryb ustalany na podstawie sposobu realizacji
SposobRealizacji – 0 – wg konfiguracji MES,1- realizuj termin, 2 – realizuj etap,3- realizuj wszystkie, 4 – realizuj termin bez edycji, 5 – realizuj wszystkie bez edycji, 6 – realizuj pozostałe, 7 – realizuj pozostałe bez edycji
CzasZakonczenia – 0 – wg konfiguracji MES, 1 – wg konfiguracji PI, 2 – wg czasu rzeczywistego, 3 – wg planu

Rozpoczęcie realizacji operacji

Zmiana ilości operacji realizowanej XLProdZmienIloscRealizacji

Funkcja umożliwia zmianę ilości realizacji na zleceniu.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API

Aby zmienić ilość należy uzupełnić pola:

RealizacjaId – Id realizacji
TypZmiany – 0 – zmiana pola na realizacji, 1 – usunięcie realizacji
Ilosc – ilość jaka ma zostać ustawiona

Zmiana ilości operacji realizowanej

Zmiana zasobu zlecenia XLProdRealizacjaZmianaPZA

Funkcja umożliwia zmianę ilości, magazynu lub usunięcie pozycji.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API

Aby zmienić ilość należy uzupełnić pola:

PZAId – Id zasobu na realizacji
TypZmiany – 0- zmiana pola na zasobie (magazyn i/lub ilość),1- usunięcie zasobu
Ilosc – ilość jaka ma zostać zmieniona
MagNumer – Id magazynu

Zmiana ilości produktu na realizowanej operacji

Generowanie dokumentów do Zlecenia Produkcyjnego

Aby utworzyć dokumenty do Zlecenia Produkcyjnego za pomocą API udostępnione są następujące funkcje:

XLProdObiektyDoDokumentow
XLProdGenerujDokumentyDlaObiektow
XLSpinajZasobyZDokumentami

Dodanie obiektów produkcyjnych w celu generowania dokumentów RW/PW do Zlecenia Produkcyjnego XLProdObiektyDoDokumentow

Za pomocą funkcji XLProdObiektyDoDokumentow można zbudować listę obiektów produkcyjnych, które będą uwzględnione podczas generowania dokumentów do wskazanych obiektów lub spinania tych obiektów z dokumentami. Pojedyncze wywołanie funkcji dodaje jeden obiekt do listy. Aby dodać kolejne elementy, należy więc dla każdego z nich wywołać niniejszą funkcję. Jako parametry funkcja przyjmuje identyfikator GID obiektu dodawanego do listy.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
GidTyp – GIDTyp dokumentu dodawanego do listy
GidNumer – GIDNumer dokumentu dodawanego do listy

Aby dodać obiekt w celu wygenerowania dokumentu RW/PW, dowiązania już wygenerowanego dokumentu RW/PW należy uzupełnić następujące pola:

GidTyp – wpisać typ obiektu 14343-ZP/HPR, 14345-operacja, 14346-surowiec/produkt, lub wskazać typ wygenerowanego dokumentu 1616-RW, 1617-PW
GidNumer – wskazać ID zlecenia, operacji, surowca/produktu, lub wskazać numer wygenerowanego już dokumentu

Generowanie dokumentów RW/PW do Zlecenia Produkcyjnego XLProdGenerujDokumentyDlaObiektow

Funkcja pozwala na wygenerowanie dokumentów RW/PW do obiektów, dodanych za pomocą funkcji XLProdObiektyDoDokumentowInfo.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
TypDokumentu – typ generowanego dokumentu 1616-RW 1617-PW
TypObiektu – typ obiektu z którego generujemy dokument 14343-ZP/HPR, 14345-operacja, 14346-surowiec/produkt

Aby wygenerować dokument RW/PW należy uzupełnić następujące wartości:

TypDokumentu – typ dokumentu 1616-RW, 1617-PW
TypObiektu – 14343-ZP/HPR, 14345-operacja, 14346-surowiec/produkt
TrybZamykaniaDok – tryb zamknięcia dokumentu -10 – zatwierdzenie bez wydruku; -5 – zamknięcie dokumentu z ustalonym kosztem; -3 – zamknięcie otwartego dokumentu; -2 – anulowanie zatwierdzonego dokumentu; -1 – skasowanie; 0 – zatwierdzenie; 1 – bufor; 2 – drukowanie dokumentu; 10 – zatwierdzenie i wydrukowanie dokumentu

Log generowania dokumentu

Wygenerowany dokument PW

Spinanie pozycji zlecenia produkcyjnego materiału/produktu z dokumentem RW/PW XLSpinajZasobyZDokumetami

Funkcja pozwala na spinanie dokumentów RW/PW dodanych za pomocą funkcji XLProdObiektyDoPowiazania do obiektów dodanych za pomocą funkcji XLProdObiektyDoDokumentow.

Dla funkcji należy uzupełnić wartości:

Wersja – numer wersji API
TypDokumentu – typ spinanego dokumentu 1616-RW 1617-PW
TypObiektu – typ obiektu do którego dowiązujemy dokument 14343-ZP/HPR, 14345-operacja, 14346-surowiec/produkt

Aby dowiązać już istniejący dokument RW/PW do obiektu należy uzupełnić następujące wartości:

TypDokumentu – typ dokumentu 1616-RW 1617-PW
TypObiektu – 14343-ZP/HPR, 14345-operacja, 14346-surowiec/produkt
TypOperacji – 0-bez kontroli cechy, 1-wg cechy dostawy (RW), 2-wg cechy towaru

Lista dokumentów do spięcia