Корзина

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

GetMyCart
https://www.zzap.ru/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://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»:»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://www.zzap.ru/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://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»: «» // если пусто, ошибок нет
}



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

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

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



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

MakeOrdersCartV2
https://www.zzap.ru/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 да код региона покупателя
name_first string да имя
name_second string нет отчество
name_last string да фамилия
api_key string да нужно попросить у нас
test string да true (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения — false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

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

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



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

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

Корзина