Кабінет закупівель

Інструкція для менеджера

Доступ для перегляду взаєморозрахунків усіх закріплених клієнтів. ID менеджера починається з символу @.

1. У полі ID клієнта введіть свій менеджерський ключ у форматі @xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
2. Натисніть «Вхід» — виконається оновлення взаєморозрахунків. Після успішного входу зʼявляться вкладки, замість ID відобразиться імʼя клієнта.
3. На вкладці «Взаєморозрахунки» вкажіть період з та період по для звіту.
4. За потреби натисніть «Оновити» ще раз — зʼявиться таблиця клієнтів із сумами за період.
5. Натисніть на рядок потрібного клієнта — відкриється вікно з детальними взаєморозрахунками та балансом.
6. Натисніть на рахунок у вікні — переглянете позиції рахунку (артикул, кількість, ціни).
7. Замовлення: додайте товари в кошик, оберіть клієнта та контракт у кошику, за потреби увімкніть «Доставка», оберіть адресу й дату зі списку і натисніть «Зробити замовлення».
8. Голосовий пошук: фрази без збігу з товарами збираються в журналі — кнопка «Фрази» на вкладці «Товар» або сторінка /shop/voice-misses.php.
9. Щоб вийти з кабінету, натисніть «Вихід».

Дані зберігаються в кеші браузера — при наступному відкритті список клієнтів відобразиться одразу. Для актуальних сум натисніть «Оновити» ще раз.

Інструкція для клієнта

Отримайте ключ до особистого кабінету у вашого персонального менеджера — це унікальний код доступу до ваших даних. Відеопрезентація — короткий огляд роботи з кабінетом.

1. Вставте ключ у поле ID клієнта. Ключ прихований зірочками — щоб переглянути його, натисніть іконку ока справа від поля.
2. Натисніть «Вхід» справа від поля. Якщо оновлення взаєморозрахунків пройде успішно, зʼявляться вкладки «Взаєморозрахунки» та «Товар», а замість ID відобразиться назва клієнта.
3. Взаєморозрахунки: оберіть період і за потреби натисніть «Оновити». У таблиці — ваші рахунки та суми. Зверху видно баланс. Натисніть на рахунок, щоб побачити товари в ньому.
4. Поруч із датою оновлення є кнопка Excel — завантажте таблицю взаєморозрахунків або склад рахунку у файл для Excel.
5. Товар: натисніть «Оновити», щоб завантажити прайс. Шукайте товар по артикулу, назві чи бренду; за потреби скористайтеся фільтрами.
6. Щоб швидко додати товар у кошик — натисніть кнопку + зліва в рядку. Або відкрийте картку товару (натисніть на рядок) і оберіть «В корзину» — картка закриється автоматично.
7. На телефоні список товарів і кошик зручно читати без горизонтального гортання: спочатку назва, нижче — ціна та інші дані.
8. У списку товарів також є кнопка Excel — можна зберегти поточний (відфільтрований) прайс у файл.
9. Відкрийте іконку кошика біля імені клієнта: змініть кількість, за потреби увімкніть «Доставка» (оберіть адресу та дату), додайте коментар і натисніть «Зробити замовлення». З кошика теж можна завантажити Excel.
10. Щоб вийти з кабінету, натисніть «Вихід» — ключ очиститься, вкладки зникнуть.

Останні завантажені дані та сеанс входу зберігаються в браузері — при повторному відкритті кабінету ви залишитесь у режимі входу на тій самій вкладці. Для свіжих даних з облікової системи натисніть «Оновити».

Короткий гайд кабінету

Перший раз система показує підказки по кнопках. Якщо пропустили — запустіть огляд ще раз.

Встановлення застосунку на телефон

Кабінет закупівель IOI можна додати на головний екран — працює як звичайний застосунок, без App Store чи Google Play.

Android (Chrome)

1. Відкрийте цю сторінку у браузері Chrome.
2. Натисніть кнопку «Додати на головний екран» вище — або меню ⋮ → «Встановити застосунок».
3. Підтвердіть установку — іконка IOI зʼявиться на робочому столі.

iPhone / iPad (Safari)

1. Відкрийте цю сторінку у Safari (інші браузери на iOS не підтримують установку).
2. Натисніть кнопку «Поділитися» (квадрат зі стрілкою вгору).
3. Прокрутіть меню вниз і оберіть «На Початковий екран».
4. Натисніть «Додати» — застосунок зʼявиться поруч з іншими програмами.

Після оновлення сайту може знадобитися один раз оновити сторінку в застосунку, щоб побачити нові функції.

Інтеграція через API

Дані кабінету доступні через HTTP API. Усі запити — метод POST, формат JSON, адреса:

https://ioi.com.ua/api/index.php

У полі id передайте ваш ключ клієнта (UUID), у полі metod — номер операції в обліковій системі.

Взаєморозрахунки (metod: "1")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "1",
    "data1": "01.01.2026",
    "data2": "31.01.2026"
  }'

Товари та ціни (metod: "2")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "2"
  }'

Один товар за id (metod: "2" + idproduct)

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "2",
    "idproduct": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }'

Позиції рахунку (metod: "3")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "3",
    "check": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }'

Адреси та дати доставки (metod: "13")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "13"
  }'

У відповіді — масив addresses: id, name, days, dates (ISO YYYY-MM-DD, з завтра на 2 тижні). Для менеджера додайте idclient.

Створення замовлення (metod: "6")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "6",
    "delivery": true,
    "idaddress": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "delivery_date": "2026-10-07",
    "items": [
      {"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "quantity": 2, "price": 5215.06}
    ],
    "comment": "Коментар до замовлення"
  }'

Якщо delivery: true — обовʼязкові idaddress (з metod 13) та delivery_date.

Максимальна знижка контракту (metod: "11")

curl -X POST 'https://ioi.com.ua/api/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "metod": "11",
    "idcontract": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }'

Для менеджера (id з префіксом @). У відповіді — поле maxDiscount (відсоток).

У замовленні менеджера (metod: "6") можна передати загальну знижку discount та построчну discount у кожному елементі items. Ціни залишаються без змін.

Замість x підставте ваш ключ клієнта та ідентифікатори з кабінету. У відповіді ok: true — успіх, дані — у полі data. Дати — формат ДД.ММ.РРРР.

Для автоматизації в обліковій системі / BAS є готова зовнішня обробка — зверніться до вашого персонального менеджера IOI, щоб отримати її.