Исходный код вики Настройка оператора ТК (Топливные карты)
Редактировал(а) Андрей Калиновский 2025/03/24 12:58
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | ~1. Перейдите в справочник **Операторы ТК.** | ||
| 2 | |||
| 3 | 2. Нажмите на кнопку [[image:image-20230602142021-2.png]] **Добавить**, в панели инструментов. | ||
| 4 | |||
| 5 | 3. Откроется окно создания подключения к оператору топливных карт. Здесь необходимо заполнить наименование, выбрать оператора топливных карт, указать ключ API. Если статус получил состояние **Подключение активно**, то вы можете сохранить данное подключение. | ||
| 6 | |||
| 7 | [[image:image-20231009092027-1.png||height="342" width="498"]] | ||
| 8 | |||
| 9 | 5. После сохранения можете нажать на иконку [[image:image-20230602160308-4.png]] чтобы выполнить синхронизацию топливных карт. Будет запрошен список всех доступных топливных карт. Если вы не сделаете этого, то топливные карты со временем сами будут подгружаться вместе с транзакциями. Нажав на эту [[image:image-20230602170628-6.png]] иконку вы сможете запросить транзакции по всем картам оператора за указанный период. | ||
| 10 | |||
| 11 | Способ подключения у операторов может отличаться. Примеры подключений: | ||
| 12 | |||
| 13 | === **ППР** === | ||
| 14 | |||
| 15 | Для подключения к ППР требуется только API-ключ. | ||
| 16 | |||
| 17 | [[image:image-20231009095545-2.png]] | ||
| 18 | |||
| 19 | Чтобы сгенерировать ключ, зайдите в раздел «Настройки компании» личного кабинета — вкладка «API»: | ||
| 20 | |||
| 21 | [[image:image-20231009102058-3.png||height="444" width="891"]] | ||
| 22 | |||
| 23 | Нажмите **Выпустить ключ**. Будет сгенерирован API-ключ: | ||
| 24 | |||
| 25 | [[image:image-20231009102235-4.png]] | ||
| 26 | |||
| 27 | Этот ключ копируете и вводите в поле **Ключ-API** в окне создания оператор ТК. | ||
| 28 | |||
| 29 | === **Роснефть** === | ||
| 30 | |||
| 31 | Для создания подключения к Роснефти, потребуется логин и пароль от личного кабинета, а также ID контракта. | ||
| 32 | |||
| 33 | [[image:image-20231009102905-5.png]] | ||
| 34 | |||
| 35 | Здесь вводите логин и пароль от личного кабинета Роснефти. ID контракта можно узнать перейдя в личный кабинет. В панели **Информация о договоре** перейдите в окно **Дополнительная информация**. | ||
| 36 | |||
| 37 | [[image:image-20231009103126-6.png]] | ||
| 38 | |||
| 39 | Здесь в поле **Код **тот ID контракта, который необходимо ввести в поле **Контракт**. | ||
| 40 | |||
| 41 | === **Газпром** === | ||
| 42 | |||
| 43 | Необходимы Ключ API, логин и пароль от личного кабинета. | ||
| 44 | |||
| 45 | [[image:image-20231120164603-1.png]] | ||
| 46 | |||
| 47 | Ключ можно получить в личном кабинете. Открываете меню слева, нажимаете на пункт **Учетные записи**. Открывшемся окне видим список учетных записей: | ||
| 48 | |||
| 49 | [[image:image-20231120165328-3.png||height="133" width="891"]] | ||
| 50 | |||
| 51 | В строке учетной записи будет кнопка **Создать токен** или **Обновить токен**. | ||
| 52 | |||
| 53 | Если **Создать токен**, то создаете, копируете токен в нашу систему. | ||
| 54 | |||
| 55 | Если **Обновить токен**, то попробуйте найти где вы ранее использовали токен и возьмите его, или создайте новую учетную запись. | ||
| 56 | |||
| 57 | Можете обновить токен, но тогда, если у вас уже есть какая-то интеграция с Газпромнефтью, она может перестать работать. | ||
| 58 | |||
| 59 | === **Ликард (Лукойл)** === | ||
| 60 | |||
| 61 | Здесь требуется указать номер контракта (договора), пароль от сертификата и загрузить сам сертификат. | ||
| 62 | |||
| 63 | [[image:image-20231120171647-4.png]] | ||
| 64 | |||
| 65 | Номер договора можно найти в личном кабинете на главной странице: | ||
| 66 | |||
| 67 | [[image:image-20231120172939-2.png]] | ||
| 68 | |||
| 69 | Так и вводите, вместе с указателем страны, RU. | ||
| 70 | |||
| 71 | Сертификат и пароль к нему вы можете получить написав в поддержку в личном кабинете или вашему менеджеру. | ||
| 72 | |||
| 73 | === **Яндекс** === | ||
| 74 | |||
| 75 | Для подключения Яндекса нужен только API-ключ: | ||
| 76 | |||
| 77 | [[image:image-20231009103605-7.png]] | ||
| 78 | |||
| 79 | Для получения ключа, обратитесь к своему менеджеру или напишите письмо на почту [[dev@tanker.yandex.ru>>path:mailto:dev@tanker.yandex.ru]] | ||
| 80 | |||
| 81 | === **Экспресс-кард** === | ||
| 82 | |||
| 83 | Для подключения Экспресс-кард необходимо указать API-ключ и адрес: | ||
| 84 | |||
| 85 | [[image:image-20231009104352-8.png]] | ||
| 86 | |||
| 87 | Стандартный адрес это: [[https:~~/~~/cp.expcard.ru/api>>url:https://cp.expcard.ru/api]] | ||
| 88 | |||
| 89 | Для получения API-ключа напишите своему менеджеру в компании Экспресс-кард или к их тех. поддержке. | ||
| 90 | |||
| 91 | === **Гарвекс** === | ||
| 92 | |||
| 93 | Для создания подключения к оператору Гарвекс необходимо указать логин и пароль от личного кабинета: | ||
| 94 | |||
| 95 | [[image:image-20231214091438-1.png]] | ||
| 96 | |||
| 97 | Для данного оператора список топливных карт не запрашивается автоматически. Список топливных карт формируется только исходя из данных о карте по транзакциям. | ||
| 98 | |||
| 99 | Опция **Синхронизация топливных карт** [[image:image-20231214092410-2.png]] позволяет создать топливные карты по данным тех транзакций, что были совершены за последние две недели. | ||
| 100 | |||
| 101 | |||
| 102 | === **E1Card** === | ||
| 103 | |||
| 104 | Для создания подключения к оператору E1Card необходимо указать логин и пароль от личного кабинета: | ||
| 105 | |||
| 106 | [[image:image-20240201160020-1.png]] | ||
| 107 | |||
| 108 | === **TATNEFT - Татнефть (только для внешнего сервера)** === | ||
| 109 | |||
| 110 | Для подключения к Татнефть нужно выбрать оператора и выполнить настройку в файле конфигурации внешнего сервера. | ||
| 111 | |||
| 112 | |||
| 113 | **#Контракта** - вводится в формате RU000000 | ||
| 114 | **Сертификат** - поле для загрузки сертификата. Будет использован для авторизации. | ||
| 115 | **Пароль** - пароль от сертификата. | ||
| 116 | **Имя пользователя** - логин пользователя | ||
| 117 | |||
| 118 | [[image:image_2024-11-20_15-21-10.png]] | ||
| 119 | |||
| 120 | |||
| 121 | === (% id="cke_bm_555S" style="display:none" %)** **(%%)**Движение **(Движение-Нефтепродукт, Чепецкнефтепродукт) === | ||
| 122 | |||
| 123 | Для подключения к топливным картам "Движение" нужно выбрать оператора и ввести наименование, логин и пароль от вашего личного кабинета. | ||
| 124 | |||
| 125 | Доступ к личному кабинету вы можете получить у оператора по [[ссылке. >>http://kabinet.m-oil.ru/ITGUserOffice/ ]] | ||
| 126 | |||
| 127 | **У данного оператора будет производиться запрос транзакций с выбранной периодичностью. По умолчанию выставлено 6 часов, но вы можете его поменять в зависимости от вашей необходимости. ** | ||
| 128 | |||
| 129 | [[image:Снимок экрана 2025-03-14 113236.png||height="511" width="509"]] | ||
| 130 | |||
| 131 | |||
| 132 | === **Красноярскнефтепродукт** (КНП) === | ||
| 133 | |||
| 134 | Для подключения к топливным картам **Красноярскнефтепродукт **нужно выбрать оператора и ввести ключ API. | ||
| 135 | |||
| 136 | Ключ API вы можете получить у [[оператора >>https://www.knp24.ru/]]после заключения договора. | ||
| 137 | |||
| 138 | **У данного оператора будет производиться запрос транзакций с выбранной периодичностью. | ||
| 139 | По умолчанию выставлено 6 часов, но вы можете его поменять в зависимости от вашей необходимости. ** | ||
| 140 | |||
| 141 | [[image:screenshot_1_1731568665.png]] | ||
| 142 | |||
| 143 |