Заказы покупателя
Метод "мои заказы" (GetMyOrdersV3)
GetMyOrdersV3
https://api.zzap.pro/webservice/datasharing.asmx/GetMyOrdersV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail, указанный при регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| api_key | string | да | нужно попросить у нас |
| call_data | string | да | для внутренних целей, передавать пустое значение |
| codes_track | string | нет | коды статусов заказа** (можно указать через точку с запятой нужные статусы, соответствия кодов и статусов заказа в методе GetCodesTrack |
| date_from | string | нет | дата заказа (для выгрузки заказов не раньше этой даты) |
| date_to | string | нет | дата заказа (для выгрузки заказов не позже этой даты) |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| row_count | int | да | сколько строк вернулось |
| table | Массив GeMytOrderItem[] | да | Массив данных |
GetMyOrderItem:
| Параметр | Тип | Обязательный | Описание |
| code_order | int | да | номер заказа |
| create_date | DateTime | да | время создания заказа |
| class_man | string | да | производитель заказанной запчасти |
| logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
| partnumber | string | да | номер заказанной запчасти |
| comment | string | нет | комментарий к заказу от покупателя |
| class_cat | string | да | наименование запчасти |
| imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
| imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
| qty_order | string | да | кол-во заказанных позиций |
| qty | string | да | "В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа |
| descr_qty | string | да | срок поставки (дополнение к информации о количестве) |
| priceV2 | decimal | да | цена (в той валюте, в которой смотрел покупатель) |
| applyV2 | string | да | условия продажи |
| client_name | string | да | покупатель |
| seller_name | string | да | продавец |
| response | string | да | ответ на заказ от продавца |
| rated_orderV2 | bool | да | false – отзыв по заказу ещё не написан, true – отзыв по заказу уже написан |
| user_key | string | да | "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) |
| seller_rating_count | string | да | количество отзывов продавца текстом |
| seller_rating | int | да | рейтинг продавца |
| seller_address | string | да | полный адрес и метро продавца |
| seller_phone | string | да | телефон продавца |
| seller_phone2 | string | да | ещё один телефон продавца |
| min_sum_order | decimal | да | минимальная сумма заказа |
| descr_min_sum_order | string | да | минимальная сумма заказа текстом |
| shipment | string | да | условия доставки |
| price_orig | decimal | да | цена (в той валюте, в которой публиковал продавец) |
| descr_price_orig | string | да | цена текстом (в той валюте, в которой публиковал продавец) |
| descr_type_price | string | да | отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто) |
| descr_priceV2 | string | да | цена текстом с коротким обозначением валюты, в которой смотрел покупатель |
| 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 дней (плюс время на доставку из г. Санкт-Петербург)») |
| type_price | string | да | тип прайс-листа* |
| pack | int | да | кратность (упаковка) числом |
| descr_pack | string | да | кратность (упаковка) текстом |
| code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
| code_track | int | да | код статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack |
| create_track | DateTime | да | дата статуса |
| class_track | string | да | статус заказа |
| message_track | string | да | комментарий к статусу заказа |
| type_order | byte | да | тип заказа |
| descr_type_order | string | да | описание типа заказа |
| code_cat | int | да | внутренний уникальный код позиции |
| seller_addressV2 | string | да | полный адрес продавца |
| seller_location | string | да | город и метро продавца |
Пример вызова
Браузер
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 параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail, указанный при регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| code_order | string | да | номер заказа |
| rating | string | да | оценка от 1 до 5 баллов |
| message | string | да | комментарии по заказу |
| phone | string | да | телефон |
| api_key | string | да | нужно попросить у нас |
| test | string | да | true (режим теста): отзыв не будет сохранён. остальные значения - 0 (обычный рабочий режим): отзыв будет сохранён |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
Пример вызова
Браузер
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 = 'Ошибка'