Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"

Сводка

• Свойства страницы (2 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Автор документа

...	...	@@ -1,1 +1,1 @@
1		-XWiki.erina_jv
	1	+XWiki.erin_ds

Содержимое

...	...	@@ -2,25 +2,27 @@
2	2
3	3	== Настройка перед интеграцией ==
4	4
5		-~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ef]]
	5	+Для начала работы необходимо зарегистрироваться в Личном кабинете Интегратора
6	6
7		-2. Перейдите по ссылке из письма для подтверждения учетной записи.
8		-3. Авторизуйтесь в Топаз Web-Office (ссылка на авторизаию)
9		-4. В открывшейся форме заполните поля:
	7	+~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ef]]
10	10
	9	+2. После ввода логина и пароля на почту будет отправлено письмо для подтверждения регистрации
	10	+
	11	+3. Перейдите по ссылке из письма для подтверждения учетной записи.
	12	+
	13	+4. Авторизуйтесь в Топаз Web-Office ([[https:~~/~~/topazoffice.ru/#/login>>url:https://topazoffice.ru/#/login]] )
	14	+
	15	+5. В открывшейся форме заполните поля:
	16	+
	17	+* Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис"
	18	+* Прикрепите иконку Вашей системы  в формате svg с соотношением сторон 1:1. Эти название и иконку будут видеть конечные клиенты  в Топаз "Web Офис"
11	11	* Базовый url тестового окружения системы внешнего налива
12	12	* Список ip адресов, с которых будут приходить запросы от тестового окружения системы внешнего налива
13	13	* Базовый url боевого окружения системы внешнего налива
14	14	* Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива
15		-* Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис"
16		-* Иконку системы внешних наливов в формате svg с соотношением сторон 1:1
17	17
18		-5. Нажмите на кнопку "Создать", после этого вы получите уникальный API-ключ в соответствующем поле.
	24	+6. Нажмите на кнопку "Создать", после этого вы получите уникальный API-ключ, он отобразится в соответствующем поле.
19	19
20		-После получения информации по указанным пунктам, от ООО "Топаз-сервис" будет предоставлен тестовый доступ для настройки интеграции.
21		-
22		-Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в "Топаз-Web Office".
23		-
24	24	(% class="box errormessage" %)
25	25	(((
26	26	(% class="wikigeneratedid" id="H41443043D43D44B43943A43B44E44743D43543E43144543E43443843C43E43144343443544243F43544043543443043243044244C43243E43244143544543743043F44043E44143044543E44243243D43544843D43543944143844144243543C44B4322242243E43F430437-WebOffice2243243743043343E43B43E43243A43528header29externalSystemApikey" %)
...	...	@@ -41,7 +41,7 @@
41	41
42	42	----
43	43
44		-== **Методы API "Топаз-Web Office":** ==
	46	+== **Методы API "Топаз-Web Офис":** ==
45	45
46	46	1. **Получение списка АЗС и их конфигураций**
47	47	1. **Получение прайс-листа**
...	...	@@ -267,14 +267,25 @@
267	267
268	268	== **Методы REST API интегратора (внешней системы):** ==
269	269
	272	+
	273	+
	274	+=== Получение статусов от Топаз Web-офис ===
	275	+
	276	+
	277	+
270	270	1. **Статус Accepted**
271	271	1. **Статус Fueling**
272	272	1. **Статус Canceled**
273	273	1. **Статус Completed**
274		-1. **Отправка счетчика налива**
	282	+1. **Отправка счетчика налива Volume**
275	275
276	276	Данные запросы "Топаз-Web Office" отправляет Интегратору.
277	277
	286	+(% class="box infomessage" %)
	287	+(((
	288	+##**Все методы, отправляющие статусы заказа (**##**Accepted, Fueling, Canceled, Completed, Volume),## отправляют данные в теле в формате x-www-form-urlencoded##**
	289	+)))
	290	+
278	278	=== **Статус Accepted** ===
279	279
280	280	Данный статус сообщает внешней системе о том, что заказ принят и обработан в "Топаз-Web Office"
...	...	@@ -335,12 +335,16 @@
335	335
336	336	**baseUrl + /api/order/completed POST**
337	337
338		-**apikey={apikey}&orderId={ordeId}&litre={litre}&extendedOrderId={extendedOrderId}&extendedDate={extendedDate}**
	351	+**apikey={apikey}&orderId={ordeId}&litre={litre}&summ={summ}&extendedOrderId={extendedOrderId}&extendedDate={extendedDate}**
339	339
340	340	все параметры являются обязательными
341	341
342		-**litre **– кол-во пролитых литров, указывается как **double **с разделителем точка **extendedOrderId **– идентификатор заказа в АСУ сети
	355	+**litre **– кол-во пролитых литров, указывается как **double **с разделителем точка,
343	343
	357	+**summ **- итоговая сумма заказа,
	358	+
	359	+**extendedOrderId **– идентификатор заказа в АСУ сети
	360	+
344	344	**extendedDate **– дата по которой АСУ строит отчет для сверки, формат **dd.MM.yyyy HH:mm:ss**
345	345
346	346	=== ===
...	...	@@ -360,3 +360,10 @@
360	360	все параметры являются обязательными
361	361
362	362	**litre **– кол-во пролитых на момент отправки запроса литров, указывается как double с разделителем точка
	380	+
	381	+
	382	+=== Отправка статусов в Топаз Web Офис ===
	383	+
	384	+Для согласованности заказов после каждого полученного статуса от Топаз Web Офис необходимо отправить статус в системе Интегратора.
	385	+Для этого необходимо повторить запрос **/order, **с измененными полями **OrderStatus, **в соответствии с состоянием заказа в системе Интегратора.
	386	+При отправке статуса **Completed **допускается присылать размер реально налитых литров и оплаченных средств **LitreCompleted, SumPaidCompleted**