Для продавца

Главная > Помощь > Для продавца

Заказы продавца

Метод "заказы от покупателей" (GetSellerOrdersV3)

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

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

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



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

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



GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qty_orderstringдакол-во заказанных позиций
qtystringда"В наличии", "Есть", "Заказ" или кол-во штук - то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
min_sum_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
applyV2stringдаусловия продажи
client_namestringдаФИО покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
client_code_regionintдакод региона покупателя
client_id_hashstringдахэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
seller_namestringданазвание продавца (доп. адреса, если заказали у доп. адреса)
responsestringдаответ на заказ от продавца
client_rating_countstringдаколичество отзывов покупателя текстом
client_ratingintдарейтинг покупателя
user_keystringда"ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
code_templateintдакод шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
price_namestringданазвание прайс-листа с заказанной позицией
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датип прайс-листа*
other_dests_countintдаколичество других продавцов, у которых заказана такая же запчасть этим же покупателем
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
code_trackintдакод статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack
create_trackDateTimeдадата статуса
class_trackstringдастатус заказа
message_trackstringдакомментарий к статусу заказа
type_orderbyteдатип заказа ***
descr_type_orderstringдаописание типа заказа ***



Пример вызова
Браузер
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": [ {
"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 параметрах запроса):

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



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

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



Пример вызова
Браузер
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 параметрах запроса):

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



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

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



GetMyStatCustomersListItem:

ПараметрТипОбязательныйОписание
stat_dateDateTimeдадата статистики
descr_type_statstringдатип статистики
counterintдаколичество совершения соответствующего действия (перехода по ссылке, например)



Пример вызова
Браузер
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 параметрах запроса):

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_templintдакод шаблона (этот шаблон должен быть включен и иметь тип 'Загрузка прайса через API')
urlstringдассылка на прайс-лист
file_bodystringдасодержимое прайс-листа в кодировке base64
file_namestringдаимя файла
api_keystringданужно попросить у нас



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

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


Пример вызова
Браузер
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' - Есть самовывоз


**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)
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 = 'Ошибка'
Для продавца