Elbuz сам качає прайс за адресою від постачальника під час кожного завантаження джерела: пряме посилання, Google Таблиця, хмарне сховище або файл в особистому кабінеті.
Коли це знадобиться:
- Прайс лежить у Google Таблиці — вставляєте адресу як є, програма сама вивантажить книгу у xlsx.
- Таблиця закрита для всіх — постачальник відкриває її сервісній пошті Elbuz, ваш пароль не потрібен.
- У назві файла щодня нова дата — шаблон дати в посиланні, програма шукає файл до пʼяти днів назад.
- Прайс видно тільки після входу на сайт — програма сама заходить у кабінет постачальника.
З чого почати: картка джерела → секція «Джерело» → плитка «Посилання» → поле «Посилання на файл».
Що вміє завантаження за посиланням
- Пряме посилання — з HTTP-авторизацією і ключем доступу в заголовку, якщо постачальник їх вимагає.
- Хмарні сховища — Google Таблиці, Google Диск, OneDrive, Яндекс.Диск, cloud.mail.ru перетворюються на пряме завантаження самі.
- Закритий файл Google — доступ лише для сервісної пошти Elbuz.
- Дата в назві файла — підставляється сьогоднішня, а немає файла — попередні дні.
- Особистий кабінет — вхід під логіном постачальника й пошук посилання на сторінці.
Де це і хто має доступ
- Меню
- Довідники → Обробка прайс-листів → Список прайс-листів
- Картка джерела
- секція «Джерело» → плитка «Посилання»
- Особистий кабінет
- секція «Джерело», спосіб «Посилання» → «Налаштування доступу до особистого кабінету»
- Право доступу
- вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»
- Підготувати
- адресу файла; логін і пароль або ключ доступу, якщо файл закритий
Чому в джерелі має бути налаштований лише один спосіб — у статті про способи отримувати прайс.
Як підключити прайс за посиланням
Найпоширеніший спосіб автоматичного отримання. Постачальник виклав файл на своєму сайті чи в хмарі, дав адресу — програма щоразу качає її сама.
Поля способу «Посилання» в секції «Джерело» зберігаються автоматично, окремої кнопки збереження в них немає.
| Поле | Що вписати |
|---|---|
| «Посилання на файл» | адресу, за якою лежить прайс |
| «Логін» | імʼя користувача, якщо файл закритий HTTP-авторизацією |
| «Пароль» | пароль до неї |
| «HTTP-заголовки запиту» | ключ доступу, якщо постачальник вимагає його заголовком |
| «Закритий Google-файл (доступ за сервісною поштою)» | прапорець для непублічного файла Google |
Логін і пароль ідуть як звичайна HTTP-авторизація. Одне виключення: якщо для цього джерела заповнена форма входу до особистого кабінету, ці ж логін і пароль підуть у форму, а не в заголовок авторизації.
Заголовки запиту
Поле «HTTP-заголовки запиту» потрібне, коли постачальник видав ключ доступу й вимагає передавати його в запиті. Підказка під полем каже дослівно: «Необовʼязково. По одному заголовку на рядок у форматі «Ключ: Значення». Наприклад, якщо постачальник вимагає ключ доступу: X-API-Key: ваш_ключ або Authorization: Bearer ваш_токен».
Формат треба витримати буквально: рядок без двокрапки програма мовчки викидає. Ніякого попередження не буде — просто заголовок не піде, а постачальник відповість відмовою. Заголовків можна вписати скільки завгодно, по одному на рядок; вони додаються до тих, які програма надсилає завжди.
Користуються цим рідко. Але коли постачальник віддає прайс тільки за ключем, іншого шляху немає.
Як брати прайс із Google Таблиці чи хмарного сховища
Далеко не завжди постачальник дає пряме посилання на файл: частий варіант — адреса сторінки в хмарному сховищі. Вставляйте те посилання, яке він дав, — пʼять сервісів програма перетворює на пряме завантаження сама.
| Сервіс | Що робить програма |
|---|---|
| Google Таблиці | прибирає з адреси зайві хвости й дописує вивантаження у форматі xlsx |
| Google Диск | перетворює адресу перегляду файла на адресу завантаження |
| OneDrive | замінює сторінку перегляду на сторінку завантаження |
| Яндекс.Диск | бере пряму адресу через публічний інтерфейс сервісу; якщо не вдалося — пробує ще раз |
| cloud.mail.ru | дістає адресу файла зі сторінки й окремо запитує тимчасовий ключ на завантаження |
З книги Google Таблиць завжди вивантажується вся книга. Номер аркуша з адреси прибирається, тож вказати конкретний аркуш посиланням не вийде — навіть якщо постачальник дав адресу з відкритим потрібним аркушем. Аркуш обирають уже в картці джерела, посиланням «Завантаження з аркушів» у шапці секції «Колонки».
Закритий файл Google
Коли постачальник не хоче відкривати таблицю всьому світу, він може дати доступ одній конкретній пошті. Для цього є прапорець «Закритий Google-файл (доступ за сервісною поштою)». Під ним розкривається підказка з адресою: «Файл Google Sheets/Docs не опубліковано та надано доступ конкретній пошті. Відкрийте файл у Google → «Налаштування доступу» → додайте вказану нижче сервісну пошту з правом «Перегляд». Після цього Elbuz завантажуватиме файл автоматично.»
Далі програма забирає файл не як анонімний відвідувач, а від імені службового облікового запису Elbuz, і ваш пароль від Google їй для цього не потрібен. Нативна таблиця Google при цьому вивантажується у xlsx.
Прапорець працює тільки для адрес Google Таблиць і Google Диска. Для файла в іншому сховищі він нічого не змінить.
1
Посилання на файл2
HTTP-заголовки запиту3
Закритий Google-файл- «Посилання на файл» — адреса, звідки система бере прайс; тут це посилання на Google Таблицю.
- «HTTP-заголовки запиту» — довільні заголовки для постачальників, яким потрібен ключ доступу чи токен.
- Флажок «Закритий Google-файл» вмикає доступ через сервісну пошту для приватних таблиць.
Як брати файл, у назві якого щодня нова дата
Частина постачальників щодня викладає новий файл із датою в назві: «price_16.08.2026.xlsx», «Прайс 16.08.2026.xls». Адреса щодня інша, і фіксоване посилання тут не допоможе.
Для цього в посилання вписують макрос дати: {get_date("d.m.Y")}. Замість нього підставиться поточна дата у вказаному форматі — форматом керує та сама схема, що й у звичайному записі дати: d — день, m — місяць, Y — рік із чотирьох цифр. Лапки всередині дужок можна не ставити, результат той самий. Другий, інший макрос у тому ж полі не підставиться — програма бере тільки перший.
Спершу програма підставляє сьогоднішнє число й перевіряє, чи є за такою адресою файл. Якщо немає — перебирає попередні дні, до пʼяти днів назад, і бере перший, що знайшовся. Тобто після вихідних або збою в постачальника прайс усе одно приїде, просто не найсвіжіший. Якщо не підійшов жоден із шести варіантів, у журнал іде «Неможливо отримати посилання на файл!» — і на цьому спроба скачати закінчується, а прогін піде далі на вчорашньому файлі.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Під час перебору дат перевірка одна: чи не відповів сервер кодом 404. Сторінка-заглушка з кодом 200 і відмова 403 для перебору означають «файл є», і програма зупиняється на цій даті. Що прийшло насправді, видно вже після скачування: на відмову буде «Сайт постачальника відповів кодом 403 — …», на сторінку входу чи помилки — «За посиланням прийшла вебсторінка, а не файл прайсу…». Якщо в журналі одне з них, а посилання начебто правильне, відкрийте адресу в режимі анонімного перегляду браузера: швидше за все, там сторінка входу або помилка, а не файл.
Як забирати прайс з особистого кабінету постачальника
Складніший випадок: прайс лежить у кабінеті постачальника, і без входу його не видно. Для цього є окреме вікно — «Налаштування доступу до особистого кабінету», воно відкривається посиланням із секції «Джерело» при способі «Посилання».
Указують у ньому не логін і пароль, а назви полів форми входу на сайті постачальника; логін і пароль беруться з полів способу «Посилання», і вхід виконується, лише коли заповнені всі пʼять. У журналі це видно рядком «Вхід до особистого кабінету». Там же є поля для складніших сайтів — захисні токени й селектор CSS, якщо посилання на прайс спершу треба знайти на сторінці.
Після налаштування програма сама заходить у кабінет під логіном постачальника і качає прайс — за розкладом джерела або кнопкою завантаження, як і будь-яке посилання. Поля вікна:
- «Посилання на сторінку сайту для введення логіну та пароля» — адреса сторінки, де в браузері відкривається форма входу. Кнопка «Отримати список полів» внизу вікна завантажує цю сторінку й показує поля її форми — з цього списку й беруть назви для полів нижче.
- «Посилання для надсилання форми» — адреса, куди форма відправляє логін і пароль. Порожнє — програма відправляє форму на сторінку входу.
- «Назва поля: логін» і «Назва поля: пароль» — назви (атрибут
name) полів форми, а не самі логін і пароль. - «Назва поля: csrf token #1» і «#2» — якщо форма має захисний токен: програма відкриває сторінку входу, бере значення поля з цією назвою і відправляє його разом із логіном.
- «Посилання на сторінку, де є посилання на прайс» і «Селектор CSS для отримання посилання на прайс» — коли адреса файлу в кабінеті щоразу інша: після входу програма відкриває цю сторінку і бере посилання з елемента, знайденого селектором.
- «Список значень для input для передачі вручну» — додаткові поля форми, по одному на рядок у вигляді
name = input_name, value = input_value.
Це робота для того, хто вміє дивитися в код чужої сторінки. Якщо випадок ваш — простіше спершу попросити в постачальника або доступ до FTP.
Сценарії
Постачальник щодня викладає новий файл із датою в назві
Що зробити. У секції «Джерело» оберіть плитку «Посилання» і в поле «Посилання на файл» вставте адресу вчорашнього файла, замінивши дату макросом: {get_date("d.m.Y")}, якщо файл називається «price_16.08.2026.xlsx». Формат усередині дужок має повторювати те, як постачальник пише дату в назві.
Що вийде. Кожен прогін підставляє сьогоднішню дату; якщо за нею сервер відповідає 404 — вчорашню і так далі, до пʼяти днів назад. Файл за вихідні, коли постачальник нічого не викладав, підхопиться з пʼятниці.
Чого не буде. Файл, старший за пʼять днів, не знайдеться — буде «Неможливо отримати посилання на файл!» і прогін на попередньому файлі. Перебір дат зупиняється на першій адресі, за якою сайт відповів не 404. Якщо там сторінка входу чи інший код помилки, а не файл, у журналі буде «За посиланням прийшла вебсторінка, а не файл прайсу…» або «Сайт постачальника відповів кодом …», і прогін піде на попередньому файлі.
Постачальник не хоче відкривати Google Таблицю всім
Що зробити. Плитка «Посилання», у «Посилання на файл» — адреса таблиці, прапорець «Закритий Google-файл (доступ за сервісною поштою)». Адресу сервісної пошти з підказки під прапорцем передайте постачальнику: він додає її в «Налаштування доступу» файла з правом «Перегляд».
Що вийде. Програма забирає таблицю від імені службового облікового запису Elbuz, без вашого пароля від Google, і вивантажує її у xlsx.
Чого не буде. Посиланням не обрати аркуш — приходить уся книга, аркуш вказують у секції «Колонки» через «Завантаження з аркушів». Для документа чи презентації Google і для файлів поза Google Таблицями й Google Диском прапорець не працює.
Що робити, коли файл за посиланням не приходить
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Неможливо отримати посилання на файл!» | У посиланні є макрос дати, і за жодною з шести дат — сьогодні й пʼять попередніх днів — сервер не віддав файл (перевіряється тільки код 404). Без макроса дати це повідомлення не зʼявляється | Відкрийте адресу з підставленою датою в браузері та звірте формат дати з тим, як постачальник називає файли (про дату в посиланні) |
| «Сайт постачальника показав перевірку браузера (Cloudflare) замість файлу…» | Сайт захищений перевіркою, яку проходить лише браузер, а програма качає файл без браузера | Попросіть пряме посилання без захисту або виняток для нашого сервера; інакше — пошта чи FTP (причини в журналі) |
| «За посиланням прийшла вебсторінка, а не файл прайсу…» або «Сайт постачальника відповів кодом ‹код› — …» | Сайт віддав сторінку входу чи помилки або відмовив кодом: 403 — немає доступу, 404 — файлу немає, 429 — забагато запитів, 5xx — збій сервера | Відкрийте посилання в анонімному вікні браузера й звірте з постачальником адресу та ключ у ній; 429 і 5xx зазвичай минають до наступного прогону (про посилання) |
| «Сервісний акаунт не має доступу до файлу. Поділіться файлом Google з поштою: ‹адреса› (право «Перегляд»).» | Прапорець закритого файла Google увімкнено, а доступу до файла не має | Відкрийте файл у Google → «Налаштування доступу» → додайте показану адресу з правом «Перегляд» (про закритий файл) |
| «Доступ до закритих Google-файлів не налаштовано на платформі. Зверніться до підтримки.» | На платформі немає ключа службового облікового запису | Напишіть у підтримку — самостійно це не налаштовується (про закритий файл) |
| «Цей тип Google-документа не підтримується для імпорту прайсу. Використовуйте Google Таблиці (Sheets).» | За посиланням не таблиця, а документ або презентація Google | Попросіть у постачальника саме Google Таблицю (про закритий файл) |
| «Не вдалося розпізнати посилання Google. Перевірте коректність посилання на файл.» | З адреси не вдалося дістати ідентифікатор файла | Скопіюйте посилання заново з адресного рядка відкритого файла (про закритий файл) |
| «Помилка під час завантаження файлу з Google.» | Інша помилка Google; подробиці дописуються до тексту | Повторіть прогін; якщо повторюється — у підтримку (про закритий файл) |
Часті запитання
Посилання відкривається у браузері, а програма файл не бачить. Чому?
Сайт віддає програмі сторінку — вхід, перевірку браузера або помилку. Що саме прийшло, написано в журналі джерела червоним рядком. Відкрийте адресу в анонімному вікні браузера й порівняйте — розбір проблем.
Постачальник вимагає ключ доступу. Куди його вписати?
У поле «HTTP-заголовки запиту», по одному заголовку на рядок у форматі «Ключ: Значення», наприклад X-API-Key: ваш_ключ. Рядок без двокрапки програма мовчки пропускає — про заголовки.
Як вибрати потрібний аркуш Google Таблиці?
Посиланням — ніяк: з Google Таблиць завжди вивантажується вся книга. Аркуш обирають у картці джерела, посиланням «Завантаження з аркушів» у шапці секції «Колонки».
Чи потрібен програмі мій пароль від Google для закритої таблиці?
Ні. Постачальник додає сервісну пошту Elbuz до доступу файла з правом «Перегляд», а ви вмикаєте прапорець «Закритий Google-файл» — про закритий файл.
Прайс лежить в особистому кабінеті під логіном. Чи може програма заходити сама?
Так, за розкладом джерела, як звичайне посилання. Логін і пароль вписують у поля способу «Посилання», а назви полів форми — у «Налаштування доступу до особистого кабінету». Сайти з капчею так не відкриються — про кабінет.
Суміжні теми
- Якщо потрібна загальна картина: як обрати спосіб і що буде, коли файл не приїхав — Способи отримувати прайс від постачальника.
- Якщо постачальник шле прайс листом — Як отримувати прайс постачальника з листа.
- Якщо в журналі «Сайт постачальника відповів кодом…» — причини на боці джерела.