Общая информация
Для продавцов появилась возможность получать информацию о заказе на свой сайт.
Для получения вэб-хука на свой сайт, вам потребуется помощь вашего программиста, так как необходимо обеспечить приём данных с вашей стороны.
Когда ссылка для получения данных на вашем сайте будет готова, в "Данных аккаунта" (вкладка "Информация") поставьте галочку "Хочу получать данные о заказах на свой сайт", впишите ссылку и выберите формат.
 Настроить в аккаунте |
Информация для программиста (разработчика)
1. Возможны два формата получения данных:
- Form URL encoded (application/x-www-form-urlencoded)
- JSON (application/json)
2. Заполнение поля Доп. параметр для платформы ABCP:
- Если есть доп. адрес и хотите получать заказы отдельно на него, укажите ID филиала (франчайзи) в данных доп. адреса
- Если основной аккаунт на ZZap является для ABCP филиалом, укажите ID филиала (франчайзи) в данных аккаунта
Очень важно
Веб-хук отправляется в следующих случаях:
- оформлен новый заказ без безопасной сделки
- оформленный новый заказ с подключением безопасной сделки оплачен покупателем и ожидает подтверждения отправки запчасти продавцом
- заказ изменил статус, например "отменён покупателем" (в этом случае приходит уже приходивший ранее code_order, но статус code_track изменился)
Однако, могут быть ситуации, когда один и тот же заказ с одним и тем же статусом отправляется веб-хуком более одного раза,
например, в случае получения от принимающего сервера ошибки, тайм-аута или в каких-либо ещё случаях, когда мы не уверены, что вэб-хук отправился успешно,
поэтому со стороны приёма данных необходимо реализовать логику проверки уникальности сочетания параметров code_order и code_track
Что придёт
По указанной вами ссылке будет отправляется POST запрос, в котором будут передаваться следующие поля:
| Параметр | Тип | Обязательный | Описание |
| code_order_group | int32 | да | код группы заказов от одного покупателя на сайте ZZap, равный коду первого заказа из группы при оформлении одного или нескольких заказов из корзины или равный коду одного заказа при оформлении из результатов поиска |
| create_date_group | dateTime | да | дата создания группы заказов от одного покупателя на сайте ZZap (равная дате создания первого заказа) |
| row_count_group/row_count | int32 | да | количество заказов в группе code_order_group |
| code_order | int32 | да | код заказа на сайте ZZap |
| create_date | dateTime | да | дата создания заказа на сайте ZZap |
| client_name | string | да | ФИО покупателя |
| client_region | string | да | регион, указанный покупателем |
| client_phone | string | да | телефон покупателя |
| client_email | string | да | e-mail покупателя |
| partnumber | string | да | номер запчасти (как у вас в прайс-листе) |
| class_man | string | да | производитель (как у вас в прайс-листе) |
| class_cat | string | да | наименование запчасти (как у вас в прайс-листе) |
| qty_order | int32 | да | заказываемое количество позиций |
| comment | string | да | комментарий покупателя к заказу |
| price | decimal | да | цена запчасти (в той валюте, в которой смотрел покупатель) |
| code_cur | byte | да | значение, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге - валюта, которую выбрал покупатель для отображения цены |
| file_name | string | да | название прайса, из которого заказана запчасть (только название файла) |
| code_doc_b | да | int64 | уникальный код вашего предложения в системе ZZap |
| client_id_hash | string | да | хэш от уникального кода покупателя (удобно использовать для группировки полученных данных по покупателю) |
| descr_delivery | string | да | срок поставки этой позиции, который был указан в прайсе/шаблоне на момент оформления заказа |
| delivery_days | int32 | да | срок поставки этой позиции в днях |
| shipment | string | да | условия и способы доставки этой позиции |
| logopath | string | да | логотип производителя |
| imagepath | string | да | изображение/фото запчасти |
| qty (устарело! не использовать) | string | да | кол-во, текст! (как было в прайсе продавца) |
| apply | string | да | условия продажи |
| client_code_region | int32 | да | код региона покупателя (определите с помощью метода GetRegions) |
| seller_name | string | да | название продавца (доп. адреса, если заказали у доп. адреса) |
| user_key | string | да | "ключ" покупателя, с помощью которого Вы сможете оставить отзыв по заказу, оформленному на сайте ZZap (метод MakeOrderRating), а также можете посмотреть информацию о покупателе (метод GetUserInfo) |
| used | bool | да | тип предложения: False - обычное, True - б/у и уценка |
| code_template | int32 | да | код шаблона продавца, по которому был опубликован прайс-лист с заказанной позицией |
| price_name | string | да | название и размер прайса, из которого заказана запчасть |
| descr_price | string | да | цена текстом с коротким обозначением валюты, в которой смотрел покупатель |
| price_orig | decimal | да | цена (в той валюте, в которой публиковал продавец) |
| descr_price_orig | string | да | цена текстом (в той валюте, в которой публиковал продавец) |
| descr_type_price | string | да | тип цены – «Только для юр. лиц и ИП» или «» (пусто) |
| min_sum_order | decimal | да | минимальная сумма заказа, если указана продавцом |
| descr_min_sum_order | string | да | минимальная сумма заказа текстом, если указана продавцом |
| qtyV2 | int32 | да | количество, указанное продавцом в прайсе (числом). кроме обычных значений 10, 20, 4, могут быть значения: -1 («На заказ»), -2 («В наличии»), 100012 («>12 шт.») |
| descr_qty | string | да | количество, указанное продавцом в прайсе (текстом), соответственно количеству qtyV2 могут быть значения: «10 шт.», «20 шт.», «4 шт.». «На заказ», «В наличии», «>12 шт.» |
| code_track | int | да | код статуса. Соответствия кодов и статусов заказа в методе GetCodesTrack |
| create_track | DateTime | да | дата статуса |
| class_track | string | да | статус заказа |
| message_track | string | да | комментарий к статусу заказа |
| order_params | string | да | доп. параметр (для платформы ABCP id франчайзи) |
| price_base | decimal | да | цена до применения наценки, указанной в шаблоне (в той валюте, в которой публиковал продавец) |
Информация будет отправлена в выбранном в настройках аккаунта формате
Пример запроса в формате Form URL Encoded (application/x-www-form-urlencoded)
code_order_group=310830152&create_order_group=31-01-20+19%3a20%3a57&row_count_group=1&code_order=310830152&create_date=31-01-20+19%3a20%3a57&client_name=...
Пример запроса в формате JSON (application/json)
{
"code_order_group": 310830125,
"create_date_group": "2020-01-31T18:50:08.14",
"client_name": "Скворцоффф Борис (Контора ЗЗАП)",
"client_region": "Москва и Московская область",
"client_phone": "8(916)555555",
"client_email": "[email protected]",
"client_id_hash": "668429d097a59cbcb1e5afba96d2c26b",
"client_code_region": 1,
"seller_name": "Test Seller ZZap",
"user_key": "pV9WvqNPhDn1rgHUqlb5fNzyR6wxyzC1LA1k7jniCqE=;pV9WvqNPhDk2g1YpdzaNpcqqG/VYF89NdnsZR5qgX0Y=",
"code_cur": 1,
"comment": "",
"row_count": 1,
"table": [
{
"code_order": 310830125,
"create_date": "2020-01-31T18:50:08.14",
"partnumber": "P049",
"class_man": "HEPU",
"class_cat": "ПОМПА",
"qty_order": 1,
"price": 3014.00,
"file_name": "test_price_qty.xls",
"code_doc_b": 4786771482233096496,
"descr_delivery": "",
"delivery_days": 255,
"shipment": "",
"logopath": "https://koj.blob.core.windows.net/zzap-upload/upload/logos/s168c3d55b90bfe5ac9ea3767c075ab8c.png",
"imagepath": "https://koj.blob.core.windows.net/zzap-upload/upload/catalog/p2739725d8d53bff0ccf0ecbfb9cf920b.jpg",
"apply": "ПРЕДЛОЖЕНИЕ НЕДЕЙСТВИТЕЛЬНО!!! ЭТО ТЕСТ",
"used": false,
"code_template": 270013688,
"price_name": "test_price_qty.xls (0.03мб.)",
"descr_price": " 3 014р.",
"price_orig": 102.00,
"descr_price_orig": " 102.00б.р. ЦБРФ",
"descr_type_price": "Только для юр. лиц и ИП",
"min_sum_order": 0.00,
"descr_min_sum_order": "",
"qtyV2": 1000050,
"descr_qty": ">50 шт.",
"code_track": 111,
"create_track": "2020-07-01",
"class_track": "Заказ в резерве",
"message_track":"Резерв №567438"
"order_params":"1139009"
"price_base": 97.00
}
]
}
Внимание! Примечание к полю price. Это цена, которую видел покупатель, когда оформлял заказ, в той валюте, которую выбрал покупатель для отображения цены.
Важно! В качестве разделителя используется запятая.
!Очень важно! (подтверждение/ответ на заказ)
Вам так же необходимо
реализовать подтверждение получения заказа (что его увидели и начали с ним работать).
Это можно сделать при помощи метода Метод "обновление статуса заказа" (SetOrderStatusV3),
в противном случае ZZap оставляет за собой право отключить у вас этот функционал.