Перейти к содержимому
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 27.1
отредактировано Ярослава Ерина
на 2024/12/11 12:27
Изменить комментарий: К данной версии нет комментариев
К версии 33.1
отредактировано Ярослава Ерина
на 2024/12/11 12:58
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -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  (((
23 -=== **Данный ключ необходимо будет передавать во всех запросах от внешней системы в "Топаз-Web Office" в заголовке (header) externalSystemApikey** ===
21 +(% class="wikigeneratedid" id="H41443043D43D44B43943A43B44E44743D43543E43144543E43443843C43E43144343443544243F43544043543443043243044244C43243E43244143544543743043F44043E44143044543E44243243D43544843D43543944143844144243543C44B4322242243E43F430437-WebOffice2243243743043343E43B43E43243A43528header29externalSystemApikey" %)
22 +(((
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  
... ... @@ -93,6 +93,8 @@
93 93  |propane|газ пропан
94 94  |metan|метан
95 95  
98 +== ==
99 +
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  
130 +== ==
131 +
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]]
134 +[[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"}}
... ... @@ -268,6 +268,8 @@
268 268  
269 269  все параметры являются обязательными
270 270  
275 +=== ===
276 +
271 271  === **Статус Fueling** ===
272 272  
273 273  Данный статус сообщает внешней системе о том, что "Топаз-Web Office" готов запустить колонку (начать пролив)
... ... @@ -284,6 +284,8 @@
284 284  
285 285  все параметры являются обязательными
286 286  
293 +=== ===
294 +
287 287  === **Статус Canceled** ===
288 288  
289 289  Данный статус сообщает внешней системе о том, что заказ следует отменить
... ... @@ -298,6 +298,8 @@
298 298  
299 299  **reason – **текстовая причина отмены
300 300  
309 +=== ===
310 +
301 301  === **Статус Completed** ===
302 302  
303 303  Данный статус сообщает внешней системе о том, что заказ выполнен и топливо залито
... ... @@ -314,6 +314,8 @@
314 314  
315 315  **extendedDate **– дата по которой АСУ строит отчет для сверки, формат **dd.MM.yyyy HH:mm:ss**
316 316  
327 +=== ===
328 +
317 317  === **Отправка счетчика налива** ===
318 318  
319 319  В момент процесса налива "Топаз-Web Office" может сообщать внешней системе статус счетчика налива