Метод "моя корзина" (GetMyCart)

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

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

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


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

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


GetCartItem:

ПараметрТипОбязательныйОписание
code_orderint даномер сформированного заказа
code_doc_blongдавнутренний уникальный код предложения
create_dateDateTimeдавремя создания заказа
client_namestringдаФИО покупателя
qty_orderintдакол-во заказанных позиций
qtyintдаколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
descr_qtystringдаколичество, указанное продавцом в прайсе (текстом), соответственно количеству qty могут быть значения: «10 шт.», «20 шт.», «4 шт.», «На заказ», «В наличии», «>12 шт.»
qty_maxintдамаксимально допустимое количество для заказа по конкретному предложению продавца
delivery_daysintдаколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystringдасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
partnumberstringданомер производителя
commentstringдачасы работы + краткая информация о продавце (желательно обрабатывать, если встречается)
class_manstringдапроизводитель
logopathstringдалоготип производителя
class_catstringданаименование
imagepathstringдапревью картинки 60px на 60px
seller_namestringдапродавец
user_keystringда"ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
seller_rating_countstringдаколичество отзывов продавца текстом
seller_ratingintдарейтинг продавца
usedboolдатип предложения: false – обычное предложение, true – б/у и уценка
applystringдаусловия продажи, если указаны продавцом
min_sum_orderdecimalдаминимальная сумма заказа, если указана продавцом
descr_min_sum_orderstringдаминимальная сумма заказа текстом, если указана продавцом
shipmentstringдаусловия доставки
pricedecimalдацена (в той валюте, в которой смотрел покупатель)
descr_pricestringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдатип цены – «Только для юр. лиц и ИП» или «» (пусто)

важно – если code_doc_b = -1 значит предложение устарело, его надо показывать серым и давать возможность обновить (см. метод ReplaceOldCart) или удалить. Посылать в заказ эти позиции нельзя.


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

Ответ
{ "error": "", // если пусто, ошибок нет
"row_count": 5, // сколько строк вернулось
"table": [
"code_order": 3930751, // номер заказа
"code_doc_b": 208098711507246, // внутренний уникальный код предложения (нужно передавать в GetSearchResultOne)
"create_date": "2015-04-01T19:56:36.350", // время создания заказа
"client_name": "Фамилия Имя", // ФИО покупателя
"qty_order": "1", // кол-во заказанных позиций
"qty": 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
"descr_qty": "20 шт", // количество, указанное продавцом в прайсе (текстом), соответственно количеству qty могут быть значения: «10 шт.», «20 шт.», «4 шт.», «На заказ», «В наличии», «>12 шт.»
"qty_max": 100, // максимально допустимое количество для заказа по конкретному предложению продавца
"delivery_days": 30, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
"descr_delivery": "7-15 дней", // срок поставки текстом
"partnumber": "P049", // номер
"comment": "Отдел заказов работает с 9-19 часов, сервис работает каждый день с 9-20 часов", // часы работы + краткая информация о продавце (желательно отрабатывать, если он встречается)
"class_man": "HEPU", // производитель
"logopath": "", // логотип производителя
"class_cat": "НАСОС ВОДЯНОЙ", // наименование
"imagepath": "" // изображение/фото запчасти
"seller_name": "Компания", // продавец
"user_key": "?????????????????", // "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo)
"seller_rating_count": "33 отзыва", // количество отзывов продавца
"seller_rating": 4, // рейтинг продавца
"used": true, // тип предложения: false – обычное предложение, true – б/у и уценка
"apply": "цена для покупателей ZZap", // условия продажи, если указаны продавцом
"min_sum_order": 1000.00, // минимальная сумма заказа, если указана продавцом
"shipment": "доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК", // условия доставки
"price": 1000.00, // цена (в той валюте, в которой смотрел покупатель)
"descr_price": "1000р.", // цена текстом (в той валюте, в которой смотрел покупатель)
"price_orig": 1000.00, // цена (в той валюте, в которой публиковал продавец)
"descr_price_orig": "1000р.", // цена текстом (в той валюте, в которой публиковал продавец)
"descr_type_price": "Только для юр. лиц и ИП" или «» (пусто) // отдельно тип цены
}



Метод "удалить из корзины" (DeleteFromCart)

DeleteFromCart ]
https://www.zzap.ru/webservice/datasharing.asmx/DeleteFromCart

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

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

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

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

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


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

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



Метод "редактирование корзины" (UpdateCart)

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_orderstringданомер заказа в корзине. см. примечание
qty_orderstringдакол-во заказываемой позиции. см. примечание
commentstringнетдополнительные комментарии относительно заказа
code_doc_bstringдавнутренний уникальный код предложения (для определения кода используйте метод GetSearchResult). см. примечание
currencystringдавалюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

login, password, api_key, test – обязательные параметры
comment – может быть пустым, может быть заполнен
остальные поля зависят от действия
- редактирование (изменить можно только количество заказываемых позиций и комментарий)
обязательно должны быть заполнены code_order и qty_order
обязательно НЕ должны быть заполнены code_doc_b и currency
- добавление
обязательно должны быть заполнены code_doc_b, currency и qty_order
обязательно НЕ должен быть заполнен code_order

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/UpdateCart?login={login}&password={password}&code_order=&qty_order=1&comment=Заберу в субботу в первой половине дня&code_doc_b=208098711507246&currency=1&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=" --data-urlencode "qty_order=1" --data-urlencode "comment=Заберу в субботу в первой половине дня" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "currency=1" --data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/UpdateCart

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



Метод "оформить заказы из корзины" (MakeOrdersCart)

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
codes_orderstringдаперечисление через точку с запятой уникальных кодов оформленных заказов
client_namestringдаФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации)
client_emailstringдаe-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации)
client_phonestringдателефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации)
notify_smsstringдаfalse - не оповещать по смс, true - оповещать по смс
client_code_regionstringдакод региона покупателя
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrdersCart?login={login}&password={password}&codes_order=3930751,380744&client_name=Фамилия Имя&client_email=email@mail.ru&client_phone=8(000)111-11-11&notify_sms=1&client_code_region=30100&api_key={api_key}&test=1


Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "codes_order=3930751,380744" --data-urlencode "client_name=Фамилия Имя" --data-urlencode "client_email=email@mail.ru"--data-urlencode "client_phone=8(000)111-11-11"--data-urlencode "notify_sms=1"--data-urlencode "client_code_region=30100"--data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrdersCart

Ответ
{ "error": "", // если пусто, ошибок нет
"codes_order": "3930751,380744" // перечисление через точку с запятой уникальных кодов заказов в корзине
}



Метод "обновить устаревший заказ в корзине" (ReplaceOldCart)

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

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

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


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

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

Ко всем методам относится – только свои заказы можно изменять/удалять/оформлять в полноценные заказы
Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/ReplaceOldCart?login={login}&password={password}&code_order=&api_key={api_key}


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

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