Архівна копія зі старої бази знань inCust (deprecated). Оригінал: https://incust.com/ua/knowledgebase/documentation/fuel-price-script/

Скрипт Fuel Price

Інструкція з налаштування та запуску автоматичного скрипта для оновлення цін палива через Google Apps Script. Скрипт працює як міст між обліковою системою АЗС і API inCust Терміналу: зчитує ціни з файлу на Google Drive і застосовує їх до Терміналу.

Створення проекту

1. Перейти на Google Apps Script (script.google.com).
2. Створити новий проект.
3. Перейменувати проект для зручності (за потребою).

Налаштування проекту

1. Очистити вміст файлу Code.gs.
2. Вставити основний код скрипта (з джерела на Google Drive, наданого inCust).

Підключення Drive API

1. Відкрити меню Services.
2. Додати до проекту Drive API — без нього скрипт не зможе прочитати джерельний файл цін.

Налаштування параметрів у коді

У код скрипта вшиті блоки конфігурації, які потрібно відредагувати під конкретну мережу АЗС:

• UPDATE_CONFIG — розташування файлу з цінами, API-ключ Терміналу, перелік типів палива та артикули.
• NOTIFICATION_RECIPIENTS — email-адреси для сповіщень про виконання скрипта (включаючи logs@incust.com).
• API_URL — посилання на сервер inCust: https://api.incust.com/v1/term.
• SENDERS — білий список email-адрес, з яких приймаються файли з цінами (захист від несанкціонованого оновлення).
• OFFSET — політика часу застосування цін: за 5 хвилин, завтра, післязавтра, через два дні.

Налаштування тригерів

1. Вибрати функцію для запуску — run.
2. Встановити часовий тригер (time-driven trigger) — наприклад, щогодини.
3. Зберегти налаштування.

Надання дозволів

При першому запуску потрібно:

1. Авторизуватися через Google-акаунт.
2. Надати скрипту дозволи на доступ до Drive і відправку email.

Рекомендації з експлуатації

• Тригер рекомендується встановлювати кожні 30 хвилин або щогодини.
• Нові ціни активуються згідно з налаштуваннями часового поясу.
• У бізнес-панелі inCust обов'язково увімкнути опцію «Дозволити зміну базових цін у Терміналі» — без цього скрипт не зможе застосувати нові ціни.
• Заплановані зміни цін слід перевіряти в інтерфейсі управління Терміналом.