Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 37.3
отредактировано Dmitriy
на 2025/02/19 08:59
на 2025/02/19 08:59
Изменить комментарий:
Update document after refactoring.
К версии 44.1
отредактировано Ярослава Ерина
на 2026/02/09 10:37
на 2026/02/09 10:37
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (3 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Родительский документ
-
... ... @@ -1,1 +1,1 @@ 1 -vneshnie_api. Внешние наливы.WebHome1 +vneshnie_api.vneshnie_nalivy2.WebHome - Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.erin_ ds1 +XWiki.erina_jv - Содержимое
-
... ... @@ -2,16 +2,21 @@ 2 2 3 3 == Настройка перед интеграцией == 4 4 5 +~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ef]] 5 5 6 -Перед началом интеграции, уполномоченный сотрудник компании, предоставляющей услуги внешних наливов (далее Интегратор), передает в ООО "Топаз-сервис" следующую информацию: 7 +2. Перейдите по ссылке из письма для подтверждения учетной записи. 8 +3. Авторизуйтесь в Топаз Web-Office ([[https:~~/~~/topazoffice.ru/#/login>>https://topazoffice.ru/#/login]]) 9 +4. В открывшейся форме заполните поля: 7 7 8 - 1.Базовый url тестового окружения системы внешнего налива9 - 1.Список ip адресов, с которых будут приходить запросы от тестового окружения системы внешнего налива10 - 1.Базовый url боевого окружения системы внешнего налива11 - 1.Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива12 - 1.Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис"13 - 1.Иконку системы внешних наливов в формате svg с соотношением сторон 1:111 +* Базовый url тестового окружения системы внешнего налива 12 +* Список ip адресов, с которых будут приходить запросы от тестового окружения системы внешнего налива 13 +* Базовый url боевого окружения системы внешнего налива 14 +* Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива 15 +* Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис" 16 +* Иконку системы внешних наливов в формате svg с соотношением сторон 1:1 14 14 18 +5. Нажмите на кнопку "Создать", после этого вы получите уникальный API-ключ в соответствующем поле. 19 + 15 15 После получения информации по указанным пунктам, от ООО "Топаз-сервис" будет предоставлен тестовый доступ для настройки интеграции. 16 16 17 17 Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в "Топаз-Web Office". ... ... @@ -144,10 +144,12 @@ 144 144 { 145 145 // Идентификатор заказа 146 146 String Id 147 -// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 152 +// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z', yyyy-MM-dd'T'HH:mm:ss.SSS'Z', либо yyyy-MM-dd HH:mm:ss 148 148 String DateCreate 149 149 // идентификатор станции АЗС 150 150 String StationExtendedId 156 +// Идентификатор АЗС в системе Интегратора (Необязательное поле) 157 +String StationId 151 151 // Тип заказа 152 152 String OrderType 153 153 // номер стороны (поста) ... ... @@ -164,7 +164,7 @@ 164 164 double SumPaid 165 165 // Статус заказа 166 166 OrderStatus Status 167 -// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 174 +// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z', yyyy-MM-dd'T'HH:mm:ss.SSS'Z', либо yyyy-MM-dd HH:mm:ss 168 168 String DateEnd 169 169 // Идентификатор причины отмены заказа 170 170 String ReasonId ... ... @@ -225,6 +225,13 @@ 225 225 **FuelId **+ **PriceFuel **– в случае если стоимость топлива в Топаз "Web Офис" отличается от присланной, то Топаз "Web Офис" дает ответ **402.** 226 226 227 227 235 +== Отмена заказа == 236 + 237 +Отмена заказа возможна даже после его старта. Для инициации отмены необходимо отправить тот же заказ со статусом (% style="background-color:#dddddd; font-family:Courier New,Courier,monospace" %)**UserCanceled**(%%). Если на момент получения запроса на отмену процесс налива ещё не начался, заказ будет отменён. 238 + 239 +В случае, если отмена инициирована после начала налива, система остановит процесс пролива и зафиксирует заказ как отменённый. В этом случае в ответе будет указано количество литров, фактически налитых до момента остановки. 240 + 241 + 228 228 == Проверка статуса работы станции == 229 229 230 230 Перед формирование заказ внешняя система делает запрос на станцию для определения доступности и готовности станции принять заказ **baseUrl **с префиксом