Регистрация и оформление заказа

Регистрация

Метод «регистрация» (MakeRegistration)

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

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

Параметр Тип Обязательный Описание
email string да e-mail, который будет использоваться в дальнейшем как Ваш login на сайте ZZap
password string см. примечание ваш пароль — пароль должен состоять как минимум из 4 символов
code_region string да выбранный вами регион — числовое значение региона определите с помощью метода GetRegions
name_first string да имя
name_second string нет отчество
name_last string да фамилия
company_nick string нет ник вашей компании: если заполнено поле, пользователь — юр.лицо, если поле останется пустым, пользователь — физ.лицо
phone_code_country string да код страны
phone_code_city string да код города
phone string да телефон
phone_add string нет добавочный
email_old string см. примечание e-mail, указанный при регистрации на сайте ZZap
password_old string см. примечание ваш пароль от аккаунта на сайте ZZap
api_key string да нужно попросить у нас

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

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

Примечание:
Для регистрации не надо заполнять email_old и password_old
все остальные поля, кроме name_second, company_nick (если вы физ. лицо) и phone_add, обязательны для заполнения
Для изменения данных обязательно надо заполнить email_old и password_old,
обязательны для заполнения все поля, кроме name_second, company_nick (если вы физ. лицо), phone_add и password

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/[email protected]&password={password}&code_region=1&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick=&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&[email protected]&password_old={password_old}&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «[email protected]» —data-urlencode «password={password}» —data-urlencode «code_region=1» —data-urlencode «name_first=Имя» —data-urlencode «name_second=Отчество» —data-urlencode «name_last=Фамилия» —data-urlencode «company_nick=» —data-urlencode «phone_code_country=8» —data-urlencode «phone_code_city=000» —data-urlencode «phone=111-11-11» —data-urlencode «phone_add=11»—data-urlencode «[email protected]»—data-urlencode «password_old={password_old}» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistration

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


Оформление заказа

Метод «заказ и регистрация» (MakeRegistrationOrderV3)

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

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

Параметр Тип Обязательный Описание
login string да e-mail для регистрации на сайте ZZap
password string да ваш пароль от аккаунта на сайте ZZap
name_first string да имя
name_second string нет отчество
name_last string да фамилия
company_nick string нет ник вашей компании: если заполнено поле, пользователь — юр.лицо, если поле останется пустым, пользователь — физ.лицо
phone_code_country string да код страны
phone_code_city string да код города
phone string да телефон
phone_add string нет добавочный
client_code_region string да регион покупателя — числовое значение региона определите с помощью метода GetRegions
code_doc_b string да внутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_order string да кол-во заказываемой позиции
comment string нет дополнительные комментарии относительно заказа
notify_sms string да оповещение по смс: false — не оповещать, true — оповещать
code_cur string да валюта: цифра от 1 до 5, где 1 — рубль, 2 — доллар, 3 — евро, 4 — гривна, 5 — белорусский рубль, 6 — казахстанский тенге
api_key string да нужно попросить у нас
test string да true (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения — false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу

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

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

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrderV3?login={login}&password={password}&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick={company_nick}&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&client_code_region=30100&code_doc_b=208098711507246&qty_order=1&comment=Заберу в субботу в первой половине дня¬ify_sms=true&code_cur=1&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode » —data-urlencode «name_first=Имя» —data-urlencode «name_second=Отчество» —data-urlencode «name_last=Фамилия» —data-urlencode «company_nick={company_nick}» —data-urlencode «phone_code_country=8» —data-urlencode «phone_code_city=000» —data-urlencode «phone=111-11-11» —data-urlencode «phone_add=11» —data-urlencode «client_code_region=30100» —data-urlencode «code_doc_b=208098711507246» —data-urlencode «qty_order=1» —data-urlencode «comment=Заберу в субботу в первой половине дня» —data-urlencode «notify_sms=true» —data-urlencode «code_cur=1»—data-urlencode «api_key={api_key}» —data-urlencode «test=true» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeRegistrationOrderV3

Ответ
{
«error»: «», // если пусто, ошибок нет
«code_order»: 999999999 // номер сформированного заказа (999999999 — если оформление происходит в режиме теста) }

Очень важно!!! Партнёры, реализующие на своём сайте трансляцию выдачи ZZap с возможностью оформить на их же сайте заказ, для корректного учёта таких заказов в партнёрской статистике должны передавать из данных своего партнёрского аккаунта на ZZap только api_key, а остальные данные запрашивать у пользователя, оформляющего заказ на их сайте.



Метод «сделать заказ» (MakeOrderV4)

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

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

Параметр Тип Обязательный Описание
login string да e-mail, указанный при регистрации на сайте ZZap
password string да ваш пароль от аккаунта на сайте ZZap
code_doc_b string да внутренний уникальный код предложения (для определения кода используйте метод GetSearchResult)
qty_order string да кол-во заказываемой позиции
client_name string да ФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации)
client_email string да e-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации)
client_phone string да телефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации)
comment string нет дополнительные комментарии относительно заказа
notify_sms string да оповещение по смс: false — не оповещать, true — оповещать
client_code_region string да выбранный регион для заказа (может отличаться от региона, указанного при регистрации) — числовое значение региона определите с помощью метода GetRegions
code_cur string да валюта: цифра от 1 до 5, где 1 — рубль, 2 — доллар, 3 — евро, 4 — гривна, 5 — белорусский рубль, 6 — казахстанский тенге
name_first string да имя
name_second string нет отчество
name_last string да фамилия
api_key string да нужно попросить у нас
test string да true (режим теста): заказ не будет сформирован, остальные значения — false (обычный рабочий режим): заказ будет сформирован и отправлен продавцу

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

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

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderV4?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&code_cur=1&name_first=Имя&name_second=Отчество&name_last=Фамилия&api_key={api_key}&test=true

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_doc_b=208098711507246» —data-urlencode «qty_order=1» —data-urlencode «client_name=Фамилия Имя» —data-urlencode «[email protected]» —data-urlencode «client_phone=8(000)111-11-11» —data-urlencode «comment=заберу в субботу в первой половине дня» —data-urlencode «notify_sms=true» —data-urlencode «client_code_region=30100» —data-urlencode «code_cur=1» —data-urlencode «name_first=Имя» —data-urlencode «name_second=Отчество» —data-urlencode «name_last=Фамилия» —data-urlencode «api_key={api_key}» —data-urlencode «test=true» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/MakeOrderV4

Ответ
{
«error»: «», // если пусто, ошибок нет
«code_order»: 999999999 // номер сформированного заказа (999999999 — если оформление происходит в режиме теста)
}

Регистрация и оформление заказа