Войдите в свою учётную запись с логином и временным паролем для mail.zzap.pro
Логин для входа в учётную записьВременный пароль для входа в учётную запись
Смените временный пароль на постоянный, для этого в верхней строке введите ваш временный пароль, а в строках ниже постоянный (запрос на замену временного пароля на постоянный, иногда происходит не сразу, а при следующем входе)
Смена на постоянный пароль для входа в учётную запись
для Honor, Huawei нужно использовать альтернативный Authenticator. Нажмите на строку «Я хочу использовать другое приложение для проверки подлинности», чтобы перейти к настройке альтернативного приложения Authenticator
У некоторый пользователей и менеджеров ZZap при работе с сайтом иногда возникает "белый экран". Если при этом открыть консоль браузера (нажав F12), то в консоли можно увидеть ошибку: ERR_QUIC_PROTOCOL_ERROR.
Данная ошибка связана с новой экспериментальной функцией в браузере Chrome.
Что делать?
Первый вариант действий, если вы в первый раз столкнулись с этой ситуацией: попробуйте несколько раз обновить страницу, нажав клавишу F5 или сочетание клавиш Ctrl+F5. Обычно это помогает.
Второй вариант, если обновление страницы не помогает или проблема повторяется:
Откройте новую вкладку в браузере
Вставьте в адресную строку chrome://flags, нажмите Enter
В открывшемся списке найдите строку Experimental QUIC protocol и выберете пункт Disabled, как на скриншоте ниже:
Аналогично GetSearchSuggest, но с дополнительным параметром type_request, login и password GetSearchSuggestV3 https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр
Тип
Обязательный
Описание
login
string
нет
e-mail, указанный при регистрации (может быть пустым)
password
string
нет
ваш пароль от аккаунта на сайте ZZap (может быть пустым)
search_text
string
да
произвольная строка поиска
row_count
string
да
сколько максимально записей возвращать
type_request
string
да
тип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам)
api_key
string
да
нужно попросить у нас
Выходные параметры:
Параметр
Тип
Обязательный
Описание
error
string
да
если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса.
row_count
int
да
сколько строк вернулось
terms
string
да
поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
table
Массив GetSearchSuggestItem[]
да
массив данных
GetSearchSuggestItem:
Параметр
Тип
Обязательный
Описание
class_man
string
да
производитель
logopath
string
да
ссылка на превью логотипа производителя 30px на 30px
массив ссылок на превью фото запчасти 60px на 60px****
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3?login={login}&password={password}&search_text=Колодки BMW&row_count=3&type_request=0&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=колодки BMW" --data-urlencode "row_count=3" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchSuggestV3
Ответ { "error": "" // если пусто, ошибок нет "row_count": 50, // сколько строк вернулось "terms": "колодок;колодку;колодкою;колодкой;колодке;колодках;колодками;колодкам;колодка;колодки;колодки", "table": [ { "class_man": "BMW", // производитель "logopath": "https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "34116769951", // номер "class_cat": "КОЛОДКИ ПЕРЕД Е90 318", // наименование "code_cat": 115835062, // внутренний уникальный код позиции "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] , // массив ссылок на превью фото запчасти 60px на 60px "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) }, { ... } ] }
МЕТОД "РЕЗУЛЬТАТ ПОИСКА" (GETSEARCHRESULTV3)
Аналогично GetSearchResult, но с дополнительными параметрами search_text и type_request GetSearchResultV3 https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр
Тип
Обязательный
Описание
login
string
нет
e-mail, указанный при регистрации (может быть пустым)
password
string
нет
ваш пароль от аккаунта на сайте ZZap (может быть пустым)
code_region
string
да
code_region из метода GetRegions
search_text
string
да
произвольная строка поиска
partnumber
string
да
номер запчасти
class_man
string
да
производитель запчасти
row_count
string
да
ограничение по кол-ву строк. по умолчанию 100, максимум 500
type_request
string
да
тип поискового запроса: 0 - поиск любых запчастей по номеру, 1 - поиск только новых запчастей по номеру, 2 - поиск по б/у и уценке (по введённым в поисковую строку словам)
api_key
string
да
нужно попросить у нас
Выходные параметры:
Параметр
Тип
Обязательный
Описание
error
string
да
если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса.
row_count
int
да
сколько строк вернулось
terms
strings
да
"колодок;колодку;колодкою; колодкой; колодке;колодках;колодками; колодкам; колодка;колодки;колодки" поле terms нужно для того, чтобы выделять жёлтым цветом, что найдено, т.к. сервер может искать с учетом склонений.
class_man
string
да
производитель запрашиваемой запчасти
logopath
string
да
ссылка на превью логотипа производителя 30px на 30px запрашиваемой запчасти
partnumber
string
да
номер запрашиваемой запчасти
class_cat
string
да
наименование запрашиваемой запчасти
imagepath
string
да
ссылка на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
imagepathV2
string[]
да
массив ссылок на превью фото запчасти 60px на 60px**** запрашиваемой запчасти
code_cat
int
да
внутренний уникальный код позиции запрашиваемой запчасти
class_cur
string
да
валюта (например, белорусские рубли) запрашиваемой запчасти
price_count_instock
int
да
количество предложений в наличии запрашиваемой запчасти
price_min_instock
decimal
да
минимальная цена среди предложений в наличии запрашиваемой запчасти
price_avg_instock
decimal
да
средняя цена среди предложений в наличии запрашиваемой запчасти
price_max_instock
decimal
да
максимальная цена среди предложений в наличии запрашиваемой запчасти
price_count_order
int
да
количество предложений под заказ запрашиваемой запчасти
price_min_order
decimal
да
минимальная цена среди предложений под заказ запрашиваемой запчасти
price_avg_order
decimal
да
средняя цена среди предложений под заказ запрашиваемой запчасти
price_max_order
decimal
да
максимальная цена среди предложений под заказ запрашиваемой запчасти
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) запрашиваемой запчасти
table
Массив GetSearchResultItem[]
да
Массив данных
GetSearchResultItem:
Параметр
Тип
Обязательный
Описание
code_doc_b
long
да
внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
code_cat
int
да
внутренний уникальный код позиции
descr_type_search
string
да
тип предложения
class_man
string
да
производитель
logopath
string
да
ссылка на превью логотипа производителя 30px на 30px
массив ссылок на превью фото запчасти 60px на 60px****
qty
string
да
кол-во, текст!
apply
string
да
условия продажи, если указаны продавцом
min_sum_order
decimal
да
минимальная сумма заказа, если указана продавцом
descr_min_sum_order
string
да
минимальная сумма заказа текстом, если указана продавцом
shipment
string
да
условия доставки
courier
bool
да
доставка курьером: если true - есть, если false - нет
instockV2
bool
да
наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2
bool
да
тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2
bool
да
если true, то предложение локальное, если false, то из другого региона
priceV2
decimal
да
цена (в той валюте, в которой смотрел покупатель)
price_date
DateTime
да
дата публикации
descr_priceV2
string
да
цена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_orig
decimal
да
цена (в той валюте, в которой публиковал продавец)
descr_price_orig
string
да
цена текстом (в той валюте, в которой публиковал продавец)
descr_type_price
string
да
отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qty
string
да
подпись под кол-вом
class_user
string
да
наименование продавца
descr_rating_count
string
да
сколько отзывов текстом
rating
int
да
рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_address
string
да
местоположение
phone1
string
да
телефон
order_text
string
да
три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
user_key
string
да
"ключ" продавца, с помощью которого вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
addr_map_geo1
double
да
широта (координаты местонахождения продавца)
addr_map_geo2
double
да
долгота (координаты местонахождения продавца)
type_search
int
да
10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценка,
usedV2
bool
да
тип предложения: false – обычное предложение, true – б/у и уценка
qtyV2
int
да
количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_max
int
да
максимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2
string
да
количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_days
int
да
количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_delivery
string
да
срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorig
bool
да
если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
location
string
да
город и метро продавца
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3?login={login}&password={password}&search_text=Колодки Nissan&partnumber=MR245368&class_man=MITSUBISHI&code_region=11135&row_count=100&type_request=0&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "search_text=Колодки Nissan" --data-urlencode "partnumber=MR245368" --data-urlencode "class_man=MITSUBISHI" --data-urlencode "code_region=11135" --data-urlencode "row_count=100" --data-urlencode "type_request=0" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultV3
Ответ { "error":"", // если пусто, ошибок нет "row_count": 100, // сколько строк вернулось
"class_man": "MITSUBISHI", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "MR245368", // номер "class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "code_cat": 1116901944 // внутренний уникальный код позиции "class_cur": "б.р.", // валюта (например, белорусские рубли) "price_count_instock": 13 // количество предложений в наличии "price_min_instock": 56.35, // минимальная цена среди предложений в наличии "price_avg_instock": 64.56, // средняя цена среди предложений в наличии "price_max_instock": 75.16, // максимальная цена среди предложений в наличии "price_count_order": 147 // количество предложений под заказ "price_min_order": 56.35, // минимальная цена среди предложений под заказ "price_avg_order": 66.06, // средняя цена среди предложений под заказ "price_max_order": 92.42, // максимальная цена среди предложений под заказ "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) "table": [ { "code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne) "code_cat": 1116901944 // внутренний уникальный код позиции "descr_type_search": "Запрошенный номер (специальные предложения)", // тип предложения "class_man": "Mitsubishi", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "MR245368", // номер "class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "qty": "10 шт. ", // кол-во, текст! "apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом "min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом "descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом "shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки "courier": true, // доставка курьером: если true - есть, если false - нет "instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом "wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой) "localV2": true, // если true, то предложение локальное, если false, то из другого региона "priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель) "price_date":"2015-02-16T00:09:55" // дата публикации "descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель "price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец) "descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец) "descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // тип цены "descr_qty": "заказ 1 день", // подпись под кол-вом "class_user": "Repart", // наименование продавца "descr_rating_count": "5 отзывов", // сколько отзывов "rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд "descr_address": "Москва, м. Юго-Западная", // местоположение "phone1": "8(926)103-45-33", // телефон "order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) "user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) "addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца) "addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца) "type_search": 10, // 10 - Запрошенный номер (cпец. предложения), 13 - Запрошенный номер, 21- Замены (cпец. предложения), 31 - Замены, 50 - Запрошенный номер (недостоверные предложения), 34 - Деталь, как составляющие, 54 - Детали, как составляющие (недостоверные предложения), 14 - Запрошенный номер б/у и уценка, 15 - Результат поиска по б/у и уценке "usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка "qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») "qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца "descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» "delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) "descr_delivery": "7-15 дней", // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») "type_user": "UBNAIRWPYTOGM234", // тип пользователя "type_user2": "GCKMNZ", // тип пользователя 2 "type_price": "RMP", // тип прайс-листа "descr_price_date":"Сегодня 13ч. назад" // текстовое описание давности обновления прайс-листа "pack": 4, // кратность (упаковка) числом "descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом "type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений "noorig": false, // неоригинальность (true/false) "code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) "location": ""Москва, м. Юго-Западная" // город и метро продавца } { ... } ] }
МЕТОД "ОДНО ПРЕДЛОЖЕНИЕ" (GETSEARCHRESULTONE) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!
массив ссылок на превью фото запчасти 60px на 60px****
qty
string
да
кол-во, текст!
apply
string
да
условия продажи, если указаны продавцом
min_sum_order
decimal
да
минимальная сумма заказа, если указана продавцом
descr_min_sum_order
string
да
минимальная сумма заказа текстом, если указана продавцом
shipment
string
да
условия доставк
courier
bool
да
доставка курьером: если true - есть, если false - нет
instockV2
bool
да
наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2
bool
да
тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2
bool
да
если true, то предложение локальное, если false, то из другого региона
priceV2
decimal
да
цена (в той валюте, в которой смотрел покупатель)
priceV3
decimal
да
цена в рублях
price_date
DateTime
да
дата публикации
descr_priceV2
string
да
цена текстом с коротким обозначением валюты, в которой смотрел покупатель
descr_priceV3
string
да
цена в рублях
price_orig
decimal
да
цена (в той валюте, в которой публиковал продавец)
descr_price_orig
string
да
цена текстом (в той валюте, в которой публиковал продавец)
descr_type_price
string
да
отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qty
string
да
подпись под кол-вом
class_user
string
да
наименование продавца
descr_rating_count
string
да
сколько отзывов текстом
rating
int
да
рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_address
string
да
местоположение
phone1
string
да
телефон 1
phone2
string
да
телефон 2
comment
string
да
часы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
commentV2
string
да
краткая информация о продавце
info
string
да
когда началось сотрудничество с ZZap
order_text
string
да
три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
addr_map_geo1
double
да
широта (координаты местонахождения продавца)
addr_map_geo2
double
да
долгота (координаты местонахождения продавца)
user_key
string
да
"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
usedV2
bool
да
тип предложения: false – обычное предложение, true – б/у и уценка
accept_messages
bool
да
готов ли продавец переписываться с покупателями: true - готов, false - не готов
qtyV2
int
да
количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_max
int
да
максимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2
string
да
количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_days
int
да
количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_delivery
string
да
срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorig
bool
да
если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOne?login={login}&password={password}&code_doc_b=208098711507246&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOne
Ответ { "error": "", // если пусто, ошибок нет "code_doc_b": 208098711507246, // внутренний уникальный код предложения "code_cat": 1116901944 // внутренний уникальный код позиции "class_man": "Mitsubishi", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "MR245368", // номер "class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "qty": "10 шт. ", // кол-во, текст! "apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом "min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом "descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом "shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки "courier": true, // доставка курьером: если true - есть, если false - нет "instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом "wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой "localV2": true, // если true, то предложение локальное, если false, то из другого региона "priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель) "priceV3": 1000.00, // цена в рублях "price_date":"2015-02-16T00:09:55" // дата публикации "descr_priceV2": "1000р." // цена текстом (в той валюте, в которой смотрел покупатель) "descr_priceV3": "1000р." // цена текстом в рублях "price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец) "descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец) "descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены "descr_qty": "заказ 1 день", // подпись под кол-вом "class_user": "Repart", // наименование продавца "descr_rating_count": "5 отзывов", // сколько отзывов "rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд "descr_address": "Москва, м. Юго-Западная", // местоположение "phone1": "8(926)103-45-33", // телефон 1 "phone2": "8(926)103-45-34", // телефон 2 "comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается) "commentV2": "Возможна доставка оптовым покупателям", // краткая информация о продавце (существующее поле comment содержит сочетание двух полей - времени работы компании и краткой информации о продавце) "info": "Публикуется в ZZap с 20-08-12", // когда началось сотрудничество с ZZap "order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) "addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца) "addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца) "user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) "usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка "accept_messages": true, // хочет ли продавец принимать сообщения "qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») "qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца "descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» "delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) "descr_delivery": "7-15 дней" // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») "work_time: "пн.-пт. с 10 до 20, сб. с 10 до 18, вс. выходной", // время работы продавца "type_user": "UBNAIRWPYTOGM234", // тип пользователя "type_user2": "GCKMN", // тип пользователя 2 "type_price": "RMP", // тип прайс-листа "telegram": "89261234567", // номер в telegram "whatsapp": "89261234567", // номер в whatsapp "viber": "89261234567", // номер в viber "pack": 4, // кратность (упаковка) числом "descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом "type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений "noorig": false, // неоригинальность (true/false) "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) }
массив ссылок на превью фото запчасти 60px на 60px****
qty
string
да
кол-во, текст!
apply
string
да
условия продажи, если указаны продавцом
min_sum_order
decimal
да
минимальная сумма заказа, если указана продавцом
descr_min_sum_order
string
да
минимальная сумма заказа текстом, если указана продавцом
shipment
string
да
условия доставк
courier
bool
да
доставка курьером: если true - есть, если false - нет
instockV2
bool
да
наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом
wholesaleV2
bool
да
тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой
localV2
bool
да
если true, то предложение локальное, если false, то из другого региона
priceV2
decimal
да
цена (в той валюте, в которой смотрел покупатель)
priceV3
decimal
да
цена в рублях
price_date
DateTime
да
дата публикации
descr_priceV2
string
да
цена текстом с коротким обозначением валюты, в которой смотрел покупатель
descr_priceV3
string
да
цена в рублях
price_orig
decimal
да
цена (в той валюте, в которой публиковал продавец)
descr_price_orig
string
да
цена текстом (в той валюте, в которой публиковал продавец)
descr_type_price
string
да
отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_qty
string
да
подпись под кол-вом
class_user
string
да
наименование продавца
descr_rating_count
string
да
сколько отзывов текстом
rating
int
да
рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд
descr_address
string
да
местоположение
phone1
string
да
телефон 1
phone2
string
да
телефон 2
comment
string
да
часы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
commentV2
string
да
краткая информация о продавце
info
string
да
когда началось сотрудничество с ZZap
order_text
string
да
три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом)
addr_map_geo1
double
да
широта (координаты местонахождения продавца)
addr_map_geo2
double
да
долгота (координаты местонахождения продавца)
user_key
string
да
"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
usedV2
bool
да
тип предложения: false – обычное предложение, true – б/у и уценка
accept_messages
bool
да
готов ли продавец переписываться с покупателями: true - готов, false - не готов
qtyV2
int
да
количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_max
int
да
максимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2
string
да
количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_days
int
да
количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_delivery
string
да
срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений
noorig
bool
да
если true, значит, предложение помечено продавцом в прайс-листе или нашей системой при проверке во время публикации как неоригинальное
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
seller_addressV2
string
да
полный адрес продавца
seller_location
string
да
город и метро продавца
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2?login={login}&password={password}&code_doc_b=208098711507246&code_region=11135&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "code_region=11135" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultOneV2
Ответ { "error": "", // если пусто, ошибок нет "code_doc_b": 208098711507246, // внутренний уникальный код предложения "code_cat": 1116901944 // внутренний уникальный код позиции "class_man": "Mitsubishi", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "MR245368", // номер "class_cat": "МОТОР ОМЫВАТЕЛЯ ЛОБОВОГО СТЕКЛА LANCER03-", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "qty": "10 шт. ", // кол-во, текст! "apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом "min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом "descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом, если указана продавцом "shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки "courier": true, // доставка курьером: если true - есть, если false - нет "instockV2": true, // наличие на складе, если true, то надо зеленым подсвечивать квадратик с кол-вом "wholesaleV2": true, // тип цены, опт или розница, если true, то надо желтым подсвечивать квадратик с ценой "localV2": true, // если true, то предложение локальное, если false, то из другого региона "priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель) "priceV3": 1000.00, // цена в рублях "price_date":"2015-02-16T00:09:55" // дата публикации "descr_priceV2": "1000р." // цена текстом (в той валюте, в которой смотрел покупатель) "descr_priceV3": "1000р." // цена текстом в рублях "price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец) "descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец) "descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены "descr_qty": "заказ 1 день", // подпись под кол-вом "class_user": "Repart", // наименование продавца "descr_rating_count": "5 отзывов", // сколько отзывов "rating": 2, // рейтинг: если 0, ничего не показывать, если от 1 до 5, то показывать 5 звезд, заливая соотв. кол-во звезд "descr_address": "Москва, м. Полежаевская", // местоположение "phone1": "8(926)103-45-33", // телефон 1 "phone2": "8(926)103-45-34", // телефон 2 "comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается) "commentV2": "Возможна доставка оптовым покупателям", // краткая информация о продавце (существующее поле comment содержит сочетание двух полей - времени работы компании и краткой информации о продавце) "info": "Публикуется в ZZap с 20-08-12", // когда началось сотрудничество с ZZap "order_text": "Заказать", // три варианта: "Заказать" (можно оформить заказ у продавца через сайт ZZap), "Купить" (товар есть в наличии у данного продавца, можно совершить покупку в этот же день, оформить покупку можно на сайте ZZap) или "" (нет возможности заказать через сайт ZZap, необходимо связаться с продавцом) "addr_map_geo1": 55.5959324577887, // широта (координаты местонахождения продавца) "addr_map_geo2": 37.513069357681161, // долгота (координаты местонахождения продавца) "user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) "usedV2": true, // тип предложения: false – обычное предложение, true – б/у и уценка "accept_messages": true, // хочет ли продавец принимать сообщения "qtyV2": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») "qty_max": 50, // максимально допустимое количество для заказа по конкретному предложению продавца "descr_qtyV2": "15 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.» "delivery_days": 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) "descr_delivery": "7-15 дней" // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») "work_time: "пн.-пт. с 10 до 20, сб. с 10 до 18, вс. выходной", // время работы продавца "type_user": "UBNAIRWPYTOGM234", // тип пользователя "type_user2": "GCKMN", // тип пользователя 2 "type_price": "RMP", // тип прайс-листа "telegram": "89261234567", // номер в telegram "whatsapp": "89261234567", // номер в whatsapp "viber": "89261234567", // номер в viber "pack": 4, // кратность (упаковка) числом "descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом "type_chain_search": 0, // основные значения: 0 - запрашиваемые номера, 1 - замены, 3 - выбор производителя, 10 - номер не найден, 11 - нет предложений "noorig": false, // неоригинальность (true/false) "code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) "seller_addressV2": "Россия, Москва, Хорошевское шоссе 39", // полный адрес продавца "seller_location": "Москва, м. Полежаевская" // город и метро продавца }
МЕТОД "ИНФОРМАЦИЯ О ПОЗИЦИИ" (GETSEARCHRESULTINFO) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!
массив ссылок на превью фото запчасти 60px на 60px****
code_cat
int
да
внутренний уникальный код позиции
class_cur
string
да
валюта (например, белорусские рубли)
price_count_instock
int
да
количество предложений в наличии
price_min_instock
decimal
да
минимальная цена среди предложений в наличии
price_avg_instock
decimal
да
средняя цена среди предложений в наличии
price_max_instock
decimal
да
максимальная цена среди предложений в наличии
price_count_order
int
да
количество предложений под заказ
price_min_order
decimal
да
минимальная цена среди предложений под заказ
price_avg_order
decimal
да
средняя цена среди предложений под заказ
price_max_order
decimal
да
максимальная цена среди предложений под заказ
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfo?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI¤cy=5&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "partnumber=MR245368" --data-urlencode "currency=5" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfo
Ответ { "error": "", // если пусто, ошибок нет "class_man": "HEPU", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "P049", // номер "class_cat": "НАСОС ВОДЯНОЙ", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "code_cat": 1114507085 // внутренний уникальный код позиции "class_cur": "б.р.", // валюта (например, белорусские рубли) "price_count_instock": 13 // количество предложений в наличии "price_min_instock": 56.35, // минимальная цена среди предложений в наличии "price_avg_instock": 64.56, // средняя цена среди предложений в наличии "price_max_instock": 75.16, // максимальная цена среди предложений в наличии "price_count_order": 147 // количество предложений под заказ "price_min_order": 56.35, // минимальная цена среди предложений под заказ "price_avg_order": 66.06, // средняя цена среди предложений под заказ "price_max_order": 92.42, // максимальная цена среди предложений под заказ "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) }
В приведённом примере цены в белорусских рублях Для российских рублей действует округление цен до целого значения.
МЕТОД "ИНФОРМАЦИЯ О ПОЗИЦИИ" (GETSEARCHRESULTINFOV3)
массив ссылок на превью фото запчасти 60px на 60px****
code_cat
int
да
внутренний уникальный код позиции
class_cur
string
да
валюта (например, белорусские рубли)
price_count_instock
int
да
количество предложений в наличии
price_min_instock
decimal
да
минимальная цена среди предложений в наличии
price_avg_instock
decimal
да
средняя цена среди предложений в наличии
price_max_instock
decimal
да
максимальная цена среди предложений в наличии
price_count_order
int
да
количество предложений под заказ
price_min_order
decimal
да
минимальная цена среди предложений под заказ
price_avg_order
decimal
да
средняя цена среди предложений под заказ
price_max_order
decimal
да
максимальная цена среди предложений под заказ
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3?login={login}&password={password}&partnumber=MR245368&class_man=MITSUBISHI&code_cur=5&code_region=1&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "partnumber=MR245368" --data-urlencode "code_cur=5" --data-urlencode "code_region=1" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetSearchResultInfoV3
Ответ { "error": "", // если пусто, ошибок нет "class_man": "HEPU", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "P049", // номер "class_cat": "НАСОС ВОДЯНОЙ", // наименование "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] // массив ссылок на превью фото запчасти 60px на 60px "code_cat": 1114507085 // внутренний уникальный код позиции "class_cur": "б.р.", // валюта (например, белорусские рубли) "price_count_instock": 13 // количество предложений в наличии "price_min_instock": 56.35, // минимальная цена среди предложений в наличии "price_avg_instock": 64.56, // средняя цена среди предложений в наличии "price_max_instock": 75.16, // максимальная цена среди предложений в наличии "price_count_order": 147 // количество предложений под заказ "price_min_order": 56.35, // минимальная цена среди предложений под заказ "price_avg_order": 66.06, // средняя цена среди предложений под заказ "price_max_order": 92.42, // максимальная цена среди предложений под заказ "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) }
В приведённом примере цены в белорусских рублях Для российских рублей действует округление цен до целого значения.
МЕТОД "МОЯ ИСТОРИЯ ПОИСКА" (GETMYSEARCHHISTORY) УСТАРЕЛ, НЕ ИСПОЛЬЗОВАТЬ!
массив ссылок на превью фото запчасти 60px на 60px****
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistory?login={login}&password={password}&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistory
Ответ { "error": "", // если пусто, ошибок нет "row_count": 10, // сколько строк вернулось "table": [ { "create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00) "class_man": "HEPU", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "P049", // номер "class_cat": "Помпа", // наименование запчасти "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"] , // массив ссылок на превью фото запчасти 60px на 60px "code_man": 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) } { ... } ] }
массив ссылок на превью фото запчасти 60px на 60px****
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
code_cat
int
да
внутренний код позиции
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2?login={login}&password={password}&api_key={api_key}&call_data=
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "api_key={api_key}" --data-urlencode "call_data=" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetMySearchHistoryV2
Ответ { "error": "", // если пусто, ошибок нет "row_count": 10, // сколько строк вернулось "table": [ { "create_date": "2013-10-20T00:00:00", // дата поиска запчасти (информативна только дата, учитываем неповторяющиеся позиции за день, время всегда 00:00:00) "class_man": "HEPU", // производитель "logopath":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px "partnumber": "P049", // номер "class_cat": "Помпа", // наименование запчасти "imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" // ссылка на превью фото запчасти 60px на 60px "imagepathV2": ["https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p96e25867cd6841e1ad7529a01bd84cfc.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/pdf315e2533ee0f974b30d64997e3ef65.jpg","https://koj.blob.core.windows.net/zzap-upload/upload/priceimages/p0a353cc79dc420e54cf3e75091376f79.jpg"], // массив ссылок на превью фото запчасти 60px на 60px "code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) "code_cat": 353454213 // внутренний код позиции } { ... } ] }
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр
Тип
Обязательный
Описание
login
string
да
e-mail, указанный при регистрации (может быть пустым)
password
string
да
ваш пароль от аккаунта на сайте ZZap (может быть пустым)
filter
string
да
произвольная строка фильтрации, например tag_r='R20'
sort
string
да
сортировка по колонкам, например class_cat asc (asc и desc обязательны после каждого поля
code_region
string
да
code_region из метода GetRegions
row_count
string
да
сколько максимально записей возвращать
row_start
string
да
с каким сдвигом от нулевой строки возвращать записи
api_key
string
да
нужно попросить у нас
Выходные параметры:
Параметр
Тип
Обязательный
Описание
error
string
да
если пусто, ошибок нет содержит текст ошибки, если таковая возникла при выполнении запроса.
row_count
int
да
сколько строк вернулось
row_count_total
int
да
сколько всего строк в таблице без учета фильтрации
class_man_enum
string[]
да
массив из возможных значений поля class_man - производителей, использовать для фильтра.
tag_r_enum
string[]
да
массив из возможных значений поля tag_r - радиус, использовать для фильтра.
tag_m_enum
string[]
да
массив из возможных значений поля tag_m - ширина, использовать для фильтра.
tag_n_enum
string[]
да
массив из возможных значений поля tag_n - высота, использовать для фильтра.
tag_l_enum
string[]
да
массив из возможных значений поля tag_l - сезон, использовать для фильтра.
table
Массив GetCatalogTyresItem[]
да
массив данных
GetCatalogTyresItem:
Параметр
Тип
Обязательный
Описание
class_man
string
да
производитель
logopath
string
да
ссылка на превью логотипа производителя 30px на 30px
partnumber
string
да
номер производителя
class_cat
string
да
наименование
code_cat
int
да
внутренний уникальный код позиции
imagepath
string[]
да
массив ссылок на превью фото запчасти 60px на 60px****
code_man
int
да
внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
comment
string
да
описание позиции
price_min
decimal
да
минимальная цена
price_med
decimal
да
цена медиана
price_max
decimal
да
максимальная цена
price_count
int
да
кол-во предложений
tag_r
string
да
радиус
tag_m
string
да
ширина
tag_n
string
да
высота
tag_l
string
да
сезон
Пример вызова: Браузер https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres?login={login}&password={password}&code_region=1&row_count=3&api_key={api_key}
Windows через cmd.exe Chcp 65001 curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "filter=" --data-urlencode "code_region=1" --data-urlencode "row_count=3" --data-urlencode "row_start=" --data-urlencode "api_key={api_key}" -X POST https://api.zzap.pro/webservice/datasharing.asmx/GetCatalogTyres
Ответ { "error": "" // если пусто, ошибок нет "row_count": 3, // сколько строк вернулось "row_count_total":18975, "class_man_enum":["ACHILLES","ALTENZO","AMTEL"....], "tag_r_enum":["R12","R13","R14","R15","R16","R17","R17.5","R18","R19","R20","R21","R22","R22.5","R23","R24"], "tag_m_enum":["27\"","30\"","31\"","32\"","33\"","35\"","37\"","38\"","39\"","40\"","135","145","155","165","175","185",
*type_user 'K' - медаль "Официальный автодилер" '1' - медаль "Больше года на сайте" '2' - медаль "Больше 3х лет на сайте" '3' - медаль "Есть уставные документы" '4' - медаль "Есть фотографии магазина" '5' - международная отправка 'P' - Доставка товара курьером 'Y' - Отправка товара в регионы 'B' - Покупатель 'A' - Продавец 'I' - Интернет магазин 'S' - Автосервис/служба установки 'R' - Торговля в розницу 'W' - Торговля оптом 'F' - Частное лицо 'U' - Юридическое лицо
**type_user2 'Y' - Понизить до недостоверных 'K' - Принимаем к оплате банковские карты 'M' - Ручная проверка (снимает пометку Регистрация не подтверждена) 'I' - Неликвидный товар (клиент продаёт неликвид) 'W' - Шиномонтаж 'R' - Не хотят переписываться с покупателями 'Z' - Подтверждена гарантия наличия 'F' - Подтверждение наличия 'R' - Не переписываются с покупателями
***type_price 'R' - Прайс-лист для розницы 'W' - Прайс-лист для юр.лиц и ИП 'M' - Запретить загрузку прайса с сайта как файл 'I' - Неликвидный товар 'P' - Есть самовывоз
****imagepath ссылка https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg содержит в имени файла "p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" букву p, что делает картинку превью 60px на 60px. если из ссылки эту букву убрать, получится ссылка на картинку оригинального размера (изначально загруженная картинка) https://koj.blob.core.windows.net/zzap-upload/upload/catalog/2739725d8d53bff0ccf0ecbfb9cf920b.jpg
Эта фраза над названием продавца означает, что данный продавец самостоятельно зарегистрировался на сайте ZZap, но наши менеджеры ещё не успели с ним связаться и подтвердить его данные. Будьте особенно осторожны с такими продавцами. А ещё лучше дождаться, когда эта фраза исчезнет.
Производитель Номер производителя Наименование Цена Кол-во Срок поставки
Опциональные колонки:
Производитель, текст Наименование, доп Неоригинал б/у и уценка Срок поставки, текст Ссылка на фото запчасти
И колонки, которые может настроить только менеджер:
Линк на позицию Промо Промо, текст
Вместо количества можно указывать "+", "В наличии" или "Заказ"
Наименование колонок и их порядок - не имеет значения
Пример прайс-листа
В каком формате должен быть прайс-лист для шин/дисков?
Необходимые колонки:
Производитель Наименование шины/диска с размерами Цена Кол-во Срок поставки
Вместо количества можно указывать "+", "В наличии" или "Заказ"
Наименование колонок и их порядок - не имеет значения
Пример прайс-листа шины/диски
В каком формате должен быть прайс-лист для б/у и уценки
Необходимые колонки:
Производитель Номер производителя Наименование шины/диска с размерами Цена Срок поставки
Какие тэги могут быть в yml прайсах и какие их них вы 'читаете'?
При публикации мы учитываем следующие тэги:
Vendor VendorCode Name Description Price CurrencyId Count Model Available Url Picture TypePrefix
В отчёте об ошибках в шапке таблицы видны все тэги, которые мы используем:
Прайсы в обработке
Шапка таблицы
Важно!
Если в вашем прайсе есть важная дополнительная информация в тэге, который мы не учитываем, вы можете использовать незадействованный в вашем прайсе тэг из списка тэгов, которые мы учитываем.
Пример:
В вашем прайсе есть тэг condition с важной доп. информацией о позиции, и вы хотите добавить это поле к основному наименованию позиции.
Тэг condition мы не 'увидим' и не 'прочитаем'.
Но вы можете использовать любой тэг из списка выше, который не задействован в вашем прайсе, указать доп. информацию в этом тэге и указать соответствующую колонку в качестве доп. наименования в настройках шаблона.
В каком формате можно прислать вам кроссы?
Таблицу кроссов нужно оформлять в своем аккаунте в "Заявки на тех. поддержку".
Таблица кроссов должна состоять из 5 колонок
Пример таблицы кроссов
Обязательные колонки в файле с кроссами:
Неоригинальный производитель
Неоригинальный номер
Наименование запчасти
Оригинальный производитель
Оригинальный номер
Обращаем ваше внимание! В колонке "Номер" должен быть указан только один
номер (несколько номеров, прописанных через слеш, запятую или пробел, система не
пропускает на публикацию). Если номеров несколько к одному производителю, необходимо
вынести каждую позицию в отдельную строку.
Готовый файл необходимо самостоятельно подгрузить в заявку на тех. поддержку:
"Мой аккаунт" – первая вкладка "Заявки на тех. поддержку" – Создать заявку.
В теме заявки необходимо выбрать "Добавление новых позиций и кроссов", в тексте заявки в
произвольной форме: "Прошу добавить кроссы", через кнопку "Загрузка файла" загрузить файл с
кроссами через кнопку "Загрузка файла" – нажать "Cохранить".
Когда заявка будет выполнена, на ваш email придет уведомление о закрытии заявки. После этого
необходимо заново опубликовать прайс-лист на портале и эти позиции должны пройти на публикацию.
Могу ли я указать в одном прайс-листе оптовые и розничные цены?
Да. Для этого необходимо два раза пройти процедуру самостоятельной публикации прайс-листа, указав в каждом случае соответствующие колонки с ценами (оптовые и розничные), при этом файл может быть один и тот же.
В моем прайс-листе есть позиции «под заказ», опубликуются ли они?
Да, мы публикуем позиции «под заказ», но вам обязательно нужно будет в отдельной колонке, напротив этих позиций указать «срок поставки». Обычно пишут в днях или часах (2-3 дня или 24 часа)
Публикуете ли вы неоригинальные запчасти?
Да. Но очень важно, для правильной загрузки прайс-листа, что бы номер неоригинальной позиции был указан по каталогу производителя этой запчасти, а не кроссом на оригинал. Вычислять кроссы будет наша поисковая система.
Как часто нужно обновлять информацию?
Желательно каждый день. Устаревшие прайс-листы, более чем недельной давности, показываются внизу и отображаются серым цветом, покупатели обращают на них меньше своего внимания. Прайс-листы двухнедельной давности полностью снимаются из поиска.
Мой прайс-лист перестал публиковаться без видимых причин. В чем дело?
Очень важно для нашей автоматической системы публикации, чтобы формат прайс-листа не менялся, т.е. что бы он был подобен тому, что был опубликован в первый раз. Также прайс-лист может перестать публиковаться, если изменилась его ссылка на Вашем сайте или Вы стали его присылать с другого адреса электронной почты.
Так же, если файл прайс-листа не изменился со времени последней публикации, то система не будет его загружать заново. Необходимо добавить, хотя бы пробел или точку в высылаемый файл, что бы изменился его размер и дата.
В любом случае, Вы можете с нами связаться, и мы все исправим.
Я прислал вам прайс-лист, а из него опубликовалась только часть позиций, почему?
На данный момент, мы имеем почти полную базу всевозможных запчастей, но всегда чего-то не хватает. Мы активно работаем над расширением представленных брендов, в т.ч. и с помощью наших уважаемых клиентов, и со временем Ваши прайс-листы будут представлены в полном объеме. Мы так же будем благодарны, если вы нам предоставите информацию по полному ассортименту товара и марок, которые вы продаете.
Есть ли какие-то ограничение по размеру и количеству подгружаемых прайс-листов?
Если вы подгружаете прайс-листы по почте, то размер файла не должен превышать 25 мегабайт, во всех остальных случаях ограничений на размер файла нет. Так же количество строк (позиций) в одном файле не должно превышать 5 млн. В идеале, большие файлы лучше делить на более мелкие, но желательно не более 1 млн. строк.
Для Текстовых (.csv, .txt) файлов, можно использовать данную программу для разбивки их на более мелкие файлы CSVSplitter
