Заказы продавца
Метод "заказы от покупателей" (GetSellerOrdersV3)
GetSellerOrdersV3
https://api.zzap.pro/webservice/datasharing.asmx/GetSellerOrdersV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
row_count | string | да | сколько максимально записей возвращать (не больше 10000, по умолчанию - 100) |
api_key | string | да | нужно попросить у нас |
call_data | string | да | для внутренних целей, передавать пустое значение |
codes_track | string | нет | коды статусов заказа (можно указать через точку с запятой нужные статусы) соответствия кодов и статусов заказа в методе GetCodesTrack |
date_from | string | нет | дата последнего события по заказу (для выгрузки заказов не раньше этой даты) |
date_to | string | нет | дата последнего события по заказу (для выгрузки заказов не позже этой даты) |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
row_count | int | да | сколько строк вернулось |
table | Массив GetSellerOrderItem[] | да | Массив данных |
class_template | string | да | название шаблона |
GetSellerOrderItem:
Параметр | Тип | Обязательный | Описание |
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 | да | срок поставки (дополнение к информации о количестве) |
min_sum_order | decimal | да | минимальная сумма заказа |
descr_min_sum_order | string | да | минимальная сумма заказа текстом |
shipment | string | да | условия доставки |
priceV2 | decimal | да | цена (в той валюте, в которой смотрел покупатель) |
descr_priceV2 | string | да | цена текстом с коротким обозначением валюты, в которой смотрел покупатель |
price_orig | decimal | да | цена (в той валюте, в которой публиковал продавец) |
descr_price_orig | string | да | цена текстом (в той валюте, в которой публиковал продавец) |
descr_type_price | string | да | отдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто) |
applyV2 | string | да | условия продажи |
client_name | string | да | ФИО покупателя |
client_email | string | да | e-mail покупателя |
client_phone | string | да | телефон покупателя |
client_code_region | int | да | код региона покупателя (определите с помощью метода GetRegions) |
client_id_hash | string | да | хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю) |
seller_name | string | да | название продавца (доп. адреса, если заказали у доп. адреса) |
response | string | да | ответ на заказ от продавца |
client_rating_count | string | да | количество отзывов покупателя текстом |
client_rating | int | да | рейтинг покупателя |
user_key | string | да | "ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo) |
usedV2 | bool | да | тип предложения: false – обычное предложение, true – б/у и уценка |
code_template | int | да | код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией |
price_name | string | да | название прайс-листа с заказанной позицией |
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 | да | тип прайс-листа* |
other_dests_count | int | да | количество других продавцов, у которых заказана такая же запчасть этим же покупателем |
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 | да | описание типа заказа** |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetSellerOrdersV3?login={login}&password={password}&row_count=3&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 "row_count=3" --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/GetSellerOrdersV3
Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 10, // сколько строк вернулось
"table": [ {
"class_template": "розница доставка", // название шаблона
"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 р.д.", // срок поставки (дополнение к информации о количестве)
"min_sum_order": 1000.00, // минимальная сумма заказа
"descr_min_sum_order": "заказ от 1000р.", // минимальная сумма заказа текстом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"priceV2": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"descr_priceV2": "1000р.", // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
"price_orig": 1000.00, // цена числом (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"applyV2": "скидка постоянным клиентам", // условия продажи
"client_name": "Фамилия Имя", // ФИО покупателя
"client_email": "[email protected]", // e-mail покупателя
"client_phone": "8(000)111-11-11", // телефон покупателя
"client_code_region": "30100", // код региона покупателя
"client_id_hash": "...", // хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
"seller_name": "Компания", // продавец
"response": "Помпа в наличии - приезжайте!" // ответ на заказ от продавца
"client_rating_count": "33 отзыва", // количество отзывов покупателя
"client_rating": 4, // рейтинг покупателя
"user_key": "?????????????????", // "ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
"usedV2": false, // тип предложения: false - обычное, true - б/у и уценка
"code_template": 111111, // код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
"price_name": "Price.xls" // название прайс-листа с заказанной позицией
"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", // тип прайс-листа
"other_dests_count": 0, // у других продавцов не заказывал этот же покупатель эту же запчасть
"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" // описание типа заказа
}
{
...
}
]
}
Важно!
При вызове GetSellerOrdersV3 и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Метод "обновление статуса заказа" (SetOrderStatusV3)
SetOrderStatusV3
https://api.zzap.pro/webservice/datasharing.asmx/SetOrderStatusV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
code_order | string | да | номер заказа |
code_track | string | да | код статуса заказа. Соответствия кодов и статусов заказа в методе GetCodesTrack |
response | string | да | комментарий к статусу заказа |
api_key | string | да | нужно попросить у нас |
call_data | string | да | для внутренних целей, передавать пустое значение |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/SetOrderStatusV3?login={login}&password={password}&code_order=3930751&code_track=107&response=приезжайте&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 "code_track=107" --data-urlencode "response=приезжайте" --data-urlencode "api_key={api_key}" --data-urlencode "call_data=" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/SetOrderStatusV3
Ответ
{
"error": "" // если пусто, ошибок нет
}
Важно!
При вызове SetOrderStatusV3 для новых заказов!
Лучше выполнять запрос SetOrderStatusV3 только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatusV3 лучше подождать с ответом несколько минут.
Отправка заказа от покупателя на сайт продавца (вэб-хуки)
Для продавцов есть возможность настроить получение данных о заказах покупателей на свой сайт
Более подробно можно почитать здесь:
Вэб-хуки (настройка получения, описание)
Статистика продавца
Метод "моя статистика" (GetMyStatCustomers)
GetMyStatCustomers
https://api.zzap.pro/webservice/datasharing.asmx/GetMyStatCustomers
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
code_templ | string | да | код шаблона, если нужна статистика по конкретному шаблону (если не указан номер, выгрузится общая статистика по всем шаблонам клиента) |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
row_count | int | да | сколько строк вернулось |
table | Массив GetMyStatCustomersListItem[] | да | Массив данных |
GetMyStatCustomersListItem:
Параметр | Тип | Обязательный | Описание |
stat_date | DateTime | да | дата статистики |
descr_type_stat | string | да | тип статистики |
counter | int | да | количество совершения соответствующего действия (перехода по ссылке, например) |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/GetMyStatCustomers?login={login}&password={password}&code_templ={code_templ}&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_templ={code_templ}" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/GetMyStatCustomers
Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 495, // сколько строк вернулось
"table": [ {
"stat_date": "2015-07-01T00:00:00" // дата статистики
"descr_type_stat": "Переходы по ссылке" // тип статистики
"counter": 25 // количество совершения соответствующего действия (перехода по ссылке, например)
}
{
...
}
]
}
Примечание:
Дата всегда указана в виде первого числа месяца и времени 00:00:00, т.е., данные представлены за соответствующий месяц
Пример: "stat_date":"2015-07-01T00:00:00", "descr_type_stat":"Переходы по ссылке", "counter":25 значит, что переходов по ссылке за июль 2015 года было 25
Загрузка прайса
Метод "Загрузка прайса" (UploadTemplatePrice)
UploadTemplatePrice
https://api.zzap.pro/webservice/datasharing.asmx/UploadTemplatePrice
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
code_templ | int | да | код шаблона (этот шаблон должен быть включен и иметь тип 'Загрузка прайса через API') |
url | string | да | ссылка на прайс-лист |
file_body | string | да | содержимое прайс-листа в кодировке base64 |
file_name | string | да | имя файла |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
file_url | string | да | ссылка на загруженный прайс-лист |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/UploadTemplatePrice?login={login}&password={password}&code_templ=340010940&url={url}&file_body={file_body}&file_name=price.xlsx&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_templ=340010940" --data-urlencode "url={url}" --data-urlencode "file_body={file_body}" --data-urlencode "file_name=price.xlsx" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/UploadTemplatePrice
Ответ
{
"error": "", // если пусто, ошибок нет
"file_url": "https://..." // ссылка на загруженный прайс-лист
}
Важно!
1. Только один из параметров 'url' или 'file_body' должен иметь не пустое значение
2. Можно загружать только файлы следующих типов: .xls, .xlsx, .xltx, .zip, .arj, .7z, .gz, .txt, .csv, .xml, .yml, .mde, .mdb, .accdb, .dbf
3. Большие файлы (более 10 Мб с учётом кодировки base64) лучше грузить по ссылке, используя параметр url
4. При передаче данных в поле file_body необходимо убедиться, что правильно закодированы некоторые символы.
base64 – это 62 букво-цифры, два дополнительных символа ‘/’, ‘+’ и терминальный символ ‘=’
и важно в значениях параметров кодировать эти три символа следующим образом ‘/’ -> %2F, ‘+’ -> %2B, ‘=’ -> %3D
*type_price
'R' - Прайс-лист для розницы
'W' - Прайс-лист для юр. лиц и ИП
'M' - Запретить загрузку прайса с сайта как файл
'I' - Неликвидный товар
'P' - Есть самовывоз
- 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 = 'Ошибка'