|
Оглавление [Скрыть/Показать] |
Метод "регионы поиска" (GetRegionsV2)
Аналогично GetRegions, но с дополнительным параметром login и password
GetRegionsV2 // доступные регионы для поиска
https://api.zzap.pro/webservice/datasharing.asmx/GetRegionsV2
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
| password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GetRegionItem[] | да | Массив данных |
GetRegionItem:
| Параметр | Тип | Обязательный | Описание |
| code_region | int | да | Код региона |
| class_region | string | да | Название региона |
Вернувшееся значение 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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
| password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GetBrandItem[] | да | Массив данных |
GetBrandItem:
| Параметр | Тип | Обязательный | Описание |
| code_man | int | да | Код производителя |
| class_man | string | да | Название производителя |
Пример вызова
Браузер
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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
| password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
| codes_cat | string | да | перечисление через точку с запятой внутренних уникальных кодов запчастей code_cat (code_cat можно получить с помощью метода GetSearchSuggest и метода GetSearchResult) |
| code_region | string | да | выбранный вами регион (числовое значение региона определите с помощью метода GetRegion) (code_region = 1, если не задан) |
| instock | string | да | найти запчасть в наличии или под заказ: false - под заказ, true - в наличии (instock = true, если не задан) |
| wholesale | string | да | покупаете в розницу или оптом: false - в розницу, true - оптом (wholesale = false, если не задан) |
| used | string | нет | искать новую запчасть или б/у: false - новая, true - б/у (может быть не задан) |
| delivery_periods | string | нет | найти запчасть под заказ с заданными периодами поставки. Периоды задаются перечислением через точку с запятой одного или нескольких значений: 1 - 1-7дней, 2 - 8-14 дней, 3 - 15-30 дней, 4 - 31-90 дней (может быть не задан) |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GetStatPricesItem[] | да | Массив данных |
GetStatPricesItem:
| Параметр | Тип | Обязательный | Описание |
| code_cat | int | да | уникальный код запчасти |
| price_min | decimal | да | минимальная цена запчасти |
| price_med | decimal | да | средняя цена запчасти |
| price_max | decimal | да | максимальная цена запчасти |
Важно: цены указываются в рублях
Пример вызова
Браузер
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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail, указанный при регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| login_info | string | да | для внутренних целей, передавать пустое значение |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| name_first | string | да | имя, указанное при регистрации |
| name_second | string | да | отчество, указанное при регистрации |
| name_last | string | да | фамилия, указанная при регистрации |
| string | да | e-mail, указанный при регистрации (логин) | |
| company_nick | string | да | название компании |
| phone_code_country | string | да | код страны |
| phone_code_city | string | да | код города |
| phone | string | да | телефон |
| phone_add | string | да | добавочный телефон |
| code_region | int | да | код региона |
| is_seller | bool | да | true - продавец, false - не продавец |
| user_key | string | да | "ключ", идентифицирующий вас в системе (используется в некоторых методах в качестве входного параметра) |
Пример вызова
Бразуер
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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail, указанный при регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| user_key | string | да | "ключ" продавца, полученный в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| class_user | string | да | наименование продавца |
| descr_rating_count | string | да | сколько отзывов текстом |
| rating | int | да | рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд |
| descr_address | string | да | местоположение продавца |
| phone1 | string | да | телефон 1 |
| phone2 | string | да | телефон 2 |
| comment | string | да | часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается) |
| commentV2 | string | да | краткая информация о продавце |
| info | string | да | когда началось сотрудничество с ZZap |
| addr_map_geo1 | double | да | широта (координаты местонахождения продавца) |
| addr_map_geo2 | double | да | долгота (координаты местонахождения продавца) |
| accept_messages | bool | да | готов ли продавец переписываться с покупателями: true - готов, false - не готов |
| work_time | string | да | время работы продавца |
| type_user | string | да | тип пользователя* |
| type_user2 | string | да | тип пользователя 2** |
| type_price | string | да | тип прайс-листа*** |
| telegram | string | да | номер в telegram |
| string | да | номер в whatsapp | |
| viber | string | да | номер в viber |
| descr_addressV2 | string | да | полный адрес продавца |
| location | string | да | город и метро продавца |
Пример вызова
Бразуер
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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
| password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
| user_key | string | да | "ключ" продавца, полученный в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies |
| row_count | string | да | сколько максимально записей возвращать (максимум 500) |
| api_key | string | да | нужно попросить у нас |
| call_data | string | да | для внутренних целей, передавать пустое значение |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GetRatingsItem[] | да | Массив данных |
GetRatingsItem:
| Параметр | Тип | Обязательный | Описание |
| create_date | DateTime | да | дата написания отзыва |
| message | string | да | полный текст отзыва |
| rating | decimal | да | оценка от 1 до 5 баллов |
| client_info | string | да | имя и телефон (скрыт) того, кто оставил отзыв |
| rating_type | string | да | тип отзыва: "Отзыв как о продавце по предложению в поиске", "Отзыв как о продавце по заказу", "Отзыв как о покупателе по заказу" |
| client_name | string | да | имя того, кто оставил отзыв |
| phone | string | да | телефон (скрыт) того, кто оставил отзыв |
| response_date | DateTime | да | дата написания ответа на отзыв |
| response | string | да | текст ответа на отзыв |
| code_rating | int | да | код отзыва |
| no_delete | bool | да | true - нельзя удалить, false - можно удалить (удалить отзыв может только создатель отзыва) |
| photos | string | нет | фотографии, приложенные к отзыву |
Пример вызова
Браузер
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,
"photos":"1073.1.jpg|**upload/ratingphotos/f7b04c24edcfcf5586c871852045a143.jpg;2021-05-20-13-24-01-300x225.jpg|**upload/ratingphotos/121c5be69a4c78cc54c67a06b5905a00.jpg;2021-05-20-13-24-29-300x225.jpg|**upload/ratingphotos/6cfa59fee54a661416548e00a82badd1.jpg"
}
}
]Метод "статусы заказов" (GetCodesTrack)
GetCodesTrack
https://api.zzap.pro/webservice/datasharing.asmx/GetCodesTrack
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | нет | e-mail, указанный при регистрации (может быть пустым) |
| password | string | нет | ваш пароль от аккаунта на сайте ZZap (может быть пустым) |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GetCodesTrackItem[] | да | Массив данных |
GetCodeTrackItem:
| Параметр | Тип | Обязательный | Описание |
| code_track int | int | да | код статуса заказа |
| class_track | string | да | статус заказа |
| sort_order | int | да | сортировка статусов (предлагаем такую последовательность смены статусов) |
Важно! для страницы "Заказы от покупателей" доступны статусы не равные текущему и у которых 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' - Есть самовывоз