Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 43.1
отредактировано Ярослава Ерина
на 2026/02/09 10:34
на 2026/02/09 10:34
Изменить комментарий:
К данной версии нет комментариев
К версии 38.1
отредактировано Ярослава Ерина
на 2025/06/05 07:18
на 2025/06/05 07:18
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -2,21 +2,17 @@ 2 2 3 3 == Настройка перед интеграцией == 4 4 5 -~1. Для регистрации пройдите по ссылке: [[https:~~/~~/topazoffice.ru/#/auth/integrator-registration/ef>>https://topazoffice.ru/#/auth/integrator-registration/ef]] 6 6 7 -2. Перейдите по ссылке из письма для подтверждения учетной записи. 8 -3. Авторизуйтесь в Топаз Web-Office (ссылка на авторизаию) 9 -4. В открывшейся форме заполните поля: 6 +Перед началом интеграции, уполномоченный сотрудник компании, предоставляющей услуги внешних наливов (далее Интегратор), передает в ООО "Топаз-сервис" следующую информацию: 10 10 11 -* Базовый url тестового окружения системы внешнего налива 12 -* Список ip адресов, с которых будут приходить запросы от тестового окружения системы внешнего налива 13 -* Базовый url боевого окружения системы внешнего налива 14 -* Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива 15 -* Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис" 16 -* Иконку системы внешних наливов в формате svg с соотношением сторон 1:1 8 +1. Базовый url тестового окружения системы внешнего налива 9 +1. Список ip адресов, с которых будут приходить запросы от тестового окружения системы внешнего налива 10 +1. Базовый url боевого окружения системы внешнего налива 11 +1. Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива 12 +1. Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис" 13 +1. Иконку системы внешних наливов в формате svg с соотношением сторон 1:1 14 +1. Email, на который будет зарегистрирован личный кабинет интегратора 17 17 18 -5. Нажмите на кнопку "Создать", после этого вы получите уникальный API-ключ в соответствующем поле. 19 - 20 20 После получения информации по указанным пунктам, от ООО "Топаз-сервис" будет предоставлен тестовый доступ для настройки интеграции. 21 21 22 22 Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в "Топаз-Web Office". ... ... @@ -149,12 +149,10 @@ 149 149 { 150 150 // Идентификатор заказа 151 151 String Id 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:ss148 +// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 153 153 String DateCreate 154 154 // идентификатор станции АЗС 155 155 String StationExtendedId 156 -// Идентификатор АЗС в системе Интегратора (Необязательное поле) 157 -String StationId 158 158 // Тип заказа 159 159 String OrderType 160 160 // номер стороны (поста) ... ... @@ -171,7 +171,7 @@ 171 171 double SumPaid 172 172 // Статус заказа 173 173 OrderStatus Status 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:ss168 +// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 175 175 String DateEnd 176 176 // Идентификатор причины отмены заказа 177 177 String ReasonId ... ... @@ -232,13 +232,6 @@ 232 232 **FuelId **+ **PriceFuel **– в случае если стоимость топлива в Топаз "Web Офис" отличается от присланной, то Топаз "Web Офис" дает ответ **402.** 233 233 234 234 235 -== Отмена заказа == 236 - 237 -Отмена заказа возможна даже после его старта. Для инициации отмены необходимо отправить тот же заказ со статусом (% style="background-color:#dddddd; font-family:Courier New,Courier,monospace" %)**UserCanceled**(%%). Если на момент получения запроса на отмену процесс налива ещё не начался, заказ будет отменён. 238 - 239 -В случае, если отмена инициирована после начала налива, система остановит процесс пролива и зафиксирует заказ как отменённый. В этом случае в ответе будет указано количество литров, фактически налитых до момента остановки. 240 - 241 - 242 242 == Проверка статуса работы станции == 243 243 244 244 Перед формирование заказ внешняя система делает запрос на станцию для определения доступности и готовности станции принять заказ **baseUrl **с префиксом