Studio TCS.net udostępnia zewnętrznemu systemowi metodę API, która zwraca koszty wydań narzędzi i części według MPK, pracownika albo pozycji. Wartość każdej pozycji to ilość razy cena ewidencyjna. Zapytanie wysyła się w formacie JSON i zawiera dane logowania. Funkcja jest w przygotowaniu do wdrożenia.
Funkcja w skrócie
| Cecha | Opis |
|---|---|
| Produkt | Studio TCS.net, moduł narzędziowni i utrzymania ruchu w platformie StudioSystem ST 26 |
| Funkcja | Metoda API zwracająca koszty wydań (dokumenty RW i LK) z grupowaniem wg MPK, pracownika lub pozycji |
| Dla kogo | Dział, który pobiera koszty do własnego systemu, oraz administrator integracji po stronie firmy |
| Gdzie w programie | Dashboard, zakładka Integracja, przykład zapytania i odpowiedzi dla kosztów wydań |
| Status | w przygotowaniu do wdrożenia; wdrożenie po uzgodnieniu zakresu |
| Wymagania | Dane logowania do usługi API programu oraz zakres dat w zapytaniu |
| Integracje | Wywołanie metody przez system zewnętrzny w formacie JSON; pozostałe metody katalogu nie są opisane |
| Granice | Metoda zwraca koszty wydań i nie opisuje innych operacji API |
Dla kogo i kiedy metoda ma sens
Koszty narzędzi i części zwykle żyją w dwóch miejscach: w magazynie narzędziowni i w systemie finansowym. Przepisywanie wydań z jednego do drugiego raz w miesiącu jest powolne i łatwo się w nim pomylić. Metoda API pozwala systemowi zewnętrznemu pobrać koszty wydań bez ręcznego eksportu, a grupowanie od razu odpowiada na pytanie, kto, na jakie MPK albo jaka pozycja zużyła materiał.
Metoda jest przydatna, gdy firma ma system księgowy lub kontroling, który przyjmuje koszty według MPK, i gdy chce, by dane źródłowe pochodziły z dokumentów RW i LK zapisanych w narzędziowni.
Metoda nie prowadzi ewidencji kosztów w systemie finansowym i nie wykonuje księgowania. Zwraca zestawienie wydań, a decyzje o ujęciu kosztów należą do działu, który je przyjmuje.
Co zmienia się w pracy
| Zadanie | Jak to wygląda ręcznie lub w arkuszu | Jak to wygląda z metodą API |
|---|---|---|
| Zestawienie kosztów za okres | Eksport z programu i ręczne sumowanie wartości | Zapytanie z zakresem dat zwraca gotowe sumy |
| Podział kosztów na MPK | Sortowanie wierszy według MPK w arkuszu | Grupowanie wg MPK w odpowiedzi |
| Koszty przypisane do pracownika | Zestawienie wydań dla każdej osoby osobno | Grupowanie wg pracownika w odpowiedzi |
| Koszty w rozbiciu na pozycje | Ręczne wyszukiwanie artykułów w zestawieniu | Grupowanie wg pozycji, z ilością i wartością |
Jak to działa
Zewnętrzny system wywołuje metodę zapytaniem w formacie JSON. Zapytanie zawiera dane logowania oraz parametry: datę początkową i końcową w formacie RRRR-MM-DD, sposób grupowania oraz opcjonalnie filtr MPK, pracownika i listę typów dokumentów. Sposób grupowania przyjmuje jedną z trzech wartości: mpk, employee albo line. Typy dokumentów w przykładzie to RW i LK, czyli rozchód z magazynu i protokół likwidacyjny.
Program liczy wartość każdej pozycji jako ilość razy cena ewidencyjna z kartoteki narzędzia lub części.
Odpowiedź zawiera status, wybrane grupowanie, walutę, liczbę wierszy, sumę całkowitą oraz listę pozycji. Każda pozycja ma klucz grupy, na przykład numer MPK, oraz liczbę wierszy, ilość i wartość. Suma całkowita pokazuje wartość wszystkich grup w zakresie.
Grupowanie wg MPK odpowiada na pytanie, ile kosztów wydań przypada na każde miejsce powstawania kosztów. Grupowanie wg pracownika pokazuje, kto pobrał najwięcej narzędzi lub materiałów w zakresie dat. Grupowanie wg pozycji pokazuje, które artykuły generują koszt. Każdy z tych widoków korzysta z tego samego zapytania i różni się tylko kluczem grupy, więc zmiana sposobu zestawienia nie wymaga zmiany integracji.
Parametry opcjonalne zawężają wynik. Filtr MPK ogranicza zestawienie do jednego miejsca powstawania kosztów, a filtr pracownika do jednej osoby. Gdy filtry są puste, zestawienie obejmuje wszystkie wydania w zakresie dat. Lista typów dokumentów decyduje, czy do sumy wchodzą tylko wydania RW, czy także protokoły LK.
Przykład zapytania i odpowiedzi jest na zakładce Integracja dashboardu. Pokazuje on strukturę bez danych logowania. Wartości w przykładzie są fikcyjne, a dane logowania są pominięte.
Co dostajesz
| Element | Do czego służy | Kto z niego korzysta | Gdzie w programie |
|---|---|---|---|
| Parametry zakresu dat | Wybór okresu wydań | System zewnętrzny | Zapytanie w formacie JSON |
| Grupowanie mpk, employee, line | Wybór klucza zestawienia | System zewnętrzny | Zapytanie, parametr groupBy |
| Filtry MPK i pracownika | Zawężenie wyniku do jednego MPK lub jednej osoby | Dział kosztów | Zapytanie, parametry opcjonalne |
| Odpowiedź z sumą | Gotowe wartości do zaksięgowania przez dział | Dział kosztów | Odpowiedź metody |
Scenariusz dnia
Przykład: system kosztowy firmy przykładowej wysyła na początku miesiąca zapytanie za poprzedni miesiąc z grupowaniem wg MPK. Program zwraca listę MPK z ilością i wartością wydań RW i LK w zakresie dat. Dział kosztów sprawdza sumę całkowitą w odpowiedzi, porównuje ją z zestawieniem w narzędziowni i przyjmuje koszty do księgowania. Ten sam dział po kwartale zmienia grupowanie na pracownika, aby sprawdzić, kto pobiera najwięcej narzędzi.
Połączenia z resztą platformy
Metoda czyta dokumenty RW i LK, które powstają w narzędziowni i przy zleceniach CMMS. Wartości pochodzą z cen ewidencyjnych kartotek. Zakładka Integracja na dashboardzie pokazuje metodę obok innych elementów API, ale ta strona opisuje tylko metodę kosztów wydań.
Wykres zużycia materiałów RW według MPK na kokpicie czyta dokumenty RW tej samej narzędziowni. Przy tym samym zakresie dat oba widoki można więc porównać, zanim koszty trafią do działu, który je przyjmuje.
Czego funkcja nie robi
- Metoda zwraca koszty wydań.
- Opisana jest tylko metoda kosztów wydań wg MPK, pracownika i pozycji. Pozostałe metody katalogu API roli nie są tu opisane.
- Wartość pozycji liczy się z cen ewidencyjnych, a nie z cen zakupu.
Funkcja jest w przygotowaniu do wdrożenia; wdrożenie po uzgodnieniu zakresu.
Jak zacząć
Przed uruchomieniem metody trzeba mieć dane logowania do usługi API, kartoteki z cenami ewidencyjnymi oraz uzgodniony format przyjmowania kosztów po stronie działu. Trzeba też wiedzieć, które typy dokumentów mają wejść do zestawienia. Konfigurację wykonuje zespół Studio TCS.net po uzgodnieniu zakresu, a sposób połączenia z systemem zewnętrznym ustala się przy wdrożeniu.
Przed rozmową o wdrożeniu warto odpowiedzieć na pięć pytań:
- Jaki klucz kosztowy przyjmuje system: MPK, pracownik czy pozycja?
- Czy koszty mają obejmować tylko RW, czy także protokoły likwidacyjne LK?
- Kto prowadzi dostęp do usługi API po stronie firmy?
- Jaka jest częstotliwość pobierania kosztów: raz w miesiącu, czy częściej?
Jak ocenić takie rozwiązanie
| Pytanie do dostawcy | Jak to wygląda w Studio TCS.net |
|---|---|
| Jak liczona jest wartość pozycji? | Ilość razy cena ewidencyjna z kartoteki. |
| Jak można grupować wynik? | Wg MPK, pracownika albo pozycji. |
| Czy metoda zapisuje dane w programie? | Nie. Metoda zwraca zestawienie kosztów wydań. |
| Jakie dokumenty wchodzą do zestawienia? | Wydania RW i protokoły LK, jako typy dokumentów zapytania. |
| Czy dane logowania dają dostęp do wszystkich metod? | Zakres dostępu ustala się przy wdrożeniu. Ten opis dotyczy tylko metody kosztów. |
Powiązane strony
Dokumenty RW i LK, z których liczone są koszty, opisuje strona Dokumenty magazynu narzędziowni: dwanaście typów w jednym oknie. Koszty części zleceń naprawy zapisuje strona Zlecenie CMMS: części, czynności, pracownicy i anulowanie. Zestawienia na dashboardzie opisuje strona Kokpit narzędziowni i utrzymania ruchu w Studio TCS.net.
Architekturę interfejsu opisuje artykuł o architekturze SOA i REST API, a rozliczanie według MPK w programie artykuł o rozliczaniu kosztów narzędzi według MPK. Ogólny opis programu jest w dziale o programie do narzędziowni.