Информация

Метод «регионы поиска» (GetRegionsV2)

Аналогично GetRegions, но с дополнительным параметром login и password
GetRegionsV2 // доступные регионы для поиска
https://www.zzap.ru/webservice/datasharing.asmx/GetRegionsV2

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
api_keystringданужно попросить у нас


Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
row_countintдасколько строк вернулось
tableМассив GetRegionItem[]даМассив данных


GetRegionItem:

ПараметрТипОбязательныйОписание
code_regionintдаКод региона
class_regionstringдаНазвание региона



Вернувшееся значение code_region передавать в параметре location в GetSearchResult

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetRegions?login={login}&password={password}&api_key={api_key}


Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetRegionsV2

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 5, // сколько строк вернулось
«table»: [
{«code_region»: -1, «class_region»: «Любой» },
{ «code_region»: 1, «class_region»: «Москва и область» },
{ «code_region»: 11151, «class_region»: «Владивосток и Приморский край» },
{ «code_region»: 11159, «class_region»: «Екатеринбург и Свердловская область» },
{ «code_region»: 11135, «class_region»: «Санкт-Петербург и область» }
… ]
}



Метод «производители авто» (GetBrandsV2)

Аналогично GetBrands, но с дополнительным параметром login и password
GetBrandsV2 // доступные производители авто
https://www.zzap.ru/webservice/datasharing.asmx/GetBrandsV2

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
api_keystringданужно попросить у нас



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
row_countintдасколько строк вернулось
tableМассив GetBrandItem[]даМассив данных



GetBrandItem:

ПараметрТипОбязательныйОписание
code_manintдаКод производителя
class_manstringдаНазвание производителя



Вернувшееся значение class_man можно передавать в параметре car_brand в MakeVinRequest

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetBrandsV2?login={login}&password={password}&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «api_key={api_key}» -X POST https://www.zzap.ru/webservice/datasharing.asmx/GetBrandsV2


Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: …, // сколько строк вернулось
«table»: [
{«code_man»:3600,»class_man»:»ALFA ROMEO»},
{«code_man»:2162,»class_man»:»ARCTIC CAT»},
{«code_man»:3408,»class_man»:»AUDI»},
{«code_man»:677,»class_man»:»AVIA»},
… ]
}



Метод «статистика цен» (GetStatPricesV3)

Аналогично GetStatPricesV2, но с дополнительным параметром login и password
GetStatPricesV3
https://www.zzap.ru/webservice/datasharing.asmx/GetStatPricesV3

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
codes_catstringдаперечисление через точку с запятой внутренних уникальных кодов запчастей code_cat (code_cat можно получить с помощью метода GetSearchSuggest)
code_regionstringдавыбранный вами регион (числовое значение региона определите с помощью метода GetRegion) (code_region = 1, если не задан)
instockstringданайти запчасть в наличии или под заказ: false — под заказ, true — в наличии (instock = true, если не задан)
wholesalestringдапокупаете в розницу или оптом: false — в розницу, true — оптом (wholesale = false, если не задан)
api_keystringданужно попросить у нас



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
row_countintдасколько строк вернулось
tableМассив GetStatPricesItem[]даМассив данных



GetStatPricesItem:

ПараметрТипОбязательныйОписание
code_catintдауникальный код запчасти
price_mindecimalдаминимальная цена запчасти
price_meddecimalдасредняя цена запчасти
price_maxdecimalдамаксимальная цена запчасти


Важно: цены указываются в рублях

Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/GetStatPricesV3?login={login}&password={password}&codes_cat=1114507085;118182355;114720089&code_region=1&instock=true&wholesale=false&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «codes_cat=1114507085;118182355;114720089» —data-urlencode «code_region=1» —data-urlencode «instock=true» —data-urlencode «wholesale=false» —data-urlencode «api_key={api_key}» -X POST https://www.zzap.ru/webservice/datasharing.asmx/GetStatPricesV3

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_cat»: 1114507085, // уникальный код запасти
«price_min»: 1596.83, // минимальная цена запчасти
«price_med»: 1829.17, // средняя цена запчасти
«price_max»: 2096.54 // максимальная цена запчасти
}
{

}
]
}



Метод «мои данные» (GetMyInfoV2)

GetMyInfoV2
https://www.zzap.ru/webservice/datasharing.asmx/GetMyInfoV2

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
login_infostringдадля внутренних целей, передавать пустое значение
api_keystringданужно попросить у нас



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
name_firststringдаимя, указанное при регистрации
name_secondstringдаотчество, указанное при регистрации
name_laststringдафамилия, указанная при регистрации
emailstringдаe-mail, указанный при регистрации (логин)
company_nickstringданазвание компании
phone_code_countrystringдакод страны
phone_code_citystringдакод города
phonestringдателефон
phone_addstringдадобавочный телефон
code_regionintдакод региона
is_sellerboolдаtrue — продавец, false — не продавец
user_keystringда«ключ», идентифицирующий вас в системе (используется в некоторых методах в качестве входного параметра)



Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/GetMyInfoV2?login={login}&password={password}&login_info=&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «login_info=» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyInfoV2

Ответ
{
«error»: «», // если пусто, ошибок нет
«name_first»: «Имя», // имя, указанное при регистрации
«name_second»: «Отчество», // отчество, указанное при регистрации
«name_last»: «Фамилия», // фамилия, указанная при регистрации
«email»: «[email protected]», // e-mail, указанный при регистрации (логин)
«company_nick»: «…», // название компании
«phone_code_country»: «8», // код страны
«phone_code_city»: «000», // код города
«phone»: «111-11-11», // телефон
«phone_add»: «11», // добавочный телефон
«code_region»: «30100», // код региона
«is_seller»: false, // true — продавец, false — не продавец
«user_key»: «??????????????????????????????» //»ключ» собеседника, аналогичный в методах GetMyMessagesThreads (или в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies)
}



Метод «информация о продавце» (GetUserInfo)

GetUserInfo
https://www.zzap.ru/webservice/datasharing.asmx/GetUserInfo


Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
user_keystringда«ключ» продавца, полученный в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies
api_keystringданужно попросить у нас



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение продавца
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
commentV2stringдакраткая информация о продавце
infostringдакогда началось сотрудничество с ZZap
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
accept_messagesboolдаготов ли продавец переписываться с покупателями: true — готов, false — не готов
work_timestringдавремя работы продавца
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
telegramstringданомер в telegram
whatsappstringданомер в whatsapp
viberstringданомер в viber
descr_addressV2stringдаполный адрес продавца
locationstringдагород и метро продавца



Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/GetUserInfo?login={login}&password={password}&user_key={user_key}&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «user_key={user_key}» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetUserInfo

Ответ
{
«error»: «», // если пусто, ошибок нет
«class_user»: «Repart», // наименование продавца
«descr_rating_count»: «5 отзывов», // сколько отзывов
«rating»: 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
«descr_address»: «Абакан», // местоположение продавца
«phone1»: «8(926)103-45-33», //телефон 1
«phone2»: «8(926)103-45-34», //телефон 2
«comment»: «Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов», // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
«commentV2»: «Возможна доставка оптовым покупателям», // краткая информация о продавце (существующее поле comment содержит сочетание двух полей — времени работы компании и краткой информации о продавце)
«info»: «Публикуется в ZZap с 20-08-12», // когда началось сотрудничество с ZZap
«addr_map_geo1»: 55.5959324577887, // широта (координаты местонахождения продавца)
«addr_map_geo2»: 37.513069357681161, // долгота (координаты местонахождения продавца)
«accept_messages»: true, // хочет ли продавец принимать сообщения
«work_time: «пн.-пт. с 10 до 20, сб. с 10 до 18, вс. выходной», // время работы продавца
«type_user»: «UBNAIRWPYTOGM234», // тип пользователя
«type_user2»: «GCKMN», // тип пользователя 2
«type_price»: «RMP», // тип прайс-листа
«telegram»: «89261234567», // номер в telegram
«whatsapp»: «89261234567», // номер в whatsapp
«viber»: «89261234567», // номер в viber
«descr_addressV2»: «Россия, Москва, Хорошевское шоссе 39», // полный адрес продавца
«location»: «Москва, м. Полежаевская» // город и метро продавца
}



Метод «отзывы о продавце» (GetRatingsV3)

Аналогично GetRatingsV2, но с дополнительным параметром login и password
GetRatingsV3
https://www.zzap.ru/webservice/datasharing.asmx/GetRatingsV3

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
user_keystringда«ключ» продавца, полученный в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies
row_countstringдасколько максимально записей возвращать (максимум 500)
api_keystringданужно попросить у нас
call_datastringдадля внутренних целей, передавать пустое значение



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
row_countintдасколько строк вернулось
tableМассив GetRatingsItem[]даМассив данных



GetRatingsItem:

ПараметрТипОбязательныйОписание
create_dateDateTimeдадата написания отзыва
messagestringдаполный текст отзыва
ratingdecimalдаоценка от 1 до 5 баллов
client_infostringдаимя и телефон (скрыт) того, кто оставил отзыв
rating_typestringдатип отзыва: «Отзыв как о продавце по предложению в поиске», «Отзыв как о продавце по заказу», «Отзыв как о покупателе по заказу»
client_namestringдаимя того, кто оставил отзыв
phonestringдателефон (скрыт) того, кто оставил отзыв
response_dateDateTimeдадата написания ответа на отзыв
responsestringдатекст ответа на отзыв



Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/GetRatingsV3?login={login}&password={password}&user_key={user_key}&row_count=50&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «user_key={user_key}» —data-urlencode «row_count=50» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetRatingsV3

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 100, // сколько строк вернулось
«table»:
[
{
«create_date»: «2015-03-15T14:26:28.76»,
«message»: «Номер заказа: \\n1111111\\nПозиция: \\nRENAULT 7701070525 ФИЛЬТР ВОЗД. КАНГУ КЛИО E7J, K7J, LB03, заказано: 1шт., по 632.00р.\\n\\nЗамечаний нет!\\n\\nКомментарии:\\nотзыв о покупателе (по заказу)\\nпокупатель — ok», //полный текст отзыва
«rating»: 5.00, // оценка от 1 до 5 баллов
«client_info»: «Имя Фамилия Телефон», // имя и телефон (скрыт) того, кто оставил отзыв
«rating_type»: «Отзыв как о продавце по предложению в поиске», // тип отзыва
«client_name»: «Test Buyer», // имя того, кто оставил отзыв
«phone»: «8(000)1**-1*-11», // телефон (скрыт) того, кто оставил отзыв
«response_date»: «2015-03-18T14:00:03.98», // дата написания ответа на отзыв
«response»: «Ответ на отзыв» // текст ответа на отзыв
}
{

}
]
}



Метод «статусы заказов» (GetCodesTrack)

GetCodesTrack
https://www.zzap.ru/webservice/datasharing.asmx/GetCodesTrack

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
api_keystringданужно попросить у нас



Выходные параметры:

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
row_countintдасколько строк вернулось
tableМассив GetCodesTrackItem[]даМассив данных



GetCodeTrackItem:

ПараметрТипОбязательныйОписание
code_track intintдакод статуса заказа
class_trackstringдастатус заказа
sort_orderintдасортировка статусов (предлагаем такую последовательность смены статусов)


Важно! для страницы «Заказы от покупателей» доступны статусы не равные текущему и у которых sort_order больше или равен текущему
для страницы «Заказы продавцам» доступен только статус с кодом 10 (Заказ отменен) и только в случае, когда статус заказа не равен 11 (Заказ выполнен) и не равен 10 (Заказ отменен)

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetCodesTrack?login={login}&password={password}&api_key={api_key}


Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «api_key={api_key}» -X POST https://www.zzap.ru/webservice/datasharing.asmx/GetCodesTrack

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 100, // сколько строк вернулось
«table»:
[
{
{«code_track»:15,»class_track»:»Новый заказ»,»sort_order»:5},
{«code_track»:19,»class_track»:»Заказ принят»,»sort_order»:10},
{«code_track»:23,»class_track»:»Заказ в работе»,»sort_order»:13},
{«code_track»:111,»class_track»:»Заказ в резерве»,»sort_order»:13},
{«code_track»:141,»class_track»:»Заказ ожидает предоплаты»,»sort_order»:13},
{«code_track»:166,»class_track»:»Заказ оплачен»,»sort_order»:13},
{«code_track»:108,»class_track»:»Заказ в пути»,»sort_order»:15},
{«code_track»:107,»class_track»:»Заказ ожидает в пункте выдачи»,»sort_order»:20},
{«code_track»:11,»class_track»:»Заказ выполнен»,»sort_order»:30},
{«code_track»:153,»class_track»:»Заказ получен»,»sort_order»:30},
{«code_track»:10,»class_track»:»Заказ отменен покупателем»,»sort_order»:40},
{«code_track»:142,»class_track»:»Заказ отменен продавцом»,»sort_order»:40},
{«code_track»:63,»class_track»:»Ответ на заказ»,»sort_order»:50}
… ]
}



 

*type_user
‘K’ — медаль «Официальный автодилер»
‘1’ — медаль «Больше года на сайте»
‘2’ — медаль «Больше 3х лет на сайте»
‘3’ — медаль «Есть уставные документы»
‘4’ — медаль «Есть фотографии магазина»
‘5’ — международная отправка
‘P’ — Доставка товара курьером
‘Y’ — Отправка товара в регионы
‘B’ — Покупатель
‘A’ — Продавец
‘I’ — Интернет магазин
‘S’ — Автосервис/служба установки
‘R’ — Торговля в розницу
‘W’ — Торговля оптом
‘F’ — Частное лицо
‘U’ — Юридическое лицо


**type_user2
‘Y’ — Понизить до недостоверных
‘K’ — Принимаем к оплате банковские карты
‘M’ — Ручная проверка (снимает пометку Регистрация не подтверждена)
‘I’ — Неликвидный товар (клиент продаёт неликвид)
‘W’ — Шиномонтаж
‘R’ — Не хотят переписываться с покупателями
‘Z’ — Подтверждена гарантия наличия
‘F’ — Подтверждение наличия
‘R’ — Не переписываются с покупателями


***type_price
‘R’ — Прайс-лист для розницы
‘W’ — Прайс-лист для юр.лиц и ИП
‘M’ — Запретить загрузку прайса с сайта как файл
‘I’ — Неликвидный товар
‘P’ — Есть самовывоз




Информация