Перейти к содержимому
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 13.1
отредактировано Ярослава Ерина
на 2024/07/30 06:36
Изменить комментарий: К данной версии нет комментариев
К версии 1.1
отредактировано Ярослава Ерина
на 2024/07/17 12:36
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -24,32 +24,38 @@
24 24  
25 25  **...**
26 26  
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
39 -{
40 -double Lat,
41 -double Lon },
42 -// словарь доступных ТРК
43 -Dictionary Columns {
44 -// номер колонки
45 -(int32) Key:
46 -{
47 -// список доступных типов топлива
48 -"Fuels": [ "a92", "a95", "diesel_premium", ... N ]
49 -}
50 -} ... N
51 -}
52 -{{/code}}
27 +{{{{
28 + // идентификатор станции АЗС
29 + string Id
30 + // статус станции: true – доступна, false – выключена
31 + bool Enable,
32 + // наименование станции
33 + string Name,
34 + // адрес станции
35 + string Address,
36 + // гео точка на карте
37 + location Location {
38 + double Lat,
39 + double Lon
40 + },
41 + // словарь доступных ТРК
42 + Dictionary Columns
43 + {
44 + // номер колонки (int32)
45 + Key: {
46 + // список доступных типов топлива
47 + "Fuels": [
48 + "a92",
49 + "a95",
50 + "diesel_premium",
51 + ...
52 + N
53 + ]
54 + }
55 + }
56 + ...
57 + N
58 +}}}}
53 53  
54 54  **Возможные идентификаторы топлива**
55 55  
... ... @@ -72,47 +72,28 @@
72 72  
73 73  Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд.
74 74  
75 -В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}}
81 +В ответ Топаз "Web Офис" дает ответ в формате **JSON**
76 76  
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}}
83 +{{{{
84 + {
85 + // идентификатор станции внутри Топаз "Web Офис"
86 + string StationId,
87 + // идентификатор топлива
88 + string ProductId,
89 + // цена за 1 литр
90 + double Price
91 + },
92 + …. N
93 +}}}}
90 90  
95 +**Пример ответа**
91 91  
92 -{{code language="javascript"}}
93 -{
94 -{
95 -// идентификатор станции внутри Топаз "Web Офис"
96 -string StationId, 
97 -// идентификатор топлива 
98 -string ProductId, 
99 -// цена за 1 литр 
100 -double Price 
101 -}, …. N 
102 -}
103 -{{/code}}
97 +{{{{
98 + {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66},
99 + {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21},
100 + {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98},
101 +}}}}
104 104  
105 -
106 -**Пример ответа**{{{}}}
107 -
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}}
115 -
116 116  == Обработка заказа ==
117 117  
118 118  [[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]]
... ... @@ -120,46 +120,44 @@
120 120  Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд.
121 121  
122 122  
123 -**Тело запроса содержит JSON вида Order**{{{}}}
110 +**Тело запроса содержит JSON вида Order**
124 124  
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}}
112 +{{{{
113 + // идентификатор заказа
114 + string Id
115 + // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
116 + String DateCreate
117 + // значение заказа
118 + double OrderVolume
119 + // идентификатор станции АЗС
120 + string StationExtendedId
121 + // номер колонки
122 + int ColumnId
123 + // идентификатор топлива
124 + string FuelId
125 + // стоимость 1 литра топлива
126 + double PriceFuel
127 + // сумма заказа
128 + double Sum
129 + // кол-во литров
130 + double Litre
131 + // итого оплачено
132 + double SumPaid
133 + // статус заказа
134 + OrderStatus Status
135 + // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
136 + String DateEnd
137 + // идентификатор причины отмены заказа
138 + string ReasonId
139 + // причина отмены
140 + string Reason
141 + // итого сумма литров залито
142 + double LitreCompleted
143 + // итого оплачено по завершению заказа
144 + double SumPaidCompleted
145 + // идентификатор договора
146 + string ContractId
147 +}}}}
163 163  
164 164  Параметр **OrderType **– тип заказа может принимать следующие значения:
165 165  
... ... @@ -166,6 +166,7 @@
166 166  * **Money **– заправка на фиксированную сумму, **OrderVolume **– сумма рублей
167 167  * **Liters **– заправка на литры, **OrderVolume **– кол-вол литров
168 168  
154 +
169 169  Параметр **Status **– статус заказа может принимать следующие значения
170 170  
171 171  * **OrderCreated **– заказ создан и полностью оплачен
... ... @@ -174,6 +174,7 @@
174 174  * **StationCanceled **– заказ отменен оператором АЗС или же Топаз "Web Офис"
175 175  * **UserCanceled **– заказ отменен пользователем
176 176  
163 +
177 177  Параметр **ContractId **– стандартными типами договора, по которому обрабатывается заказ
178 178  
179 179  * **Individual **– договор возмездного оказания услуг (физические лица)