Документація

API ClearMoney

REST, JSON, авторизація токеном у заголовку. Оберіть модуль — на його сторінці всі ендпоінти з методами, параметрами та прикладами відповідей. Модулі без відкритого API так і позначені, щоб ви не писали інтеграцію під те, чого поки немає.

21 відкритих ендпоінтів

JSON запит і відповідь

UTF-8 кодування

Авторизація

Токен передається в заголовку — будь-яким із двох способів, вони рівнозначні:

Authorization: Bearer <token>
X-API-Key: <token>

Токен генерується в налаштуваннях модуля «Товари та замовлення» і діє на платному тарифі. Запит без токена повертає 401, з токеном на безкоштовному тарифі — 403.

Товари та замовлення

/erp/api/v1/

Відкритий API

Товари, категорії та замовлення — читання й завантаження. Саме через цей API працює плагін синхронізації з WooCommerce.

GET /erp/api/v1/products/
GET /erp/api/v1/products/<id>/
GET /erp/api/v1/categories/
GET /erp/api/v1/orders/
GET /erp/api/v1/orders/<id>/
POST /erp/api/v1/ingest/products/
…і ще 2 на сторінці модуля

Документація модуля — 8 ендпоінтів →

Облік доходів

У планах

Доходи, витрати, рахунки й податкові розрахунки. Відкритого API поки немає: доходи заводяться в кабінеті або підтягуються з банківської виписки.

GET /finance/api/tax-calendar/

Документація модуля — 1 ендпоінт →

Послуги

/services/api/v1/

Відкритий API

Клієнти, записи, вільні слоти, статуси та історія клієнта. Те саме, що робить кабінет, але для сайту, телеграм-бота чи рецепції.

GET /services/api/v1/clients/
POST /services/api/v1/clients/
GET /services/api/v1/clients/<id>/
PATCH /services/api/v1/clients/<id>/
POST /services/api/v1/clients/<id>/status/
GET /services/api/v1/clients/<id>/history/
…і ще 7 на сторінці модуля

Документація модуля — 13 ендпоінтів →

Спільні правила

Ізоляція даних: Кожен запит бачить лише обʼєкти власника токена. Чужий id у шляху повертає 404, а не чужі дані.
Гроші: Суми — рядками з двома знаками ("320.00"), щоб не втратити копійки на float. Валюта — гривня.
Дати: ISO 8601 із часовим поясом: 2026-09-04T11:20:00+03:00.
Повторні надсилання: Ingest-ендпоінти ідемпотентні за парою external_id + source: той самий обʼєкт можна надсилати скільки завгодно разів, дубліката не буде.
Мова: Назви полів і тексти повідомлень — англійською: їх читає код інтеграції та логи. Українська лишається в кабінеті й у цій документації.
Помилки: Завжди {"error": {"code", "message"}}, у details — конкретні поля. Перевіряйте code: він стабільний, а message може бути уточнений. Повний перелік із тілами відповідей — на сторінці кожного модуля.

Питання по інтеграції

Напишіть у Telegram або на сторінку підтримки — відповімо українською й підкажемо, як зробити те, чого поки немає в API.