Для продавца


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

Метод "заказы продавца" (GetSellerOrders) устарел, не использовать!

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

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

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


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepath stringдассылка на превью фото запчасти 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_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
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 дакомментарий к статусу заказа


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

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}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrders

Ответ
{ "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@mail.ru", // 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" // комментарий к статусу заказа
}
{
...
}
]
}

Важно!

При вызове GetSellerOrders и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Примечание:
метод GetSellerOrders выдаёт заказы от покупателей, созданные не ранее 3 месяцев назад от текущей даты



Метод "заказы продавца" (GetSellerOrdersV2)

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

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

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


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepath stringдассылка на превью фото запчасти 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_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
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 дакомментарий к статусу заказа


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

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=" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrdersV2

Ответ
{ "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@mail.ru", // 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" // комментарий к статусу заказа
}
{
...
}
]
}

Важно!

При вызове GetSellerOrdersV2 и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Примечание:
метод GetSellerOrdersV2 выдаёт заказы от покупателей, созданные не ранее 3 месяцев назад от текущей даты



Метод "подтверждение продавцом получения заказа" (SetOrderStatus) устарел, не использовать!

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

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

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


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

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


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии - приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "response=Помпа в наличии - приезжайте!" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus

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

Важно!
При вызове SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.


Метод "подтверждение продавцом получения заказа" (SetOrderStatusV2) устарел, не использовать!

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

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

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


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

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


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV2?login={login}&password={password}&code_order=3930751&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 "response=Помпа в наличии - приезжайте!" --data-urlencode "api_key={api_key}" --data-urlencode "call_data=" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV2

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

Важно!
При вызове SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatusV2 только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatusV2 лучше подождать с ответом несколько минут.


Метод "обновление статуса заказа" (SetOrderStatusV3)

SetOrderStatusV3
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV3

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

Важно!
При вызове SetOrderStatusV3 для новых заказов!
Лучше выполнять запрос SetOrderStatusV3 только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatusV3 лучше подождать с ответом несколько минут.


Отправка заказа от покупателя на сайт продавца (вэб-хуки)

Для продавцов есть возможность настроить получение данных о заказах покупателей на свой сайт
Более подробно можно почитать здесь:
Вэб-хуки (настройка получения, описание)



VIN запросы продавца

Метод "VIN запросы продавца" (GetSellerVinRequests) устарел, не использовать!

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

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

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


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

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


GetSellerVinRequestsData:

ПараметрТипОбязательныйОписание
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-запросу
responsestringдаответ продавца на vin-запрос
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

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

Ответ
{ "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@mail.ru", // 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-запросу
"response": "Уважаемый (покупатель)! По вашему запросу (номер) отвечаем: всё в наличии! приезжайте! (информация о продавце)" // ответ продавца на vin-запрос
"responses": "3" // количество ответов на vin-запросов от разных продавцов
}
{
...
}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе SetVinRequestStatus
Примечание:
метод GetSellerVinRequests выдаёт vin-запросы от покупателей, созданные не ранее месяца назад от текущей даты



Метод "VIN запросы продавца" (GetSellerVinRequestsV2)

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

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

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


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

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


GetSellerVinRequestsData:

ПараметрТипОбязательныйОписание
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-запросу
responsestringдаответ продавца на vin-запрос
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

Ответ
{ "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@mail.ru", // 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-запросу
"response": "Уважаемый (покупатель)! По вашему запросу (номер) отвечаем: всё в наличии! приезжайте! (информация о продавце)" // ответ продавца на vin-запрос
"responses": "3" // количество ответов на vin-запросов от разных продавцов
}
{
...
}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе SetVinRequestStatus
Примечание:
метод GetSellerVinRequestsV2 выдаёт vin-запросы от покупателей, созданные не ранее месяца назад от текущей даты



Метод "подтверждение продавцом получения VIN запроса" (SetVinRequestStatus)

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

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

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


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

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


Пример вызова
Бразуер
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии - приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_order=3930751" --data-urlencode "response=Помпа в наличии - приезжайте!" --data-urlencode "api_key={api_key}" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus

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


Статистика продавца

Метод "моя статистика" (GetMyStatCustomers)

GetMyStatCustomers
https://www.zzap.ru/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://www.zzap.ru/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://www.zzap.ru/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



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


**code_track
15 - Новый заказ (5)
19 - Заказ принят (10)
23 - Заказ в работе (13)
111 - Заказ в резерве (13)
141 - Заказ ожидает предоплаты (13)
107 - Заказ ожидает в пункте выдачи (20)
11 - Заказ выполнен (30)
10 - Заказ отменен покупателем (40)
142 - Заказ отменен продавцом (40)
63 - Ответ на заказ (50)