Исходный код вики Интеграция с Яндекс.Заправки

Версия 18.1 от Ярослава Ерина на 2025/05/28 10:46

version	line-number	content
1.1	1	(% class="warning" %)\|=(((
	2	== Важно! ==
	3
9.1	4	Перед настройкой Топаз-АЗС необходимо обновить ее до актуальной версии. Последнюю актуальную версию можно запросить в техподдержке или [[скачать на сайте>>https://wiki.topazelectro.ru/pages/viewpage.action?pageId=1180234]].
1.1	5
	6	Пункты, отмеченные звёздочкой ( * ), необходимо выполнять только в том случае, если Вы впервые регистрируетесь на сайте [[topazoffice.ru >>url:http://topazoffice.ru/]]и впервые настраиваете интеграцию Топаз-АЗС с сервисами внешних наливов, доступными по подписке. Если у Вас уже есть активные подписки, убедитесь в правильной настройке отмеченных пунктов.
	7	)))
	8
7.1	9	=== На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]] ===
1.1	10
	11	\|=(((
8.1	12	(% class="mark" %)1*(%%) . Зайдите на сайт [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]]
1.1	13
12.1	14	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/start/WebHome/1730119808080-110.png?rev=1.1\|\|alt="1730119808080-110.png"]]
1.1	15
12.1	16	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/start/WebHome/1730119902774-575.png?rev=1.1\|\|alt="1730119902774-575.png"]]
1.1	17
8.1	18	(% class="mark" %)2*(%%) . Зарегистрируйтесь на сайте и активируйте аккаунт по ссылке с электронной почты
1.1	19
	20	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-3_17-20-22.png?version=1&modificationDate=1716440517000&api=v2]]
	21
	22	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-3_16-19-29.png?version=1&modificationDate=1716440506000&api=v2]]
	23
8.1	24	(% class="mark" %)3* (%%). Зайдите на вкладку "АЗС"
1.1	25
2.1	26	[[image:https://topazoffice.ru/xwiki/bin/download/TAZS_Benzuber/WebHome/1732705690485-164.png?rev=1.1\|\|alt="1732705690485-164.png"]]
1.1	27
8.1	28	(% class="mark" %)4* (%%). Если хотите переименовать АЗС
1.1	29
	30	1. Кликните на строку с АЗС
	31	1. Введите новый код
	32	1. Нажмите кнопку "Сохранить"
	33
2.1	34	[[image:https://topazoffice.ru/xwiki/bin/download/TAZS_Benzuber/WebHome/1732705757594-220.png?rev=1.1\|\|alt="1732705757594-220.png"]]
1.1	35
8.1	36	(% class="mark" %)5* (%%). Нажмите на кнопку "Настройки":
1.1	37
13.1	38	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/azs/kak_dobavit_azs/WebHome/1730284690835-734.png?rev=1.1\|\|alt="1730284690835-734.png"]]
1.1	39
8.1	40	(% class="mark" %)6* (%%). В разделе "Настройки" введите “Адрес”, “Широту”, “Долготу” и “Часовой пояс”.
1.1	41
2.1	42	[[image:https://topazoffice.ru/xwiki/bin/download/FuelUp/WebHome/1732706811731-521.png?rev=1.1\|\|alt="1732706811731-521.png"]]
	43
	44	Нажмите кнопку “Сохранить”.
1.1	45	)))
	46
7.1	47	=== В "Топаз АЗС" ===
1.1	48
	49	\|=(((
	50	7. Закрыть смену и закрыть программу "Топаз АЗС"
	51
	52	8. Запустить скрипт backupBeforeSync.cmd в корневом каталоге и дождаться его завершения
	53
	54	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-3_17-1-13.png?version=1&modificationDate=1716440624000&api=v2]]
	55
	56	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-3_17-3-0.png?version=1&modificationDate=1716440642000&api=v2]]
	57
	58	9. Запустите "Топаз АЗС" и зайдите в режим "Настройки"
	59
	60
3.1	61
1.1	62	)))
	63
7.1	64	=== На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]] ===
1.1	65
	66	\|=(((
8.1	67	(% class="mark" %)10* (%%). На вкладке "АЗС" выберите АЗС с помощью галки в первой колонке:
1.1	68
14.1	69	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/azs/actyvaciya/WebHome/1732184406508-921.png?rev=1.1\|\|alt="1732184406508-921.png"]]
1.1	70
8.1	71	(% class="mark" %)11* (%%). Нажмите кнопку "Сгенерировать код регистрации"
1.1	72
8.1	73	(% class="mark" %)12* (%%). В появившемся окне скопируйте код (нажмите кнопку "Копировать").
1.1	74
14.1	75	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/azs/actyvaciya/WebHome/1732184457004-353.png?rev=1.1\|\|alt="1732184457004-353.png"]]
2.1	76
	77
1.1	78	)))
	79
7.1	80	=== В "Топаз АЗС" ===
1.1	81
	82	\|=(((
8.1	83	(% class="mark" %)13* (%%). Вставьте код из окна с сайта [[https:~~/~~/topazoffice.ru/ >>url:https://topazoffice.ru/]]в поле "Код регистрации" в меню "WebOffice" -> “Код регистрации”
1.1	84
15.1	85	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/azs/actyvaciya/WebHome/1732184518186-631.png?rev=1.1\|\|alt="1732184518186-631.png"]]
1.1	86
8.1	87	(% class="mark" %)14* (%%). Нажмите кнопку "Отправить" и дождитесь появления сообщения: "Регистрация выполнена, Активирована."
1.1	88
15.1	89	[[image:https://topazoffice.ru/xwiki/bin/download/nachalo_raboty/azs/actyvaciya/WebHome/1732185025975-793.png?rev=1.1\|\|alt="1732185025975-793.png"]]
1.1	90
8.1	91	(% class="mark" %)15* (%%). Создайте экземпляр менеджера оборудования "Прочие устройства" -> "WebOfficeActiveDevice" и, по желанию, назовите его "Внешние наливы"
3.1	92
1.1	93	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-6_8-37-31.png?version=1&modificationDate=1716440757000&api=v2]]
	94
18.1	95	16. Создайте вид оплаты "Регистрация внешних заказов", назовите его "Яндекс (физ.лица)".
1.1	96
	97	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-8_16-13-45.png?version=1&modificationDate=1716440771000&api=v2]]
	98
18.1	99	17. Создайте ещё один вид оплаты "Регистрация внешних заказов", назовите его "Яндекс (юр.лица)".
1.1	100
18.1	101	18. Для данных видов оплаты установите следующие параметры:
1.1	102
6.1	103	* Печать чека на фискальном регистраторе: “<Не выбран>”
	104	* Печать квитанции на принтере: “<Не выбран>”
	105	* Регистрация в базе данных: “Безналичный расчет”
	106	* (((
1.1	107	Внешний код - введите любое числовое значение, уникальное для каждого из видов оплаты
	108
18.1	109	Нажмите кнопку "Изменить" для сохранения параметров
1.1	110	)))
	111
	112	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-8_16-21-42.png?version=1&modificationDate=1716440794000&api=v2]]
	113
8.1	114	19. Убедитесь, что в видах нефтепродуктов каждый вид топлива имеет уникальный внешний код (столбец “Код” в настройках видов топлива, кодом может быть любое числовое значение ).
1.1	115
8.1	116	(% class="box errormessage" %)
	117	(((
	118	Внешние коды топлива должны быть числовыми
	119	)))
	120
1.1	121	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-8_16-38-33.png?version=1&modificationDate=1716440816000&api=v2]]
	122
17.1	123	(% class="mark" %)20* (%%). Если Вы хотите, чтобы частично налитые заказы автоматически закрывались после того как был повешен кран, то
1.1	124
17.1	125
	126	* Закройте ТопазАЗС
	127	* Откройте файл <Путь до ТопазАЗС>/Ini/localsettings.ini
1.1	128	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-6_9-21-18.png?version=1&modificationDate=1716440843000&api=v2\|\|width="1000"]]
17.1	129	* Добавьте в секцию [Pumps] следующие строки
1.1	130
17.1	131	IsAutoCancel=1
1.1	132
17.1	133	AutoCancelTimeout=30
1.1	134
17.1	135
	136	Где 30 - время ожидания от момента перехода в состояние остановки в секундах
	137
	138
1.1	139	[[image:https://wiki.topazelectro.ru/download/attachments/1180119/image2021-12-6_9-23-32.png?version=1&modificationDate=1716440868000&api=v2]]
	140
3.1	141	21. Откройте смену
1.1	142
	143
	144	)))
17.1	145	\|=(% scope="col" %)
	146	\|=(% scope="col" %)
1.1	147
7.1	148	=== На сайте [[https:~~/~~/topazoffice.ru/>>url:https://topazoffice.ru/]] ===
1.1	149
	150	\|=(((
11.1	151	(% class="mark" %)22* (%%). Зайдите на вкладку Иконка пользователя → “Профиль компании” → “Настройка компании”, заполните поля “Почтовый адрес”, “Email”, “Контактный телефон”, “Юридический адрес”, “ИНН”, “БИК”, “Номер банковского счета”, и нажмите кнопку “Сохранить”.
1.1	152
4.1	153	Поле Почтовый адрес используется для отправки бухгалтерских документов.
1.1	154
	155
4.1	156	[[image:1732782173353-674.png]]
1.1	157
3.1	158	23. Зайдите на вкладку "Подписки"
1.1	159
3.1	160	24. В таблице "Ваши подписки на плагины" в колонке " Яндекс.Заправки " выберите подписку на интересующий Вас срок
1.1	161
5.1	162	[[image:1732795871666-671.png]]
1.1	163
3.1	164	25. Нажмите кнопку "Сохранить" в нижнем правом углу таблицы. Цена на интеграцию составляет 600 руб/АЗС/мес
1.1	165
5.1	166	[[image:1732795919088-530.png]]
1.1	167
3.1	168	26. Перейдите в меню "Главная" → " Яндекс.Заправки "
1.1	169
5.1	170	[[image:1732795958303-144.png]]
1.1	171
3.1	172	27. В блоке “Настройки компании” введите апикей Вашей сети АЗС, который Вам выдал Яндекс
1.1	173
3.1	174	28. В поля “Физические лица” и “Юридические лица” введите соответствующие коды видов оплаты с АЗС (п.19).
1.1	175
3.1	176	29. Нажмите кнопку “Сохранить” под блоком “Настройки компании”
1.1	177
5.1	178	[[image:1732796092422-810.png]]
1.1	179
3.1	180	30. В блоке “Настройки АЗС” выберите необходимую АЗС.
1.1	181
	182	Убедитесь, что появившейся таблице виды топлива, цены и внешние коды совпадают с указанными на АЗС (п.20)
	183
5.1	184	[[image:1732796762287-505.png]]
1.1	185
3.1	186	31. Настройте последний столбец таблицы в соответствии с видами топлива Яндекса.
1.1	187
5.1	188	Нажмите кнопку “Сохранить” под блоком “Настройки АЗС”
1.1	189
5.1	190	[[image:1732796912350-821.png]]
1.1	191	)))
	192	\|(% colspan="1" %)
	193
3.1	194	32. Сообщите в Яндекс.Заправки, что настройка со стороны WEB Офиса завершена. Если настройка была произведена корректно, то Яндекс должен увидеть конфигурацию Ваших АЗС (ид АЗС, виды топлива и цены).
1.1	195
3.1	196	33. Как только Яндекс установит номер АЗС в своей системе, попытайтесь сделать тестовый налив через мобильное приложение.