Інтеграція через 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: "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,
"items": [
{"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "quantity": 2, "price": 5215.06}
],
"comment": "Коментар до замовлення"
}'
Клієнти менеджера (metod: "7")
curl -X POST 'https://ioi.com.ua/api/index.php' \
-H 'Content-Type: application/json' \
-d '{
"id": "@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"metod": "7"
}'
Замовлення менеджера (metod: "6" + idclient, idcontract)
curl -X POST 'https://ioi.com.ua/api/index.php' \
-H 'Content-Type: application/json' \
-d '{
"id": "@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"metod": "6",
"idclient": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"idcontract": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"delivery": false,
"items": [{"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "quantity": 1, "price": 100}]
}'
Позиції рахунку (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"
}'
Замість x підставте ваш ключ клієнта та ідентифікатори з кабінету. У відповіді ok: true — успіх, дані — у полі data. Дати — формат ДД.ММ.РРРР.
Для автоматизації в 1С:Бухгалтерія / BAS є готова зовнішня обробка — зверніться до вашого персонального менеджера IOI, щоб отримати її.