Поиск

Метод «подсказка» (GetSearchSuggestV3)

Аналогично GetSearchSuggest, но с дополнительным параметром type_request, login и password
GetSearchSuggestV3
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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 — поиск по б/у и уценке (по введённым в поисковую строку словам), 4 — любые предложения только по запрошенному номеру, 5 — новые только по запрошенному номеру
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://www.zzap.ru/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://www.zzap.ru/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»: «»Москва, м. Юго-Западная» // город и метро продавца
}
{

}
]
}



Метод «одно предложение» (GetSearchResultOneV2)

GetSearchResultOneV2
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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»: «Москва, м. Полежаевская» // город и метро продавца
}



 

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

GetSearchResultInfoV3
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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)
}

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



 

Метод «моя история поиска» (GetMySearchHistoryV2)

GetMySearchHistoryV2
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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»:»Зимняя нешипованная»}

]
}


Метод «результат поиска» (GetSearchResultLight)

Аналогично GetSearchResultV3, но только по запрошенному номеру (без замен)
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultLight

Входные параметры (для 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да4 — любые только по запрошенному номеру, 5 — только новые и только по запрошенному номеру
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://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultLight?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&code_region=11135&row_count=100&type_request=4&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=4» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultLight

Ответ
{
«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»: «»Москва, м. Юго-Западная» // город и метро продавца
}
{

}
]
}

Важно!
Для данного метода значения входного параметра type_request могут быть только 4 и 5



 

*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

Поиск