Все методы API
Каталог методов https://ВАШ_ДОМЕН/api/integrations/v1.
Обозначения полей и сумм: Структура и обозначения.
Права: Авторизация.
Единственный публичный REST интеграций. Legacy /api/b2b и /api/1c сняты.
Сводка по сущностям
| Сущность | Читать | Создать | Изменить | Удалить | Страница |
|---|---|---|---|---|---|
| Пользователи | да | да | да | да | пользователи и организации |
| Заказы | да | да | поля, статус, meta, архив | да | работа с заказами |
| Позиции заказа | да | да | qty/цена/коммент, статус, архив | да | работа с заказами |
| Статусы | справочник | — | — | — | статусы |
| Проценка | POST /pricing/search | — | — | — | проценка |
| Товары | да | пакетная загрузка | пакетная загрузка | деактивация | каталог и остатки |
| Категории | — | пакетная загрузка | пакетная загрузка | деактивация | каталог и остатки |
| Остатки / цены | — | пакетная загрузка | пакетная загрузка | — | каталог и остатки |
| Прайс-файл | статус задачи | загрузка | — | — | прайс-листы |
| Платежи | да | да | да | да | платежи |
| Оплата / доставка | GET /modules | — | — | — | справочники |
| Точки выдачи | да | нет | нет | нет | справочники |
| Организации | да | нет | нет | нет | пользователи и организации |
| Документы | да | нет | только внешний ID | нет | документы |
Полный список методов
Заказы
| Метод | Путь | Право |
|---|---|---|
GET | /orders | orders.read |
GET | /orders/{id} | orders.read |
POST | /orders | orders.write |
PATCH | /orders/{id} | orders.write |
DELETE | /orders/{id} | orders.delete |
POST | /orders/{id}/status | orders.write_status |
POST | /orders/{id}/meta | orders.write_meta |
POST | /orders/{id}/archive | orders.archive |
POST | /orders/{id}/unarchive | orders.unarchive |
GET | /orders/{orderId}/items/{itemId} | orders.read |
POST | /orders/{orderId}/items | order_items.write |
PATCH | /orders/{orderId}/items/{itemId} | order_items.write |
DELETE | /orders/{orderId}/items/{itemId} | order_items.delete |
POST | /orders/{orderId}/items/{itemId}/status | orders.write_status |
POST | /orders/{orderId}/items/{itemId}/archive | order_items.archive |
POST | /orders/{orderId}/items/{itemId}/unarchive | order_items.unarchive |
Статусы
| Метод | Путь | Право |
|---|---|---|
GET | /statuses/orders | statuses.read |
GET | /statuses/order-items | statuses.read |
Пользователи, организации, платежи, документы
| Метод | Путь | Право |
|---|---|---|
GET | /users, /users/{id} | users.read |
POST | /users | users.write |
PATCH | /users/{id} | users.write |
DELETE | /users/{id} | users.delete |
POST | /users/{id}/meta | users.write_meta |
GET | /organizations | organizations.read |
GET | /payments, /payments/{id} | payments.read |
POST | /payments | payments.write |
PATCH | /payments/{id} | payments.write |
DELETE | /payments/{id} | payments.delete |
GET | /documents | documents.read |
POST | /documents/{id}/external-ref | documents.write_external_ref |
Каталог, проценка, прайсы, справочники
| Метод | Путь | Право |
|---|---|---|
GET | /products | products.read |
GET | /products/{id} | products.read |
POST | /products/batch-upsert | products.write |
POST | /products/delete | products.delete |
POST | /categories/batch-upsert | categories.write |
POST | /categories/delete | categories.delete |
POST | /stocks/batch-update | stocks.write |
POST | /pricing/search | pricing.read |
POST | /price-lists/upload | price_lists.write |
POST | /price-lists/status | price_lists.write |
GET | /modules | modules.read |
GET | /pickup-points | pickup_points.read |
POST | /integrations/{package}/sync | integrations.trigger_sync |
Входящий webhook модуля
| Метод | Путь | Авторизация |
|---|---|---|
POST | /integrations/inbound/{package}/{instance} | Подпись модуля (X-Integration-Signature), не Bearer API |
См. Платформа интеграций → Inbound.
Чего API намеренно не делает
- Не создаёт и не правит точки выдачи и организации — только чтение.
- Не создаёт и не правит содержимое документов (PDF/номер) — только список и внешний ID.
- Не заменяет готовые модули интеграций — у них свои подключения в панели управления.
Пагинация списков
Большинство GET-списков — cursor-пагинация:
| Параметр | Описание |
|---|---|
per_page | 1–100, по умолчанию 50 |
cursor | курсор следующей страницы |
since | фильтр по updated_at (где поддерживается) |
В ответе: data, per_page, next_cursor, next_page_url, …
Общие коды ошибок
| HTTP | Когда |
|---|---|
401 | Нет/неверный Bearer |
403 | Нет права или чужая точка |
404 | Сущность не найдена |
422 | Ошибка валидации (message + errors) |