Метод "моя корзина" (GetMyCart)
GetMyCart
https://api.zzap.pro/webservice/datasharing.asmx/GetMyCart
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
api_key | string | да | нужно попросить у нас |
call_data | string | да | для внутренних целей, передавать пустое значение |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
row_count | int | да | сколько строк вернулось |
table | Массив GetCartItem[] | да | массив данных |
GetCartItem:
Параметр | Тип | Обязательный | Описание |
code_order | int | да | номер сформированного заказа |
code_doc_b | long | да | внутренний уникальный код предложения |
create_date | DateTime | да | время создания заказа |
client_name | string | да | ФИО покупателя |
qty_order | int | да | кол-во заказанных позиций |
qty | int | да | количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») |
descr_qty | string | да | количество, указанное продавцом в прайсе (текстом), соответственно количеству qty могут быть значения: «10 шт.», «20 шт.», «4 шт.», «На заказ», «В наличии», «>12 шт.» |
qty_max | int | да | максимально допустимое количество для заказа по конкретному предложению продавца |
delivery_days | int | да | количество дней поставки (вычисленное нами в зависимости от указанного в прайсе) |
descr_delivery | string | да | срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)») |
partnumber | string | да | номер производителя |
comment | string | да | часы работы + краткая информация о продавце (желательно обрабатывать, если встречается) |
class_man | string | да | производитель |
logopath | string | да | ссылка на превью логотипа производителя 30px на 30px |
class_cat | string | да | наименование |
imagepath | string | да | ссылка на превью фото запчасти 60px на 60px**** |
imagepathV2 | string[] | да | массив ссылок на превью фото запчасти 60px на 60px**** |
seller_name | string | да | продавец |
user_key | string | да | "ключ" продавца, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о продавце (метод GetUserInfo) |
seller_rating_count | string | да | количество отзывов продавца текстом |
seller_rating | int | да | рейтинг продавца |
used | bool | да | тип предложения: false – обычное предложение, true – б/у и уценка |
apply | string | да | условия продажи, если указаны продавцом |
min_sum_order | decimal | да | минимальная сумма заказа, если указана продавцом |
descr_min_sum_order | string | да | минимальная сумма заказа текстом, если указана продавцом |
shipment | string | да | условия доставки |
price | decimal | да | цена (в той валюте, в которой смотрел покупатель) |
descr_price | string | да | цена текстом с коротким обозначением валюты, в которой смотрел покупатель |
type_user | string | да | тип пользователя* |
type_user2 | string | да | тип пользователя 2** |
type_price | string | да | тип прайс-листа*** |
price_orig | decimal | да | цена (в той валюте, в которой публиковал продавец) |
descr_price_orig | string | да | цена текстом (в той валюте, в которой публиковал продавец) |
descr_type_price | string | да | тип цены – «Только для юр. лиц и ИП» или «» (пусто) |
pack | int | да | кратность (упаковка) числом |
descr_pack | string | да | кратность (упаковка) текстом |
code_man | int | да | внутренний код производителя позиции (соответствия кодов и названий всех производителей - в методе GetBrands) |
location | string | да | город и метро продавца |
важно – если 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 параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
codes_order | string | да | перечисление через точку с запятой уникальных кодов заказов в корзине |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
Пример вызова
Браузер
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 параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
code_order | string | да | номер заказа в корзине. см. примечание |
qty_order | string | да | кол-во заказываемой позиции. см. примечание |
comment | string | нет | дополнительные комментарии относительно заказа |
code_doc_b | string | да | внутренний уникальный код предложения (для определения кода используйте метод GetSearchResult). см. примечание |
code_cur | string | да | валюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге |
code_region | string | да | code_region из метода GetRegions |
api_key | string | да | нужно попросить у нас |
test | string | да | true (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
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 параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
codes_order | string | да | перечисление через точку с запятой уникальных кодов оформленных заказов |
client_name | string | да | ФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации) |
client_email | string | да | e-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации) |
client_phone | string | да | телефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации) |
notify_sms | string | да | false - не оповещать по смс, true - оповещать по смс |
client_code_region | string | да | код региона покупателя (определите с помощью метода GetRegions) |
name_first | string | да | имя |
name_second | string | нет | отчество |
name_last | string | да | фамилия |
api_key | string | да | нужно попросить у нас |
test | string | да | true (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
codes_order | string | да | перечисление через точку с запятой уникальных кодов заказов в корзине |
Пример вызова
Браузер
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=заберу в субботу в первой половине дня¬ify_sms=true&client_code_region=30100¤cy=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 параметрах запроса):
Параметр | Тип | Обязательный | Описание |
login | string | да | e-mail, указанный при регистрации на сайте ZZap |
password | string | да | ваш пароль от аккаунта на сайте ZZap |
code_order | string | да | перечисление через точку с запятой уникальных кодов заказов в корзине |
api_key | string | да | нужно попросить у нас |
Выходные параметры:
Параметр | Тип | Обязательный | Описание |
error | string | да | если пусто, ошибок нет |
Ко всем методам относится – только свои заказы можно изменять/удалять/оформлять в полноценные заказы
Пример вызова
Браузер
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