Редактировал(а) Dmitriy 2026/04/23 06:18

От версии 22.1
отредактировано Dmitriy
на 2024/12/06 08:48
Изменить комментарий: К данной версии нет комментариев
К версии 19.1
отредактировано Ярослава Ерина
на 2024/11/28 10:45
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Автор документа
... ... @@ -1,1 +1,1 @@
1 -XWiki.erin_ds
1 +XWiki.erina_jv
Содержимое
... ... @@ -21,7 +21,7 @@
21 21  === **Данный ключ необходимо будет передавать во всех запросах от внешней системы в "Топаз-Web Office" в заголовке (header) externalSystemApikey** ===
22 22  )))
23 23  
24 -== ApiKey ==
24 +=== ApiKey ===
25 25  
26 26  (% class="wikigeneratedid" %)
27 27  Интегратору необходимо для каждого своего клиента (сети АЗС) сформировать и хранить в собственной базе данных уникальный Apikey.
... ... @@ -39,7 +39,7 @@
39 39  
40 40  **...**
41 41  
42 -{{code language="javascript" layout="LINENUMBERS"}}
42 +{{code language="javascript"}}
43 43  {
44 44  // идентификатор станции АЗС
45 45  string Id
... ... @@ -89,7 +89,7 @@
89 89  
90 90  В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}}
91 91  
92 -{{code language="javascript" layout="LINENUMBERS"}}
92 +{{code language="javascript"}}
93 93  {
94 94   {
95 95   // идентификатор станции внутри Топаз "Web Офис"
... ... @@ -109,9 +109,9 @@
109 109  
110 110  {{code language="javascript"}}
111 111  {
112 -{"StationId": "0001", "ProductId": "a92", "Price": 38.66},
113 -{"StationId": "0001", "ProductId": "a95_premium", "Price": 45.21},
114 -{"StationId": "0002", "ProductId": "a92", "Price": 38.98},
112 +{StationId: 0001, ProductId: a92, Price: 38.66},
113 +{StationId: 0001, ProductId: a95_premium, Price: 45.21},
114 +{StationId: 0002, ProductId: a92, Price: 38.98},
115 115  }
116 116  {{/code}}
117 117  
... ... @@ -122,77 +122,56 @@
122 122  Информирование "Топаз-Web Office" о заказе и их статусах осуществляется **HTTP **запросом на **baseUrl **с префиксом **/order **, запрос типа **POST **, timeout 10 секунд.
123 123  
124 124  
125 -**Тело запроса содержит JSON вида Order{{{}}}**
125 +**Тело запроса содержит JSON вида Order**{{{}}}
126 126  
127 -{{code language="javascript" layout="LINENUMBERS"}}
127 +{{code language="none"}}
128 128  {
129 -// Идентификатор заказа
130 -String Id
129 +// идентификатор заказа
130 +string Id
131 131  // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
132 -String DateCreate
132 +String DateCreate
133 +// значение заказа
134 +double OrderVolume
133 133  // идентификатор станции АЗС
134 -String StationExtendedId
135 -// Тип заказа
136 -String OrderType
137 -// номер стороны (поста)
136 +string StationExtendedId
137 +// номер колонки
138 138  int ColumnId
139 -// Идентификатор топлива
140 -String FuelId
141 -// Стоимость 1 литра топлива
139 +// идентификатор топлива
140 +string FuelId
141 +// стоимость 1 литра топлива
142 142  double PriceFuel
143 -// Сумма заказа
143 +// сумма заказа
144 144  double Sum
145 -// Размер заказа в литрах
145 +// кол-во литров
146 146  double Litre
147 -// Итого оплачено
147 +// итого оплачено
148 148  double SumPaid
149 -// Статус заказа
149 +// статус заказа
150 150  OrderStatus Status
151 151  // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
152 152  String DateEnd
153 -// Идентификатор причины отмены заказа
154 -String ReasonId
155 -// Причина отмены
156 -String Reason
157 -// Итого заправлено
153 +// идентификатор причины отмены заказа
154 +string ReasonId
155 +// причина отмены
156 +string Reason
157 +// итого сумма литров залито
158 158  double LitreCompleted
159 -// Итого оплачено по завершению заказа
159 +// итого оплачено по завершению заказа
160 160  double SumPaidCompleted
161 -// Идентификатор договора
162 -String ContractId
163 -// Способ оплаты
164 -String PayType
161 +// идентификатор договора
162 +string ContractId
165 165  }
166 166  {{/code}}
167 167  
168 -**Обязательными полями при создании нового заказа являются:**
169 -
170 -{{code layout="LINENUMBERS" language="javascript"}}
171 -{
172 - "Id": "string",
173 - "DateCreate": "string",
174 - "OrderType": "Money",
175 - "StationExtendedId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
176 - "ColumnId": 0,
177 - "FuelId": "diesel"
178 - "PriceFuel": 0,
179 - "Sum": 0,
180 - "Litre": 0,
181 - "Status": "OrderCreated"
182 - "ContractId": "string"
183 -}
184 -{{/code}}
185 -
186 186  Параметр **OrderType **– тип заказа может принимать следующие значения:
187 187  
188 -* **Money **– заправка на фиксированную сумму
189 -* **Liters **– заправка на литры
168 +* **Money **– заправка на фиксированную сумму, **OrderVolume **– сумма рублей
169 +* **Liters **– заправка на литры, **OrderVolume **– кол-вол литров
190 190  
191 191  Параметр **Status **– статус заказа может принимать следующие значения
192 192  
193 193  * **OrderCreated **– заказ создан и полностью оплачен
194 -* **Accepted **- АЗС готова начать налив
195 -* **Expired **– статус от АЗС не поступил в течение 30 минут
174 +* **Expire **– статус от АЗС не поступил в течение 30 минут
196 196  * **Completed **– заказа завершен успешно
197 197  * **StationCanceled **– заказ отменен оператором АЗС или же Топаз "Web Офис"
198 198  * **UserCanceled **– заказ отменен пользователем
... ... @@ -210,7 +210,7 @@
210 210  
211 211  == Передача статусов о заказе ==
212 212  
213 -=== Статус Accepted ===
192 +=== Статус Accept ===
214 214  
215 215  Данный статус сообщает внешней системе о том, что заказ принят и обработан в "Топаз-Web Office"
216 216