Интеграция с PlatParts по API
Единый REST API магазина PlatParts для внешних систем: CRM, ERP, склад, собственный бэкенд, middleware.
Базовый URL:
text
https://ВАШ_ДОМЕН/api/integrations/v1Других партнёрских REST-контуров (/api/b2b, /api/1c и т.п.) нет — всё делается через этот префикс.
Для чего подходит
| Сценарий | Как |
|---|---|
| CRM (Amo, Bitrix24, PlanFix, своя) | Читать/создавать заказы, статусы, meta с ID сделки; связывать документы через external_id |
| Учёт / склад / ERP | Каталог и остатки по external_id, прайс-файл в модуль «Прайс-листы» |
| Публичная часть / бот / B2B-кабинет | Проценка → создание заказа, справочники точек и способов оплаты |
| Готовый модуль платформы | Outbound/inbound webhooks + при необходимости тот же REST |
Типичный контур CRM:
- Ключ API с правами на заказы (и при необходимости пользователей/документы).
- Периодический
GET /orders?since=…или исходящий webhook модуля. - В CRM храните
idзаказа PlatParts; обратно пишите свой ID вPOST /orders/{id}/meta. - Документы сайта связывайте через
POST /documents/{id}/external-ref.
Этого справочника достаточно, чтобы написать интеграцию на любом языке (curl, PHP, Node, Python и т.д.) без отдельного «адаптера от PlatParts».
С чего начать
- Структура и обозначения — поля, суммы, права.
- Авторизация — ключ и scopes.
- Быстрый старт — первый
200 OK. - Все методы — полный каталог.
Разделы API
| Раздел | Назначение |
|---|---|
| Заказы | Обмен заказами, позициями и статусами с CRM |
| Статусы | Справочник статусов заказов и позиций |
| Пользователи и организации | Клиенты и юрлица |
| Каталог и остатки | JSON-синхронизация каталога наличия |
| Прайс-листы | Загрузка файла в модуль прайсов |
| Проценка | Предложения поставщиков |
| Платежи / Документы | Оплаты и внешние ссылки на документы |
| Справочники | Точки, оплата, доставка |
| Ошибки | Типовые сбои |
Два уровня интеграции
| Уровень | Когда выбирать |
|---|---|
| REST API (этот раздел) | Свой код, middleware, любая CRM без готового модуля |
| Модуль платформы (Платформа интеграций) | Готовый или свой пакет с хуками и webhooks (например PlanFix) |
Оба уровня используют один и тот же /api/integrations/v1. Модуль не заменяет REST — дополняет событиями.