Obecna wersja

2020.009 beta z dnia 5.02.2021r.
WERSJA ROZWOJOWA - dokumentacja będzie aktualizowana w miarę wdrażania kolejnych metod dostępu.

Wstęp

API to zestaw gotowych do użycia metod dostępu do wymiany informacji pomiędzy platformą B2B firmy KENO a systemem zewnętrznym.
Do komunikacji wykorzystywane są dane w formacie JSON.

Integracja

Dostarczana przez nas dokumentacja techniczna zawiera wszystkie informacje niezbędne do integracji z systemem zainteresowanego. Każdy użytkownik API samodzielnie integruje się ze swoim systemem. Integracji powinien dokonać programista z niezbędną wiedzą i doświadczeniem.

Klucz dostępu do API

Do korzystania z API platformy B2B firmy KENO konieczne jest uzyskanie klucza dostępu (tokena). Klucz dostępu generowany jest na życzenie zainteresowanego, tylko dla stałych partnerów biznesowych KENO.
W wyjątkowych sytuacjach klucz dostępu może zostać w każdej chwili dezaktywowany, a dostęp do systemu API zablokowany bez podania przyczyny (np. w przypadku zaległości płatniczych wobec KENO, zakończenia współpracy biznesowej itp.)

Prośbę należy przesłać na adres e-mail: programista@keno-energy.com

Wykonanie zapytania

Aby wysłać żądanie do API, wyślij odpowiednie żądanie POST na adres: https://api.wycena.keno-energy.com
Dla każdego zapytania należy przesłać zestaw danych w formacie JSON:

apikey - unikalny klucz dostępu do API użytkownika
method - nazwa metody API do wywołania
parameters - argumenty wywoływanej funkcji w formacie JSON

Przykładowe zapytanie

https://api.wycena.keno-energy.com,
POST: {
	"apikey": "A5TTRfG453d24F",
	"method": "GetProductsList",
	"parameters": [
			{
				"ShowGroups": "1",
				"ShowIndex": "1"
			}
	]
}

Limit ilości zapytań

Maksymalna ilość żądań do API to 100 żądań/min. Po przekroczeniu limitu wykonanie kolejnego żądania nie będzie możliwe, w odpowiedzi pojawi się błąd „Przekroczono limit żądania”. Limit jest resetowany co 60 sekund.

{
  "connection_status": "Success",
  "errors": "Request limit exceeded"
}

Obsługa błędów

W przypadku błędu, do odpowiedzi na zapytanie zostanie dodane dodatkowe pole JSON 'errors', które zawiera informacje opisujące błąd w języku naturalnym.

{
  "connection_status": "Success",
  "errors": "Product not found"
}

Metody - Zamówienia

GetActualOrdersList

Data utworzenia: 25.08.2020r.

Metoda umożliwia pobranie listy oraz szczegółów aktualnie realizowanych zamówień - bez zamówień już zrealizowanych i anulowanych.

Metody - Produkty

GetProductBase	Data utworzenia: 22.03.2023r.	Metoda umożliwia pobranie pełnej bazy produktowej aktualnie dostępnej w sprzedaży
GetProductDocuments	Data utworzenia: 22.01.2021r.	Metoda umożliwia pobranie dokumentacji produktu
GetWarrantyExtension	Data utworzenia: 1.04.2021r.	Sposób pobrania dostępnych wariantów i cen przedłużenia gwarancji na produkt
GetProductCategories	Data utworzenia: 16.06.2021r.	Metoda umożliwia drzewa kategorii produktów dostępnych w sprzedaży

Metody - Księgowość

GetBalanceOfOverduePayments	Data utworzenia: 5.02.2021r.	Metoda umożliwia sprawdzenie i odzyskanie aktualnej kwoty zaległych płatności
GetInvoicesList	Data utworzenia: 5.02.2021r.	Metoda umożliwia pobranie listy faktur