Webhook - История изменений

Бутусов: /* API Key */

2025-10-22T02:59:57Z

‎API Key

Бутусов: /* API Key */

2025-10-22T02:58:55Z

‎API Key

Бутусов в 02:58, 22 октября 2025

2025-10-22T02:58:18Z

Бутусов: /* Настройка */

2025-10-22T02:45:52Z

‎Настройка

Natalia: /* Формат ответа от получателя вебхука */

2024-12-24T11:49:13Z

‎Формат ответа от получателя вебхука

Бутусов в 07:16, 13 декабря 2024

2024-12-13T07:16:11Z

Бутусов: /* Принцип работы */

2024-12-13T07:13:52Z

‎Принцип работы

Бутусов: /* Принцип работы */

2024-12-13T07:06:36Z

‎Принцип работы

Бутусов в 07:06, 13 декабря 2024

2024-12-13T07:06:21Z

Бутусов в 08:41, 12 декабря 2024

2024-12-12T08:41:14Z

@@ Строка 33: / Строка 33: @@
 Можно передавать параметр в
-*Headers* - в данном случае параметры добавляются в Headers
+'''Headers''' - в данном случае параметры добавляются в Headers
-*Query Params* - в данном случае вместо XML шлется form-data с двумя параметрами: xml - XML тело и ваш параметр
+'''Query Params''' - в данном случае вместо XML шлется form-data с двумя параметрами: xml - XML тело и ваш параметр
 == Формат данных в адрес получателя вебхука ==

@@ Строка 25: / Строка 25: @@
 Данный тип авторизации позволяет передавать любой параметр в авторизации
-'''Название key''' - название параметр
+'''Название key''' - название параметра
-'''Значение key''' - значение параметр
+'''Значение key''' - значение параметра
 '''Добавлять к''' - данная настройка позволяет указывать как передавать ваш параметр.
@@ Строка 36: / Строка 36: @@
 *Query Params* - в данном случае вместо XML шлется form-data с двумя параметрами: xml - XML тело и ваш параметр
 == Формат данных в адрес получателя вебхука ==

← Предыдущая		Версия 02:58, 22 октября 2025
Строка 13:		Строка 13:
	В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.		В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.

		+	== Авторизация ==
		+	Интеграция поддерживает 3 типа авторизации
		+
		+	=== Basic Auth ===
		+	Укажите '''Username''' и '''Password''' для Basic Auth авторизации
		+
		+	=== Bearer Token ===
		+	Укажите '''Token ''' для Bearer Token авторизации
		+
		+	=== API Key ===
		+	Данный тип авторизации позволяет передавать любой параметр в авторизации
		+
		+	'''Название key''' - название параметр
		+
		+	'''Значение key''' - значение параметр
		+
		+	'''Добавлять к''' - данная настройка позволяет указывать как передавать ваш параметр.
		+
		+	Можно передавать параметр в
		+
		+	Headers - в данном случае параметры добавляются в Headers
		+
		+	Query Params - в данном случае вместо XML шлется form-data с двумя параметрами: xml - XML тело и ваш параметр

−	~~== Авторизация ==~~
−	В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.

	== Формат данных в адрес получателя вебхука ==		== Формат данных в адрес получателя вебхука ==

← Предыдущая		Версия 02:45, 22 октября 2025
Строка 11:		Строка 11:

	== Настройка ==		== Настройка ==
		+	В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.
		+
		+
		+	== Авторизация ==
	В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.		В разделе [[Личный_кабинет_клиента#Интеграция\|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.

@@ Строка 89: / Строка 89: @@
 В случае успешной обработки вебхука, наша система ожидает от вас именно такой ответ:
 </div>
-Обязательный ответ:
+Обязательный ответ (он сообщает, что вы получили наш вебхук. Как вы будете обрабатывать эти данные и будете ли обрабатывать их вообще не имеет значения дня нашей системы):
 <source lang=json>
+{

@@ Строка 2: / Строка 2: @@
 Webhook передает данные по заказам и статусам на ваш URL.
-Важно понимать, что на обработку вебхуков уходит время.
+Важно понимать, что на обработку очереди всех вебхуков, включая ваш, уходит время.
-За 1 раз наша система забирает максимум 100 ваших изменений. По нашим средним подсчетом на обработку и отправка этих данных может уйти 2 - 4 минуты.
+За 1 раз наша система забирает максимум 100 ваших изменений. По нашим средним подсчетам на обработку и отправку этих данных может уйти 2 - 4 минуты.
 Также нужно понимать, что вебхуки всех клиентов обрабатываются поочередно. То есть, сначала обрабатываются заказы по вебхуку первого клиента, потом заказы по вебхуку второго клиента, потом заказы по вебхуку третьего клиента и тд.
-Таким образом, 100 ваших изменений вы будете получать не каждые 4 минуты, а только после того, как до вас снова дойдет ваша очередь.
+Таким образом, 100 ваших изменений вы будете получать не каждые 4 минуты, а только после того, как до вас снова дойдет ваша очередь. Это может происходить и каждые 4 минуты, если у других клиентов не было множества изменений по заказам.
 == Настройка ==
-Чтобы создать оповещение о статусах на ваш URL, в разделе [[Личный_кабинет_клиента#Интеграция|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять уведомление.
+В разделе [[Личный_кабинет_клиента#Интеграция|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять вам данные.
-== Формат сообщений в адрес получателя вебхука ==
+== Формат данных в адрес получателя вебхука ==
 Пример запроса:
 <source lang=xml>

@@ Строка 6: / Строка 6: @@
 За 1 раз наша система забирает максимум по 100 ваших изменений. По нашим средним подсчетом на это может уйти 2 - 4 минуты.
-Также нужно понимать, что вебхуки всех клиентов обрабатываются поочередно. То есть, сначала обрабатываются заказы по вебхукам первого клиента, потом заказы по вебхукам второго клиента, потом заказы по вебхукам третьего клиентаи тд. Таким образом, 100 ваших изменений вы будете получать не каждые 4 минуты, а только после того, как до вас снова дойдет ваша очередь.
+Также нужно понимать, что вебхуки всех клиентов обрабатываются поочередно. То есть, сначала обрабатываются заказы по вебхукам первого клиента, потом заказы по вебхукам второго клиента, потом заказы по вебхукам третьего клиентаи тд.
 == Настройка ==

@@ Строка 1: / Строка 1: @@
-'''Webhook передает данные по заказам и статусам на ваш URL.'''
+== Принцип работы ==
 Чтобы создать оповещение о статусах на ваш URL, в разделе [[Личный_кабинет_клиента#Интеграция|"Интеграции"]] создайте интеграцию с типом "Webhook". В настройках укажите URL на который мы будем отправлять уведомление.
+== Формат сообщений в адрес получателя вебхука ==
 Пример запроса:
 <source lang=xml>
@@ Строка 76: / Строка 83: @@
 Подробное описание '''контейнера order''' вы можете увидеть на [[API#Примеры ответов 2|этой странице]]
+== Формат ответа от получателя вебхука ==
 <div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
 В случае успешной обработки вебхука, наша система ожидает от вас именно такой ответ:

← Предыдущая		Версия 08:41, 12 декабря 2024
Строка 5:		Строка 5:


−	Пример запроса~~, который мы пошлем вам~~ вы можете увидеть на [[API#Примеры ответов\|этой странице]]	+	Пример запроса:
		+	<source lang=xml>
		+	<?xml version="1.0"?>
		+	<order orderno="00032011" awb="00032011" orderno2="" ordercode="0000032" givencode="">
		+	<barcode>00032011</barcode>
		+	<sender>
		+	<company>TEST</company>
		+	<date/>
		+	<time_min/>
		+	<time_max/>
		+	</sender>
		+	<receiver>
		+	<company>TEST2</company>
		+	<person/>
		+	<phone>+7 (495) 000-00-00</phone>
		+	<contacts>
		+	<phone>+74950000000</phone>
		+	</contacts>
		+	<inn/>
		+	<zipcode/>
		+	<date>2022-01-21</date>
		+	<time_min/>
		+	<time_max/>
		+	<coords lat="55.7287" lon="37.6447"/>
		+	<deliveryPIN/>
		+	</receiver>
		+	<pickup>NO</pickup>
		+	<return>YES</return>
		+	<weight>0.4</weight>
		+	<return_weight/>
		+	<quantity>1</quantity>
		+	<paytype>NO</paytype>
		+	<print_check>YES</print_check>
		+	<service>1</service>
		+	<return_service>1</return_service>
		+	<type>1</type>
		+	<return_type>1</return_type>
		+	<waittime>0</waittime>
		+	<price>0.00</price>
		+	<inshprice>0.00</inshprice>
		+	<enclosure/>
		+	<instruction/>
		+	<basestatus code="0"/>
		+	<currcoords lat="" lon="" accuracy="" RequestDateTime=""/>
		+	<receiverpays>NO</receiverpays>
		+	<acceptpartially>YES</acceptpartially>
		+	<status eventstore="NEW" eventtime="2022-01-20 17:08:43" createtimegmt="2022-01-20 17:08:43" message="" title="new">NEW</status>
		+	<statushistory>
		+	<status eventstore="NEW" eventtime="2022-01-20 17:08:43" createtimegmt="2022-01-20 17:08:43" message="" title="NEW" country="RU">NEW</status>
		+	</statushistory>
		+	<customstatecode>1</customstatecode>
		+	<clientstatecode/>
		+	<department/>
		+	<return_message/>
		+	<deliveredto/>
		+	<delivereddate/>
		+	<deliveredtime/>
		+	<outstrbarcode/>
		+	<arrival/>
		+	<costcode/>
		+	<receipt/>
		+	<items>
		+	</items>
		+	<packages>
		+	</packages>
		+	<webhook_status_code>NEW</webhook_status_code>
		+	</order>
		+	</source>
		+
		+	Подробное описание '''контейнера order''' вы можете увидеть на [[API#Примеры ответов 2\|этой странице]]