Для продавца

Оглавление [Скрыть/Показать]


Заказы продавца

Метод «заказы от покупателей» (GetSellerOrders) устарел, не использовать!

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

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

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


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepath stringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qty_orderstringдакол-во заказанных позиций
qtystringда«В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
min_sum_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
applyV2stringдаусловия продажи
client_namestringдаФИО покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
client_code_regionintдакод региона покупателя
client_id_hashstringдахэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
seller_namestringданазвание продавца (доп. адреса, если заказали у доп. адреса)
responsestringдаответ на заказ от продавца
client_rating_countstringдаколичество отзывов покупателя текстом
client_ratingintдарейтинг покупателя
user_keystringда«ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
code_templateintдакод шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
price_namestringданазвание прайс-листа с заказанной позицией
qtyV2int даколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxint дамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2string даколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysint даколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystring дасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_pricestring датип прайс-листа*
other_dests_countint даколичество других продавцов, у которых заказана такая же запчасть этим же покупателем
packint дакратность (упаковка) числом
descr_packstring дакратность (упаковка) текстом
code_manint давнутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
code_trackint дакод статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack
create_trackDateTime дадата статуса
class_trackstring дастатус заказа
message_trackstring дакомментарий к статусу заказа
type_orderbyte датип заказа ***
descr_type_orderstring даописание типа заказа ***


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrders?login={login}&password={password}&row_count=3&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «row_count=3» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrders

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3930751, // номер заказа
«create_date»: «2015-04-01T19:56:36.350», // время создания заказа
«class_man»: «HEPU», // производитель заказанной запчасти
«logopath»:»https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png» // ссылка на превью логотипа производителя 30px на 30px
«partnumber»: «P049», // номер заказанной запчасти
«comment»: «», // комментарий к заказу от покупателя
«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
«qty_order»: «1», // кол-во заказанных позиций
«qty»: «6 шт. «, // «В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
«descr_qty»: «3-5 р.д.», // срок поставки (дополнение к информации о количестве)
«min_sum_order»: 1000.00, // минимальная сумма заказа
«descr_min_sum_order»: «заказ от 1000р.», // минимальная сумма заказа текстом
«shipment»: «доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК», // условия доставки
«priceV2»: 1000.00, // цена (в той валюте, в которой смотрел покупатель)
«descr_priceV2»: «1000р.», // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
«price_orig»: 1000.00, // цена числом (в той валюте, в которой публиковал продавец)
«descr_price_orig»: «1000р.», // цена текстом (в той валюте, в которой публиковал продавец)
«descr_type_price»: «Только для юр. лиц и ИП» или «» (пусто), // отдельно тип цены
«applyV2»: «скидка постоянным клиентам», // условия продажи
«client_name»: «Фамилия Имя», // ФИО покупателя
«client_email»: «[email protected]», // e-mail покупателя
«client_phone»: «8(000)111-11-11», // телефон покупателя
«client_code_region»: «30100», // код региона покупателя
«client_id_hash»: «…», // хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
«seller_name»: «Компания», // продавец
«response»: «Помпа в наличии — приезжайте!» // ответ на заказ от продавца
«client_rating_count»: «33 отзыва», // количество отзывов покупателя
«client_rating»: 4, // рейтинг покупателя
«user_key»: «?????????????????», // «ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
«usedV2»: false, // тип предложения: false — обычное, true — б/у и уценка
«code_template»: 111111, // код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
«price_name»: «Price.xls» // название прайс-листа с заказанной позицией
«qtyV2»: 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
«qty_max»: 50, // максимально допустимое количество для заказа по конкретному предложению продавца
«descr_qtyV2»: «15 шт», // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
«delivery_days»: 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
«descr_delivery»: «7-15 дней», // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
«type_price»: «RMP», // тип прайс-листа
«other_dests_count»: 0, // у других продавцов не заказывал этот же покупатель эту же запчасть
«pack»: 4, // кратность (упаковка) числом
«descr_pack»: «(по 4 шт.)», // кратность (упаковка) текстом
«code_man»: 3113, // внутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
«code_track»: 111, // код статуса
«create_track»: «2020-07-01», // дата статуса
«class_track»: «Заказ в резерве», // статуса заказа (соответствия кодов и статусов заказа — в методе GetCodesTrack)
«message_track»:»Резерв №567438″, // комментарий к статусу заказа
«type_order»: 4,// тип заказа
«descr_type_order» : «Безопасная сделка CDEK» // описание типа заказа
}
{

}
]
}

Важно!

При вызове GetSellerOrders и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Примечание:
метод GetSellerOrders выдаёт заказы от покупателей, созданные не ранее 3 месяцев назад от текущей даты



Метод «заказы от покупателей» (GetSellerOrdersV2) устарел, не использовать!

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

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

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


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepath stringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qty_orderstringдакол-во заказанных позиций
qtystringда«В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
min_sum_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
applyV2stringдаусловия продажи
client_namestringдаФИО покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
client_code_regionintдакод региона покупателя
client_id_hashstringдахэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
seller_namestringданазвание продавца (доп. адреса, если заказали у доп. адреса)
responsestringдаответ на заказ от продавца
client_rating_countstringдаколичество отзывов покупателя текстом
client_ratingintдарейтинг покупателя
user_keystringда«ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
code_templateintдакод шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
price_namestringданазвание прайс-листа с заказанной позицией
qtyV2int даколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxint дамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2string даколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysint даколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystring дасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_pricestring датип прайс-листа*
other_dests_countint даколичество других продавцов, у которых заказана такая же запчасть этим же покупателем
packint дакратность (упаковка) числом
descr_packstring дакратность (упаковка) текстом
code_manint давнутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
code_trackint дакод статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack
create_trackDateTime дадата статуса
class_trackstring дастатус заказа
message_trackstring дакомментарий к статусу заказа
type_orderbyte датип заказа ***
descr_type_orderstring даописание типа заказа ***


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrdersV2?login={login}&password={password}&row_count=3&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «row_count=3» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrdersV2

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3930751, // номер заказа
«create_date»: «2015-04-01T19:56:36.350», // время создания заказа
«class_man»: «HEPU», // производитель заказанной запчасти
«logopath»:»https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png» // ссылка на превью логотипа производителя 30px на 30px
«partnumber»: «P049», // номер заказанной запчасти
«comment»: «», // комментарий к заказу от покупателя
«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
«qty_order»: «1», // кол-во заказанных позиций
«qty»: «6 шт. «, // «В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
«descr_qty»: «3-5 р.д.», // срок поставки (дополнение к информации о количестве)
«min_sum_order»: 1000.00, // минимальная сумма заказа
«descr_min_sum_order»: «заказ от 1000р.», // минимальная сумма заказа текстом
«shipment»: «доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК», // условия доставки
«priceV2»: 1000.00, // цена (в той валюте, в которой смотрел покупатель)
«descr_priceV2»: «1000р.», // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
«price_orig»: 1000.00, // цена числом (в той валюте, в которой публиковал продавец)
«descr_price_orig»: «1000р.», // цена текстом (в той валюте, в которой публиковал продавец)
«descr_type_price»: «Только для юр. лиц и ИП» или «» (пусто), // отдельно тип цены
«applyV2»: «скидка постоянным клиентам», // условия продажи
«client_name»: «Фамилия Имя», // ФИО покупателя
«client_email»: «[email protected]», // e-mail покупателя
«client_phone»: «8(000)111-11-11», // телефон покупателя
«client_code_region»: «30100», // код региона покупателя
«client_id_hash»: «…», // хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
«seller_name»: «Компания», // продавец
«response»: «Помпа в наличии — приезжайте!» // ответ на заказ от продавца
«client_rating_count»: «33 отзыва», // количество отзывов покупателя
«client_rating»: 4, // рейтинг покупателя
«user_key»: «?????????????????», // «ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
«usedV2»: false, // тип предложения: false — обычное, true — б/у и уценка
«code_template»: 111111, // код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
«price_name»: «Price.xls» // название прайс-листа с заказанной позицией
«qtyV2»: 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
«qty_max»: 50, // максимально допустимое количество для заказа по конкретному предложению продавца
«descr_qtyV2»: «15 шт», // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
«delivery_days»: 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
«descr_delivery»: «7-15 дней», // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
«type_price»: «RMP», // тип прайс-листа
«other_dests_count»: 0, // у других продавцов не заказывал этот же покупатель эту же запчасть
«pack»: 4, // кратность (упаковка) числом
«descr_pack»: «(по 4 шт.)», // кратность (упаковка) текстом
«code_man»: 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
«code_track»: 111, // код статуса
«create_track»: «2020-07-01», // дата статуса
«class_track»: «Заказ в резерве», // статуса заказа (соответствия кодов и статусов заказа — в методе GetCodesTrack)
«message_track»:»Резерв №567438″ // комментарий к статусу заказа
«type_order»: 4,// тип заказа
«descr_type_order» : «Безопасная сделка CDEK» // описание типа заказа
}
{

}
]
}

Важно!

При вызове GetSellerOrdersV2 и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.
Примечание:
метод GetSellerOrdersV2 выдаёт заказы от покупателей, созданные не ранее 3 месяцев назад от текущей даты



Метод «заказы от покупателей» (GetSellerOrdersV3)

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
row_countstringдасколько максимально записей возвращать (не больше 10000, по умолчанию — 100)
api_keystringданужно попросить у нас
call_datastringдадля внутренних целей, передавать пустое значение
codes_trackstring неткоды статусов заказа** (можно указать через точку с запятой нужные статусы, соответствия кодов и статусов заказа в методе GetCodesTrack
date_fromstring нетдата последнего события по заказу (для выгрузки заказов не раньше этой даты)
date_tostring нетдата последнего события по заказу (для выгрузки заказов не позже этой даты)


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

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


GetSellerOrderItem:

ПараметрТипОбязательныйОписание
code_orderintданомер заказа
create_dateDateTimeдавремя создания заказа
class_manstringдапроизводитель заказанной запчасти
logopathstringдассылка на превью логотипа производителя 30px на 30px
partnumberstringданомер заказанной запчасти
commentstringдакомментарий к заказу от покупателя
class_catstringданаименование запчасти
imagepath stringдассылка на превью фото запчасти 60px на 60px****
imagepathV2string[]дамассив ссылок на превью фото запчасти 60px на 60px****
qty_orderstringдакол-во заказанных позиций
qtystringда«В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
descr_qtystringдасрок поставки (дополнение к информации о количестве)
min_sum_orderdecimalдаминимальная сумма заказа
descr_min_sum_orderstringдаминимальная сумма заказа текстом
shipmentstringдаусловия доставки
priceV2decimalдацена (в той валюте, в которой смотрел покупатель)
descr_priceV2stringдацена текстом с коротким обозначением валюты, в которой смотрел покупатель
price_origdecimalдацена (в той валюте, в которой публиковал продавец)
descr_price_orig stringдацена текстом (в той валюте, в которой публиковал продавец)
descr_type_price stringдаотдельно тип цены – «Только для юр. лиц и ИП» или «» (пусто)
applyV2stringдаусловия продажи
client_namestringдаФИО покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
client_code_regionintдакод региона покупателя
client_id_hashstringдахэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
seller_namestringданазвание продавца (доп. адреса, если заказали у доп. адреса)
responsestringдаответ на заказ от продавца
client_rating_countstringдаколичество отзывов покупателя текстом
client_ratingintдарейтинг покупателя
user_keystringда«ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
usedV2boolдатип предложения: false – обычное предложение, true – б/у и уценка
code_templateintдакод шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
price_namestringданазвание прайс-листа с заказанной позицией
qtyV2int даколичество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
qty_maxint дамаксимально допустимое количество для заказа по конкретному предложению продавца
descr_qtyV2string даколичество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
delivery_daysint даколичество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
descr_deliverystring дасрок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
type_pricestring датип прайс-листа*
other_dests_countint даколичество других продавцов, у которых заказана такая же запчасть этим же покупателем
packint дакратность (упаковка) числом
descr_packstring дакратность (упаковка) текстом
code_manint давнутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
code_trackint дакод статуса**. Соответствия кодов и статусов заказа в методе GetCodesTrack
create_trackDateTime дадата статуса
class_trackstring дастатус заказа
message_trackstring дакомментарий к статусу заказа
type_orderbyte датип заказа ***
descr_type_orderstring даописание типа заказа ***


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrdersV3?login={login}&password={password}&row_count=3&api_key={api_key}&call_data=&codes_track=15;19;23&date_from=2021-10-01&date_to=2021-11-01

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «row_count=3» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» —data-urlencode «codes_track=15;19;23» —data-urlencode «date_from=2021-10-01» —data-urlencode «date_to=2021-11-01» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetSellerOrdersV3

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3930751, // номер заказа
«create_date»: «2015-04-01T19:56:36.350», // время создания заказа
«class_man»: «HEPU», // производитель заказанной запчасти
«logopath»:»https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png» // ссылка на превью логотипа производителя 30px на 30px
«partnumber»: «P049», // номер заказанной запчасти
«comment»: «», // комментарий к заказу от покупателя
«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
«qty_order»: «1», // кол-во заказанных позиций
«qty»: «6 шт. «, // «В наличии», «Есть», «Заказ» или кол-во штук — то, что было указано у продавца в момент заказа
«descr_qty»: «3-5 р.д.», // срок поставки (дополнение к информации о количестве)
«min_sum_order»: 1000.00, // минимальная сумма заказа
«descr_min_sum_order»: «заказ от 1000р.», // минимальная сумма заказа текстом
«shipment»: «доставка от 400 руб. по округам в пределах МКАД, самовывоз, доставка в регионы ТК», // условия доставки
«priceV2»: 1000.00, // цена (в той валюте, в которой смотрел покупатель)
«descr_priceV2»: «1000р.», // цена текстом с коротким обозначением валюты, в которой смотрел покупатель
«price_orig»: 1000.00, // цена числом (в той валюте, в которой публиковал продавец)
«descr_price_orig»: «1000р.», // цена текстом (в той валюте, в которой публиковал продавец)
«descr_type_price»: «Только для юр. лиц и ИП» или «» (пусто), // отдельно тип цены
«applyV2»: «скидка постоянным клиентам», // условия продажи
«client_name»: «Фамилия Имя», // ФИО покупателя
«client_email»: «[email protected]», // e-mail покупателя
«client_phone»: «8(000)111-11-11», // телефон покупателя
«client_code_region»: «30100», // код региона покупателя
«client_id_hash»: «…», // хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю)
«seller_name»: «Компания», // продавец
«response»: «Помпа в наличии — приезжайте!» // ответ на заказ от продавца
«client_rating_count»: «33 отзыва», // количество отзывов покупателя
«client_rating»: 4, // рейтинг покупателя
«user_key»: «?????????????????», // «ключ» покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo)
«usedV2»: false, // тип предложения: false — обычное, true — б/у и уценка
«code_template»: 111111, // код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией
«price_name»: «Price.xls» // название прайс-листа с заказанной позицией
«qtyV2»: 20, // количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть спец. значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.»)
«qty_max»: 50, // максимально допустимое количество для заказа по конкретному предложению продавца
«descr_qtyV2»: «15 шт», // количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «5 шт.», «15 шт.», «На заказ», «В наличии», «>20 шт.»
«delivery_days»: 7, // количество дней поставки (вычисленное нами в зависимости от указанного в прайсе)
«descr_delivery»: «7-15 дней», // срок поставки текстом (примеры: «7-15 дней», «14-20 дней (плюс время на доставку из г. Санкт-Петербург)»)
«type_price»: «RMP», // тип прайс-листа
«other_dests_count»: 0, // у других продавцов не заказывал этот же покупатель эту же запчасть
«pack»: 4, // кратность (упаковка) числом
«descr_pack»: «(по 4 шт.)», // кратность (упаковка) текстом
«code_man»: 3113 // внутренний код производителя позиции (соответствия кодов и названий всех производителей — в методе GetBrands)
«code_track»: 111, // код статуса
«create_track»: «2020-07-01», // дата статуса
«class_track»: «Заказ в резерве», // статуса заказа (соответствия кодов и статусов заказа — в методе GetCodesTrack)
«message_track»:»Резерв №567438″ // комментарий к статусу заказа
«type_order»: 4,// тип заказа
«descr_type_order» : «Безопасная сделка CDEK» // описание типа заказа
}
{

}
]
}

Важно!

При вызове GetSellerOrdersV3 и потом SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживаются группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.




Метод «подтверждение продавцом получения заказа» (SetOrderStatus) устарел, не использовать!

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

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

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


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

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


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии — приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_order=3930751» —data-urlencode «response=Помпа в наличии — приезжайте!» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatus

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

Важно!
При вызове SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatus только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatus лучше подождать с ответом несколько минут.


Метод «подтверждение продавцом получения заказа» (SetOrderStatusV2) устарел, не использовать!

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

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

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


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

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


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV2?login={login}&password={password}&code_order=3930751&response=Помпа в наличии — приезжайте!&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_order=3930751» —data-urlencode «response=Помпа в наличии — приезжайте!» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV2

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

Важно!
При вызове SetOrderStatus для новых заказов!
Лучше выполнять запрос SetOrderStatusV2 только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatusV2 лучше подождать с ответом несколько минут.


Метод «обновление статуса заказа» (SetOrderStatusV3)

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

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

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


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

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


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV3?login={login}&password={password}&code_order=3930751&code_track=107&response=приезжайте&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_order=3930751» —data-urlencode «code_track=107» —data-urlencode «response=приезжайте» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetOrderStatusV3

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

Важно!
При вызове SetOrderStatusV3 для новых заказов!
Лучше выполнять запрос SetOrderStatusV3 только для заказов, сделанных более 5 минут назад.
Запросы через API обслуживается группой серверов с балансированием нагрузки, и данные на них синхронизируются через репликацию.
Обычно требуется несколько секунд, чтобы изменение проявилось всюду, но в случае с SetOrderStatusV3 лучше подождать с ответом несколько минут.


Отправка заказа от покупателя на сайт продавца (вэб-хуки)

Для продавцов есть возможность настроить получение данных о заказах покупателей на свой сайт
Более подробно можно почитать здесь:
Вэб-хуки (настройка получения, описание)



VIN запросы продавца

Метод «VIN запросы продавца» (GetSellerVinRequests) устарел, не использовать!

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

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

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


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

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


GetSellerVinRequestsData:

ПараметрТипОбязательныйОписание
code_orderintданомер vin-запроса — это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
create_dateDateTimeдавремя создания vin-запроса
client_namestringдаФИО покупателя
client_regionstringдарегион покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
notify_smsboolдаfalse — не оповещать по смс, true — оповещать по смс
vin_numberstringдаvin-номер автомобиля
class_manstringдамарка автомобиля
class_car_typestringдамодель автомобиля
submodelstringдамодификация (если было заполнено)
engine_typestringдадвигатель
man_datestringдагод выпуска автомобиля
vin_infostringдамодельный год, завод, страна и т.д. (если было заполнено)
imagepathstringдассылка на фото (если было прикреплено)
commentstringнеткомментарий покупателя к vin-запросу
responsestringдаответ продавца на vin-запрос
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

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

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3807443, // номер vin-запроса — это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
«create_date»: «2013-09-02T11:07:45.050», // время создания vin-запроса
«client_name»: «Фамилия Имя», // ФИО покупателя
«client_region»: «Сыктывкар и Коми респ.», // регион покупателя
«client_email»: «[email protected]», // e-mail покупателя
«client_phone»: «8(000)111-11-11», // телефон покупателя
«notify_sms»: false, // false — не оповещать по смс, true — оповещать по смс
«vin_number»: «AA1AAAA11A1111111», // vin-номер автомобиля
«class_man»: «OPEL», // марка автомобиля
«class_car_type» : «VECTRA», // модель автомобиля
«submodel»: «C18NZ», // модификация (если было заполнено)
«engine_type»: «1.8», // двигатель
«man_date»: «1992», // год выпуска автомобиля
«vin_info»: «…», // модельный год, завод, страна и т.д. (если было заполнено)
«imagepath»: «», // ссылка на фото (если было прикреплено)
«comment»: «шаровая опора левая, амортизаторы задние, ремень генератора», // комментарий покупателя к vin-запросу
«response»: «Уважаемый (покупатель)! По вашему запросу (номер) отвечаем: всё в наличии! приезжайте! (информация о продавце)» // ответ продавца на vin-запрос
«responses»: «3» // количество ответов на vin-запросов от разных продавцов
}
{

}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе SetVinRequestStatus
Примечание:
метод GetSellerVinRequests выдаёт vin-запросы от покупателей, созданные не ранее месяца назад от текущей даты



Метод «VIN запросы продавца» (GetSellerVinRequestsV2)

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

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

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


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

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


GetSellerVinRequestsData:

ПараметрТипОбязательныйОписание
code_orderintданомер vin-запроса — это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
create_dateDateTimeдавремя создания vin-запроса
client_namestringдаФИО покупателя
client_regionstringдарегион покупателя
client_emailstringдаe-mail покупателя
client_phonestringдателефон покупателя
notify_smsboolдаfalse — не оповещать по смс, true — оповещать по смс
vin_numberstringдаvin-номер автомобиля
class_manstringдамарка автомобиля
class_car_typestringдамодель автомобиля
submodelstringдамодификация (если было заполнено)
engine_typestringдадвигатель
man_datestringдагод выпуска автомобиля
vin_infostringдамодельный год, завод, страна и т.д. (если было заполнено)
imagepathstringдассылка на фото (если было прикреплено)
commentstringнеткомментарий покупателя к vin-запросу
responsestringдаответ продавца на vin-запрос
responsesstringдаколичество ответов на vin-запросов от разных продавцов


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

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 10, // сколько строк вернулось
«table»: [ {
«code_order»: 3807443, // номер vin-запроса — это значение используйте для просмотра ответов по данному vin-запросу (см. комментарий ниже)
«create_date»: «2013-09-02T11:07:45.050», // время создания vin-запроса
«client_name»: «Фамилия Имя», // ФИО покупателя
«client_region»: «Сыктывкар и Коми респ.», // регион покупателя
«client_email»: «[email protected]», // e-mail покупателя
«client_phone»: «8(000)111-11-11», // телефон покупателя
«notify_sms»: false, // false — не оповещать по смс, true — оповещать по смс
«vin_number»: «AA1AAAA11A1111111», // vin-номер автомобиля
«class_man»: «OPEL», // марка автомобиля
«class_car_type» : «VECTRA», // модель автомобиля
«submodel»: «C18NZ», // модификация (если было заполнено)
«engine_type»: «1.8», // двигатель
«man_date»: «1992», // год выпуска автомобиля
«vin_info»: «…», // модельный год, завод, страна и т.д. (если было заполнено)
«imagepath»: «», // ссылка на фото (если было прикреплено)
«comment»: «шаровая опора левая, амортизаторы задние, ремень генератора», // комментарий покупателя к vin-запросу
«response»: «Уважаемый (покупатель)! По вашему запросу (номер) отвечаем: всё в наличии! приезжайте! (информация о продавце)» // ответ продавца на vin-запрос
«responses»: «3» // количество ответов на vin-запросов от разных продавцов
}
{

}
]
}

Вернувшиеся значения code_order используйте для передачи в параметр code_order в методе SetVinRequestStatus
Примечание:
метод GetSellerVinRequestsV2 выдаёт vin-запросы от покупателей, созданные не ранее месяца назад от текущей даты



Метод «подтверждение продавцом получения VIN запроса» (SetVinRequestStatus)

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

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

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


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

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


Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus?login={login}&password={password}&code_order=3930751&response=Помпа в наличии — приезжайте!&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_order=3930751» —data-urlencode «response=Помпа в наличии — приезжайте!» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SetVinRequestStatus

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


Статистика продавца

Метод «моя статистика» (GetMyStatCustomers)

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

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

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


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

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


GetMyStatCustomersListItem:

ПараметрТипОбязательныйОписание
stat_dateDateTimeдадата статистики
descr_type_statstringдатип статистики
counterintдаколичество совершения соответствующего действия (перехода по ссылке, например)


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

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_templ={code_templ}» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyStatCustomers

Ответ
{ «error»: «», // если пусто, ошибок нет
«row_count»: 495, // сколько строк вернулось
«table»: [ {
«stat_date»: «2015-07-01T00:00:00» // дата статистики
«descr_type_stat»: «Переходы по ссылке» // тип статистики
«counter»: 25 // количество совершения соответствующего действия (перехода по ссылке, например)
}
{

}
]
}

Примечание:
Дата всегда указана в виде первого числа месяца и времени 00:00:00, т.е., данные представлены за соответствующий месяц
Пример: «stat_date»:»2015-07-01T00:00:00″, «descr_type_stat»:»Переходы по ссылке», «counter»:25 значит, что переходов по ссылке за июль 2015 года было 25

Загрузка прайса

Метод «Загрузка прайса» (UploadTemplatePrice)

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

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

ПараметрТипОбязательныйОписание
loginstringдаe-mail, указанный при регистрации на сайте ZZap
passwordstringдаваш пароль от аккаунта на сайте ZZap
code_templintдакод шаблона (этот шаблон должен быть включен и иметь тип ‘Загрузка прайса через API’)
urlstringдассылка на прайс-лист
file_bodystring дасодержимое прайс-листа в кодировке base64
file_namestringдаимя файла
api_keystringданужно попросить у нас


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

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

Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/UploadTemplatePrice?login={login}&password={password}&code_templ=340010940&url={url}&file_body={file_body}&file_name=price.xlsx&api_key={api_key}


Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «code_templ=340010940» —data-urlencode «url={url}» —data-urlencode «file_body={file_body}» —data-urlencode «file_name=price.xlsx» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/UploadTemplatePrice

Ответ
{
«error»: «», // если пусто, ошибок нет
«file_url»: «https://…» // ссылка на загруженный прайс-лист
}

Важно!
1. Только один из параметров ‘url’ или ‘file_body’ должен иметь не пустое значение
2. Можно загружать только файлы следующих типов: .xls, .xlsx, .xltx, .zip, .arj, .7z, .gz, .txt, .csv, .xml, .yml, .mde, .mdb, .accdb, .dbf
3. Большие файлы (более 10 Мб с учётом кодировки base64) лучше грузить по ссылке, используя параметр url
4. При передаче данных в поле file_body необходимо убедиться, что правильно закодированы некоторые символы.
base64 – это 62 букво-цифры, два дополнительных символа ‘/’, ‘+’ и терминальный символ ‘=’
и важно в значениях параметров кодировать эти три символа следующим образом ‘/’ -> %2F, ‘+’ -> %2B, ‘=’ -> %3D


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


**code_track
Важно!
новый статус не должен быть равен предыдущему
в скобках указан порядок, в котором могут меняться статусы — порядок нового статуса должен быть больше или равен порядку предыдущего статуса, иначе возникнет ошибка
15 — Новый заказ (5)
19 — Заказ принят (10)
23 — Заказ в работе (13)
111 — Заказ в резерве (13)
141 — Заказ ожидает предоплаты (13)
107 — Заказ ожидает в пункте выдачи (20)
108 — Заказ в пути (15)
11 — Заказ выполнен (30)
153 — Заказ получен (30)
10 — Заказ отменен покупателем (40)
142 — Заказ отменен продавцом (40)
63 — Ответ на заказ (50)


***type_order
type_order = 0 — descr_type_order = ‘Обычный заказ’
type_order = 3 — descr_type_order = ‘Безопасная сделка Boxberry’ (в разработке)
type_order = 4 — descr_type_order = ‘Безопасная сделка CDEK’
type_order = 255 — descr_type_order = ‘Ошибка’
Для продавца