How to Save the Payment Date in the Deal Field

# pip install b24pysdk
        from b24pysdk import BitrixWebhook, Client
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="USER_ID/TOKEN",  # user_id/token only, without https://
            )
        )
        
        fields = client.crm.item.fields(
            2,  # 2 — deal
        ).response.result["fields"]
        
        field_name = next(
            (
                key
                for key, settings in fields.items()
                if settings["title"] == "Payment Date" and settings["type"] in ("date", "datetime")
            ),
            None,
        )
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');
        
        // crm.item.fields has no wrapper in the SDK — call the method directly
        $resultFields = $sb->core->call(
            'crm.item.fields',
            [ 'entityTypeId' => 2 ] // 2 — deal
        );
        
        $fields = $resultFields->getResponseData()->getResult()['fields'];
        
        $fieldName = null;
        foreach ($fields as $key => $settings) {
            if ($settings['title'] === 'Payment Date' && in_array($settings['type'], ['date', 'datetime'], true)) {
                $fieldName = $key;
                break;
            }
        }
        

payments = client.crm.item.payment.list(
            entity_type_id=2,
            entity_id=6917,
        ).response.result
        

// crm.item.payment.list has no wrapper in the SDK — call the method directly
        $resultPayments = $sb->core->call(
            'crm.item.payment.list',
            [
                'entityTypeId' => 2,
                'entityId' => 6917
            ]
        );
        
        $payments = $resultPayments->getResponseData()->getResult();
        

result_update = client.crm.item.update(
            2,
            6917,
            {
                # the key is the field identifier from step 1, the value is datePaid from step 2
                field_name: payments[0]["datePaid"],
            },
        ).response.result["item"]
        

$resultUpdate = $sb->getCRMScope()->item()->update(
            2,
            6917,
            [
                // the key is the field identifier from step 1, the value is datePaid from step 2
                $fieldName => $payments[0]['datePaid']
            ]
        );
        

print(client.crm.item.get(2, 6917).response.result["item"][field_name])
        

echo $sb->getCRMScope()->item()->get(2, 6917)->item()->{$fieldName};
        

# pip install b24pysdk
        from b24pysdk import BitrixWebhook, Client
        from b24pysdk.errors import BitrixAPIError
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="USER_ID/TOKEN",  # user_id/token only, without https://
            )
        )
        
        ENTITY_TYPE_ID = 2  # 2 — deal
        DEAL_ID = 6917  # specify your own deal
        FIELD_TITLE = "Payment Date"  # the field name in the deal card
        
        try:
            # Step 1: find the field identifier by its name and type
            fields = client.crm.item.fields(
                ENTITY_TYPE_ID,
            ).response.result["fields"]
        
            field_name = next(
                (
                    key
                    for key, settings in fields.items()
                    if settings["title"] == FIELD_TITLE and settings["type"] in ("date", "datetime")
                ),
                None,
            )
        
            if field_name is None:
                print(f'The "{FIELD_TITLE}" field of the "Date" type is not found in the deal card')
            else:
                print(f"Field identifier: {field_name}")
        
                # Step 2: read the date of the completed payment
                payments = client.crm.item.payment.list(
                    entity_type_id=ENTITY_TYPE_ID,
                    entity_id=DEAL_ID,
                ).response.result
        
                dates = [
                    payment["datePaid"]
                    for payment in payments
                    if payment["paid"] == "Y" and payment["datePaid"]
                ]
        
                if not dates:
                    print(f"Deal {DEAL_ID} has no completed payments")
                else:
                    # take the latest payment rather than the first one in the array
                    date_paid = max(dates)
                    print(f"Payment date: {date_paid}")
        
                    # Step 3: write the date to the deal field
                    updated = client.crm.item.update(
                        ENTITY_TYPE_ID,
                        DEAL_ID,
                        {field_name: date_paid},
                    ).response.result["item"]
        
                    # a field of the "Date" type discards the time, so check the value in the response
                    print(f"Written to the deal: {updated[field_name]}")
        except BitrixAPIError as error:
            print(f"The payment date is not written: {error}")
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');
        
        $entityTypeId = 2; // 2 — deal
        $dealId = 6917; // specify your own deal
        $fieldTitle = 'Payment Date'; // the field name in the deal card
        
        try {
            // Step 1: find the field identifier by its name and type
            // crm.item.fields has no wrapper in the SDK — call the method directly
            $resultFields = $sb->core->call(
                'crm.item.fields',
                [ 'entityTypeId' => $entityTypeId ]
            );
            $fields = $resultFields->getResponseData()->getResult()['fields'];
        
            $fieldName = null;
            foreach ($fields as $key => $settings) {
                if ($settings['title'] === $fieldTitle && in_array($settings['type'], ['date', 'datetime'], true)) {
                    $fieldName = $key;
                    break;
                }
            }
            if ($fieldName === null) {
                echo 'The "' . $fieldTitle . '" field of the "Date" type is not found in the deal card';
                return;
            }
            echo 'Field identifier: ' . $fieldName . PHP_EOL;
        
            // Step 2: read the date of the completed payment
            // crm.item.payment.list has no wrapper in the SDK — call the method directly
            $resultPayments = $sb->core->call(
                'crm.item.payment.list',
                [
                    'entityTypeId' => $entityTypeId,
                    'entityId' => $dealId
                ]
            );
            $payments = $resultPayments->getResponseData()->getResult();
        
            $dates = [];
            foreach ($payments as $payment) {
                if ($payment['paid'] === 'Y' && !empty($payment['datePaid'])) {
                    $dates[] = $payment['datePaid'];
                }
            }
            if ($dates === []) {
                echo 'Deal ' . $dealId . ' has no completed payments';
                return;
            }
            // take the latest payment rather than the first one in the array
            sort($dates);
            $datePaid = end($dates);
            echo 'Payment date: ' . $datePaid . PHP_EOL;
        
            // Step 3: write the date to the deal field
            $updated = $sb->getCRMScope()->item()->update(
                $entityTypeId,
                $dealId,
                [ $fieldName => $datePaid ]
            );
        
            // a field of the "Date" type discards the time, so check the value in the response
            echo 'Written to the deal: ' . $updated->item()->{$fieldName};
        } catch (\Throwable $e) {
            echo 'The payment date is not written: ' . $e->getMessage();
        }