Перейти к содержимому
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 27.1
отредактировано Ярослава Ерина
на 2024/12/11 12:27
Изменить комментарий: К данной версии нет комментариев
К версии 36.2
отредактировано Ярослава Ерина
на 2025/01/17 07:38
Изменить комментарий: Update document after refactoring.

Сводка

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Main.WebHome
1 +Внешние API.Внешние наливы.WebHome
Содержимое
... ... @@ -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="background-color:#e5e4e2; border-color:black" %)ID|(% style="background-color:#e5e4e2; 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" может сообщать внешней системе статус счетчика налива