Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/08/28 10:53
От версии 45.1
отредактировано Ярослава Ерина
на 2026/02/09 11:36
на 2026/02/09 11:36
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (2 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.erin a_jv1 +XWiki.erin_ds - Содержимое
-
... ... @@ -4,7 +4,7 @@ 4 4 5 5 Для начала работы необходимо зарегистрироваться в Личном кабинете Интегратора 6 6 7 -~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ sc]]7 +~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ef]] 8 8 9 9 2. После ввода логина и пароля на почту будет отправлено письмо для подтверждения регистрации 10 10 ... ... @@ -43,7 +43,7 @@ 43 43 44 44 ---- 45 45 46 -== **Методы API "Топаз-Web Office":** ==46 +== **Методы API "Топаз-Web Офис":** == 47 47 48 48 1. **Получение списка АЗС и их конфигураций** 49 49 1. **Получение прайс-листа** ... ... @@ -238,7 +238,6 @@ 238 238 239 239 Отмена заказа возможна даже после его старта. Для инициации отмены необходимо отправить тот же заказ со статусом (% style="background-color:#dddddd; font-family:Courier New,Courier,monospace" %)**UserCanceled**(%%). Если на момент получения запроса на отмену процесс налива ещё не начался, заказ будет отменён. 240 240 241 -В случае, если отмена инициирована после начала налива, система остановит процесс пролива и зафиксирует заказ как отменённый. В этом случае в ответе будет указано количество литров, фактически налитых до момента остановки. 242 242 243 243 244 244 == Проверка статуса работы станции == ... ... @@ -269,14 +269,25 @@ 269 269 270 270 == **Методы REST API интегратора (внешней системы):** == 271 271 271 + 272 + 273 +=== Получение статусов от Топаз Web-офис === 274 + 275 + 276 + 272 272 1. **Статус Accepted** 273 273 1. **Статус Fueling** 274 274 1. **Статус Canceled** 275 275 1. **Статус Completed** 276 -1. **Отправка счетчика налива** 281 +1. **Отправка счетчика налива Volume** 277 277 278 278 Данные запросы "Топаз-Web Office" отправляет Интегратору. 279 279 285 +(% class="box infomessage" %) 286 +((( 287 +##**Все методы, отправляющие статусы заказа (**##**Accepted, Fueling, Canceled, Completed, Volume),## отправляют данные в теле в формате x-www-form-urlencoded##** 288 +))) 289 + 280 280 === **Статус Accepted** === 281 281 282 282 Данный статус сообщает внешней системе о том, что заказ принят и обработан в "Топаз-Web Office" ... ... @@ -337,12 +337,16 @@ 337 337 338 338 **baseUrl + /api/order/completed POST** 339 339 340 -**apikey={apikey}&orderId={ordeId}&litre={litre}&extendedOrderId={extendedOrderId}&extendedDate={extendedDate}** 350 +**apikey={apikey}&orderId={ordeId}&litre={litre}&summ={summ}&extendedOrderId={extendedOrderId}&extendedDate={extendedDate}** 341 341 342 342 все параметры являются обязательными 343 343 344 -**litre **– кол-во пролитых литров, указывается как **double **с разделителем точка **extendedOrderId **– идентификатор заказа в АСУ сети354 +**litre **– кол-во пролитых литров, указывается как **double **с разделителем точка, 345 345 356 +**summ **- итоговая сумма заказа, 357 + 358 +**extendedOrderId **– идентификатор заказа в АСУ сети 359 + 346 346 **extendedDate **– дата по которой АСУ строит отчет для сверки, формат **dd.MM.yyyy HH:mm:ss** 347 347 348 348 === === ... ... @@ -362,3 +362,10 @@ 362 362 все параметры являются обязательными 363 363 364 364 **litre **– кол-во пролитых на момент отправки запроса литров, указывается как double с разделителем точка 379 + 380 + 381 +=== Отправка статусов в Топаз Web Офис === 382 + 383 +Для согласованности заказов после каждого полученного статуса от Топаз Web Офис необходимо отправить статус в системе Интегратора. 384 +Для этого необходимо повторить запрос **/order, **с измененными полями **OrderStatus, **в соответствии с состоянием заказа в системе Интегратора. 385 +При отправке статуса **Completed **допускается присылать размер реально налитых литров и оплаченных средств **LitreCompleted, SumPaidCompleted**