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

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

Метод «мои заказы» (GetMyOrdersV3)

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

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

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

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

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

GetMyOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringнеткомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
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_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
qtyV2intдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2stringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_pricestringдатип прайс-листа*
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
code_trackintдакод статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack
create_trackDateTimeдадата статуса
class_trackstringдастатус заказа
message_trackstringдакомментарий к статусу заказа
type_orderbyteдатип заказа
descr_type_orderstringдаописание типа заказа
code_catintдавнутренний уникальный код позиции
seller_addressV2stringдаполный адрес продавца
seller_locationstringдагород и метро продавца

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetMyOrdersV3?login={login}&password={password}&api_key={api_key}&call_data=&codes_track=15;19;23&date_from=2021-10-01&date_to=2021-11-01

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=» —data-urlencode «codes_track=15;19;23» —data-urlencode «date_from=2021-10-01» —data-urlencode «date_to=2021-11-01» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyOrdersV3

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3930751, // номер заказа
«create_date»: «2015-04-01T19:56:36.350», // время создания заказа
«class_man»: «HEPU», // производитель заказанной запчасти
«logopath»:»https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png» // ссылка на превью логотипа производителя 30px на 30px
«partnumber»: «P049», // номер заказанной запчасти
«comment»: «», // комментарий к заказу от покупателя
«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
«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»: «Россия, Москва, Хорошевское шоссе 39, м. Полежаевская», // полный адрес и метро продавца
«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 – б/у и уценка
«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_price»: «RMP», // тип прайс-листа
«pack»: 4, // кратность (упаковка) числом
«descr_pack»: «(по 4 шт.)», // кратность (упаковка) текстом
«code_man»: 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
«code_track»: 111, // код статуса
«create_track»: «2020-07-01», // дата статуса
«class_track»: «Заказ в резерве», // статуса заказа (соответствия кодов и статусов заказа — в методе GetCodesTrack)
«message_track»:»Резерв №567438″ // комментарий к статусу заказа
«type_order»: 4,// тип заказа
«descr_type_order» : «Безопасная сделка CDEK», // описание типа заказа
«code_cat» : 12343321, // внутренний уникальный код позиции
«seller_addressV2»: «Россия, Москва, Хорошевское шоссе 39», // полный адрес продавца
«seller_location»: «Москва, м. Полежаевская» // город и метро продавца
}
{

}
]
}



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

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

Входные параметры (для 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/MakeOrderRatingV2?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отзыв о продавце (по заказу)\\nnпродавец — 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отзыв о продавце (по заказу)\\nnпродавец — 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/MakeOrderRatingV2

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


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

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

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

Входные параметры (для 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_citystringдакод города
phonestringдателефон
client_code_regionstringдавыбранный вами регион — числовое значение региона определите с помощью метода GetRegions
notify_smsstringдаоповещение по смс: false — не оповещать, true — оповещать
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения — false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

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

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



Метод «мои VIN запросы» (GetMyVinRequestsV2)

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

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

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

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

ПараметрТипОбязательныйОписание
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-запросов от разных продавцов
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)

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

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

Ответ
{ «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 protected]», // 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_man»: 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
}
{

}
]
}

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



Метод «ответы на мои VIN запросы» (GetMyVinRequestRepliesV2)

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

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

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

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

ПараметрТипОбязательныйОписание
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даещё один телефон продавца
seller_addressV2stringдаполный адрес продавца
seller_locationstringдагород и метро продавца

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

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}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyVinRequestRepliesV2

Ответ
{ «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»: «Россия, Москва, Хорошевское шоссе 39, м. Полежаевская», // полный адрес и метро продавца
«seller_phone2»: «8(000)111-11-11» // ещё один телефон продавца
}
{

}
]



 

*type_price
‘R’ — Прайс-лист для розницы
‘W’ — Прайс-лист для юр.лиц и ИП
‘M’ — Запретить загрузку прайса с сайта как файл
‘I’ — Неликвидный товар
‘P’ — Есть самовывоз


**code_track
Важно!
новый статус не должен быть равен предыдущему
в скобках указан порядок, в котором могут меняться статусы — порядок нового статуса должен быть больше или равен порядку предыдущего статуса, иначе возникнет ошибка
15 — Новый заказ (5)
19 — Заказ принят (10)
23 — Заказ в работе (13)
111 — Заказ в резерве (13)
141 — Заказ ожидает предоплаты (13)
166 — Заказ оплачен (13)
108 — Заказ в пути (15)
107 — Заказ ожидает в пункте выдачи (20)
11 — Заказ выполнен (30)
153 — Заказ получен (30)
10 — Заказ отменен покупателем (40)
142 — Заказ отменен продавцом (40)
63 — Ответ на заказ (50)


***type_order
type_order = 0 — descr_type_order = ‘Обычный заказ’
type_order = 3 — descr_type_order = ‘Безопасная сделка Boxberry’ (в разработке)
type_order = 4 — descr_type_order = ‘Безопасная сделка CDEK’
type_order = 255 — descr_type_order = ‘Ошибка’

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