Systim API - Zarządzanie płatnościami

Strona główna API

addPayment

Dodanie nowej płatności, z możliwością powiązania z dokumentem

Wymagane parametry

token, kwota, data_wplaty - w formacie YYYY-MM-DD
rodzaj - 1 przelew, 2 gotówka, 3 barter, 4 za pobraniem, 5 rozliczenie saldami, 6 karta płatnicza
dotyczy - 0 dokument sprzedaży, 1 dokument zakupu, 2 inny przychód, 3 inny rozchód

id_kasy - parametr wymagany, w przypadku kiedy rodzaj płatności = 2 (gotówka)

w przypadku płatności w walucie:
id_waluty - ID można uzyskać wykorzystując metodę listCurrencies
kurs_waluty
kwota_w_walucie

Opcjonalne parametry

id_faktury, rachunek_nadawcy, nadawca, tytul, id_kontrahenta

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zawiera zmienną id dodanej płatności
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=addPayment'.
							'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
							'&kwota=509,22'. 			//kwota płatnosci
							'&data_wplaty=2016-06-22'.
							'&rodzaj=1'.				//przelew
							'&dotyczy=0'.				//dokument sprzedaży
							'&tytul=Title'.
							'&nadawca=nadawca'.
							'&id_faktury=128'.			//nr ID faktury z którą powiązać płatność
							'&rachunek_nadawcy=rachunek');
					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 nowej płatności: ' . $dane['result'];
					



delPayment

Usunięcie jednej lub wielu płatności

Wymagane parametry

token
ids - zmienna typu "string" zawierająca numery ID płatności które mają zostać usunięte, gdzie separatorem jest "," np. 1,2,4,12,23,45

Opcjonalne parametry

brak

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - zmienna ids zawierająca numery ID usuniętych płatności
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=delPayment'.
							'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f' .
							'&ids=45,72');
					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ętych płatności: ' . $dane['result'];
					



listPayments

Lista płatności

Wymagane parametry

token

Opcjonalne parametry

ids - zmienna typu "string" zawierająca numery ID płatności, gdzie separatorem jest "," np. 1,2,4,12,23,45
data_platnosci_od, data_platnosci_do, rodzaj - 1 przelew, 2 gotówka, 3 barter, 4 za pobraniem, 5 rozliczenie saldami, 6 karta płatnicza
dotyczy - 0 dokument sprzedaży, 1 dokument zakupu, 2 inny przychód, 3 inny rozchód
rozliczono - 0 nie, 1 tak
id_kontrahenta, opis

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result'] - jest tablicą asocjacyjną o wartościach:
id, numer_platnosci, tytul, kontrahent, id_kontrahenta, kwota, kwota_w_walucie, waluta, numer_zewnetrzny, sposob_platnosci, dotyczy, nadawca, rozliczono, id_kasy
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=listPayments'.
							'&token=6aed003dc54951c043f8d1ad4b4804a2a8a40f');
					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 platnosci: ' . $id . ' Numer płatności: ' . $dane['numer_platnosci'] . ' Tytuł: ' . $dane['tytul'] . 
							' Nazwa kontrahenta: ' . $dane['kontrahent'] . ' Id kontrahenta: ' . $dane['id_kontrahenta'] .
							' Kwota: ' . $dane['kwota'] . ' Kwota w walucie: ' . $dane['kwota_w_walucie'] . 
							' Waluta: ' . $dane['waluta_platnosci'] . ' Numer zewnętrzny: ' . $dane['numer_zewnetrzny'] . 
							' Rodzaj: ' . $dane['rodzaj'] . ' Dotyczy: ' . $dane['dotyczy'] . ' Nadawca: ' . $dane['nadawca'] . 
							' Rozliczono: ' . $dane['rozliczono'] . ' Id kasy: ' . $dane['id_kasy'] . '
'; }



getPayment

Pobranie danych płatności wraz z powiazanymi informacjami

Wymagane parametry

token
id - ID płatności

Opcjonalne parametry

brak

Wartości zwracane

Zwracane wartości w przypadku powodzenia:
$dane['result']['platnosc'] - jest tablicą asocjacyjną o wartościach:
id, numer_platnosci, tytul, kontrahent, id_kontrahenta, kwota, kwota_w_walucie, waluta, numer_zewnetrzny, rodzaj, dotyczy, nadawca, rozliczono, id_kasy
$dane['result']['powiazania'] - jest tablicą asocjacyjną o wartościach:
id_faktury, kwota, kwota_waluta, odsetki, id_waluty
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=getPayment'.
							'&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 = $dane['result']['platnosc'];
					echo 'Id platnosci: ' . $id . ' Numer płatności: ' . $dane['numer_platnosci'] . ' Tytuł: ' . $dane['tytul'] . 
							' Nazwa kontrahenta: ' . $dane['kontrahent'] . ' Id kontrahenta: ' . $dane['id_kontrahenta'] .
							' Kwota: ' . $dane['kwota'] . ' Kwota w walucie: ' . $dane['kwota_w_walucie'] . 
							' Waluta: ' . $dane['waluta_platnosci'] . ' Numer zewnętrzny: ' . $dane['numer_zewnetrzny'] . 
							' Rodzaj: ' . $dane['rodzaj'] . ' Dotyczy: ' . $dane['dotyczy'] . ' Nadawca: ' . $dane['nadawca'] . 
							' Rozliczono: ' . $dane['rozliczono'] . ' Id kasy: ' . $dane['id_kasy'] . '
'; foreach($dane['result']['powiazania'] as $id_faktury=>$faktura) { echo '

ID faktury: ' . $id_faktury . ' Kwota: ' . $faktura['kwota'] . ' Kwota waluta: ' . $faktura['kwota_waluta'] . ' Odsetki: ' . $faktura['odsetki'] . ' ID waluty: ' . $faktura['id_waluty']; }
Wersja DEMO - przetestuj za darmo! Załóż konto Systim w 15 sekund!