Корзина

Главная > Помощь > Корзина

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

GetMyCart
https://api.zzap.pro/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дассылка на превью логотипа производителя 30px на 30px
class_catstringданаименование
imagepathstringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 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дацена текстом с коротким обозначением валюты, в которой смотрел покупатель
type_userstringдатип пользователя*
type_user2stringдатип пользователя 2**
type_pricestringдатип прайс-листа***
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_origstringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_pricestringдатип цены – «Только для юр. лиц и ИП» или «» (пусто)
packintдакратность (упаковка) числом
descr_packstringдакратность (упаковка) текстом
code_manintдавнутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
locationstringдагород и метро продавца

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

Пример вызова
Браузер
https://api.zzap.pro/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://api.zzap.pro/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":"https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png" // ссылка на превью логотипа производителя 30px на 30px
"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
"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": "Только для юр. лиц и ИП" или «» (пусто), // отдельно тип цены
"pack": 4, // кратность (упаковка) числом
"descr_pack": "(по 4 шт.)", // кратность (упаковка) текстом
"code_man": 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands)
"location": "Москва, м. Полежаевская" // город и метро продавца
}



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

DeleteFromCart ]
https://api.zzap.pro/webservice/datasharing.asmx/DeleteFromCart

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

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

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

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

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

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



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

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

Метод для обновления корзины и добавления в корзину


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

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

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

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

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

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

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



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

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

Входные параметры (для 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дакод региона покупателя (определите с помощью метода GetRegions)
name_firststringдаимя
name_secondstringнетотчество
name_laststringдафамилия
api_keystringданужно попросить у нас
teststringдаtrue (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/MakeOrderV2?login={login}&password={password}&code_doc_b=208098711507246&qty_order=1&client_name=Фамилия Имя&[email protected]&client_phone=8(000)111-11-11&comment=заберу в субботу в первой половине дня&notify_sms=true&client_code_region=30100&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 "codes_order=3930751,380744" --data-urlencode "client_name=Фамилия Имя" --data-urlencode "[email protected]"--data-urlencode "client_phone=8(000)111-11-11"--data-urlencode "notify_sms=1"--data-urlencode "client_code_region=30100" --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "api_key={api_key}" --data-urlencode "test=1" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/MakeOrdersCartV2

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



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

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

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

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

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

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

Ко всем методам относится – только свои заказы можно изменять/удалять/оформлять в полноценные заказы
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/ReplaceOldCartV2?login={login}&password={password}&code_order=&code_region=11135&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 "code_region=11135" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/ReplaceOldCartV2

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



*type_user
'K' - медаль "Официальный автодилер"
'1' - медаль "Больше года на сайте"
'2' - медаль "Больше 3х лет на сайте"
'3' - медаль "Есть уставные документы"
'4' - медаль "Есть фотографии магазина"
'5' - международная отправка
'P' - Доставка товара курьером
'Y' - Отправка товара в регионы
'B' - Покупатель
'A' - Продавец
'I' - Интернет магазин
'S' - Автосервис/служба установки
'R' - Торговля в розницу
'W' - Торговля оптом
'F' - Частное лицо
'U' - Юридическое лицо


**type_user2
'Y' - Понизить до недостоверных
'K' - Принимаем к оплате банковские карты
'M' - Ручная проверка (снимает пометку Регистрация не подтверждена)
'I' - Неликвидный товар (клиент продаёт неликвид)
'W' - Шиномонтаж
'R' - Не хотят переписываться с покупателями
'Z' - Подтверждена гарантия наличия
'F' - Подтверждение наличия
'R' - Не переписываются с покупателями


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


****imagepath
ссылка https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg содержит в имени файла "p2739725d8d53bff0ccf0ecbfb9cf920b.jpg" букву p, что делает картинку превью 60px на 60px. если из ссылки эту букву убрать, получится ссылка на картинку оригинального размера (изначально загруженная картинка) https://koj.blob.core.windows.net/zzap-upload/upload/catalog/2739725d8d53bff0ccf0ecbfb9cf920b.jpg

Корзина