API zzap.ru

Изменено 26/02/2019 00:13 Administrator — Категории страницы: Без категорий

Базовая ссылка вебсервиса

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


Получить api_key

Для того, чтобы воспользоваться ниже описанными методами выгрузки данных, необходимо получить api_key

Правила работы


Оглавление [Скрыть/Показать]


Базовая ссылка вебсервиса
   Получить api_key
   Правила работы
История изменений
Поиск
    Метод "подсказка" (GetSearchSuggest) устарел, не использовать!
    Метод "подсказка" (GetSearchSuggestV2)
    Метод "результат поиска" (GetSearchResult) устарел, не использовать!
    Метод "результат поиска" (GetSearchResultV2)
    Метод "одно предложение" (GetSearchResultOne)
    Метод "информация о позиции" (GetSearchResultInfo)
    Метод "моя история поиска" (GetMySearchHystory)
Информация
    Метод "регионы поиска" (GetRegions)
    Метод "производители авто" (GetBrands)
    Метод "статистика цен" (GetStatPrices) устарел, не использовать!
    Метод "статистика цен" (GetStatPricesV2)
    Метод "мои данные" (GetMyInfo) устарел, не использовать!
    Метод "мои данные" (GetMyInfoV2)
    Метод "информация о продавце" (GetUserInfo)
    Метод "отзывы о продавце" (GetRatings)
Регистрация
    Метод "регистрация" (MakeRegistration)
Для покупателей
Заказ и регистрация
    Метод "заказ и регистрация" (MakeRegistrationOrder) устарел, не использовать!
    Метод "заказ и регистрация" (MakeRegistrationOrderV2)
    Метод "сделать заказ" (MakeOrder) устарел, не использовать!
    Метод "сделать заказ" (MakeOrderV2)
Заказы покупателя
    Метод "мои заказы" (GetMyOrders)
    Метод "оставить отзыв по заказу" (MakeOrderRating) устарел, не использовать!
    Метод "оставить отзыв по заказу" (MakeOrderRatingV2)
VIN запросы покупателя
    Метод "VIN запрос" (MakeVinRequest) устарел, не использовать!
    Метод "VIN запрос" (MakeVinRequestV2)
    Метод "мои VIN запросы" (GetMyVinRequests)
    Метод "ответы на мои VIN запросы" (GetMyVinRequestReplies)
Для продавцов
Заказы продавца
    Метод "заказы продавца" (GetSellerOrders)
    Метод "подтверждение продавцом получения заказа" (SetOrderStatus)
   Отправка заказа от покупателя на сайт продавца
VIN запросы продавца
    Метод "VIN запросы продавца" (GetSellerVinRequests)
    Метод "подтверждение продавцом получения VIN запроса" (SetVinRequestStatus)
Статистика продавца
    Метод "моя статистика" (GetMyStatCustomers)
Общие методы
    Метод "восстановление пароля" (RequestPasswordRecover)
Избранные позиции
    Метод "добавление позиции в избранные" (AddFavoriteSearch)
    Метод "удаление позиции из избранных" (DeleteFavoriteSearch)
    Метод "мои избранные позиции" (GetMyFavoritesSearch)
Сообщения
    Метод "мои собеседники" (GetMyMessagesThreads) устарел, не использовать!
    Метод "мои собеседники" (GetMyMessagesThreadsV2)
    Метод "мои сообщения" (GetMyMessages) устарел, не использовать!
    Метод "мои сообщения" (GetMyMessagesV2)
    Метод "отправка сообщения" (SendMessage) устарел, не использовать!
    Метод "отправка сообщения" (SendMessageV2)
Сообщение об ошибке
    Метод "отправка сообщения об ошибке" (SendAppErrorMessage)


История изменений

версия 1.1 начальный выпуск - методы GetSearchSuggest, GetSearchResult, GetUserData, GetRegions
версия 1.2 добавлены методы MakeRegistration, MakeOrder, GetRatings, MakeOrderRating, GetMyOrders
версия 1.3 добавлена возможность отправки заказа от покупателя на сайт продавца, метод SetOrderStatus
версия 1.4 добавлены методы GetSellerOrders, GetMyInfo
версия 1.5 в методах GetSearchSuggest, GetSearchResult добавлено поле logopath (логотип производителя)
версия 1.6 добавлен метод GetStatPrices
версия 1.7 добавлен метод MakeRegistrationOrder
версия 1.8 добавлен метод MakeVinRequest
версия 1.9 добавлен метод GetBrands и поля addr_map_geo1 и addr_map_geo2 в метод GetSearchResult
версия 1.10 добавлены методы GetMyVinRequests, GetMyVinRequestReplies
версия 1.11 добавлен метод GetUserInfo, в методах GetMyOrders и GetMyVinRequestReplies добавлено поле user_key
версия 1.12 добавлены поля (на выход):
seller_rating_count, seller_rating, seller_address, seller_phone, seller_phone2, descr_price - в метод GetMyOrders
seller_rating_count, seller_rating, seller_address, seller_phone2 - в метод GetMyVinRequestReplies
версия 1.13 добавлены методы GetMySearchHistory, SetVinRequestStatus, GetSellerVinRequests; добавлено поле is_seller в метод GetMyInfo
версия 1.14 добавлен метод SendAppErrorMessage
версия 1.15 добавлены методы GetMyFavoritesSearch, AddFavoriteSearch, DeleteFavoriteSearch
версия 1.16 метод GetUserData "одно предложение" устарел, добавлен новый метод GetSearchResultOne
версия 1.17 методы GetMinPrices и GetAvgPrices устарели, пользуйтесь вместо них GetStatPrices
версия 1.18 добавлен метод GetSearchResultInfo
версия 1.19 добавлены методы GetSearchSuggestV2 (принимает новый параметр type_request) и GetSearchResultV2 (принимает новые параметры type_request и search_text)
GetSearchSuggestV2 и GetSearchResultV2 возвращают новое поле type_search
версия 1.20 добавлено поле (на выход) terms в метод GetSearchResultV2
версия 1.21 добавлен метод GetMyStatCustomers
версия 1.22 добавлено поле used в методы GetSearchResultV2, GetSearchResultOne, GetMyOrders, GetSellerOrders, GetSearchResult
версия 1.23 добавлены поля code_template и price_name в метод GetSellerOrders
версия 1.24 добавлены методы GetMyMessagesThreads, GetMyMessages, SendMessage и поле user_key в GetMyInfo
версия 1.25 добавлено поле accept_messages в методы GetUserInfo, GetSearchResultOne
версия 1.26 добавлен метод RequestPasswordRecover
версия 1.27 добавлены методы MakeOrderV2, MakeRegistrationOrderV2, MakeVinRequestV2, MakeOrderRatingV2, GetStatPricesV2 - на входе изменены типы полей:
в методах MakeOrderV2, MakeRegistrationOrderV2, MakeVinRequestV2 поля notifySms и test теперь bool
в методе MakeOrderRatingV2 поле test теперь bool
в методе GetStatPricesV2 поля instock, wholesale теперь bool
добавлены некоторые возвращаемые параметры:
в методах GetSearchResult, GetSearchResultV2, GetSearchResultOne - apply, min_sum_order, descr_min_sum_order, shipment, courier, price_orig, descr_price_orig, descr_type_price
в методах GetMyOrders , GetSellerOrders - min_sum_order, descr_min_sum_order, shipment, price_orig, descr_price_orig, descr_type_price
изменены типы некоторых возвращаемых параметров:
в методах GetSearchResult, GetSearchResultV2, GetSearchResultOne теперь это параметры instockV2, wholesaleV2, localV2, usedV2, priceV2, descr_priceV2
в методе GetMyOrders - usedV2, rated_orderV2, applyV2, priceV2, descr_priceV2
в методе GetSellerOrders - usedV2, applyV2, priceV2, descr_priceV2


Поиск

Метод "подсказка" (GetSearchSuggest) устарел, не использовать!

Аналогично тому, что можно видеть на заглавной странице, когда набираешь поиск
GetSearchSuggest
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchSuggest

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

ПараметрТипОбязательныйОписание
search_text string да произвольная строка поиска
row_countstring дасколько максимально записей возвращать
api_keystringданужно попросить у нас


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

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


GetSearchSuggestItem:

ПараметрТипОбязательныйОписание
class_man string дапроизводитель
logopath string далоготип производителя
partnumber string даномер производителя
class_catstring данаименование
code_cat intдавнутренний уникальный код позиции
imagepath stringдапревью картинки 60px на 60px


Пример вызова:
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchSuggest?search_text=Колодки BMW&row_count=3&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "search_text=колодки BMW" --data-urlencode "row_count=3" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchSuggest

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 50, // сколько строк вернулось
"terms": "колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки",
"table":
[
{
"class_man": "BMW", // производитель
"logopath": "", // картинка
"partnumber": "34116769951", // номер
"class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование
"code_cat": 115835062, // внутренний уникальный код позиции
"imagepath":"http://i.zzap.ru/i/t4q3/39/p710476.jpg" // превью картинки 60px на 60px
},
{
...
}
]
}



Метод "подсказка" (GetSearchSuggestV2)

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

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

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


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

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


GetSearchSuggestItem:

ПараметрТипОбязательныйОписание
class_man string дапроизводитель
logopath string далоготип производителя
partnumber string даномер производителя
class_catstring данаименование
code_cat intдавнутренний уникальный код позиции
imagepath stringдапревью картинки 60px на 60px


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

Windows через cmd.exe
Chcp 65001
curl.exe --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/GetSearchSuggestV2

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 50, // сколько строк вернулось
"terms": "колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки",
"table":
[
{
"class_man": "BMW", // производитель
"logopath": "", // картинка
"partnumber": "34116769951", // номер
"class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование
"code_cat": 115835062, // внутренний уникальный код позиции
"imagepath":"http://i.zzap.ru/i/t4q3/39/p710476.jpg" // превью картинки 60px на 60px
},
{
...
}
]
}



Метод "результат поиска" (GetSearchResult) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
login string нет e-mail, указанный при регистрации (может быть пустым)
passwordstring нетваш пароль от аккаунта на сайте ZZap (может быть пустым)
partnumberstringданомер запчасти
class_manstringдапроизводитель запчасти
locationstringдаcode_region из метода GetRegions
row_countstringдаограничение по кол-ву строк по умолчанию 100 максимум 500
api_keystringданужно попросить у нас


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

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


GetSearchResultItem:

ПараметрТипОбязательныйОписание
code_doc_blongдавнутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
code_catintдавнутренний уникальный код позиции
descr_type_searchstring датип предложения
class_manstring дапроизводитель
logopathstring далоготип производителя
partnumberstring даномер
class_catstring данаименование
imagepathstring даизображение/фото запчасти
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_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
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 – б/у и уценка


Пример вызова:
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResult?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI&location=0&row_count=100&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 "class_man=MITSUBISHI" --data-urlencode "location=0" --data-urlencode "row_count=100" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResult

Ответ
{
"error":"", // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"table": [ {
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"code_cat": 1116901944 // внутренний уникальный код позиции
"descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения
"class_man": "Mitsubishi", // производитель
"logopath": "", // логотип производителя
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath":"" // изображение/фото запчасти
"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 – б/у и уценка
}
{
...
}
]
}



Метод "результат поиска" (GetSearchResultV2)

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

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

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


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

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


GetSearchResultItem:

ПараметрТипОбязательныйОписание
code_doc_blongдавнутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
code_catintдавнутренний уникальный код позиции
descr_type_searchstring датип предложения
class_manstring дапроизводитель
logopathstring далоготип производителя
partnumberstring даномер
class_catstring данаименование
imagepathstring даизображение/фото запчасти
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_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
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 - Результат поиска по б/у и уценка,
termsstring да"колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки"
поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка


Пример вызова:
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultV2?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&location=0&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 "location=0" --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/GetSearchResultV2

Ответ
{
"error":"", // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"table": [ {
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"code_cat": 1116901944 // внутренний уникальный код позиции
"descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения
"class_man": "Mitsubishi", // производитель
"logopath": "", // логотип производителя
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath":"" // изображение/фото запчасти
"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 – б/у и уценка
}
{
...
}
]
}



Метод "одно предложение" (GetSearchResultOne)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
содержит текст ошибки, если таковая возникла при выполнении запроса.
code_doc_blongдавнутренний уникальный код предложения
code_catintдавнутренний уникальный код код позиции
class_manstringдапроизводитель
logopathstringдалоготип производителя
partnumberstringданомер
class_catstringданаименование
imagepathstringдаизображение/фото запчасти
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_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qtystringдаподпись под кол-вом
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
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 - не готов

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

Ответ
{
"error": "", // если пусто, ошибок нет
"code_doc_b": 208098711507246, // внутренний уникальный код предложения
"code_cat": 1116901944 // внутренний уникальный код позиции
"class_man": "Mitsubishi", // производитель
"logopath": "", // логотип производителя
"partnumber": "MR245368", // номер
"class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование
"imagepath":"" // изображение/фото запчасти
"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", // телефон 1
"phone2": "8(926)103-45-34", // телефон 2
"comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
"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 // хочет ли продавец принимать сообщения
}



Метод "информация о позиции" (GetSearchResultInfo)

GetSearchResultInfo
https://www.zzap.ru/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далоготип производителя
partnumberstringданомер
class_catstringданаименование
imagepathstringдаизображение/фото запчасти
code_catintдавнутренний уникальный код позиции
class_curstringдавалюта (например, белорусские рубли)
price_count_instockintдаколичество предложений в наличии
price_min_instockdecimnalдаминимальная цена среди предложений в наличии
price_avg_instockdecimnalдасредняя цена среди предложений в наличии
price_max_instockdecimnalдамаксимальная цена среди предложений в наличии
price_count_orderintдаколичество предложений под заказ
price_min_orderdecimalдаминимальная цена среди предложений под заказ
price_avg_orderdecimalдасредняя цена среди предложений под заказ
price_max_orderdecimalдамаксимальная цена среди предложений под заказ


Пример вызова:
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultInfo?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI&currency=2&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=2" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSearchResultInfo

Ответ
{
"error": "", // если пусто, ошибок нет
"class_man": "HEPU", // производитель
"logopath": "", // логотип производителя
"partnumber": "P049", // номер
"class_cat": "НАСОС ВОДЯНОЙ", // наименование
"imagepath": "" // изображение/фото запчасти
"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, // максимальная цена среди предложений под заказ
}

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



Метод "моя история поиска" (GetMySearchHystory)

GetMySearchHystory
https://www.zzap.ru/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далоготип производителя
partnumberstringданомер
class_catstringданаименование запчасти
imagepathstringдаизображение/фото запчасти


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

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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00)
"class_man": "HEPU", // производитель
"logopath": "", // логотип производителя
"partnumber": "P049", // номер
"class_cat": "Помпа", // наименование запчасти
"imagepath": "" // изображение/фото запчасти
}
{
...
}
]
}


Информация

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

GetRegions // доступные регионы для поиска
https://www.zzap.ru/webservice/datasharing.asmx/GetRegions

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

ПараметрТипОбязательныйОписание
api_keystringданужно попросить у нас

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

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

GetRegionItem:

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


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

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


Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetRegions

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



Метод "производители авто" (GetBrands)

GetBrands // доступные производители авто
https://www.zzap.ru/webservice/datasharing.asmx/GetBrands

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

ПараметрТипОбязательныйОписание
api_keystringданужно попросить у нас


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

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


GetBrandItem:

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


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

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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "api_key={api_key}" -X POST

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



Метод "статистика цен" (GetStatPrices) устарел, не использовать!

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

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

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


Примечание:
в параметре codes_cat можно передавать не больше 100 code_cat


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

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


GetStatPricesItem:

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

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

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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "codes_cat=1114507085;118182355;114720089" --data-urlencode "code_region=1" --data-urlencode "instock=1" --data-urlencode "wholesale=0" --data-urlencode "api_key={api_key}" -X POST

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



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

GetStatPricesV2
https://www.zzap.ru/webservice/datasharing.asmx/GetStatPrices

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

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


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

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


GetStatPricesItem:

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

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

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

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

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



Метод "мои данные" (GetMyInfo) устарел, не использовать!

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

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

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


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

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


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

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

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



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

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

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

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


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

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


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

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

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



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

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


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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
class_userstringданаименование продавца
descr_rating_countstringдасколько отзывов текстом
ratingintдарейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_addressstringдаместоположение
phone1stringдателефон 1
phone2stringдателефон 2
commentstringдачасы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
infostringдакогда началось сотрудничество с ZZap
addr_map_geo1doubleдаширота (координаты местонахождения продавца)
addr_map_geo2doubleдадолгота (координаты местонахождения продавца)
accept_messagesboolдаготов ли продавец переписываться с покупателями: true - готов, false - не готов


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

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

Ответ
{
"error": "", // если пусто, ошибок нет
"class_user": "Repart", // наименование продавца
"descr_rating_count": "5 отзывов", // сколько отзывов
"rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
"descr_address": "Москва п.Внуково, м.Юго-Западная", //местоположение
"phone1": "8(926)103-45-33", //телефон 1
"phone2": "8(926)103-45-34", //телефон 2
"comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
"info": "Публикуется в ZZap с 20-08-12", // когда началось сотрудничество с ZZap
"addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца)
"addr_map_geo2": 37.513069357681161 // долгота (координаты местонахождения продавца)
"accept_messages": true // хочет ли продавец принимать сообщения
}



Метод "отзывы о продавце" (GetRatings)

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

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

ПараметрТипОбязательныйОписание
user_keystringда"ключ" продавца, полученный в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies
row_countstringдасколько максимально записей возвращать (максимум 500)
api_keystringданужно попросить у нас


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

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


GetRatingsItem:

ПараметрТипОбязательныйОписание
create_dateDateTimeдадата написания отзыва
messagestringдаполный текст отзыва
ratingdecimalдаоценка от 1 до 5 баллов
client_infostringдаимя того, кто оставил отзыв и телефон (скрытый)
rating_typestringдаОтзыв" (отзыв о продавце) или "Ответ на отзыв" (ответ продавца на отзыв)


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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "user_key={user_key}" --data-urlencode "row_count=50" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetRatings

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


Регистрация

Метод "регистрация" (MakeRegistration)

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

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

ПараметрТипОбязательныйОписание
emailstringдаe-mail, который будет использоваться в дальнейшем как Ваш login на сайте ZZap
passwordstringсм. примечаниеваш пароль - пароль должен состоять как минимум из 4 символов
code_regionstringдавыбранный вами регион - числовое значение региона определите с помощью метода GetRegions
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
company_nickstringнетник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо
phone_code_countrystringдакод страны
phone_code_citystringдакод города
phonestringдателефон
phone_addstringнетдобавочный
email_oldstringсм. примечаниеe-mail, указанный при регистрации на сайте ZZap
password_oldstringсм. примечаниеваш пароль от аккаунта на сайте ZZap
api_keystringданужно попросить у нас


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Примечание:
Для регистрации не надо заполнять email_old и password_old
все остальные поля, кроме name_second, company_nick (если вы физ. лицо) и phone_add, обязательны для заполнения
Для изменения данных обязательно надо заполнить email_old и password_old,
обязательны для заполнения все поля, кроме name_second, company_nick (если вы физ. лицо), phone_add и password

Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistration?email=email@mail.ru&password={password}&code_region=1&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick=&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&email_old=email@mail.ru&password_old={password_old}&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "email=email@mail.ru" --data-urlencode "password={password}" --data-urlencode "code_region=1" --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick=" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "phone_add=11"--data-urlencode "email_old=email@mail.ru"--data-urlencode "password_old={password_old}" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistration

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


Для покупателей


Заказ и регистрация

Метод "заказ и регистрация" (MakeRegistrationOrder) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail для регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
company_nickstringнетник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо
phone_code_countrystringдакод страны
phone_code_citystringдакод города
phone stringдателефон
phone_add stringнетдобавочный
client_code_regionstringдарегион покупателя - числовое значение региона определите с помощью метода GetRegions
code_doc_bstringдавнутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_orderstringдакол-во заказываемой позиции
commentstringнетдополнительные комментарии относительно заказа
notify_smsstringдаоповещение по смс: 0 - не оповещать, 1 - оповещать
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас
teststringда1 (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - 0 (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
code_orderintданомер сформированного заказа


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrder?login={login}&password={password}&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick={company_nick}&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&client_code_region=30100&code_doc_b=208098711507246&qty_order=1&comment=Заберу в субботу в первой половине дня&notify_sms=1&currency=1&api_key={api_key}&test=1

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode " --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick={company_nick}" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "phone_add=11" --data-urlencode "client_code_region=30100" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "comment=Заберу в субботу в первой половине дня" --data-urlencode "notify_sms=1" --data-urlencode "currency=1"--data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrder

Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста) }

Очень важно!!! Партнёры, реализующие на своём сайте трансляцию выдачи ZZap с возможностью оформить на их же сайте заказ, для корректного учёта таких заказов в партнёрской статистике должны передавать из данных своего партнёрского аккаунта на ZZap только api_key, а остальные данные запрашивать у пользователя, оформляющего заказ на их сайте.



Метод "заказ и регистрация" (MakeRegistrationOrderV2)

MakeRegistrationOrderV2
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrder

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail для регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
company_nickstringнетник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо
phone_code_countrystringдакод страны
phone_code_citystringдакод города
phone stringдателефон
phone_add stringнетдобавочный
client_code_regionstringдарегион покупателя - числовое значение региона определите с помощью метода GetRegions
code_doc_bstringдавнутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_orderstringдакол-во заказываемой позиции
commentstringнетдополнительные комментарии относительно заказа
notify_smsstringдаоповещение по смс: false - не оповещать, true - оповещать
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
code_orderintданомер сформированного заказа


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrder?login={login}&password={password}&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick={company_nick}&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&client_code_region=30100&code_doc_b=208098711507246&qty_order=1&comment=Заберу в субботу в первой половине дня&notify_sms=true&currency=1&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode " --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick={company_nick}" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "phone_add=11" --data-urlencode "client_code_region=30100" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "comment=Заберу в субботу в первой половине дня" --data-urlencode "notify_sms=true" --data-urlencode "currency=1"--data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrder

Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста) }

Очень важно!!! Партнёры, реализующие на своём сайте трансляцию выдачи ZZap с возможностью оформить на их же сайте заказ, для корректного учёта таких заказов в партнёрской статистике должны передавать из данных своего партнёрского аккаунта на ZZap только api_key, а остальные данные запрашивать у пользователя, оформляющего заказ на их сайте.



Метод "сделать заказ" (MakeOrder) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_doc_bstringдавнутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_orderstringдакол-во заказываемой позиции
client_namestringдаФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации)
client_emailstringдаe-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации)
client_phonestringдателефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации)
commentstringнетдополнительные комментарии относительно заказа
notify_smsstringдаоповещение по смс: 0 - не оповещать, 1 - оповещать
client_code_regionstringдавыбранный регион для заказа (может отличаться от региона, указанного при регистрации) - числовое значение региона определите с помощью метода GetRegions
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас
teststringда1 (режим теста): заказ не будет сформирован, остальные значения - 0 (обычный рабочий режим): заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
code_orderintданомер сформированного заказа


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrder?login={login}&password={password}&code_doc_b=208098711507246&qty_order=1&client_name=Фамилия Имя&client_email=email@mail.ru&client_phone=8(000)111-11-11&comment=заберу в субботу в первой половине дня&notify_sms=1&client_code_region=30100&currency=1&api_key={api_key}&test=1

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "client_name=Фамилия Имя" --data-urlencode "client_email=email@mail.ru" --data-urlencode "client_phone=8(000)111-11-11" --data-urlencode "comment=заберу в субботу в первой половине дня" --data-urlencode "notify_sms=1" --data-urlencode "client_code_region=30100" --data-urlencode "currency=1" --data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrder

Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста)
}



Метод "сделать заказ" (MakeOrderV2)

MakeOrderV2
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrder

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_doc_bstringдавнутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_orderstringдакол-во заказываемой позиции
client_namestringдаФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации)
client_emailstringдаe-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации)
client_phonestringдателефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации)
commentstringнетдополнительные комментарии относительно заказа
notify_smsstringдаоповещение по смс: false - не оповещать, true - оповещать
client_code_regionstringдавыбранный регион для заказа (может отличаться от региона, указанного при регистрации) - числовое значение региона определите с помощью метода GetRegions
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): заказ не будет сформирован, остальные значения - false (обычный рабочий режим): заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
code_orderintданомер сформированного заказа


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrder?login={login}&password={password}&code_doc_b=208098711507246&qty_order=1&client_name=Фамилия Имя&client_email=email@mail.ru&client_phone=8(000)111-11-11&comment=заберу в субботу в первой половине дня&notify_sms=true&client_code_region=30100&currency=1&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "client_name=Фамилия Имя" --data-urlencode "client_email=email@mail.ru" --data-urlencode "client_phone=8(000)111-11-11" --data-urlencode "comment=заберу в субботу в первой половине дня" --data-urlencode "notify_sms=true" --data-urlencode "client_code_region=30100" --data-urlencode "currency=1" --data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrder

Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста)
}


Заказы покупателя


Метод "мои заказы" (GetMyOrders)

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

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

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


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

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


GetOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдалоготип производителя
partnumberstringданомер заказанной запчасти
commentstringнеткомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepathstringдаизображение/фото запчасти
qty_orderstringдакол-во заказанных позиций
qtystringда"В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
applyV2stringдаусловия продажи
client_namestringдапокупатель
seller_namestringдапродавец
responsestringдаответ на заказ от продавца
rated_orderV2boolдаfalse – отзыв по заказу ещё не написан, true – отзыв по заказу уже написан
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
seller_rating_countstringдаколичество отзывов продавца текстом
seller_ratingintдарейтинг продавца
seller_addressstringдаполный адрес продавца
seller_phonestringдателефон продавца
seller_phone2stringдаещё один телефон продавца
min_sum_order decimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipment stringдаусловия доставки
price_orig decimalдацена (в той валюте, в которой публиковал продавец)
descr_price_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка


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

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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"code_order": 3930751, // номер заказа
"create_date": "2015-04-01T19:56:36.350", // время создания заказа
"class_man": "HEPU", // производитель заказанной запчасти
"logopath": "", // логотип производителя
"partnumber": "P049", // номер заказанной запчасти
"comment": "", // комментарий к заказу от покупателя
"class_cat": "ПОМПА", // наименование запчасти
"imagepath":"" // изображение/фото запчасти
"qty_order": "1", // кол-во заказанных позиций
"qty": "6 шт. ", // "В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа
"descr_qty": "3-5 р.д.", // срок поставки (дополнение к информации о количестве)
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"applyV2": "Скидка постоянным клиентам", // условия продажи
"client_name": "Фамилия Имя", // покупатель
"seller_name": "Компания", // продавец
"response": "Помпа в наличии - приезжайте!", // ответ на заказ от продавца
"rated_orderV2": true, // false – отзыв по заказу ещё не написан, true – отзыв по заказу уже написан
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"seller_rating_count": "33 отзыва", // количество отзывов продавца
"seller_rating": 4, // рейтинг продавца
"seller_address": "Россия, Москва, пр-д. 4-й Рощинский проезд 19, м. Тульская", // полный адрес продавца
"seller_phone": "8(916)000-00-00", // телефон продавца
"seller_phone2": "8(000)111-11-11", // ещё один телефон продавца
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка
}
{
...
}
]
}



Метод "оставить отзыв по заказу" (MakeOrderRating) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_orderstringданомер заказа
ratingstringдаоценка от 1 до 5 баллов
messagestringдакомментарии по заказу
phonestringдателефон
api_keystringданужно попросить у нас
teststringда1 (режим теста): отзыв не будет сохранён. остальные значения - 0 (обычный рабочий режим): отзыв будет сохранён


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderRating?login={login}&password={password}&code_order=3930751&rating=5&message=Номер заказа: \\n1111111\\nПозиция: \\nRENAULT 7701070525 ФИЛЬТР ВОЗД. КАНГУ КЛИО E7J, K7J, LB03, заказано: 1шт., по 632.00р.\\n\\nЗамечаний нет!\\n\\nКомментарии:\\nотзыв о покупателе (по заказу)\\nпокупатель - ok&phone=8(916)000-00-00&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "rating=5" --data-urlencode "message=Номер заказа: \\n1111111\\nПозиция: \\nRENAULT 7701070525 ФИЛЬТР ВОЗД. КАНГУ КЛИО E7J, K7J, LB03, заказано: 1шт., по 632.00р.\\n\\nЗамечаний нет!\\n\\nКомментарии:\\nотзыв о покупателе (по заказу)\\nпокупатель - ok" --data-urlencode "phone=8(916)000-00-00" --data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderRating

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



Метод "оставить отзыв по заказу" (MakeOrderRatingV2)

MakeOrderRatingV2
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderRating

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_orderstringданомер заказа
ratingstringдаоценка от 1 до 5 баллов
messagestringдакомментарии по заказу
phonestringдателефон
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): отзыв не будет сохранён. остальные значения - 0 (обычный рабочий режим): отзыв будет сохранён


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderRating?login={login}&password={password}&code_order=3930751&rating=5&message=Номер заказа: \\n1111111\\nПозиция: \\nRENAULT 7701070525 ФИЛЬТР ВОЗД. КАНГУ КЛИО E7J, K7J, LB03, заказано: 1шт., по 632.00р.\\n\\nЗамечаний нет!\\n\\nКомментарии:\\nотзыв о покупателе (по заказу)\\nпокупатель - ok&phone=8(916)000-00-00&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "rating=5" --data-urlencode "message=Номер заказа: \\n1111111\\nПозиция: \\nRENAULT 7701070525 ФИЛЬТР ВОЗД. КАНГУ КЛИО E7J, K7J, LB03, заказано: 1шт., по 632.00р.\\n\\nЗамечаний нет!\\n\\nКомментарии:\\nотзыв о покупателе (по заказу)\\nпокупатель - ok" --data-urlencode "phone=8(916)000-00-00" --data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderRating

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


VIN запросы покупателя

Метод "VIN запрос" (MakeVinRequest) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
vin_codestringдаVIN-код авто
car_brandstringдамарка авто
car_modelstringдамодель авто
car_yearstringдагод выпуска
enginestringнетдвигатель
modificationstringнетмодификация
request_textstringдаописание запроса - какие запчасти необходимы
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
company_nickstringнетник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо
phone_code_countrystringдакод страны
phone_code_city stringдакод города
phonestringдателефон
client_code_regionstringдавыбранный вами регион - числовое значение региона определите с помощью метода GetRegions
notify_smsstringдаоповещение по смс - 0 - не оповещать, 1 - оповещать
api_keystringданужно попросить у нас
teststringда1 (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - 0 (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeVinRequest?login={login}&password={password}&vin_code=VSKJVWR51U0262363&car_brand=NISSAN&car_model=PATHFINDER&car_year=2007&engine=TD 27T&modification=&request_text=тормозные колодки&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick=&phone_code_country=8&phone_code_city=000&phone=111-11-11&client_code_region=30100&notify_sms=1&api_key={api_key}&test=1

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "vin_code=VSKJVWR51U0262363" --data-urlencode "car_brand=NISSAN" --data-urlencode "car_model=PATHFINDER" --data-urlencode "car_year=2007" --data-urlencode "engine=TD 27T" --data-urlencode "modification=" --data-urlencode "request_text=тормозные колодки" --data-urlencode "name_first=Имя"--data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick=" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "client_code_region=30100" --data-urlencode "notify_sms=1" --data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeVinRequest

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



Метод "VIN запрос" (MakeVinRequestV2)

MakeVinRequestV2
https://www.zzap.ru/webservice/datasharing.asmx/MakeVinRequest

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
vin_codestringдаVIN-код авто
car_brandstringдамарка авто
car_modelstringдамодель авто
car_yearstringдагод выпуска
enginestringнетдвигатель
modificationstringнетмодификация
request_textstringдаописание запроса - какие запчасти необходимы
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
company_nickstringнетник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо
phone_code_countrystringдакод страны
phone_code_city stringдакод города
phonestringдателефон
client_code_regionstringдавыбранный вами регион - числовое значение региона определите с помощью метода GetRegions
notify_smsstringдаоповещение по смс: false - не оповещать, true - оповещать
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/MakeVinRequest?login={login}&password={password}&vin_code=VSKJVWR51U0262363&car_brand=NISSAN&car_model=PATHFINDER&car_year=2007&engine=TD 27T&modification={modification}&request_text=тормозные колодки&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick={company_nick}&phone_code_country=8&phone_code_city=000&phone=111-11-11&client_code_region=30100&notify_sms=true&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "vin_code=VSKJVWR51U0262363" --data-urlencode "car_brand=NISSAN" --data-urlencode "car_model=PATHFINDER" --data-urlencode "car_year=2007" --data-urlencode "engine=TD 27T" --data-urlencode "modification={modification}" --data-urlencode "request_text=тормозные колодки" --data-urlencode "name_first=Имя"--data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick={company_nick}" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "client_code_region=30100" --data-urlencode "notify_sms=true" --data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeVinRequest

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



Метод "мои VIN запросы" (GetMyVinRequests)

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

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

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


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

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


GetVinRequestItem:

ПараметрТипОбязательныйОписание
code_orderintданомер vin-запроса - это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
create_dateDateTimeдавремя создания vin-запроса
client_namestringдаФИО покупателя
client_regionstringдарегион покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
notify_smsboolдаfalse - не оповещать по смс, true - оповещать по смс
vin_numberstringдаvin-номер автомобиля
class_manstringдамарка автомобиля
class_car_typestringдамодель автомобиля
submodelstringдамодификация (если было заполнено)
engine_typestringдадвигатель
man_datestringдагод выпуска автомобиля
vin_infostringдамодельный год, завод, страна и т.д. (если было заполнено)
imagepathstringдассылка на фото (если было прикреплено)
commentstringдакомментарий покупателя к vin-запросу
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"code_order": 3807443, // номер vin-запроса - это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
"create_date": "2013-09-02T11:07:45.050", // время создания vin-запроса
"client_name": "Фамилия Имя", // ФИО покупателя
"client_region": "Сыктывкар и Коми респ.", // регион покупателя
"client_email": "email@mail.ru", // e-mail покупателя
"client_phone": "8(000)111-11-11", // телефон покупателя
"notify_sms": false, // false - не оповещать по смс, true - оповещать по смс
"vin_number": "AA1AAAA11A1111111", // vin-номер автомобиля
"class_man": "OPEL", // марка автомобиля
"class_car_type": "VECTRA", // модель автомобиля
"submodel": "C18NZ", // модификация (если было заполнено)
"engine_type": "1.8", // двигатель
"man_date": "1992", // год выпуска автомобиля
"vin_info": "...", // модельный год, завод, страна и т.д. (если было заполнено)
"imagepath": "", // ссылка на фото (если было прикреплено)
"comment": "шаровая опора левая, амортизаторы задние, ремень генератора", // комментарий покупателя к vin-запросу
"responses": "3" // количество ответов на vin-запросов от разных продавцов
}
{
...
}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе GetMyVinRequestReplies



Метод "ответы на мои VIN запросы" (GetMyVinRequestReplies)

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

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

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


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

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


GetVinRequestReplyItem:

ПараметрТипОбязательныйОписание
code_orderintданомер vin-запроса
response_dateDateTimeдавремя получения ответа на vin-запрос
seller_namestringданазвание ответившего продавца
seller_phonestringдателефон продавца
seller_regionstringдарегион продавца
seller_citystringдагород продавца
seller_metrostringдаметро продавца, если указано
responsestringдаответ по vin-запросу
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
seller_rating_countintдаколичество отзывов продавца текстом
seller_ratingintдарейтинг продавца
seller_addressstringдаполный адрес продавца
seller_phone2stringдаещё один телефон продавца


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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyVinRequestReplies

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"code_order": 3930751, // номер vin-запроса
"response_date ": "2013-10-20 16:42:53.783", // время получения ответа на vin-запрос
"seller_name": "Компания", // название ответившего продавец
"seller_phone": "8(000)222-22-22", // телефон продавца
"seller_region": "Сыктывкар и Коми респ.", // регион продавца
"seller_city": "Ижма", // город
"seller_metro": "", // метро, если указано
"response": "...", // ответ по vin-запросу
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"seller_rating_count": "33 отзыва", // количество отзывов продавца
"seller_rating": 4, // рейтинг продавца
"seller_address": "Россия, Москва, пр-д. 4-й Рощинский проезд 19, м. Тульская", // полный адрес продавца
"seller_phone2": "8(000)111-11-11" // ещё один телефон продавца
}
{
...
}
]


Для продавцов


Заказы продавца

Метод "заказы продавца" (GetSellerOrders)

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

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

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


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдалоготип производителя
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepathstringдаизображение/фото запчасти
qty_orderstringдакол-во заказанных позиций
qtystringда"В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
min_sum_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
applyV2stringдаусловия продажи
client_namestringдаФИО покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
client_code_regionintдакод региона покупателя
client_id_hashstringдахэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
seller_namestringдапродавец
responsestringдаответ на заказ от продавца
client_rating_countstringдаколичество отзывов покупателя текстом
client_ratingintдарейтинг покупателя
user_keystringда"ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
code_templateintдакод шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
price_namestringданазвание прайс-листа с заказанной позицией


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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "row_count=3" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrders

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"code_order": 3930751, // номер заказа
"create_date": "2015-04-01T19:56:36.350", // время создания заказа
"class_man": "HEPU", // производитель заказанной запчасти
"logopath": "", // логотип производителя
"partnumber": "P049", // номер заказанной запчасти
"comment": "", // комментарий к заказу от покупателя
"class_cat": "ПОМПА", // наименование запчасти
"imagepath":"" // изображение/фото запчасти
"qty_order": "1", // кол-во заказанных позиций
"qty": "6 шт. ", // "В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа
"descr_qty": "3-5 р.д.", // срок поставки (дополнение к информации о количестве)
"min_sum_order": 1000.00, // минимальная сумма заказа
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"price_orig": 1000.00, // цена числом (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"applyV2": "скидка постоянным клиентам", // условия продажи
"client_name": "Фамилия Имя", // ФИО покупателя
"client_email": "email@mail.ru", // e-mail покупателя
"client_phone": "8(000)111-11-11", // телефон покупателя
"client_code_region": "30100", // код региона покупателя
"client_id_hash": "...", // хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
"seller_name": "Компания", // продавец
"response": "Помпа в наличии - приезжайте!" // ответ на заказ от продавца
"client_rating_count": "33 отзыва", // количество отзывов покупателя
"client_rating": 4, // рейтинг покупателя
"user_key": "?????????????????", // "ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
"usedV2": false // тип предложения: false - обычное, true - б/у и уценка
"code_template": 111111 // код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
"price_name": "Price.xls" // название прайс-листа с заказанной позицией
}
{
...
}
]
}

Важно!

При вызове GetSellerOrders и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Примечание:
метод GetSellerOrders выдаёт заказы от покупателей, созданные не ранее 3 месяцев назад от текущей даты



Метод "подтверждение продавцом получения заказа" (SetOrderStatus)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии - приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "response=Помпа в наличии - приезжайте!" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus

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

Важно!
При вызове SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.


Отправка заказа от покупателя на сайт продавца



Более подробно можно почитать здесь:
Отправка заказа от покупателя на сайт продавца


VIN запросы продавца

Метод "VIN запросы продавца" (GetSellerVinRequests)

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

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

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


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

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


GetSellerVinRequestsData:

ПараметрТипОбязательныйОписание
code_orderintданомер vin-запроса - это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
create_dateDateTimeдавремя создания vin-запроса
client_namestringдаФИО покупателя
client_regionstringдарегион покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
notify_smsboolдаfalse - не оповещать по смс, true - оповещать по смс
vin_numberstringдаvin-номер автомобиля
class_manstringдамарка автомобиля
class_car_typestringдамодель автомобиля
submodelstringдамодификация (если было заполнено)
engine_typestringдадвигатель
man_datestringдагод выпуска автомобиля
vin_infostringдамодельный год, завод, страна и т.д. (если было заполнено)
imagepathstringдассылка на фото (если было прикреплено)
commentstringнеткомментарий покупателя к vin-запросу
responsestringдаответ продавца на vin-запрос
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"code_order": 3807443, // номер vin-запроса - это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
"create_date": "2013-09-02T11:07:45.050", // время создания vin-запроса
"client_name": "Фамилия Имя", // ФИО покупателя
"client_region": "Сыктывкар и Коми респ.", // регион покупателя
"client_email": "email@mail.ru", // e-mail покупателя
"client_phone": "8(000)111-11-11", // телефон покупателя
"notify_sms": false, // false - не оповещать по смс, true - оповещать по смс
"vin_number": "AA1AAAA11A1111111", // vin-номер автомобиля
"class_man": "OPEL", // марка автомобиля
"class_car_type" : "VECTRA", // модель автомобиля
"submodel": "C18NZ", // модификация (если было заполнено)
"engine_type": "1.8", // двигатель
"man_date": "1992", // год выпуска автомобиля
"vin_info": "...", // модельный год, завод, страна и т.д. (если было заполнено)
"imagepath": "", // ссылка на фото (если было прикреплено)
"comment": "шаровая опора левая, амортизаторы задние, ремень генератора", // комментарий покупателя к vin-запросу
"response": "Уважаемый (покупатель)! По вашему запросу (номер) отвечаем: всё в наличии! приезжайте! (информация о продавце)" // ответ продавца на vin-запрос
"responses": "3" // количество ответов на vin-запросов от разных продавцов
}
{
...
}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе SetVinRequestStatus
Примечание:
метод GetSellerVinRequests выдаёт vin-запросы от покупателей, созданные не ранее месяца назад от текущей даты



Метод "подтверждение продавцом получения VIN запроса" (SetVinRequestStatus)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии - приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "response=Помпа в наличии - приезжайте!" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus

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


Статистика продавца

Метод "моя статистика" (GetMyStatCustomers)

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

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

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


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

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


GetMyStatCustomersListItem:

ПараметрТипОбязательныйОписание
stat_dateDateTimeдадата статистики
descr_type_statstringдатип статистики
counterintдаколичество совершения соответствующего действия (перехода по ссылке, например)


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

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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 495, // сколько строк вернулось
"table": [ {
"stat_date": "2015-07-01T00:00:00" // дата статистики
"descr_type_stat": "Переходы по ссылке" // тип статистики
"counter": 25 // количество совершения соответствующего действия (перехода по ссылке, например)
}
{
...
}
]
}

Примечание:
Дата всегда указана в виде первого числа месяца и времени 00:00:00, т.е., данные представлены за соответствующий месяц
Пример: "stat_date":"2015-07-01T00:00:00", "descr_type_stat":"Переходы по ссылке", "counter":25 значит, что переходов по ссылке за июль 2015 года было 25


Общие методы

Метод "восстановление пароля" (RequestPasswordRecover)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


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

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

Ответ
{
"error": "", // если пусто, ошибок нет и отправлено письмо клиенту на почту = login с инструкциями по восстановлению пароля
}


Избранные позиции

Метод "добавление позиции в избранные" (AddFavoriteSearch)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет
code_favintдавнутренний уникальный код добавленной избранной позиции


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/AddFavoriteSearch?login={login}&password={password}&code_cat=115835062&partnumber=MR245368&class_man=Mitsubishi&class_cat=Мотор омывателя&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_cat=115835062" --data-urlencode "partnumber=MR245368" --data-urlencode "pclass_man=" --data-urlencode "class_cat=КОЛОДКИ ПЕРЕД Е90 318--data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/AddFavoriteSearch

Ответ
{
"error": "" // если пусто, ошибок нет
"code_fav": 200000015 // внутренний уникальный код добавленной избранной позиции
}



Метод "удаление позиции из избранных" (DeleteFavoriteSearch)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_fav=300013116" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/DeleteFavoriteSearch

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



Метод "мои избранные позиции" (GetMyFavoritesSearch)

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

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

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


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

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


GetMyFavoritesSearchItem:

ПараметрТипОбязательныйОписание
code_favintдавнутренний уникальный код избранной позиции
class_manstringдапроизводитель
logopathstringдалоготип производителя
partnumberstringданомер
class_catstringданаименование
imagepathstringдаизображение/фото запчасти
code_catintдавнутренний уникальный код позиции


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

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

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 5, // сколько строк вернулось
"table":
[
{
"code_fav": 200000004, // внутренний уникальный код избранной позиции
"class_man": "BMW", // производитель
"logopath": "", // логотип производителя
"partnumber": "34116769951", // номер
"class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование
"imagepath": "" // изображение/фото запчасти
"code_cat": 115835062, // внутренний уникальный код позиции
},
{
...
}
]
}


Сообщения

Метод "мои собеседники" (GetMyMessagesThreads) устарел, не использовать!

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

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

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


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

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


GetMessagesThreadItem:

ПараметрТипОбязательныйОписание
user_namestringдаФИО (или название компании) собеседника
unread_countintдаколичество непрочитанных сообщений
user_keystringда"ключ" собеседника, с помощью которого Вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages), а также можете посмотреть информацию о продавце/покупателе (метод GetUserInfo)
message_last_dateDateTimeдадата последнего сообщения с этим собеседником
message_laststringдатекст последнего сообщения с этим собеседником
read_onlyboolдаможно ли этому собеседнику отсылать сообщения: false - можно, true - нельзя


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

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

Ответ (данные условны)
{
"error": "" // если пусто, ошибок нет
"row_count": 5, // сколько строк вернулось
"table":
[
{
"user_name": "фамилия имя", // ФИО (или название компании) собеседника
"unread_count": 9, // количесто непрочитанных сообщений
"user_key": "?????????????????", // "ключ" собеседника, с помощью которого Вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages), а также можете посмотреть информацию о продавце/покупателе (метод GetUserInfo)
"message_last_date": "2017-06-30T16:17:24", // дата последнего сообщения с этим собеседником
"message_last": "Текст последнего сообщения с этим собеседником"
"read_only": false, // можно ли этому собеседнику отсылать сообщения: false - можно, true - нельзя
},
{
...
}
]
}



Метод "мои собеседники" (GetMyMessagesThreadsV2)

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

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

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


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

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


GetMessagesThreadItem:

ПараметрТипОбязательныйОписание
user_namestringдаФИО (или название компании) собеседника
unread_countstringдаколичество непрочитанных сообщений
user_keystringда"ключ" собеседника, с помощью которого вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages),
message_last_dateDateTimeдадата последнего сообщения с этим собеседником
message_laststringдатекст последнего сообщения с этим собеседником
read_onlyboolдаможно ли этому собеседнику отсылать сообщения: false - можно, true - нельзя


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

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

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 5, // сколько строк вернулось
"table":
[
{
"user_name": "фамилия имя", // ФИО (или название компании) собеседника
"unread_count": 9, // количество непрочитанных сообщений
"user_key": "?????????????????", // "ключ" собеседника, с помощью которого Вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages), а также можете посмотреть информацию о продавце/покупателе (метод GetUserInfo)
"message_last_date": "2017-06-30T16:17:24", // дата последнего сообщения с этим собеседником
"message_last": "Текст последнего сообщения с этим собеседником"
"read_only": false, // можно ли этому собеседнику отсылать сообщения: false - можно, true - нельзя
},
{
...
}
]
}



Метод "мои сообщения" (GetMyMessages) устарел, не использовать!

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

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

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


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


GetMessageItem:

ПараметрТипОбязательныйОписание
user_keystringда"ключ" отправителя сообщения
user_namestringдаФИО (или название компании) отправителя сообщения
message_dateDateTimeдадата сообщения
messagestringда"Текст сообщения"
unreadboolдаfalse - прочитано получателем, true - не прочитано получателем


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

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

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"table":
[
{
"user_key": "?????????????????", // "ключ" отправителя сообщения
"user_name": "фамилия имя", // ФИО (или название компании) отправителя сообщения
"message_date": "2017-06-30T16:17:24", // дата сообщения
"message": "Текст сообщения"
"unread": true, // false - прочитано получателем, true - не прочитано получателем
},
{
...
}
]
}



Метод "мои сообщения" (GetMyMessagesV2)

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

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

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


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

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


GetMessageItem:

ПараметрТипОбязательныйОписание
user_keystringда"ключ" отправителя сообщения
user_namestringдаФИО (или название компании) отправителя сообщения
message_dateDateTimeдадата сообщения
messagestringда"Текст сообщения"
unreadboolдаfalse - прочитано получателем, true - не прочитано получателем


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

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "login_info=" --data-urlencode "row_count=50" --data-urlencode "user_key={user_key}" --data-urlencode "code_object=" --data-urlencode "type_object=" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesV2

Ответ
{
"error": "" // если пусто, ошибок нет
"row_count": 100, // сколько строк вернулось
"table":
[
{
"user_key": "?????????????????", // "ключ" отправителя сообщения
"user_name": "фамилия имя", // ФИО (или название компании) отправителя сообщения
"message_date": "2017-06-30T16:17:24", // дата сообщения
"message": "Текст сообщения"
"unread": true, // false - прочитано получателем, true - не прочитано получателем
},
{
...
}
]
}



Метод "отправка сообщения" (SendMessage) устарел, не использовать!

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
login_infostringдадля внутренних целей, передавать пустое значение
user_keystringда"ключ" собеседника, полученный в методе GetMyMessagesThreads (или в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies)
messagestringдатекст сообщения
message_datestringнетдата сообщения (по умолчанию текущая дата)
isonlinestringдаfalse - собеседник офлайн, true - собеседник онлайн
api_keystringданужно попросить у нас


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SendMessage?login={login}&password={password}&login_info=&user_key={user_key}&message=Текст сообщения&message_date=2017-06-30T16:17:24&isonline=false&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "login_info=" --data-urlencode "user_key={user_key}" --data-urlencode "message=Текст сообщения" --data-urlencode "message_date=2017-06-30T16:17:24" --data-urlencode "isonline=false" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SendMessage

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



Метод "отправка сообщения" (SendMessageV2)

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
login_infostringдадля внутренних целей, передавать пустое значение
user_keystringда"ключ" собеседника, полученный в методе GetMyMessagesThreads (или в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies)
messagestringдатекст сообщения
message_datestringнетдата сообщения (по умолчанию текущая дата)
isonlinestringдаfalse - собеседник офлайн, true - собеседник онлайн
code_objectstringдадля внутренних целей, передавать пустое значение
type_objectstringдадля внутренних целей, передавать пустое значение
api_keystringданужно попросить у нас


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SendMessageV2?login={login}&password={password}&login_info=&user_key={user_key}&message=Текст сообщения&message_date=2017-06-30T16:17:24&isonline=false&code_object=&type_object=&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "login_info=" --data-urlencode "user_key={user_key}" --data-urlencode "message=Текст сообщения" --data-urlencode "message_date=2017-06-30T16:17:24" --data-urlencode "isonline=false" --data-urlencode "code_object=" --data-urlencode "type_object=" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SendMessageV2

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


Сообщение об ошибке

Метод "отправка сообщения об ошибке" (SendAppErrorMessage)

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

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

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


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

ПараметрТипОбязательныйОписание
errorstringдаесли пусто, ошибок нет


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SendAppErrorMessage?login={login}&password={password}&subject=тема сообщения&message=сообщение о проблеме&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "subject=тема сообщения" --data-urlencode "message=сообщение о проблеме" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SendAppErrorMessage

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