Интеграция с 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».

Раздел	Назначение
Заказы	Обмен заказами, позициями и статусами с CRM
Статусы	Справочник статусов заказов и позиций
Пользователи и организации	Клиенты и юрлица
Каталог и остатки	JSON-синхронизация каталога наличия
Прайс-листы	Загрузка файла в модуль прайсов
Проценка	Предложения поставщиков
Платежи / Документы	Оплаты и внешние ссылки на документы
Справочники	Точки, оплата, доставка
Ошибки	Типовые сбои

Уровень	Когда выбирать
REST API (этот раздел)	Свой код, middleware, любая CRM без готового модуля
Модуль платформы (Платформа интеграций)	Готовый или свой пакет с хуками и webhooks (например PlanFix)

Оба уровня используют один и тот же /api/integrations/v1. Модуль не заменяет REST — дополняет событиями.