test

Главная > Помощь > test
Оглавление [Скрыть/Показать]
    Метод "подсказка" (GetSearchSuggestV3)
    Метод "результат поиска" (GetSearchResultV3)
    Метод "одно предложение" (GetSearchResultOneV2)
    Метод "информация о позиции" (GetSearchResultInfo) устарел, не использовать!
    Метод "информация о позиции" (GetSearchResultInfoV3)
    Метод "моя история поиска" (GetMySearchHistory) устарел, не использовать!
    Метод "моя история поиска" (GetMySearchHistoryV2)
    Метод "каталог шин" (GetCatalogTyres)






МЕТОД "ПОДСКАЗКА" (GETSEARCHSUGGESTV3)

Аналогично GetSearchSuggest, но с дополнительным параметром type_request, login и password
GetSearchSuggestV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3

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



ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
search_textstringдапроизвольная строка поиска
row_countstringдасколько максимально записей возвращать
type_requeststringдатип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам)
api_keystringданужно попросить у нас



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
row_countintдасколько строк вернулось
termsstringдаполе terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
tableМассив GetSearchSuggestItem[]дамассив данных



GetSearchSuggestItem:



ПараметрТипОбязательныйОписание
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер производителя
class_catstringданаименование
code_catintдавнутренний уникальный код позиции
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3?login={login}&password={password}&search_text=Колодки BMW&row_count=3&type_request=0&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=колодки BMW" --data-urlencode "row_count=3" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 50, // сколько строк вернулось
"terms": "колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки",
"table":
[
{
"class_man": "BMW", // производитель
"logopath": "https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "34116769951", // номер
"class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование
"code_cat": 115835062, // внутренний уникальный код позиции
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] , // массив ссылок на превью фото запчасти 60px на 60px
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
},
{
...
}
]
}


МЕТОД "РЕЗУЛЬТАТ ПОИСКА" (GETSEARCHRESULTV3)

Аналогично GetSearchResult, но с дополнительными параметрами search_text и type_request
GetSearchResultV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3

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



ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
code_regionstringдаcode_region из метода GetRegions
search_textstringдапроизвольная строка поиска
partnumberstringданомер запчасти
class_manstringдапроизводитель запчасти
row_countstringдаограничение по кол-ву строк. по умолчанию 100, максимум 500
type_requeststringдатип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам)
api_keystringданужно попросить у нас



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
row_countintдасколько строк вернулось
termsstringsда"колодок;колодку;колодкою;
колодкой;
колодке;колодках;колодками;
колодкам;
колодка;колодки;колодки"
поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
class_manstringдапроизводитель запрашиваемой запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px запрашиваемой запчасти
partnumberstringданомер запрашиваемой запчасти
class_catstringданаименование запрашиваемой запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
code_catintдавнутренний уникальный код позиции запрашиваемой запчасти
class_curstringдавалюта (например, белорусские рубли) запрашиваемой запчасти
price_count_instockintдаколичество предложений в наличии запрашиваемой запчасти
price_min_instockdecimalдаминимальная цена среди предложений в наличии запрашиваемой запчасти
price_avg_instockdecimalдасредняя цена среди предложений в наличии запрашиваемой запчасти
price_max_instockdecimalдамаксимальная цена среди предложений в наличии запрашиваемой запчасти
price_count_orderintдаколичество предложений под заказ запрашиваемой запчасти
price_min_orderdecimalдаминимальная цена среди предложений под заказ запрашиваемой запчасти
price_avg_orderdecimalдасредняя цена среди предложений под заказ запрашиваемой запчасти
price_max_orderdecimalдамаксимальная цена среди предложений под заказ запрашиваемой запчасти
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) запрашиваемой запчасти
tableМассив GetSearchResultItem[]даМассив данных



GetSearchResultItem:



ПараметрТипОбязательныйОписание
code_doc_blongдавнутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
code_catintдавнутренний уникальный код позиции
descr_type_searchstringдатип предложения
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qtystringдакол-во, текст!
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставки
courierboolдадоставка курьером: если true - есть, если false - нет
instockV2boolданаличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2boolдатип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2boolдаесли true, то предложение локальное, если false, то из другого региона
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
price_dateDateTimeдадата публикации
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон
order_textstringдатри варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
user_keystringда"ключ" продавца, с помощью которого вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
type_searchintда10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценка,

usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
descr_price_datestringдадавности обновления прайс-листа
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
type_chain_searchintдаосновные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorigboolдаесли true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
locationstringдагород и метро продавца



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&code_region=11135&row_count=100&type_request=0&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=Колодки Nissan" --data-urlencode "partnumber=MR245368" --data-urlencode "class_man=MITSUBISHI" --data-urlencode "code_region=11135" --data-urlencode "row_count=100" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3

Ответ
{
"error":"", // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось

"class_man": "MITSUBISHI", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"table": [ {
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"code_cat": 1116901944 // внутренний уникальный код позиции
"descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
"wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой)
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"class_user": "Repart", // наименование продавца
"descr_rating_count": "5 отзывов", // сколько отзывов
"rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_address": "Москва, м. Юго-Западная", // местоположение
"phone1": "8(926)103-45-33", // телефон
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"type_search": 10, // 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценке
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней", // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"type_user": "UBNAIRWPYTOGM234", // тип пользователя
"type_user2": "GCKMNZ", // тип пользователя 2
"type_price": "RMP", // тип прайс-листа
"descr_price_date":"Сегодня 13ч. назад" // текстовое описание давности обновления прайс-листа
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"location": ""Москва, м. Юго-Западная" // город и метро продавца
}
{
...
}
]
}





МЕТОД "ОДНО ПРЕДЛОЖЕНИЕ" (GETSEARCHRESULTONE) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!

GetSearchResultOne
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOne

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



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



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
code_doc_blongдавнутренний уникальный код предложения
code_catintдавнутренний уникальный код код позиции
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qtystringдакол-во, текст!
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставк
courierboolдадоставка курьером: если true - есть, если false - нет
instockV2boolданаличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2boolдатип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2boolдаесли true, то предложение локальное, если false, то из другого региона
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
priceV3decimalдацена в рублях
price_dateDateTimeдадата публикации
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
descr_priceV3stringдацена в рублях
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
commentV2stringдакраткая информация о продавце
infostringдакогда началось сотрудничество с ZZap
order_textstringдатри варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
accept_messagesboolдаготов ли продавец переписываться с покупателями: true - готов, false - не готов
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
work_timestringдавремя работы продавца
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
telegramstringданомер в telegram
whatsappstringданомер в whatsapp
viberstringданомер в viber
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
type_chain_searchintдаосновные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorigboolдаесли true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOne?login={login}&password={password}&code_doc_b=208098711507246&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOne

Ответ
{
"error": "", // если пусто, ошибок нет
"code_doc_b": 208098711507246, // внутренний уникальный код предложения
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
"wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"priceV3": 1000.00, // цена в рублях
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р." // цена текстом (в той валюте, в которой смотрел покупатель)
"descr_priceV3": "1000р." // цена текстом в рублях
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"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
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"accept_messages": true, // хочет ли продавец принимать сообщения
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней" // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"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
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
}





МЕТОД "ОДНО ПРЕДЛОЖЕНИЕ" (GETSEARCHRESULTONEV2)

GetSearchResultOneV2
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2

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



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



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
code_doc_blongдавнутренний уникальный код предложения
code_catintдавнутренний уникальный код код позиции
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qtystringдакол-во, текст!
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставк
courierboolдадоставка курьером: если true - есть, если false - нет
instockV2boolданаличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2boolдатип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2boolдаесли true, то предложение локальное, если false, то из другого региона
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
priceV3decimalдацена в рублях
price_dateDateTimeдадата публикации
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
descr_priceV3stringдацена в рублях
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
commentV2stringдакраткая информация о продавце
infostringдакогда началось сотрудничество с ZZap
order_textstringдатри варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
accept_messagesboolдаготов ли продавец переписываться с покупателями: true - готов, false - не готов
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
work_timestringдавремя работы продавца
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
telegramstringданомер в telegram
whatsappstringданомер в whatsapp
viberstringданомер в viber
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
type_chain_searchintдаосновные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorigboolдаесли true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
seller_addressV2stringдаполный адрес продавца
seller_locationstringдагород и метро продавца



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2?login={login}&password={password}&code_doc_b=208098711507246&code_region=11135&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "code_region=11135" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2

Ответ
{
"error": "", // если пусто, ошибок нет
"code_doc_b": 208098711507246, // внутренний уникальный код предложения
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_man": "Mitsubishi", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"qty": "10 шт. ", // кол-во, текст!
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"courier": true, // доставка курьером: если true - есть, если false - нет
"instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
"wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
"localV2": true, // если true, то предложение локальное, если false, то из другого региона
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"priceV3": 1000.00, // цена в рублях
"price_date":"2015-02-16T00:09:55" // дата публикации
"descr_priceV2": "1000р." // цена текстом (в той валюте, в которой смотрел покупатель)
"descr_priceV3": "1000р." // цена текстом в рублях
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"descr_qty": "заказ 1 день", // подпись под кол-вом
"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
"order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца)
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"accept_messages": true, // хочет ли продавец принимать сообщения
"qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца
"descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
"delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней" // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
"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
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
"noorig": false, // неоригинальность (true/false)
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"seller_addressV2": "Россия, Москва, Хорошевское шоссе 39", // полный адрес продавца
"seller_location": "Москва, м. Полежаевская" // город и метро продавца
}





МЕТОД "ИНФОРМАЦИЯ О ПОЗИЦИИ" (GETSEARCHRESULTINFO) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!

GetSearchResultInfo
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfo

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



ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации на сайте ZZap (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
partnumberstringданомер запчасти
class_manstringдапроизводитель запчасти
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_catintдавнутренний уникальный код позиции
class_curstringдавалюта (например, белорусские рубли)
price_count_instockintдаколичество предложений в наличии
price_min_instockdecimalдаминимальная цена среди предложений в наличии
price_avg_instockdecimalдасредняя цена среди предложений в наличии
price_max_instockdecimalдамаксимальная цена среди предложений в наличии
price_count_orderintдаколичество предложений под заказ
price_min_orderdecimalдаминимальная цена среди предложений под заказ
price_avg_orderdecimalдасредняя цена среди предложений под заказ
price_max_orderdecimalдамаксимальная цена среди предложений под заказ
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfo?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI¤cy=5&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "partnumber=MR245368" --data-urlencode "currency=5" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfo

Ответ
{
"error": "", // если пусто, ошибок нет
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "НАСОС ВОДЯНОЙ", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1114507085 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
}

В приведённом примере цены в белорусских рублях
Для российских рублей действует округление цен до целого значения.





МЕТОД "ИНФОРМАЦИЯ О ПОЗИЦИИ" (GETSEARCHRESULTINFOV3)

GetSearchResultInfoV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3

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



ПараметрТипОбязательныйОписание
loginstringнетe-mail, указанный при регистрации на сайте ZZap (может быть пустым)
passwordstringнетваш пароль от аккаунта на сайте ZZap (может быть пустым)
partnumberstringданомер запчасти
class_manstringдапроизводитель запчасти
code_curstringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
code_regionstringдаcode_region из метода GetRegions
api_keystringданужно попросить у нас



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_catintдавнутренний уникальный код позиции
class_curstringдавалюта (например, белорусские рубли)
price_count_instockintдаколичество предложений в наличии
price_min_instockdecimalдаминимальная цена среди предложений в наличии
price_avg_instockdecimalдасредняя цена среди предложений в наличии
price_max_instockdecimalдамаксимальная цена среди предложений в наличии
price_count_orderintдаколичество предложений под заказ
price_min_orderdecimalдаминимальная цена среди предложений под заказ
price_avg_orderdecimalдасредняя цена среди предложений под заказ
price_max_orderdecimalдамаксимальная цена среди предложений под заказ
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI&code_cur=5&code_region=1&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "partnumber=MR245368" --data-urlencode "code_cur=5" --data-urlencode "code_region=1" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3

Ответ
{
"error": "", // если пусто, ошибок нет
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "НАСОС ВОДЯНОЙ", // наименование
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px
"code_cat": 1114507085 // внутренний уникальный код позиции
"class_cur": "б.р.", // валюта (например, белорусские рубли)
"price_count_instock": 13 // количество предложений в наличии
"price_min_instock": 56.35, // минимальная цена среди предложений в наличии
"price_avg_instock": 64.56, // средняя цена среди предложений в наличии
"price_max_instock": 75.16, // максимальная цена среди предложений в наличии
"price_count_order": 147 // количество предложений под заказ
"price_min_order": 56.35, // минимальная цена среди предложений под заказ
"price_avg_order": 66.06, // средняя цена среди предложений под заказ
"price_max_order": 92.42, // максимальная цена среди предложений под заказ
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
}

В приведённом примере цены в белорусских рублях
Для российских рублей действует округление цен до целого значения.





МЕТОД "МОЯ ИСТОРИЯ ПОИСКА" (GETMYSEARCHHISTORY) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!

GetMySearchHistory
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistory

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



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



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



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



GetMySearchHistoryItem:



ПараметрТипОбязательныйОписание
create_dateDateTimeдадата поиска запчасти (информативна только дата, учитываем не повторяющиеся позиции за день, время всегда 00:00:00)
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)



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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00)
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "Помпа", // наименование запчасти
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] , // массив ссылок на превью фото запчасти 60px на 60px
"code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
}
{
...
}
]
}



МЕТОД "МОЯ ИСТОРИЯ ПОИСКА" (GETMYSEARCHHISTORYV2)

GetMySearchHistoryV2
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2

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



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



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



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



GetMySearchHistoryItem:



ПараметрТипОбязательныйОписание
create_dateDateTimeдадата поиска запчасти (информативна только дата, учитываем не повторяющиеся позиции за день, время всегда 00:00:00)
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер
class_catstringданаименование запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
code_catintдавнутренний код позиции



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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "api_key={api_key}" --data-urlencode "call_data=" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00)
"class_man": "HEPU", // производитель
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"partnumber": "P049", // номер
"class_cat": "Помпа", // наименование запчасти
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px
"imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"], // массив ссылок на превью фото запчасти 60px на 60px
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"code_cat": 353454213 // внутренний код позиции
}
{
...
}
]
}





МЕТОД "КАТАЛОГ ШИН" (GETCATALOGTYRES)

GetCatalogTyres
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres

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



ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации (может быть пустым)
passwordstringдаваш пароль от аккаунта на сайте ZZap (может быть пустым)
filterstringдапроизвольная строка фильтрации, например tag_r='R20'
sortstringдасортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля
code_regionstringдаcode_region из метода GetRegions
row_countstringдасколько максимально записей возвращать
row_startstringдас каким сдвигом от нулевой строки возвращать записи
api_keystringданужно попросить у нас



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



ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
row_countintдасколько строк вернулось
row_count_totalintдасколько всего строк в таблице без учета фильтрации
class_man_enumstring[]дамассив из возможных значений поля class_man - производителей, использовать для фильтра.
tag_r_enumstring[]дамассив из возможных значений поля tag_r - радиус, использовать для фильтра.
tag_m_enumstring[]дамассив из возможных значений поля tag_m - ширина, использовать для фильтра.
tag_n_enumstring[]дамассив из возможных значений поля tag_n - высота, использовать для фильтра.
tag_l_enumstring[]дамассив из возможных значений поля tag_l - сезон, использовать для фильтра.
tableМассив GetCatalogTyresItem[]дамассив данных



GetCatalogTyresItem:



ПараметрТипОбязательныйОписание
class_manstringдапроизводитель
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер производителя
class_catstringданаименование
code_catintдавнутренний уникальный код позиции
imagepathstring[]дамассив ссылок на превью фото запчасти 60px на 60px****
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
commentstringдаописание позиции
price_mindecimalдаминимальная цена
price_meddecimalдацена медиана
price_maxdecimalдамаксимальная цена
price_countintдакол-во предложений
tag_rstringдарадиус
tag_mstringдаширина
tag_nstringдавысота
tag_lstringдасезон



Пример вызова:
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres?login={login}&password={password}&code_region=1&row_count=3&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "filter=" --data-urlencode "code_region=1" --data-urlencode "row_count=3" --data-urlencode "row_start=" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 3, // сколько строк вернулось
"row_count_total":18975,
"class_man_enum":["ACHILLES","ALTENZO","AMTEL"....],
"tag_r_enum":["R12","R13","R14","R15","R16","R17","R17.5","R18","R19","R20","R21","R22","R22.5","R23","R24"],
"tag_m_enum":["27\"","30\"","31\"","32\"","33\"","35\"","37\"","38\"","39\"","40\"","135","145","155","165","175","185",

"195","205","215","225","235","245","255","265","275","285","295","305","315","325","335","345","355","385"],
"tag_n_enum":["8.5\"","9.5\"","10.5\"","11.5\"","12.5\"","13.5\"","14.5\"","20","25","30","35","40","45","50","55","60",

"65","70","75","80","85","90"],
"tag_l_enum":["Всесезонная","Зимняя нешипованная","Зимняя шипованная","Летняя"]


"table":
[
{
"class_man":"MICHELIN",
"logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s7ade3bde2d5ac9cb8138285159d321f9.jpg",
"partnumber":"ZZ436707390",
"class_cat":"X-ICE",
"code_cat":1749664696,
"imagepath":["https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p28b88ff9dff8732e44dd3d8bf957b2ad.jpg"],
"code_man":3186,
"comment":"Зимняя нешипуемая шина Michelin X-Ice с направленным рисунком ....",
"price_min":7978.20,
"price_med":8796.50,
"price_max":10996.50,
"price_count":35,
"tag_r":"R16",
"tag_m":"205",
"tag_n":"55",
"tag_l":"Зимняя нешипованная"}
...
]
}









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


****imagepath
ссылка https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg содержит в имени файла "p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" букву p, что делает картинку превью 60px на 60px. если из ссылки эту букву убрать, получится ссылка на картинку оригинального размера (изначально загруженная картинка) https://koj.blob.core.windows.net/zzap-upload/upload/catalog/2739725d8d53bff0ccf0ecbfb9cf920b.jpg

test