Информация

Главная > Помощь > Информация

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

Аналогично GetRegions, но с дополнительным параметром login и password
GetRegionsV2 // доступные регионы для поиска
https://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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даНазвание производителя



Пример вызова
Браузер
https://api.zzap.pro/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://api.zzap.pro/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"}, 
... ] 
} 

Метод "статистика цен" (GetStatPricesV4)

Аналогично GetStatPricesV3, но с дополнительными параметрами used и delivery_periods
GetStatPricesV4
https://api.zzap.pro/webservice/datasharing.asmx/GetStatPricesV4
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
codes_catstringдаперечисление через точку с запятой внутренних уникальных кодов запчастей code_cat (code_cat можно получить с помощью метода GetSearchSuggest и метода GetSearchResult)
code_regionstringдавыбранный вами регион (числовое значение региона определите с помощью метода GetRegion) (code_region = 1, если не задан)
instockstringданайти запчасть в наличии или под заказ: false - под заказ, true - в наличии (instock = true, если не задан)
wholesalestringдапокупаете в розницу или оптом: false - в розницу, true - оптом (wholesale = false, если не задан)
usedstringнетискать новую запчасть или б/у: false - новая, true - б/у (может быть не задан)
delivery_periodsstringнетнайти запчасть под заказ с заданными периодами поставки. Периоды задаются перечислением через точку с запятой одного или нескольких значений: 1 - 1-7дней, 2 - 8-14 дней, 3 - 15-30 дней, 4 - 31-90 дней (может быть не задан)
api_keystringданужно попросить у нас

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

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

GetStatPricesItem:

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

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

Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetStatPricesV4?login={login}&password={password}&codes_cat=1114507085;118182355;114720089&code_region=1&instock=true&wholesale=false&delivery_periods=1;2;4&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://api.zzap.pro/webservice/datasharing.asmx/GetStatPricesV4

Ответ

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

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

GetMyInfoV2
https://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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датекст ответа на отзыв
code_ratingintдакод отзыва
no_deleteboolдаtrue - нельзя удалить, false - можно удалить (удалить отзыв может только создатель отзыва)

Пример вызова
Браузер
https://api.zzap.pro/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://api.zzap.pro/webservice/datasharing.asmx/GetRatingsV3

Ответ

{
"error":"",
"row_count":75,
"table":[{
"create_date":"2023-03-03T19:50:45.507",
"message":
"Номер заказа: \n410754374\nПозиция: \nHEPU P049 ПОМПА, заказано: 1шт., по 3 100р.\n\n[26] Сроки соответствуют\n[27] Наличие соответствует\n[28] Удобная оплата\n\n\nКомментарии:\nтест",
"rating":5.0,
"client_info":"Zzap Продавец Тестовый (Продавец Тестовый ZZap) 8(926)0**-0*-00",
"rating_type":"Отзыв как о продавце по заказу",
"client_name":"Zzap Продавец Тестовый",
"phone":"8(926)0**-0*-00",
"response_date":"",
"response":"",
"code_rating":620021916,
"no_delete":true
}
}
]

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

GetCodesTrack
https://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/webservice/datasharing.asmx/GetCodesTrack

Ответ

<string
	xmlns="http://www.zzap.ru/">
{"error":"",
"row_count":14,
"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":169,"class_track":"Архив","sort_order":50},
{"code_track":63,"class_track":"Ответ на заказ","sort_order":50}
]
}
</string>

*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' - Есть самовывоз




Информация