Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 15.1
отредактировано Ярослава Ерина
на 2024/09/18 06:42
на 2024/09/18 06:42
Изменить комментарий:
К данной версии нет комментариев
К версии 11.1
отредактировано Ярослава Ерина
на 2024/07/30 06:30
на 2024/07/30 06:30
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -16,10 +16,6 @@ 16 16 17 17 Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в Топаз "Web Офис". Данный ключ необходимо будет передавать во всех запросах от внешней системы в Топаз "Web Офис" в заголовке externalSystemApikey 18 18 19 -== Адрес для отправки запросов == 20 - 21 -Базовым адресом (baseUrl) для выполнения запросов является https:~/~/topazoffice.ru/ms/external-fueling/integration 22 - 23 23 == Получение списка АЗС и их конфигураций == 24 24 25 25 Внешняя система опрашивает Топаз "Web Офис" для получения списка АЗС и их конфигураций **через HTTP **запрос на **url **с префиксом **/integration/station?apikey={apikey **}, запрос типа **GET **, timeout 10 секунд. ... ... @@ -93,17 +93,24 @@ 93 93 {{/code}} 94 94 95 95 96 - 97 -**Пример ответа**{{{}}} 98 - 99 99 {{code language="javascript"}} 100 -{ 101 -{“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, 102 -{“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, 103 -{“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, 93 +{ 94 +{ 95 +// идентификатор станции внутри Топаз "Web Офис" 96 +string StationId, 97 +// идентификатор топлива 98 +string ProductId, 99 +// цена за 1 литр 100 +double Price 101 +}, …. N 104 104 } 105 105 {{/code}} 106 106 105 + 106 +**Пример ответа** 107 + 108 +{{{{ {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, }}}} 109 + 107 107 == Обработка заказа == 108 108 109 109 [[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]] ... ... @@ -111,46 +111,9 @@ 111 111 Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд. 112 112 113 113 114 -**Тело запроса содержит JSON вида Order** {{{}}}117 +**Тело запроса содержит JSON вида Order** 115 115 116 -{{code language="none"}} 117 -{ 118 -// идентификатор заказа 119 -string Id 120 -// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 121 -String DateCreate 122 -// значение заказа 123 -double OrderVolume 124 -// идентификатор станции АЗС 125 -string StationExtendedId 126 -// номер колонки 127 -int ColumnId 128 -// идентификатор топлива 129 -string FuelId 130 -// стоимость 1 литра топлива 131 -double PriceFuel 132 -// сумма заказа 133 -double Sum 134 -// кол-во литров 135 -double Litre 136 -// итого оплачено 137 -double SumPaid 138 -// статус заказа 139 -OrderStatus Status 140 -// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 141 -String DateEnd 142 -// идентификатор причины отмены заказа 143 -string ReasonId 144 -// причина отмены 145 -string Reason 146 -// итого сумма литров залито 147 -double LitreCompleted 148 -// итого оплачено по завершению заказа 149 -double SumPaidCompleted 150 -// идентификатор договора 151 -string ContractId 152 -} 153 -{{/code}} 119 +{{{{ // идентификатор заказа string Id // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss String DateCreate // значение заказа double OrderVolume // идентификатор станции АЗС string StationExtendedId // номер колонки int ColumnId // идентификатор топлива string FuelId // стоимость 1 литра топлива double PriceFuel // сумма заказа double Sum // кол-во литров double Litre // итого оплачено double SumPaid // статус заказа OrderStatus Status // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss String DateEnd // идентификатор причины отмены заказа string ReasonId // причина отмены string Reason // итого сумма литров залито double LitreCompleted // итого оплачено по завершению заказа double SumPaidCompleted // идентификатор договора string ContractId }}}} 154 154 155 155 Параметр **OrderType **– тип заказа может принимать следующие значения: 156 156