CRM и продажи
API для внутренней работы с клиентами и исполнением заказов. Сотрудник или внутренний сервис с User Bearer может вести клиентскую базу, получать заказы, связывать их с промоакциями, изменять реквизиты и состав заказов, назначать задачи команде.
Клиентская витрина оформляет покупки через интернет-магазин и приложения. Этот раздел посвящён внутренней клиентской базе и обработке заказов независимо от того, созданы они витриной, сотрудником или серверной интеграцией.
С чего начать
Синхронизировать клиентскую базу
Получайте и создавайте физических лиц и компании, обновляйте контакты и реквизиты, фильтруйте список по менеджеру и просматривайте историю изменений.
Обрабатывать заказы
Фильтруйте заказы по источнику, клиенту, отделу и статусу; hierarchy=my ограничивает выборку заказами текущего менеджера. Работайте с составом, файлами, историей и заявками на возврат.
Отмечать источник заказа или мероприятия
Получите промоакции проекта и передайте promotion_id во внутренний заказ или мероприятие. Эта связь нужна для классификации и атрибуции, но не рассчитывает скидку.
Назначать работу команде
Создавайте задачи по заказу, назначайте исполнителя, срок и уведомления, затем обновляйте состояние задачи.
Выберите задачу
| Задача | Раздел |
|---|---|
| Найти или изменить клиента либо компанию | Клиенты и контрагенты |
| Получить заказы для обработки | Заказы и исполнение |
| Изменить реквизиты и состав заказа | Заказы и исполнение |
| Связать заказ или мероприятие с внутренней промоакцией | Промоакции |
| Получить историю заказа или оформить заявку на возврат | Заказы и исполнение |
| Создать и назначить задачу | Задачи команды |
Доступ
Сотрудник и внутренний сервис используют User Bearer. Agent Token применяйте только к точному списку методов, разрешённых профилем агента: рекомендуемый production-профиль допускает безопасное чтение заказов и контрагентов, но не включает /api/tasks* и другие непроверенные операции записи. Ограничения и готовые профили собраны в разделе об агентском доступе.
Карточки методов описывают параметры, фильтры и ограничения. Права User Bearer задаются ролью и разрешениями (permissions) учётной записи; техническому пользователю выдавайте только необходимый набор. Общие правила авторизации собраны в правилах API.
Связанные разделы
- Создание заказа клиентом, оплата, стратегии продаж, промокоды и скидки — интернет-магазин и приложения.
- Товары и услуги — каталог.
- Остатки и резервы под заказ — управление складом.
- Профиль и заказы в личном кабинете клиента — профиль клиента.
- Регулярные списания и состояние подписки — сервис управления подписками.