1. Метод проценки деталей (v.3)

Адрес сервиса https://www.japarts.ru/?id=ws;action=search3

Параметры:

login       # Логин пользователя*
pass        # Пароль пользователя*
makename    # Полное наименование производителя 
detailnum   # Каталожный номер детали*
cross       # Поиск с аналогами (1-да, 0-нет)
crosslimit  # ограничение кол-ва выводимых аналогов к каждому найденному каталожному номеру детали
rowlimit    # ограничение кол-ва строк одного каталожного номера детали


Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=search3;login=test;pass=testws;makename=mitsubishi;detailnum=MB831042;cross=1;crosslimit=10;rowlimit=5;      

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:
 
{
	"priceid":"774643111"			# Уникальный идентификатор предложения
	"crossid":"7134853",			# Идентификатор взаимозаменяемости деталей (детали с одинаковым crossid - взаимозаменяемые)
	"makename":"Mitsubishi",		# Полное наименование производителя
	"detailnum":"MB831042",			# Каталожный номер детали
	"detailname":"РЫЧАГ МАЯТНИКОВЫЙ",	# Наименование детали
	"pricerur":"3064.87",			# Цена в рублях с Вашей скидкой
	"quantity":"5",				# Кол-во деталей на складе постващика (может быть пустым для заказных прайс-листов)
	"lot":"1",				# Партия (при заказе количество деталей должно быть кратно этой величине)
	"time":"2",				# Средний срок поставки детали в днях
	"timegar":"4",				# Гарантированный срок поставки детали в днях
	"country":"Москва",			# Регион поставки
	"supcode":"0589"			# Уникальный код поставщика
	"statistic":"99"			# Статистика успешных поставок по детали в процентах
	"deposit":"1"				# Прием заказов только по 100% депозиту (1-да, 0-нет)
	"uncreturn":"1"				# Возможность возврата качественного товара (1-да, 0-нет)
	"refurbished":"1"			# Деталь восстановлена в заводских условиях (1-да, 0-нет)
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED                  # Не указан метод веб-сервиса
NO DETAILNUM SPECIFIED               # Не указан каталожный номер детали
LOGIN FAILED                         # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED                  # Логин пользователя не активирован
NO RESULTS FOUND                     # В результате поиска ни одной детали не найдено
EXCEEDED LIMIT OF REQUESTS PER DAY   # Превышен лимит количества запросов к прайс-листу за сутки


2. Добавление детали в корзину (v.2)

Адрес сервиса https://www.japarts.ru/?id=ws;action=addtobasket2

Параметры:

login        # Логин пользователя*
pass         # Пароль пользователя*
priceid      # Уникальный идентификатор предложения*
quantity     # Кол-во заказываемых деталей (при отсутствии равно 1)
clientprice  # Цена клиента в рублях
comment      # Комментарий клиента 

Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=addtobasket2;login=test;pass=testws;priceid=501028825;quantity=10;clientprice=100;comment=test;

Результат работы в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

{
	"result":"ITEM ADDED TO BASKET", # Позиция успешно добавлена в корзину
	"makename":"Mitsubishi",	 # Полное наименование производителя
	"detailnum":"MB831042",		 # Каталожный номер детали
	"clientprice":"100",		 # Цена клиента в рублях
	"quantity":"10",		 # Кол-во заказываемых деталей
	"supcode":"0007",		 # Уникальный код поставщика
	"comment":"test"		 # Комментарий клиента
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED         # Не указан метод веб-сервиса
LOGIN FAILED                # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED         # Логин пользователя не активирован
NO PRICEID SPECIFIED        # Не указан уникальный идентификатор предложения
PRICEID NOT FOUND	    # Позиция не найдена в активных прайс-листах.
Данная ошибка также возвращает параметр priceid:

{
	"error":"PRICEID NOT FOUND",
	"priceid":"501028825",		# Уникальный идентификатор предложения
}

QUANTITY OF DETAILS NOT MULTIPLE QUANTITY IN LOT # Количество деталей должно быть кратно партии.
Данная ошибка также возвращает параметры makename, detailnum, supcode, quantity и lot:

{
	"error":"QUANTITY OF DETAILS NOT MULTIPLE QUANTITY IN LOT",
	"makename":"Mitsubishi",	# Полное наименование производителя
	"detailnum":"MB831042",		# Каталожный номер детали
	"supcode":"0589"		# Уникальный код поставщика
	"quantity":"1"			# Кол-во заказываемых деталей
	"lot":"5"			# Партия (при заказе количество деталей должно быть кратно этой величине)
}

3. Просмотр содержимого корзины

Адрес сервиса https://www.japarts.ru/?id=ws;action=showbasket

Параметры:

login     # Логин пользователя*
pass      # Пароль пользователя*

Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=showbasket;login=test;pass=testws;

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:

{
	"basketid":"113048",			# Уникальный идентификатор позиции в корзине
	"makename":"Mitsubishi",		# Полное наименование производителя
	"makelogo":"MC",			# Код производителя 
	"detailnum":"MB831042",			# Каталожный номер детали
	"detailname":"РЫЧАГ МАЯТНИКОВЫЙ",	# Наименование детали
	"pricerur":"2521.64",			# Цена в рублях с Вашей скидкой
	"clientprice":"",			# Цена клиента (добавленная при подгрузке xls или с помощью веб-сервиса)
	"quantity":"5",				# Кол-во деталей в корзине
	"time":"25",				# Средний срок поставки детали в днях
	"timegar":"40",				# Гарантированный срок поставки детали в днях
	"country":"Эмираты",			# Регион поставки
	"supcode":"0589",			# Уникальный код поставщика
	"comment":"test"			# Комментарий клиента
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED         # Не указан метод веб-сервиса
LOGIN FAILED                # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED         # Логин пользователя не активирован
BASKET IS EMPTY	            # В корзине нет ни одной детали


4. Отправка деталей в заказ

Адрес сервиса https://www.japarts.ru/?id=ws;action=baskettoorder

Параметры:

login     # Логин пользователя*
pass      # Пароль пользователя*
basketidm # Массив уникальных идентификаторов позиций в корзине в виде basketid1,basketid2,basketid3 *

Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=baskettoorder;login=test;pass=testws;basketidm=1,2,3,4,5,6,7,8

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:

{
	"result":"ITEM ADDED TO ORDER", # Позиция успешно добавлена в заказ
	"basketid":"119082",		# Уникальный идентификатор позиции в корзине 
	"ordernum":"0011"		# Номер заказа клиента
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED         # Не указан метод веб-сервиса
LOGIN FAILED                # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED         # Логин пользователя не активирован
NO BASKETIDM SPECIFIED	    # Не указан массив уникальных идентификаторов позиций в корзине
BASKET IS EMPTY	            # В корзине нет ни одной детали
NOT ENOUGH MONEY ON BALANCE # Недостаточно средств для отправки корзины в заказ. Возвращает также параметр needpay:

{
	"error":"NOT ENOUGH MONEY ON BALANCE",
	"needpay":"541210.16"			# Сумма, которую необходимо доплатить для возможности отправки заказа 
}

NO ONE BASKETID FOUND IN BASKET # Ни одна позиция из массива уникальных идентификаторов позиций в корзине не обнаружена
BASKETID NOT FOUND IN BASKET	# Уникальный идентификатор позиции в корзине не обнаружен. Возвращает также параметр basketid и выводится в одном массиве с результатом работы:

{
	"error":"BASKETID NOT FOUND IN BASKET",
	"basketid":"119103"
}


5. Удаление деталей из корзины

Адрес сервиса https://www.japarts.ru/?id=ws;action=delfrombasket

Параметры:

login     # Логин пользователя*
pass      # Пароль пользователя*
basketidm # Массив уникальных идентификаторов позиций в корзине в виде basketid1,basketid2,basketid3 *

Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=delfrombasket;login=test;pass=testws;basketidm=1,2,3,4,5,6,7,8

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:

{
	"result":"ITEM DELETED FROM BASKET", # Позиция успешно удалена
	"basketid":"119082"		     # Уникальный идентификатор позиции в корзине 
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED             # Не указан метод веб-сервиса
LOGIN FAILED                    # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED             # Логин пользователя не активирован
NO BASKETIDM SPECIFIED	        # Не указан массив уникальных идентификаторов позиций в корзине
BASKET IS EMPTY	                # В корзине нет ни одной детали
NO ONE BASKETID FOUND IN BASKET # Ни одна позиция из массива уникальных идентификаторов позиций в корзине не обнаружена
BASKETID NOT FOUND IN BASKET	# Уникальный идентификатор позиции в корзине не обнаружен. Возвращает также параметр basketid и выводится в одном массиве с результатом работы:

{
	"error":"BASKETID NOT FOUND IN BASKET",
	"basketid":"119103"
}


6. Просмотр заказов

Адрес сервиса https://www.japarts.ru/?id=ws;action=showorders

Параметры:

login       # Логин пользователя*
pass        # Пароль пользователя*
interval    # Количество дней, за которые просматривать обновления (по параметру lastupdate)
showarchive # Показывать архивные заказы (1-да, 0-нет) - без указания параметра архив не отображается

Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=showorders;login=test;pass=testws;interval=10;showarchive=1

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:


{
	"globalid":"108420",			# Уникальный идентификатор позиции в заказе
	"ordernum":"0013",			# Номер заказа клиента
	"timeadd":"2010-09-12 19:14:55",	# Время добавления позиции в заказ
	"makename":"Mitsubishi",		# Полное наименование производителя
	"makelogo":"MC",			# Код производителя 
	"detailnum":"MB831042",			# Каталожный номер детали
	"eqdetailnum":"",			# Дополнительная информация (номер замены, если присутствует)
	"detailname":"РЫЧАГ МАЯТНИКОВЫЙ",	# Наименование детали
	"quanordered":"10",			# Количество заказанных деталей
	"quanbuyed":"0",			# Количество выкупленных деталей (при статусе "Нет в наличии" = 0)
	"quanarrived":"",			# Количество пришедших деталей
	"quanshipped":"",			# Количество отгруженных деталей
	"orderprice":"2692.83",			# Цена при заказе в рублях
	"pricerur":"2692.83",			# Текущая цена в рублях
	"comment":"test",			# Комментарий клиента
	"country":"Эмираты",			# Регион поставки
	"supcode":"0589",			# Уникальный код поставщика
	"time":"7",				# Средний срок поставки детали в днях
	"timegar":"16",				# Гарантированный срок поставки детали в днях
	"status":"Нет в наличии",		# Статус позиции
	"archive":"0",				# Признак архивной позиции (1 - да, 0 - нет)
	"lastupdate":"2010-09-12 19:16:29"	# Дата последнего изменения позиции
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED             # Не указан метод веб-сервиса
LOGIN FAILED                    # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED             # Логин пользователя не активирован
NO ORDERS ITEMS FOUND		# Ни одной позиции не найдено


7. Просмотр баланса и прочей информации

Адрес сервиса https://www.japarts.ru/?id=ws;action=showbalance

Параметры:

login       # Логин пользователя*
pass        # Пароль пользователя*


Звездочкой (*) отмечены обязательные параметры.

Пример запроса:

https://www.japarts.ru/?id=ws;action=showbalance;login=test;pass=testws

Результат работы:

Массив строк в JSON-формате (https://ru.wikipedia.org/wiki/JSON). 

Каждая строка представляет собой массив вида:


{
	"balance":"-503977.87",						# Текущий баланс
	"inbasket":"10910.39",						# Сумма стоимости деталей, размещенных в корзине
	"ordered":"1221773.64",						# Сумма стоимости заказанных деталей
	"buyed":"1504832.90",						# Сумма стоимости выкупленных деталей
	"arrived":"45328.86",						# Сумма стоимости пришедших деталей
	"keeping":"0.00",						# Сумма начисленного сверхнормативного хранения
	"issuedebt":"0.00",						# Сумма долга выдачи (при значении "0.00" выдача разрешена)
	"orderdebt":"0.00",						# Сумма долга для заказа (при значении "0.00" размещение заказов разрешено)
	"recpayment":"2054139.63",					# Рекомендуемая сумма к оплате
	"avgvolume":"4790502.01",					# Среднемесячный оборот за последние 3 месяца
	"contract":"Договор купли-продажи 01-М от 07.11.2014 г."	# Наименование, дата и номер договора
}

Коды ошибок в JSON-формате (https://ru.wikipedia.org/wiki/JSON):

Вид:

{
	"error":"NO ACTION SPECIFIED"
}

Описание:

NO ACTION SPECIFIED             # Не указан метод веб-сервиса
LOGIN FAILED                    # Не указан логин или пароль (неверно указан логин или пароль)
LOGIN NOT ACTIVATED             # Логин пользователя не активирован