Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 7.1
отредактировано Ярослава Ерина
на 2024/07/30 05:32
на 2024/07/30 05:32
Изменить комментарий:
К данной версии нет комментариев
К версии 13.1
отредактировано Ярослава Ерина
на 2024/07/30 06:36
на 2024/07/30 06:36
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -24,23 +24,33 @@ 24 24 25 25 **...** 26 26 27 -**{{code language="javascript" layout="LINENUMBERS"}}{ 28 -// идентификатор станции АЗС string Id 29 -// статус станции: true – доступна, false – выключена bool Enable, 30 -// наименование станции string Name, 31 -// адрес станции string Address, 32 -// гео точка на карте location Location 33 -{ double Lat, double Lon }, // словарь доступных ТРК Dictionary Columns { 34 -// номер колонки (int32) Key: 27 +{{code language="javascript"}} 28 +{ 29 +// идентификатор станции АЗС 30 +string Id 31 +// статус станции: true – доступна, false – выключена 32 +bool Enable, 33 +// наименование станции 34 +string Name, 35 +// адрес станции 36 +string Address, 37 +// гео точка на карте 38 +location Location 35 35 { 40 +double Lat, 41 +double Lon }, 42 +// словарь доступных ТРК 43 +Dictionary Columns { 44 +// номер колонки 45 +(int32) Key: 46 +{ 36 36 // список доступных типов топлива 37 37 "Fuels": [ "a92", "a95", "diesel_premium", ... N ] 38 38 } 39 39 } ... N 40 -}{{/code}}** 51 +} 52 +{{/code}} 41 41 42 -{{{{ // идентификатор станции АЗС string Id // статус станции: true – доступна, false – выключена bool Enable, // наименование станции string Name, // адрес станции string Address, // гео точка на карте location Location { double Lat, double Lon }, // словарь доступных ТРК Dictionary Columns { // номер колонки (int32) Key: { // список доступных типов топлива "Fuels": [ "a92", "a95", "diesel_premium", ... N ] } } ... N }}}} 43 - 44 44 **Возможные идентификаторы топлива** 45 45 46 46 |ID|Марка ... ... @@ -62,18 +62,27 @@ 62 62 63 63 Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд. 64 64 65 -В ответ Топаз "Web Офис" дает ответ в формате **JSON** 75 +В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}} 66 66 67 -{{{{ { // идентификатор станции внутри Топаз "Web Офис" string StationId, // идентификатор топлива string ProductId, // цена за 1 литр double Price }, …. N }}}} 77 +{{code language="javascript"}} 78 +{ 79 + { 80 + // идентификатор станции внутри Топаз "Web Офис" 81 + string StationId, 82 + // идентификатор топлива 83 + string ProductId, 84 + // цена за 1 литр 85 + double Price 86 + }, 87 +…. N 88 +} 89 +{{/code}} 68 68 69 69 70 70 {{code language="javascript"}} 71 71 { 72 - 73 73 { 74 - 75 75 // идентификатор станции внутри Топаз "Web Офис" 76 - 77 77 string StationId, 78 78 // идентификатор топлива 79 79 string ProductId, ... ... @@ -84,9 +84,15 @@ 84 84 {{/code}} 85 85 86 86 87 -**Пример ответа** 106 +**Пример ответа**{{{}}} 88 88 89 -{{{{ {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, }}}} 108 +{{code language="javascript"}} 109 +{ 110 +{“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, 111 +{“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, 112 +{“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, 113 +} 114 +{{/code}} 90 90 91 91 == Обработка заказа == 92 92 ... ... @@ -95,9 +95,46 @@ 95 95 Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд. 96 96 97 97 98 -**Тело запроса содержит JSON вида Order** 123 +**Тело запроса содержит JSON вида Order**{{{}}} 99 99 100 -{{{{ // идентификатор заказа 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 }}}} 125 +{{code language="none"}} 126 +{ 127 +// идентификатор заказа 128 +string Id 129 +// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 130 +String DateCreate 131 +// значение заказа 132 +double OrderVolume 133 +// идентификатор станции АЗС 134 +string StationExtendedId 135 +// номер колонки 136 +int ColumnId 137 +// идентификатор топлива 138 +string FuelId 139 +// стоимость 1 литра топлива 140 +double PriceFuel 141 +// сумма заказа 142 +double Sum 143 +// кол-во литров 144 +double Litre 145 +// итого оплачено 146 +double SumPaid 147 +// статус заказа 148 +OrderStatus Status 149 +// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 150 +String DateEnd 151 +// идентификатор причины отмены заказа 152 +string ReasonId 153 +// причина отмены 154 +string Reason 155 +// итого сумма литров залито 156 +double LitreCompleted 157 +// итого оплачено по завершению заказа 158 +double SumPaidCompleted 159 +// идентификатор договора 160 +string ContractId 161 +} 162 +{{/code}} 101 101 102 102 Параметр **OrderType **– тип заказа может принимать следующие значения: 103 103