Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Как добавить действие для создания счета на основании лида или сделки». Вы узнаете экспертные методики работы с добавить действие и научитесь избегать типичных ошибок начинающих разработчиков.

Как добавить действие для создания счета на основании лида или сделки

Пример универсальный для действий бизнес-процессов и роботов. Отличается только метод:

• bizproc.activity.add — создать действие бизнес-процесса
• bizproc.robot.add — создать робота

В коде примера использован метод bizproc.activity.add. Если вы хотите создать робота, замените метод на bizproc.robot.add.

Чтобы использовать пример, настройте работу класса CRest и подключите файл crest.php в файлах, где используется этот класс. Подробнее в статье [](../../first-steps/how-to-use-examples).

Файл регистрации действия

Замените путь $handlerUrl на ваш путь до обработчика действия.

• JS

    BX24.callMethod(
        "bizproc.activity.add",
        {
            "CODE": "activityAccount",
            "HANDLER": "https://yourdomain.yyy/handler.php",
            "AUTH_USER_ID": 1,
            "NAME": "ActivityAccount",
            "DESCRIPTION": "description",
            "PROPERTIES": {
                "account_title": {
                    "Name": "Format account title",
                    "Description": "",
                    "Type": "string",
                    "Required": "Y",
                    "Multiple": "N",
                    "Default": "Account title"
                },
                "my_company_id": {
                    "Name": "My Company id",
                    "Description": "",
                    "Type": "int",
                    "Required": "Y",
                    "Multiple": "N",
                    "Default": "1"
                },
                "pay_system_id": {
                    "Name": "Pay system id",
                    "Description": "",
                    "Type": "int",
                    "Required": "Y",
                    "Multiple": "N",
                    "Default": "1"
                }
            }
        },
        function(result) {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );

• PHP

    <?
    $handlerUrl = 'https://yourdomain.yyy/handler.php';
    $result = CRest::call(
        'bizproc.activity.add',
        [
            'CODE' => 'activityAccount',
            'HANDLER' => $handlerUrl,
            'AUTH_USER_ID' => 1,
            'NAME' => 'ActivityAccount',
            'DESCRIPTION' => 'description',
            'PROPERTIES' => [
                'account_title' => [
                    'Name' => 'Format account title',
                    'Description' => '',
                    'Type' => 'string',
                    'Required' => 'Y',
                    'Multiple' => 'N',
                    'Default' => 'Account title',
                ],
                'my_company_id' => [
                    'Name' => 'My Company id',
                    'Description' => '',
                    'Type' => 'int',
                    'Required' => 'Y',
                    'Multiple' => 'N',
                    'Default' => '1',
                ],
                'pay_system_id' => [
                    'Name' => 'Pay system id',
                    'Description' => '',
                    'Type' => 'int',
                    'Required' => 'Y',
                    'Multiple' => 'N',
                    'Default' => '1',
                ],
            ]
        ]
    );
    ?>

Обработчик действия

<?
$my_company_id = intVal($_REQUEST['properties']['my_company_id']);
$pay_system_id = intVal($_REQUEST['properties']['pay_system_id']);//some in CRest::call('sale.paysystem.list')
$account_title = htmlspecialchars($_REQUEST['properties']['account_title']);
$arDocument = $_REQUEST['document_id'];
$iDealID = 0;
$iLeadID = 0;
if (is_array($arDocument))
{
    foreach ($arDocument as $param)
    {//search id
        if (strpos($param, 'DEAL_') !== false)
        {
            $iDealID = intVal(substr($param, strlen('DEAL_')));
            break;
        }
        elseif (strpos($param, 'LEAD_') !== false)
        {
            $iLeadID = intVal(substr($param, strlen('LEAD_')));
            break;
        }
    }
}
if ($iDealID > 0)
{
    $result = CRest::call(
        'crm.deal.get',
        [
            'id' => $iDealID
        ]
    );
    if (!empty($result['result']))
    {
        $arData = $result['result'];
        $resultProduct = CRest::call(
            'crm.deal.productrows.get',
            [
                'id' => $iDealID
            ]
        );
    }
}
elseif ($iLeadID > 0)
{
    $result = CRest::call(
        'crm.lead.get',
        [
            'id' => $iLeadID
        ]
    );
    if (!empty($result['result']))
    {
        $arData = $result['result'];
        $resultProduct = CRest::call(
            'crm.lead.productrows.get',
            [
                'id' => $iLeadID
            ]
        );
    }
}
if (!empty($arData['COMPANY_ID']) || !empty($arData['CONTACT_ID']))
{
    if (empty($resultProduct['result']))
    {//if the deal or lead has no products
        $resultProduct['result'][] = [
            'ID' => 0,
            'PRODUCT_ID' => 0,
            'PRODUCT_NAME' => $account_title,
            'QUANTITY' => 1,
            'PRICE' => ($arData['OPPORTUNITY'])?:0,
        ];
    }
    $arProduct = [];
    foreach ($resultProduct['result'] as $product)
    {
        $arProduct[] = [
            'ID' => $product['ID'],
            'PRODUCT_ID' => $product['PRODUCT_ID'],
            'PRODUCT_NAME' => $product['PRODUCT_NAME'],
            'QUANTITY' => $product['QUANTITY'],
            'PRICE' => $product['PRICE']
        ];
    }
    $resultInvoice = CRest::call(
        'crm.invoice.add',
        [
            'fields' => [
                'ORDER_TOPIC' => $account_title,
                'UF_COMPANY_ID' => $arData['COMPANY_ID'],
                'UF_CONTACT_ID' => $arData['CONTACT_ID'],
                'UF_DEAL_ID' => $arData['ID'],
                'UF_MYCOMPANY_ID' => $my_company_id,
                'PERSON_TYPE_ID' => ($arData['COMPANY_ID'] > 0) ? 1 : 2,//1 is company, 2 is contact in CRest::call('crm.persontype.list')
                'PAY_SYSTEM_ID' => $pay_system_id,
                "STATUS_ID" => "N",
                'DATE_INSERT' => date(DATE_ATOM),
                'DATE_BILL' => date(DATE_ATOM),
                'DATE_PAY_BEFORE' => date(DATE_ATOM, time() + 3600 * 24 * 20),//20 day pay
                'PRODUCT_ROWS' => $arProduct,
            ]
        ]
    );
}
?>