Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"

Сводка

• Свойства страницы (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,14 +62,47 @@
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		-**Пример ответа**
70	70
71		-{{{{ {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, }}}}
	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}}
72	72
	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	+
73	73	== Обработка заказа ==
74	74
75	75	[[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]]
...	...	@@ -77,9 +77,46 @@
77	77	Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд.
78	78
79	79
80		-**Тело запроса содержит JSON вида Order**
	123	+**Тело запроса содержит JSON вида Order**{{{}}}
81	81
82		-{{{{ // идентификатор заказа 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}}
83	83
84	84	Параметр **OrderType **– тип заказа может принимать следующие значения:
85	85