Как получить список дел из сделок

Scope: crm, user_brief

Кто может выполнять метод: пользователь с доступом на чтение сделок в CRM

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Список дел позволяет отслеживать текущие задачи и звонки по сделкам, сроки выполнения дел и ответственных. Чтобы сформировать таблицу дел, последовательно выполним методы:

user.current — найдем ID текущего пользователя,
crm.item.list — получим ID всех сделок, в которых сотрудник является ответственным,
crm.activity.list — сформируем список дел по сделкам,
user.get — получим информацию об ответственных за дела.

1. Получим ID текущего пользователя

Чтобы получить идентификатор текущего пользователя, используем метод user.current.

Как использовать примеры в документации

PHP

Python

BX24.callMethod(
            'user.current',
            {}
        );

require_once('crest.php');
        
        $result = CRest::call(
            'user.current',
            []
        );

from b24pysdk import BitrixWebhook, Client
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="user_id/webhook_key",
            )
        )
        
        result = client.user.current().response.result

В результате получим идентификатор пользователя "ID": "29".

{
            "result": {
                "ID": "29",
                "ACTIVE": true,
                "NAME": "Иван",
                "LAST_NAME": "Иванов",
                ...
            }
        }

2. Получим список ID сделок сотрудника

Чтобы получить идентификаторы сделок, закрепленных за сотрудником, вызовем метод crm.item.list. Передаем параметры:

entityTypeId — идентификатор типа объекта CRM. Получить идентификаторы можно методом crm.enum.ownertype. Укажем значение — 2, то есть сделка.
select — массив полей, которые нужно выбрать. Укажем select: ['id','title'], чтобы получить идентификаторы и названия сделок.
filter — фильтр выборки. Чтобы выбрать сделки по ID ответственного сотрудника, укажем идентификатор пользователя, который получили в прошлом запросе assignedById: 29.

Чтобы запрос работал быстрее и возвращал только актуальные данные, добавьте фильтр по стадиям stageId. Например можно выбрать сделки на стадии В работе.

Как отфильтровать элементы по названию стадии

PHP

Python

BX24.callMethod(
            'crm.item.list',
            {
                entityTypeId: 2,
                select: ['id','title'],
                filter: {
                    assignedById: 29
                }
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.list',
            [
                'entityTypeId' => 2,
                'select' => ['id','title'],
                'filter' => [
                    'assignedById' => 29
                ]
            ]
        );

result = client.crm.item.list(
            entity_type_id=2,
            select=["id", "title"],
            filter={"assignedById": 29},
        ).response.result

В результате получим массив items c идентификаторами сделок вида "id": 5111.

{
            "result": {
                "items": [
                    { "id": 5111, "title": "Сделка №1" },
                    { "id": 5199, "title": "Сделка №2" },
                    { "id": 5257, "title": "Сделка №3" }
                ]
            },
            "total": 3
        }

3. Получим список дел по найденным сделкам

Для получения списка дел используем метод crm.activity.list.

Чтобы выбрать дела из нескольких сделок, в фильтре filter используем ключ привязки к элементам CRM BINDINGS. Передадим в нем массив объектов. Каждый объект содержит:

OWNER_TYPE_ID — идентификатор типа объекта CRM. Получить идентификаторы можно методом crm.enum.ownertype. Укажем значение — 2, то есть сделка.
OWNER_ID — идентификатор сделки из результата прошлого запроса.

Также отфильтруем только активные дела COMPLETED: 'N'.

Выведем в результате select поля:

ID — идентификатор дела,
OWNER_ID — идентификатор сделки,
SUBJECT — описание дела,
DEADLINE — дата и время срока выполнения,
RESPONSIBLE_ID — идентификатор пользователя, ответственного за дело.

PHP

Python

BX24.callMethod(
            'crm.activity.list',
            {
                filter: {
                    BINDINGS: [
                        { OWNER_TYPE_ID: 2, OWNER_ID: 5111 },
                        { OWNER_TYPE_ID: 2, OWNER_ID: 5199 },
                        { OWNER_TYPE_ID: 2, OWNER_ID: 5257 }
                    ],
                    COMPLETED: 'N'
                },
                select: ['ID', 'OWNER_ID', 'SUBJECT', 'DEADLINE', 'RESPONSIBLE_ID']
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.activity.list',
            [
                'filter' => [
                    'BINDINGS' => [
                        ['OWNER_TYPE_ID' => 2, 'OWNER_ID' => 5111],
                        ['OWNER_TYPE_ID' => 2, 'OWNER_ID' => 5199],
                        ['OWNER_TYPE_ID' => 2, 'OWNER_ID' => 5257]
                    ],
                    'COMPLETED' => 'N'
                ],
                'select' => ['ID', 'OWNER_ID', 'SUBJECT', 'DEADLINE', 'RESPONSIBLE_ID']
            ]
        );

result = client.crm.activity.list(
            filter={
                "BINDINGS": [
                    {"OWNER_TYPE_ID": 2, "OWNER_ID": 5111},
                    {"OWNER_TYPE_ID": 2, "OWNER_ID": 5199},
                    {"OWNER_TYPE_ID": 2, "OWNER_ID": 5257},
                ],
                "COMPLETED": "N",
            },
            select=["ID", "OWNER_ID", "SUBJECT", "DEADLINE", "RESPONSIBLE_ID"],
        ).response.result

В результате получим список дел с описанием каждого дела.

{
            "result": [
                {
                    "ID": "10120",
                    "OWNER_ID": "5111",
                    "SUBJECT": "Позвонить клиенту",
                    "DEADLINE": "2025-08-21T16:00:00+03:00",
                    "RESPONSIBLE_ID": "29"
                },
                {
                    "ID": "10131",
                    "OWNER_ID": "5199",
                    "SUBJECT": "Проверить договор",
                    "DEADLINE": "2025-08-29T16:00:00+03:00",
                    "RESPONSIBLE_ID": "47"
                },
                ...
            ],
            "total": 5
        }

4. Получим данные пользователей по RESPONSIBLE_ID

Ответственным за дело в сделке может быть любой пользователь, не только ответственный за сделку. Чтобы увидеть в таблице имя и фамилию ответственного за дело, используем метод user.get.

В фильтре filter передадим идентификаторы ответственных ID: [29, 47, ...].

PHP

Python

BX24.callMethod(
            'user.get',
            {
                filter: {
                    ID: [29, 47, ...]
                }
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'user.get',
            [
                'filter' => [
                    'ID' => [29, 47, ...]
                ]
            ]
        );

result = client.user.get(
            filter={
                "ID": [29, 47],
            }
        ).response.result

В результате получим информацию о пользователях.

{
            "result": [
                {
                    "ID": "29",
                    "XML_ID": "23699770",
                    "ACTIVE": true,
                    "NAME": "Иван",
                    "LAST_NAME": "Иванов"
                },
                {
                    "ID": "47",
                    "XML_ID": "63726962",
                    "ACTIVE": true,
                    "NAME": "Петр",
                    "LAST_NAME": "Петров"
                },
                ...
            ],
            "total": 3,
        }

Пример кода

PHP

Python

// Функция для формирования массива привязок к сделкам
        // тип объекта CRM OWNER_TYPE_ID — 2, то есть сделка
        function buildBindingsFromDealIds(dealIds) {
            return dealIds.map((id) => ({ OWNER_TYPE_ID: 2, OWNER_ID: id }));
        }
        
        // Функция для получения всех элементов с помощью постраничной навигации
        // Нужна для списочных методов, так как один запрос получает максимум 50 записей
        function fetchAllItems(method, params, callback) {
            let allResults = [];
            
            function processResult(result) {
                if (result.error()) {
                    console.error(`Ошибка получения данных из ${method}:`, result.error().ex);
                    callback(result.error(), null);
                    return;
                }
        
                const data = result.data();
                
                // Обработка результатов в зависимости от метода
                if (method === 'crm.item.list') {
                    allResults = allResults.concat(data.items || []);
                } else if (method === 'crm.activity.list') {
                    allResults = allResults.concat(data || []);
                } else {
                    if (Array.isArray(data)) {
                        allResults = allResults.concat(data);
                    } else if (data && Array.isArray(data.result)) {
                        allResults = allResults.concat(data.result);
                    }
                }
        
                // Проверяем, есть ли ещё данные
                if (result.more && result.more()) {
                    // Используем result.next() для получения следующей страницы
                    result.next(processResult);
                } else {
                    // Если больше нет страниц, завершаем
                    callback(null, allResults);
                }
            }
        
            // Первый запрос
            BX24.callMethod(method, params, processResult);
        }
        
        // Шаг 1: Получаем информацию о текущем пользователе
        BX24.callMethod('user.current', {}, function(userResult) {
            if (userResult.error()) {
                console.error('Ошибка получения пользователя:', userResult.error().ex);
                return;
            }
        
            const current = userResult.data();
            const userId = Number(current.ID);
            console.log('Текущий пользователь ID:', userId);
        
            // Шаг 2: Получаем список всех сделок
            fetchAllItems('crm.item.list', {
                entityTypeId: 2,
                select: ['id', 'title'],
                filter: { assignedById: userId }
            }, function(error, allItems) {
                if (error) {
                    console.error('Ошибка получения всех сделок:', error.ex);
                    return;
                }
        
                const dealIds = allItems.map(it => it.id);
                const dealMap = allItems.reduce((map, deal) => {
                    map[deal.id] = deal.title;
                    return map;
                }, {});
        
                console.log('Сделки:', dealMap);
        
                if (dealIds.length === 0) {
                    alert('У сотрудника нет сделок');
                    return;
                }
        
                // Формируем привязки для поиска дел по сделкам
                const bindings = buildBindingsFromDealIds(dealIds);
        
                // Шаг 3: Получаем все дела, привязанные к этим сделкам
                fetchAllItems('crm.activity.list', {
                    filter: { BINDINGS: bindings, COMPLETED: 'N' },
                    select: ['ID', 'OWNER_ID', 'SUBJECT', 'DEADLINE', 'RESPONSIBLE_ID']
                }, function(error, allActivities) {
                    if (error) {
                        console.error('Ошибка получения всех дел:', error.ex);
                        return;
                    }
        
                    const userIds = [...new Set(allActivities.map(a => a.RESPONSIBLE_ID))];
        
                    if (userIds.length === 0) {
                        console.log('Нет незавершенных дел по сделкам.');
                        console.table([]);
                        return;
                    }
        
                    // Шаг 4: Получаем данные пользователей
                    BX24.callMethod('user.get', {
                        filter: { ID: userIds }
                    }, function(userResult) {
                        if (userResult.error()) {
                            console.error('Ошибка получения пользователей:', userResult.error().ex);
                            const tableFallback = allActivities.map(a => ({
                                activityId: a.ID,
                                dealTitle: dealMap[a.OWNER_ID] || `Сделка #${a.OWNER_ID}`,
                                subject: a.SUBJECT,
                                deadline: a.DEADLINE,
                                responsibleId: a.RESPONSIBLE_ID,
                                responsibleName: `Пользователь ${a.RESPONSIBLE_ID} (не найден)`
                            }));
                            console.table(tableFallback);
                            return;
                        }
        
                        const users = userResult.data();
                        const userMap = users.reduce((map, user) => {
                            map[user.ID] = `${user.NAME || ''} ${user.LAST_NAME || ''}`.trim() || user.LOGIN;
                            return map;
                        }, {});
        
                        const table = allActivities.map(a => ({
                            activityId: a.ID,
                            dealTitle: dealMap[a.OWNER_ID] || `Сделка #${a.OWNER_ID}`,
                            subject: a.SUBJECT,
                            deadline: a.DEADLINE,
                            responsibleId: a.RESPONSIBLE_ID,
                            responsibleName: userMap[a.RESPONSIBLE_ID] || `Пользователь ${a.RESPONSIBLE_ID}`
                        }));
        
                        console.table(table);
                    });
                });
            });
        });

<?php
        
        require_once('crest.php');
        
        // Функция для формирования массива привязок к сделкам
        // OWNER_TYPE_ID: 2 — тип объекта CRM — сделка
        function buildBindingsFromDealIds($dealIds) {
            $bindings = [];
            foreach ($dealIds as $id) {
                $bindings[] = [
                    'OWNER_TYPE_ID' => 2,
                    'OWNER_ID' => (int)$id,
                ];
            }
            return $bindings;
        }
        
        // Функция для получения всех элементов с помощью постраничной навигации
        // Нужна для списочных методов, так как один запрос получает максимум 50 записей
        function fetchAllItems($method, $params) {
            $allResults = [];
            
            $start = 0;
            $batchSize = 50;
            
            do {
                $params['start'] = $start;
                $result = CRest::call($method, $params);
                
                if (!empty($result['error'])) {
                    return ['error' => $result['error'], 'error_description' => $result['error_description']];
                }
                
                $data = $result['result'] ?? [];
                
                // Обработка результатов в зависимости от метода
                if ($method === 'crm.item.list') {
                    if (!empty($data['items']) && is_array($data['items'])) {
                        $allResults = array_merge($allResults, $data['items']);
                    }
                } elseif ($method === 'crm.activity.list') {
                    if (is_array($data)) {
                        $allResults = array_merge($allResults, $data);
                    }
                } else {
                    if (is_array($data)) {
                        $allResults = array_merge($allResults, $data);
                    }
                }
                
                // Проверяем, есть ли ещё данные
                if (count($data) >= $batchSize) {
                    $start += $batchSize;
                } else {
                    break;
                }
                
            } while (true);
            
            return ['result' => $allResults];
        }
        
        // Шаг 1: Получаем информацию о текущем пользователе
        $userResult = CRest::call('user.current', []);
        
        if (!empty($userResult['error'])) {
            echo 'Ошибка получения пользователя: ' . $userResult['error_description'] . "\n";
            exit;
        }
        
        $current = $userResult['result'] ?? null;
        if (!$current || empty($current['ID'])) {
            echo "Не удалось получить текущего пользователя\n";
            exit;
        }
        
        $userId = (int)$current['ID'];
        echo "Текущий пользователь ID: $userId\n";
        
        // Шаг 2: Получаем список всех сделок
        $itemsResult = fetchAllItems('crm.item.list', [
            'entityTypeId' => 2,
            'select' => ['id', 'title'],
            'filter' => ['assignedById' => $userId]
        ]);
        
        if (isset($itemsResult['error'])) {
            echo 'Ошибка получения всех сделок: ' . $itemsResult['error_description'] . "\n";
            exit;
        }
        
        $allItems = $itemsResult['result'];
        
        $dealMap = [];
        $dealIds = [];
        foreach ($allItems as $item) {
            $id = (int)$item['id'];
            $dealIds[] = $id;
            $dealMap[$id] = $item['title'];
        }
        
        echo "Найдено сделок: " . count($dealIds) . "\n";
        
        if (empty($dealIds)) {
            echo "У сотрудника нет сделок\n";
            exit;
        }
        
        // Формируем привязки для поиска дел по сделкам
        $bindings = buildBindingsFromDealIds($dealIds);
        
        // Шаг 3: Получаем все дела, привязанные к этим сделкам
        $activitiesResult = fetchAllItems('crm.activity.list', [
            'filter' => [
                'BINDINGS' => $bindings,
                'COMPLETED' => 'N',
            ],
            'select' => ['ID', 'OWNER_ID', 'SUBJECT', 'DEADLINE', 'RESPONSIBLE_ID']
        ]);
        
        if (isset($activitiesResult['error'])) {
            echo 'Ошибка получения всех дел: ' . $activitiesResult['error_description'] . "\n";
            exit;
        }
        
        $allActivities = $activitiesResult['result'];
        
        if (empty($allActivities)) {
            echo "Нет незавершённых дел по сделкам.\n";
            echo implode("\t", ['ID дела', 'Сделка', 'Тема', 'Дедлайн', 'Ответственный']) . "\n";
            exit;
        }
        
        // Собираем уникальные ID ответственных
        $responsibleIds = array_unique(array_column($allActivities, 'RESPONSIBLE_ID'));
        $userMap = [];
        
        if (!empty($responsibleIds)) {
            // Шаг 4: Получаем данные пользователей
            $usersResult = fetchAllItems('user.get', [
                'filter' => ['ID' => array_values($responsibleIds)]
            ]);
        
            if (isset($usersResult['error'])) {
                echo 'Ошибка получения пользователей: ' . $usersResult['error_description'] . "\n";
                $userMap = [];
            } else {
                foreach ($usersResult['result'] as $user) {
                    $fullName = trim(($user['NAME'] ?? '') . ' ' . ($user['LAST_NAME'] ?? ''));
                    $userMap[$user['ID']] = $fullName ?: ($user['LOGIN'] ?? "Пользователь {$user['ID']}");
                }
            }
        }
        
        // Формируем и выводим таблицу
        $header = ['ID дела', 'Сделка', 'Тема', 'Дедлайн', 'Ответственный'];
        echo implode("\t", $header) . "\n";
        
        foreach ($allActivities as $a) {
            $activityId = $a['ID'] ?? '';
            $ownerId = (int)($a['OWNER_ID'] ?? 0);
            $dealTitle = $dealMap[$ownerId] ?? "Сделка #{$ownerId}";
            $subject = $a['SUBJECT'] ?? '';
            $deadline = $a['DEADLINE'] ?? '';
            $responsibleId = $a['RESPONSIBLE_ID'] ?? '';
            $responsibleName = $userMap[$responsibleId] ?? "Пользователь {$responsibleId} (не найден)";
        
            echo implode("\t", [
                $activityId,
                $dealTitle,
                $subject,
                $deadline,
                $responsibleName
            ]) . "\n";
        }

from b24pysdk import BitrixWebhook, Client
        
        
        def build_bindings_from_deal_ids(deal_ids):
            return [{"OWNER_TYPE_ID": 2, "OWNER_ID": deal_id} for deal_id in deal_ids]
        
        
        def fetch_all_items(fetch_page, data_key=None):
            all_results = []
            start = 0
            batch_size = 50
        
            while True:
                response = fetch_page(start)
                if data_key is None:
                    page_items = response.result or []
                else:
                    page_items = response.result.get(data_key, [])
        
                all_results.extend(page_items)
        
                if len(page_items) < batch_size:
                    break
        
                start += batch_size
        
            return all_results
        
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="user_id/webhook_key",
            )
        )
        
        current = client.user.current().response.result
        user_id = int(current["ID"])
        print(f"Текущий пользователь ID: {user_id}")
        
        all_items = fetch_all_items(
            lambda start: client.crm.item.list(
                entity_type_id=2,
                select=["id", "title"],
                filter={"assignedById": user_id},
                start=start,
            ).response,
            data_key="items",
        )
        
        deal_ids = [int(item["id"]) for item in all_items]
        deal_map = {int(item["id"]): item["title"] for item in all_items}
        
        print(f"Найдено сделок: {len(deal_ids)}")
        
        if not deal_ids:
            print("У сотрудника нет сделок")
        else:
            bindings = build_bindings_from_deal_ids(deal_ids)
        
            all_activities = fetch_all_items(
                lambda start: client.crm.activity.list(
                    filter={
                        "BINDINGS": bindings,
                        "COMPLETED": "N",
                    },
                    select=["ID", "OWNER_ID", "SUBJECT", "DEADLINE", "RESPONSIBLE_ID"],
                    start=start,
                ).response
            )
        
            if not all_activities:
                print("Нет незавершенных дел по сделкам.")
                print("\t".join(["ID дела", "Сделка", "Тема", "Дедлайн", "Ответственный"]))
            else:
                responsible_ids = sorted(
                    {
                        int(item["RESPONSIBLE_ID"])
                        for item in all_activities
                        if item.get("RESPONSIBLE_ID")
                    }
                )
        
                user_map = {}
                if responsible_ids:
                    users = fetch_all_items(
                        lambda start: client.user.get(
                            filter={"ID": responsible_ids},
                            start=start,
                        ).response
                    )
                    for user in users:
                        full_name = f"{user.get('NAME', '')} {user.get('LAST_NAME', '')}".strip()
                        user_map[str(user["ID"])] = full_name or user.get("LOGIN", f"Пользователь {user['ID']}")
        
                print("\t".join(["ID дела", "Сделка", "Тема", "Дедлайн", "Ответственный"]))
                for activity in all_activities:
                    activity_id = activity.get("ID", "")
                    owner_id = int(activity.get("OWNER_ID", 0))
                    deal_title = deal_map.get(owner_id, f"Сделка #{owner_id}")
                    subject = activity.get("SUBJECT", "")
                    deadline = activity.get("DEADLINE", "")
                    responsible_id = activity.get("RESPONSIBLE_ID", "")
                    responsible_name = user_map.get(str(responsible_id), f"Пользователь {responsible_id} (не найден)")
        
                    print(
                        "\t".join(
                            [
                                str(activity_id),
                                str(deal_title),
                                str(subject),
                                str(deadline),
                                str(responsible_name),
                            ]
                        )
                    )

Как найти дубликаты в CRM по телефону и email

Как получить список стадий c семантикой для объектов CRM

Как получить список дел из сделок

1. Получим ID текущего пользователя1. Получим ID текущего пользователя

2. Получим список ID сделок сотрудника2. Получим список ID сделок сотрудника

3. Получим список дел по найденным сделкам3. Получим список дел по найденным сделкам

4. Получим данные пользователей по RESPONSIBLE_ID4. Получим данные пользователей по RESPONSIBLE_ID

Пример кодаПример кода

1. Получим ID текущего пользователя

2. Получим список ID сделок сотрудника

3. Получим список дел по найденным сделкам

4. Получим данные пользователей по RESPONSIBLE_ID

Пример кода