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

Сводка

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

Подробности

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

Содержимое

...	...	@@ -1,5 +3,3 @@
1		-{{toc/}}
2		-
3	3	v 1.0.1
4	4
5	5	== Настройка перед интеграцией ==
...	...	@@ -20,8 +20,11 @@
20	20
21	21	(% class="box errormessage" %)
22	22	(((
	21	+(% class="wikigeneratedid" id="H41443043D43D44B43943A43B44E44743D43543E43144543E43443843C43E43144343443544243F43544043543443043243044244C43243E43244143544543743043F44043E44143044543E44243243D43544843D43543944143844144243543C44B4322242243E43F430437-WebOffice2243243743043343E43B43E43243A43528header29externalSystemApikey" %)
	22	+(((
23	23	=== **Данный ключ необходимо будет передавать во всех запросах от внешней системы в "Топаз-Web Office" в заголовке (header) externalSystemApikey** ===
24	24	)))
	25	+)))
25	25
26	26	== ApiKey ==
27	27
...	...	@@ -33,6 +33,7 @@
33	33
34	34	Базовым адресом **(baseUrl)** для выполнения запросов является [[https:~~/~~/topazoffice.ru/ms/external-fueling/integration>>https://topazoffice.ru/ms/external-fueling/integration]]
35	35
	37	+----
36	36
37	37	== **Методы API "Топаз-Web Office":** ==
38	38
...	...	@@ -78,7 +78,8 @@
78	78
79	79	**Возможные идентификаторы топлива**
80	80
81		-|ID|Марка
	83	+(% border="1" %)
	84	+|(% style="border-color:black" %)ID|(% style="border-color:black" %)Марка
82	82	|diesel|дизель
83	83	|diesel_premium|брендированный дизель
84	84	|a80|бензин марки А80
...	...	@@ -93,6 +93,8 @@
93	93	|propane|газ пропан
94	94	|metan|метан
95	95
	99	+== ==
	100	+
96	96	== Получение прайс-листа ==
97	97
98	98	Внешняя система опрашивает "Топаз-Web Office" для получения прайс-листа **HTTP **запросом на **baseUrl **с префиксом **/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд.
...	...	@@ -113,7 +113,6 @@
113	113	}
114	114	{{/code}}
115	115
116		-
117	117	**Пример ответа**{{{}}}
118	118
119	119	{{code language="javascript"}}
...	...	@@ -124,13 +124,14 @@
124	124	}
125	125	{{/code}}
126	126
	131	+== ==
	132	+
127	127	== Получение и обработка заказа ==
128	128
129		-[[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]]
	135	+[[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"]]
130	130
131	131	Информирование "Топаз-Web Office" о заказе и их статусах осуществляется **HTTP **запросом на **baseUrl **с префиксом **/order **, запрос типа **POST **, timeout 10 секунд.
132	132
133		-
134	134	**Тело запроса содержит JSON вида Order{{{}}}**
135	135
136	136	{{code language="javascript" layout="LINENUMBERS"}}
...	...	@@ -234,8 +234,10 @@
234	234
235	235	**200 ОК **– станция и ТРК готова принять и обработать заказ
236	236
237		-**400 **– станция или ТРК не найдена (не верный идентификатор станции или ТРК) **404 **– ТРК занята / ТРК не готова принять заказ
	242	+**400 **– станция или ТРК не найдена (неверный идентификатор станции или ТРК)
238	238
	244	+**404 **– ТРК занята / ТРК не готова принять заказ
	245	+
239	239	любой ответ не **200 ОК **– интерпретируется как на станции нет интернета / станция не доступна
240	240
241	241	----
...	...	@@ -268,6 +268,8 @@
268	268
269	269	все параметры являются обязательными
270	270
	278	+=== ===
	279	+
271	271	=== **Статус Fueling** ===
272	272
273	273	Данный статус сообщает внешней системе о том, что "Топаз-Web Office" готов запустить колонку (начать пролив)
...	...	@@ -284,6 +284,8 @@
284	284
285	285	все параметры являются обязательными
286	286
	296	+=== ===
	297	+
287	287	=== **Статус Canceled** ===
288	288
289	289	Данный статус сообщает внешней системе о том, что заказ следует отменить
...	...	@@ -298,6 +298,8 @@
298	298
299	299	**reason – **текстовая причина отмены
300	300
	312	+=== ===
	313	+
301	301	=== **Статус Completed** ===
302	302
303	303	Данный статус сообщает внешней системе о том, что заказ выполнен и топливо залито
...	...	@@ -314,6 +314,8 @@
314	314
315	315	**extendedDate **– дата по которой АСУ строит отчет для сверки, формат **dd.MM.yyyy HH:mm:ss**
316	316
	330	+=== ===
	331	+
317	317	=== **Отправка счетчика налива** ===
318	318
319	319	В момент процесса налива "Топаз-Web Office" может сообщать внешней системе статус счетчика налива