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

Сводка

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

Подробности

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

Родительский документ

...	...	@@ -1,1 +1,1 @@
1		-Внешние API.Внешние наливы.WebHome
	1	+Main.WebHome

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

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

Содержимое

...	...	@@ -1,3 +1,5 @@
	1	+{{toc/}}
	2	+
1	1	v 1.0.1
2	2
3	3	== Настройка перед интеграцией ==
...	...	@@ -20,7 +20,7 @@
20	20	(((
21	21	(% class="wikigeneratedid" id="H41443043D43D44B43943A43B44E44743D43543E43144543E43443843C43E43144343443544243F43544043543443043243044244C43243E43244143544543743043F44043E44143044543E44243243D43544843D43543944143844144243543C44B4322242243E43F430437-WebOffice2243243743043343E43B43E43243A43528header29externalSystemApikey" %)
22	22	(((
23		-=== **Данный ключ необходимо будет передавать во всех запросах от внешней системы в "Топаз-Web Office" в заголовке (header) externalSystemApikey** ===
	25	+**Данный ключ необходимо будет передавать во всех запросах от внешней системы в "Топаз-Web Office" в заголовке (header) externalSystemApikey**
24	24	)))
25	25	)))
26	26
...	...	@@ -34,7 +34,6 @@
34	34
35	35	Базовым адресом **(baseUrl)** для выполнения запросов является [[https:~~/~~/topazoffice.ru/ms/external-fueling/integration>>https://topazoffice.ru/ms/external-fueling/integration]]
36	36
37		-----
38	38
39	39	== **Методы API "Топаз-Web Office":** ==
40	40
...	...	@@ -80,8 +80,7 @@
80	80
81	81	**Возможные идентификаторы топлива**
82	82
83		-(% border="1" %)
84		-|(% style="background-color:#e5e4e2; border-color:black" %)ID|(% style="background-color:#e5e4e2; border-color:black" %)Марка
	84	+|ID|Марка
85	85	|diesel|дизель
86	86	|diesel_premium|брендированный дизель
87	87	|a80|бензин марки А80
...	...	@@ -96,8 +96,6 @@
96	96	|propane|газ пропан
97	97	|metan|метан
98	98
99		-== ==
100		-
101	101	== Получение прайс-листа ==
102	102
103	103	Внешняя система опрашивает "Топаз-Web Office" для получения прайс-листа **HTTP **запросом на **baseUrl **с префиксом **/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд.
...	...	@@ -108,18 +108,17 @@
108	108	{
109	109	{
110	110	// идентификатор станции внутри Топаз "Web Офис"
111		- string stationId,
	109	+ string StationId,
112	112	// идентификатор топлива
113		- string productId,
	111	+ string ProductId,
114	114	// цена за 1 литр
115		- double price
116		- // Внешний код топлива
117		- string fuelExtendedId
	113	+ double Price
118	118	},
119	119	…. N
120	120	}
121	121	{{/code}}
122	122
	119	+
123	123	**Пример ответа**{{{}}}
124	124
125	125	{{code language="javascript"}}
...	...	@@ -130,14 +130,13 @@
130	130	}
131	131	{{/code}}
132	132
133		-== ==
134		-
135	135	== Получение и обработка заказа ==
136	136
137		-[[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2||data-xwiki-image-style-border="true"]]
	132	+[[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]]
138	138
139	139	Информирование "Топаз-Web Office" о заказе и их статусах осуществляется **HTTP **запросом на **baseUrl **с префиксом **/order **, запрос типа **POST **, timeout 10 секунд.
140	140
	136	+
141	141	**Тело запроса содержит JSON вида Order{{{}}}**
142	142
143	143	{{code language="javascript" layout="LINENUMBERS"}}
...	...	@@ -241,10 +241,8 @@
241	241
242	242	**200 ОК **– станция и ТРК готова принять и обработать заказ
243	243
244		-**400 **– станция или ТРК не найдена (неверный идентификатор станции или ТРК)
	240	+**400 **– станция или ТРК не найдена (не верный идентификатор станции или ТРК) **404 **– ТРК занята / ТРК не готова принять заказ
245	245
246		-**404 **– ТРК занята / ТРК не готова принять заказ
247		-
248	248	любой ответ не **200 ОК **– интерпретируется как на станции нет интернета / станция не доступна
249	249
250	250	----
...	...	@@ -277,8 +277,6 @@
277	277
278	278	все параметры являются обязательными
279	279
280		-=== ===
281		-
282	282	=== **Статус Fueling** ===
283	283
284	284	Данный статус сообщает внешней системе о том, что "Топаз-Web Office" готов запустить колонку (начать пролив)
...	...	@@ -295,8 +295,6 @@
295	295
296	296	все параметры являются обязательными
297	297
298		-=== ===
299		-
300	300	=== **Статус Canceled** ===
301	301
302	302	Данный статус сообщает внешней системе о том, что заказ следует отменить
...	...	@@ -311,8 +311,6 @@
311	311
312	312	**reason – **текстовая причина отмены
313	313
314		-=== ===
315		-
316	316	=== **Статус Completed** ===
317	317
318	318	Данный статус сообщает внешней системе о том, что заказ выполнен и топливо залито
...	...	@@ -329,8 +329,6 @@
329	329
330	330	**extendedDate **– дата по которой АСУ строит отчет для сверки, формат **dd.MM.yyyy HH:mm:ss**
331	331
332		-=== ===
333		-
334	334	=== **Отправка счетчика налива** ===
335	335
336	336	В момент процесса налива "Топаз-Web Office" может сообщать внешней системе статус счетчика налива