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

Главная > Помощь > Для покупателя

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

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

GetMyOrdersV3

https://api.zzap.pro/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Массив GetMytOrderItem[]даМассив данных

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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/webservice/datasharing.asmx/MakeOrderRatingV2

Ответ

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

МЕТОД "Удалить отзыв" (DELETERATING)

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

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

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



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

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



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

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

Ответ

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

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

**code_track

КодОписаниеПорядок отображенияWebhook
114Новая безопасная сделка[СДЕК]
116Ожидание отправки[СДЕК]
118Заказ отменен[СДЕК]
121Заказ в пути[СДЕК]
122Оплата заказа в процессе[СДЕК]
123Подготовка к отправке заказа[СДЕК]
124Заказ прибыл[СДЕК]
125Заказ выполнен[СДЕК]
127Ожидание оплаты заказа[СДЕК]
156Заказ отменен из-за неактивности покупателя[СДЕК]
159Новый заказ[Яндекс]
160Заказ подтверждён продавцом[Яндекс]
161Заказ забрали у продавца[Яндекс]
162Заказ доставили[Яндекс]
163Заказ вернули продавцу[Яндекс]
164Заказ бесплатно отменён[Яндекс]
165Заказ платно отменён[Яндекс]
167Заказ подтверждён покупателем[Яндекс]
15Новый заказ5
19Заказ принят10
23Заказ в работе13
111Заказ в резерве13
141Заказ ожидает предоплаты13
166Заказ оплачен13
108Заказ в пути15
107Заказ ожидает в пункте выдачи20
11Заказ выполнен30
153Заказ получен30
10Заказ отменен покупателем40
142Заказ отменен продавцом40
169Архив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 = 5 - descr_type_order = 'Заказ с Яндекс Доставкой'
  • type_order = 255 - descr_type_order = 'Ошибка'
Для покупателя