Systim API - Zarządzanie kontrahentami

addCompany

Dodanie nowego kontrahenta

Wymagane parametry

token, nazwa, miejscowosc, kod, ulica

Opcjonalne parametry

nip, nazwa_skrot, id_wojewodztwa, panstwo,
miejscowosc_dostawy, nazwa_dostawy, kod_dostawy, id_wojewodztwa_dostawy, panstwo_dostawy,
regon,uwagi,email,www,telefon,fax,id_ratingu,symbol_kontrahenta

id_grupy_cenowej - domyślnie 1

nipeu - jeśli jest to firma o ID = 1 (czyli właściciel programu) to pole to przyjmuje wartość będącą numerem NIP EU. Jeśli jest to inna firma (kontrahent) to w tym polu podajemy numer państwa EU w którym siedzibę ma dany kontrahent.

termin_platnosci (int) - domyślny termin płatności (w dniach) na fakturach dla tego kontrahenta (termin_platnosci = 0 - zapłacono)

zaplanowany_kontakt - data w formacie YYYY-MM-DD

id_handlowca - id użytkownika przypisanego do danego kontrahenta. Jeśli nie podano to id użytkownika logującego się do API konto_kontrahenta,bank_kontrahenta - pola dotyczą wyłącznie kontrahentów

Wartości zwracane

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

Uwagi

Aby został dodany adres dostawy należy wypełnić co najmniej jedno z pól:
miejscowosc_dostawy, nazwa_dostawy, ulica_dostawy, kod_dostawy

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=addCompany'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&nazwa=Enadis'.
								'&miejscowosc=Gdynia'.
								'&ulica=al. Zwycięstwa 96/98'.
								'&kod=81-451'.
								'&nip=5862120928'.
								'&termin_platnosci=14'.
								'&zaplanowany_kontakt=2013-06-21'.
								'&email=kontakt@enadis.pl'); 
					 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 kontrahenta: ' . $dane['result'];

delCompany

Usunięcie istniejącego kontrahenta

Wymagane parametry

token, id

Opcjonalne parametry

brak

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zawiera zmienną id usuniętego kontrahenta
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=delCompany'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&id=17'); 
					 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 usuniętego kontrahenta: ' . $dane['result'];

updCompany

Edycja istniejącego kontrahenta

Wymagane parametry

token, id, nazwa, miejscowosc, kod, ulica

Opcjonalne parametry

nip, nazwa_skrot, id_wojewodztwa, panstwo, miejscowosc_dostawy, nazwa_dostawy, kod_dostawy, id_wojewodztwa_dostawy, panstwo_dostawy, regon, uwagi, email, www, telefon, fax, id_ratingu, symbol_kontrahenta

id_grupy_cenowej - domyślnie 1

nipeu - jeśli jest to firma o ID = 1 (czyli właściciel programu) to pole to przyjmuje wartość będącą numerem NIP EU. Jeśli jest to inna firma (kontrahent) to w tym polu podajemy numer państwa EU w którym siedzibę ma dany kontrahent.

termin_platnosci (int) - domyślny termin płatności (w dniach) na fakturach dla tego kontrahenta (termin_platnosci = 0 - zapłacono)

zaplanowany_kontakt - data w formacie YYYY-MM-DD

id_handlowca - id użytkownika przypisanego do danego kontrahenta. Jeśli nie podano to id użytkownika logującego się do API konto_kontrahenta,bank_kontrahenta - pola dotyczą wyłącznie kontrahentów

Wartości zwracane

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

Uwagi

Uwagi: Aby został dodany adres dostawy należy wypełnić co najmniej jedno z pól:
miejscowosc_dostawy, nazwa_dostawy, ulica_dostawy, kod_dostawy
Jeśli żadne z tych pól nie zostanie podane to adres dostawy jest usuwany!!

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=updCompany'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&id=18'.
								'&nazwa=Enadis'.
								'&miejscowosc=Gdynia'.
								'&ulica=al. Zwycięstwa 96/98'.
								'&kod=81-451'.
								'&nip=5862120928'.
								'&termin_platnosci=14'.
								'&zaplanowany_kontakt=2013-06-21'.
								'&email=kontakt@enadis.pl'); 
					 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 edytowanego kontrahenta: ' . $dane['result'];

getCompany

Pobranie informacji o kontrahencie

Wymagane parametry

token,
id - id kontrahenta

Opcjonalne parametry

brak

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - jest tablicą asocjacyjną zawierającą:
nazwa, id, nip, nazwa_skrot, nipeu, id_grupy_cenowej, regon, uwagi, email, www, telefon, fax, id_ratingu, naliczanie_odsetek, termin_platnosci , zaplanowany_kontakt, id_handlowca, konto_kontrahenta, bank_kontrahenta, symbol_kontrahenta, miejscowosc, ulica, id_wojewodztwa, kod, panstwo, nazwa_dostawy, miejscowosc_dostawy, ulica_dostawy, id_wojewodztwa_dostawy, kod_dostawy, panstwo_dostawy danego kontrahenta
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=getCompany'.
								'&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
																				
					 echo 'Id kontrahenta: ' . $dane['result']['id'] . ' Nazwa: ' . $dane['result']['nazwa'] . 
						  ' Miejscowość: ' . $dane['result']['miejscowosc'] . ' Ulica: ' . $dane['result']['ulica'] .
						  ' Kod: ' . $dane['result']['kod'] . ' Nip: ' . $dane['result']['nip'];

listCompanies

Lista wszystkich kontrahentów

Wymagane parametry

token

Opcjonalne parametry

ids - zmienna zawierająca ID do wyświetlenia w postaci stringu, gdzie separatorem jest "," np. (1,2,4,12,23,45)
name – zmienna zawierająca nazwę kontrahenta. Możemy również użyć maski (nieznane znaki) znaku '*' jeśli chcemy znaleźć wszystkich kontrahentów o podobnej nazwie np. &name=*an-Kowalsk*
nip – zmienna zawierająca numer nip kontrahenta. Możemy również użyć maski (nieznane znaki) znaku '*' jeśli chcemy znaleźć wszystkich kontrahentów o podobnym nipie np. *3456789*

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - jest tablicą asocjacyjną zawierającą, nazwa, id, nip, nazwa_skrot, nipeu, id_grupy_cenowej, email, miejscowosc, ulica, id_wojewodztwa, kod, panstwo, nazwa_dostawy, miejscowosc_dostawy, ulica_dostawy, id_wojewodztwa_dostawy , kod_dostawy, panstwo_dostawy
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=listCompanies'.
								'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
								'&ids=3,5); 
					 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
					 foreach($dane['result'] as $id=>$dane)
					 {
						 echo 'Id: ' . $id . ' Nip: ' . $dane['nip'] . ' Nazwa: ' . $dane['nazwa'] . 
							  ' Miejscowość: ' . $dane['miejscowosc'] . ' Ulica: ' . $dane['ulica'] .
							  ' Kod: ' . $dane['kod'] . '
';
					 }

Opinie naszych klientów

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ą.

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.

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.

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.

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.

Wojtek
księgowy

Obsługa pełnej księgowości, dzięki Systim jest niewiarygodnie prosta. 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.

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.

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 :):) ...

Tadeusz B.
specjalista ds. obsługi magazynu

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

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.

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.

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.

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 ...

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 ...

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 ...

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 ...

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.

Anna M.
firma transportowa

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

Marek S.
dyrektor firmy transportowej

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ą.

Robert K.
prezes

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

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.

Marcin Z.
firma dystrybucyjna

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

Marcin Cz.
tester programów

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

Marcin Cz.
właściciel sklepu internetowego

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

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.

Systim API - Zarządzanie kontrahentami

addCompany

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Uwagi

Przykład wywołania w PHP

delCompany

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Przykład wywołania w PHP

updCompany

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Uwagi

Przykład wywołania w PHP

getCompany

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Przykład wywołania w PHP

listCompanies

Wymagane parametry

Opcjonalne parametry

Wartości zwracane

Przykład wywołania w PHP

Opinie naszych klientów

KONTAKT

OFERTA

POMOC