Systim API - Zarządzanie dokumentami magazynowymi

addStoreDocument

Dodanie nowego dokumentu magazynowego

Wymagane parametry

token, id_magazynu, data_wystawienia,
data_wydania - dla dokumentów wydania (WZ, WW, WP)
data_przyjecia - dla dokumentów przyjęcia (PZ, ZW, PRW)
data_operacji, id_magazynu_zrodlowego - dla przesunięcia międzymagazynowego (MM)

rodzaj:
3 - Przyjęcie na magazyn (PZ)
9 - Zwrot wewnętrzny (ZW)
20 - Protokół wprowadzenia (PRW)
4 - Wydanie z magazynu (WZ)
10 - Wydanie wewnetrzne (WW)
11 - Wydanie na produkcję (WP)
8 - Przesunięcie międzymagazynowe (MM)

wymagane są pola produktów, tablica pozycje[], zawierająca elementy:

ilosc, cena_netto, id_produktu, jednostka

Opcjonalne parametry

uwagi, id_szablonu, id_numeracji, id_faktury, id_kontrahenta

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zawiera zmienną id dodanego dokumentu
W przypadku niepowodzenia:
$dane['error']['code']>0

Przykład wywołania w PHP

					//tablica zawierająca 2 pola WZ/PZ wraz z id produktu,ilością,kwotą i ceną netto, jednostką, stawką vat, 
					//kwotą vat i kwotą brutto
					$produkty['pozycje'][0] = array('cena_netto'=>2,'ilosc'=>1,'id_produktu'=>2,'jednostka'=>'kg');
					$produkty['pozycje'][1] = array('cena_netto'=>2,'ilosc'=>1,'id_produktu'=>3,'jednostka'=>'kg');
					$pozycje =  http_build_query($produkty);

					$c = curl_init();
					curl_setopt($c, CURLOPT_URL, 'https://abcd.systim.pl/jsonAPI.php');
					curl_setopt($c, CURLOPT_POST, true); //sposób przesyłania - (true metoda POST)
					curl_setopt($c, CURLOPT_POSTFIELDS, 'act=addStoreDocument'.
							'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
							'&rodzaj=3'.    // przyjęcie na magazyn
							'&id_kontrahenta=1'.
							'&data_wystawienia=2013-04-28'.
							'&data_przyjecia=2013-04-29'.
							'&id_magazynu=1'.
							'&'.$pozycje);   //id_dostawy=1 - przesyłka kurierska
					curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
					$wynik = curl_exec($c);
					curl_close($c);
					$dane = json_decode($wynik,true); // wartości w postaci tablicy asocjacyjnej

					if($dane['error']['code']>0) die($dane['error']['message']); //sprawdzamy czy wystąpił jakiś błąd, 
																			//jeśli tak, wyświetlamy go
					echo 'Id nowego dokumentu: ' . $dane['result'];

getStoreDocumentPDF

Pobieranie PDF dla istniejącego dokumentu magazynowego

Wymagane parametry

token, id

Opcjonalne parametry

brak

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zawiera zmienną file oraz name pobieranego PDF dokumentu
W przypadku niepowodzenia:
$dane['error']['code']>0

Przykład wywołania w PHP


					 $c = curl_init();
					 curl_setopt($c, CURLOPT_URL, 'https://abcd.systim.pl/jsonAPI.php');
					 curl_setopt($c, CURLOPT_POST, true); //sposób przesyłania - (true metoda POST)
					 curl_setopt($c, CURLOPT_POSTFIELDS, 'act=getStoreDocumentPDF'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&id=8'); 
					 curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
					 $wynik = curl_exec($c);
					 curl_close($c);
					 $dane = json_decode($wynik,true); // wartości w postaci tablicy asocjacyjnej
					 
					 if($dane['error']['code']>0) die($dane['error']['message']); //sprawdzamy czy wystąpił jakiś błąd, 
																				//jeśli tak, wyświetlamy go

					 // dekodujemy i wstawiamy zawartość pliku pdf do zmiennej by potem ją zapisać, lub umożliwić pobranie
					 $fakturaPDF = base64_decode($dane['result']['file']);	
					 // nazwa pliku pdf
					 $nazwaPDF = $dane['result']['name'];

listStoreDocuments

Pobranie listy dokumentów magazynowych

Wymagane parametry

token,

Opcjonalne parametry

ids (id dokumentów rozdzielane przecinkami np. 3,4,5,2)
data (data określająca rok i miesiąc wystawienia dokumentów np. 2022-01)
data_od
data_do (zakres dat dla zakresu wyniku np. data_od=2021-02-01 data_do=2021-02-03)

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - jest tablicą asocjacyjną o wartościach:
id, kontrahent, id_kontrahenta, kwota_netto, data_operacji, numer_dokumentu, data_wystawienia, rodzaj,
W przypadku niepowodzenia:
$dane['error']['code']>0

Rodzaje dokumentów

3 - Przyjęcie na magazyn (PZ)
9 - Zwrot wewnętrzny (ZW)
20 - Protokół wprowadzenia (PRW)
4 - Wydanie z magazynu (WZ)
10 - Wydanie wewnetrzne (WW)
11 - Wydanie na produkcję (WP)
8 - Przesunięcie międzymagazynowe (MM)

Przykład wywołania w PHP


					 $c = curl_init();
					 curl_setopt($c, CURLOPT_URL, 'https://abcd.systim.pl/jsonAPI.php');
					 curl_setopt($c, CURLOPT_POST, true); //sposób przesyłania - (true metoda POST)
					 curl_setopt($c, CURLOPT_POSTFIELDS, 'act=listStoreDocuments'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&ids=6,7,8'); 
					 curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
					 $wynik = curl_exec($c);
					 curl_close($c);
					 $dane = json_decode($wynik,true); // wartości w postaci tablicy asocjacyjnej
					 
					 if($dane['error']['code']>0) die($dane['error']['message']); //sprawdzamy czy wystąpił jakiś błąd, 
																				//jeśli tak, wyświetlamy go
																				 
					 // Dane wylistowanych faktur
					 
					 foreach($dane['result'] as $id=>$dane)
					 {
						echo 'Id faktury: ' . $id . ' Numer faktury: ' . $dane['numer_dokumentu'] . 
							 ' Rodzaj: ' . $dane['rodzaj'] . ' Nazwa kontrahenta: ' . $dane['kontrahent'] .
							 ' Data operacji: ' . $dane['data_operacji'] . ' Kwota netto: ' . $dane['kwota_netto'] .
							 ' Data wystawienia: ' . $dane['data_wystawienia'] . 
							 ' Id kontrahenta: ' . $dane['id_kontrahenta'] . '
';
					 }

getStoreDocument

Pobranie danych dokumentu przyjęcia/wydania

Wymagane parametry

token, id

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result']['faktura'] - jest tablicą asocjacyjną o wartościach:
numer_faktury, pelny_numer, rodzaj, id_kontrahenta, kontrahent, data_wystawienia, data_operacji, kwota_netto, magazyn, uwagi, dostawa, powiazany_dokument
$dane['result']['adres'] - jest tablicą asocjacyjną o wartościach:
odbiorca, nip, kod, miejscowosc, ulica, wojewodztwo, panstwo oraz:
$dane['result']['pola'] - jest tablicą asocjacyjną o wartościach:
id, id_faktury, id_produktu, ilosc, cena_netto, kwota_netto, jednostka, opis, pkwiu, numer_seryjny, kod_produktu, kod_kreskowy, id_pola_faktur, ilosc_wydania
$dane['result']['wydania_z_dostaw'][] - jest tablicą asocjacyjną o wartościach:
id_pozycji_wydania, ilosc

W przypadku niepowodzenia:
$dane['error']['code']>0

Przykład wywołania w PHP


 $c = curl_init();
 curl_setopt($c, CURLOPT_URL, 'https://abcd.systim.pl/jsonAPI.php');
 curl_setopt($c, CURLOPT_POST, true); //sposób przesyłania - (true metoda POST)
 curl_setopt($c, CURLOPT_POSTFIELDS, 'act=getStoreDocument'.
            '&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
            '&id=4'); 
 curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
 $wynik = curl_exec($c);
 curl_close($c);
 $dane = json_decode($wynik,true); // wartości w postaci tablicy asocjacyjnej
  
 if($dane['error']['code']>0) die($dane['error']['message']); //sprawdzamy czy wystąpił jakiś błąd, 
                                                            //jeśli tak, wyświetlamy go
                                                              
 // Dane wylistowanych faktur
  
 $dane_faktury = $dane['result']['faktura'];
 
echo 'Id faktury: ' . $id . ' Numer faktury: ' . $dane_faktury['numer_faktury'] . 
     ' Data operacji: ' . $dane_faktury['data_operacji'] . ' Nazwa kontrahenta: ' . $dane_faktury['kontrahent'] .
     ' Rodzaj: ' . $dane_faktury['rodzaj'] . ' Kwota netto: ' . $dane_faktury['kwota_netto'] .
     ' Data wystawienia: ' . $dane_faktury['data_wystawienia'] . ' Id kontrahenta: ' . $dane_faktury['id_kontrahenta'] .
	 ' Id powiązanej faktury: ' . $dane_faktury['powiazany_dokument'] .
     '
';
  
 foreach($dane['result']['pola'] as $numer_pola=>$pole)
 {
     echo '

ID faktury: ' . $pole['id_faktury'] . '
            ID produktu: ' . $pole['id_produktu'] . '
            Ilosc: ' . $pole['ilosc'] . '
            Cena netto: ' . $pole['cena_netto'] . '
            Kwota netto: ' . $pole['kwota_netto'] . '
            Jednostka: ' . $pole['jednostka'] . '
            Opis: ' . $pole['opis'] . '
            PKWiU: ' . $pole['pkwiu'] . '
            Numer seryjny: ' . $pole['numer_seryjny'] . '
            Kod produktu: ' . $pole['kod_produktu'] . '
            Kod kreskowy: ' . $pole['kod_kreskowy'];
 }
 
 foreach($dane['result']['wydania_z_dostaw'][0] as $numer_pola=>$pole)
 {
     echo '


            Powiązane pola faktur: ' . $pole['id_pozycji_wydania'];
            Ilość wydanych produktów: ' . $pole['iloscj'];
 }

delStoreDocument

Usunięcie wskazanego dokumentu magazynowego.

Wymagane parametry

token, id

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zawiera zmienną id dodanego dokumentu
W przypadku niepowodzenia:
$dane['error']['code']>0

Przykład wywołania w PHP

 $c = curl_init();
 curl_setopt($c, CURLOPT_URL, 'https://abcd.systim.pl/jsonAPI.php');
 curl_setopt($c, CURLOPT_POST, true); //sposób przesyłania - (true metoda POST)
 curl_setopt($c, CURLOPT_POSTFIELDS, 'act=delStoreDocument'.
            '&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
            '&id=4'); 
 curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
 $wynik = curl_exec($c);
 curl_close($c);
 $dane = json_decode($wynik,true); // wartości w postaci tablicy asocjacyjnej
  
 if($dane['error']['code']>0) die($dane['error']['message']); //sprawdzamy czy wystąpił jakiś błąd, 
                                                            //jeśli tak, wyświetlamy go

Opinie naszych klientów

Marian
specjalista ds. obsługi sklepu internetowego

Dziękuję za możliwość założenia własnego sklepu internetowego wraz z pełną obsługą programu Systim. Dziękuję również za wprowadzenie możliwości zmiany wizualnej sklepu - kody CSS i JavaScript. Jesteście najlepsi w swojej branży :)

Leszek Jankowski
dyrektor oddziału

Szybka faktura dla klienta? Z Systim to nic prostszego, dlatego wybrałem właśnie ten program. Dużą zaletą jest też to, że jest to również program do KPiR i wystawiania umów.

Andrzej Jastrzębski
właściciel firmy handlowej

... to jedyny program do wystawiania faktur online z którego mogę bez problemu wydrukować kilkanaście faktur na raz, bez żadnych problemów z marginesami czy ustawieniami przeglądarki ...

Wojtek
księgowy

Obsługa pełnej księgowości, dzięki Systim jest niewiarygodnie prosta. Polecam.

Marcin Cz.
tester programów

Po przejściu przez wszystkie funkcjonalności programu - jest to nieporównywalny mechanizm we wszystkim.

Tatiana K.
Dyrektor ds. obsługi zamówień

Nowości prawne wdrażane są błyskawicznie, a obsługa klienta rozwiąże każdy problem.

Mirosław B.
właściciel własnej firmy

Good job! Program niezastąpiony w naszej firmie od lat. Wystawianie faktur to jedno kliknięcie myszką.

Marcin Z.
firma dystrybucyjna

W końcu program, w którym mogę zarządzać kilkunastoma magazynami w całej Polsce. Dziękuję.

Marcin Jabłoński
współwłaściciel firmy handlowej import-export

Systim to doskonały program do faktur online, pozwalający na komunikację między naszymi biurami w całej Polsce i za granicą.

Marek S.
dyrektor firmy transportowej

Zaufałem Wam i nie żałuje, dobra robota! Program ciągle doskonalony, wszystkie wątpliwości lub braki - rozwiązywane przez Państwa w kilkaście minut, pomoc techniczna - natychmiastowa. Nie znam lepszego programu za taką cenę, to dobrze o Was świadczy.

Tadeusz B.
specjalista ds. obsługi magazynu

Ludzkie podejście, miła obsługa, dopracowany program.

Martyna K.
kierownik ds. kadr i płac

... Bardzo, bardzo dziękuję! udało się dodać zwolnienie - wszystko jak Państwo piszą, przepraszam, że byłam taka uciążliwa, ale to pierwsza lista płac, którą tworzę (u Was) i stąd wiele pytań... system jest ogólnie świetny a wsparcie techniczne chyba najlepsze na jakie trafiłam :):) ...

Jan B.
właściciel mikroprzedsiębiorstwa

Program nie jest doskonały, natomiast jest najpełniejszy ze wszystkich, jakie testowaliśmy. Nikt inny nie proponuje tyle rozwiązań co Systim.

Andrzej W.
właściciel rodzinnej firmy handlowej

... w końcu znalazłem narzędzie które pozwoliło zinformatyzować moją firmę, i to tak niewielkim kosztem ...

Arkadiusz K.
właściciel mikro firmy

Systim to ciągle rozwijające się narzędzie, a dodatkowo na zamówienie wprowadzono bardzo ważną dla mnie funkcję, to niesamowite. Polecam testować, program jest niezawodny.

Mirek
specjalista ds. obsługi zamówień

Cieszę się zmianami jakie ciągle wprowadzacie. Program zrobił ogromny postęp wizualny i funkcjonalny względem samego początku i duży plus za ciągły rozwój. Ciesze się, że śledzicie Państwo na bieżąco przepisy prawa i wymagane obowiązki, dzięki czemu program ciągle jest aktualny z zobowiązującymi przepisami, a zmiany trafiają do systemu dużo szybciej i mogę się z nimi zapoznać. Szacunek do klienta i indywidualne podejście, to Was bardzo wyróżnia.

Małgorzata W.
właściciel firmy

Świetny program, bardzo przyjazny i czytelny dla użytkownika. Poleciłam program paru znajomym firmom w Warszawie. Filmy instruktażowe bardzo pomocne. Dziękujemy.

Marcin Cz.
właściciel sklepu internetowego

Obsługa drukarki fiskalnej i integracja Allegro z Systim - czysta bajka. Polecam i dziękuję.

Marek S.
dyrektor firmy transportowej

Krzysztof W.
właściciel firmy

Dziękuję serdecznie za szybkie rozwiązanie problemu. Od początku naszej współpracy macie nastawienie pro-klient, stąd zawsze polecam i dalej będę Wasze usługi.

Marta
przedsiębiorca

Gdy zakładałam firmę nawet nie wiedziałam jak wystawić fakturę. Z Systim okazało się to wręcz śmiesznie proste.

Marta F.
właścicielka biura tłumaczeń

... to dokładnie to czego szukałam [...] a w momencie, gdy zabrakło mi ważnej funkcji, szybko wprowadzono ją na zamówienie ...

Anna M.
firma transportowa

... myśląc o rozwoju firmy potrzebujemy nie programu komputerowego, ale partnera, który rozumie potrzeby firmy z sektora MSP ...

Zbigniew B.
kierownik działu sprzedaży

... porównanie cenników mówi samo za siebie [...] przeszliśmy na program do faktur Systim bo po prostu jest taniej ...

Agnieszka Mielska
sklep internetowy

Bardzo dziękuję za wprowadzenie obsługi drukarek fiskalnych - w końcu mogę wszystko robić w jednym programie, a nie w trzech jak dotychczas.

Zdzisław W.
właściciel rodzinnej firmy produkcyjnej

Niemalże codziennie widzę zmiany w systemie, ostatnio nawet ulepszona została szata graficzna. Oby tak dalej, cieszę się że mogę z Wami współpracować, bo widać, że zarówno pracownicy obsługi klienta jak i dbający o jakość produktu nie spoczywają na laurach.

Tomasz
właściciel firmy produkcyjnej

Na rynku są różne programy magazynowe, ale wśród nich Systim wyróżnia się wygodą obsługi, szybkością działania i niezawodnością. Polecam.

Maciej
firma spedycyjna

Systim to nie tylko program do faktur, ale też księgowość internetowa, magazyn i płatności - dlatego jego wybór jest czymś oczywistym dla każdej rozwijającej się firmy.

Robert K.
prezes

Ja przy Systimie zostaję na stałe, ze względu na funkcjonalność i bardzo dobry kontakt z obsługą techniczną.

Systim API - Zarządzanie dokumentami magazynowymi

addStoreDocument

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Przykład wywołania w PHP

getStoreDocumentPDF

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Przykład wywołania w PHP

listStoreDocuments

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Rodzaje dokumentów

Przykład wywołania w PHP

getStoreDocument

Wymagane parametry

Wartości zwracane

Przykład wywołania w PHP

delStoreDocument

Wymagane parametry

Wartości zwracane

Przykład wywołania w PHP

Opinie naszych klientów

KONTAKT

OFERTA

POMOC