Как добавить позицию в заказ с произвольной ценой

<?php
// composer require bitrix24/b24phpsdk:"^3.0"
require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('b24');
$log->pushHandler(new StreamHandler('php://stdout'));

$sb = (new ServiceBuilderFactory(new EventDispatcher(), $log))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

$result = $sb->getSaleScope()->basketItem()->add([
    'orderId' => 891,
    'productId' => 7075,
    'quantity' => 4,
    'currency' => 'RUB',
    'customPrice' => 'Y', // цену задаем сами, каталожная не применяется
    'basePrice' => 1030, // цена товара в каталоге
    'price' => 1100, // цена продажи
    'discountPrice' => -70, // наценка, поэтому значение отрицательное
]);

echo '<PRE>';
print_r($result->getId());
echo '</PRE>';

from b24pysdk import BitrixWebhook, Client
from b24pysdk.errors import BitrixAPIError

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.com",
        webhook_token="user_id/webhook_key",
    )
)

try:
    result = client.sale.basketitem.add(
        fields={
            "orderId": 891,
            "productId": 7075,
            "quantity": 4,
            "currency": "RUB",
            "customPrice": "Y",  # цену задаем сами, каталожная не применяется
            "basePrice": 1030,  # цена товара в каталоге
            "price": 1100,  # цена продажи
            "discountPrice": -70,  # наценка, поэтому значение отрицательное
        },
    ).response.result
    print(result)
except BitrixAPIError as error:
    print(error)

// Подготовка в пустом каталоге — go get без go mod init не сработает:
//
//	go mod init example && go get github.com/bitrix24/b24gosdk
//
// Запуск:
//
//	export B24_WEBHOOK_URL='https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/' && go run .
//
// Пример самодостаточный: он создает товар с ценой и заказ, добавляет позицию
// с ручной ценой, показывает ее и убирает за собой. Запускается на любом
// Битрикс24, ничего править не нужно.
package main

import (
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"log"
	"os"

	b24 "github.com/bitrix24/b24gosdk"
)

func main() {
	if err := run(context.Background()); err != nil {
		log.Fatal(err)
	}
}

func run(ctx context.Context) error {
	core := b24.NewClient(os.Getenv("B24_WEBHOOK_URL")).Core()

	// --- подготовка: товар с ценой и пустой заказ

	iblockID, err := firstCatalog(ctx, core)
	if err != nil {
		return err
	}
	productID, err := addProduct(ctx, core, iblockID, "Пример позиции (b24gosdk)")
	if err != nil {
		return err
	}
	defer del(ctx, core, "catalog.product.delete", productID)

	if err := addPrice(ctx, core, productID, 1030); err != nil {
		return err
	}
	orderID, err := addOrder(ctx, core)
	if err != nil {
		return err
	}
	defer del(ctx, core, "sale.order.delete", orderID)

	// --- собственно сценарий шага

	// Цена задается вручную, поэтому customPrice = "Y". Наценка выражается
	// ОТРИЦАТЕЛЬНЫМ discountPrice: базовая цена 1030, продаем за 1100.
	res, err := core.Call(ctx, "sale.basketitem.add", b24.Params{
		"fields": b24.Params{
			"orderId":       orderID,
			"productId":     productID,
			"quantity":      4,
			"currency":      "RUB",
			"customPrice":   "Y",
			"basePrice":     1030,
			"price":         1100,
			"discountPrice": -70,
		},
	})
	if err != nil {
		// Код ошибки сравнивается через errors.Is, а не строкой: опечатка в
		// литерале скомпилируется и молча уведет в другую ветку.
		if errors.Is(err, b24.ErrAccessDenied) {
			return fmt.Errorf("вебхуку не хватает прав на sale: %w", err)
		}
		return fmt.Errorf("sale.basketitem.add: %w", err)
	}

	// Метод заворачивает ответ в объект с ключом basketItem.
	raw, ok := b24.Unwrap(res.Result, "basketItem")
	if !ok {
		return fmt.Errorf("в ответе нет basketItem: %s", res.Result)
	}
	var item struct {
		ID        b24.ID  `json:"id"`
		Quantity  float64 `json:"quantity"`
		Price     float64 `json:"price"`
		BasePrice float64 `json:"basePrice"`
	}
	if err := json.Unmarshal(raw, &item); err != nil {
		return fmt.Errorf("разбор позиции: %w", err)
	}

	fmt.Printf("позиция %d: %.0f x %.2f при базовой цене %.2f\n",
		item.ID, item.Quantity, item.Price, item.BasePrice)
	return nil
}

// --- вспомогательное: подготовка данных и уборка

func firstCatalog(ctx context.Context, core *b24.Core) (b24.ID, error) {
	res, err := core.Call(ctx, "catalog.catalog.list", b24.Params{
		"filter": b24.Params{"iblockTypeId": "CRM_PRODUCT_CATALOG"},
	}, b24.WithIdempotent())
	if err != nil {
		return 0, fmt.Errorf("catalog.catalog.list: %w", err)
	}
	var out struct {
		Catalogs []struct {
			IblockID b24.ID `json:"iblockId"`
		} `json:"catalogs"`
	}
	if err := json.Unmarshal(res.Result, &out); err != nil {
		return 0, err
	}
	if len(out.Catalogs) == 0 {
		return 0, fmt.Errorf("в Битрикс24 нет торгового каталога")
	}
	return out.Catalogs[0].IblockID, nil
}

func addProduct(ctx context.Context, core *b24.Core, iblockID b24.ID, name string) (b24.ID, error) {
	res, err := core.Call(ctx, "catalog.product.add", b24.Params{
		"fields": b24.Params{"iblockId": iblockID, "name": name, "active": "Y"},
	})
	if err != nil {
		return 0, fmt.Errorf("catalog.product.add: %w", err)
	}
	// add отвечает ключом element, а get — ключом product для той же сущности.
	raw, ok := b24.Unwrap(res.Result, "element", "id")
	if !ok {
		return 0, fmt.Errorf("нет element.id в %s", res.Result)
	}
	var id b24.ID
	return id, json.Unmarshal(raw, &id)
}

func addPrice(ctx context.Context, core *b24.Core, productID b24.ID, price float64) error {
	res, err := core.Call(ctx, "catalog.priceType.list", nil, b24.WithIdempotent())
	if err != nil {
		return fmt.Errorf("catalog.priceType.list: %w", err)
	}
	var types struct {
		PriceTypes []struct {
			ID b24.ID `json:"id"`
		} `json:"priceTypes"`
	}
	if err := json.Unmarshal(res.Result, &types); err != nil {
		return err
	}
	if len(types.PriceTypes) == 0 {
		return fmt.Errorf("в Битрикс24 нет типов цен")
	}
	_, err = core.Call(ctx, "catalog.price.add", b24.Params{
		"fields": b24.Params{
			"productId": productID, "catalogGroupId": types.PriceTypes[0].ID,
			"price": price, "currency": "RUB",
		},
	})
	return err
}

func addOrder(ctx context.Context, core *b24.Core) (b24.ID, error) {
	res, err := core.Call(ctx, "sale.persontype.list", nil, b24.WithIdempotent())
	if err != nil {
		return 0, fmt.Errorf("sale.persontype.list: %w", err)
	}
	var types struct {
		PersonTypes []struct {
			ID b24.ID `json:"id"`
		} `json:"personTypes"`
	}
	if err := json.Unmarshal(res.Result, &types); err != nil {
		return 0, err
	}
	if len(types.PersonTypes) == 0 {
		return 0, fmt.Errorf("в Битрикс24 нет типов плательщика")
	}

	res, err = core.Call(ctx, "sale.order.add", b24.Params{
		"fields": b24.Params{
			"lid": "s1", "personTypeId": types.PersonTypes[0].ID, "currency": "RUB",
		},
	})
	if err != nil {
		return 0, fmt.Errorf("sale.order.add: %w", err)
	}
	raw, ok := b24.Unwrap(res.Result, "order", "id")
	if !ok {
		return 0, fmt.Errorf("нет order.id в %s", res.Result)
	}
	var id b24.ID
	return id, json.Unmarshal(raw, &id)
}

// del убирает созданное. Ошибку уборки печатаем, но не возвращаем: она не
// должна маскировать настоящую ошибку сценария.
func del(ctx context.Context, core *b24.Core, method string, id b24.ID) {
	if _, err := core.Call(ctx, method, b24.Params{"id": id}); err != nil {
		fmt.Fprintf(os.Stderr, "%s(%d): %v\n", method, id, err)
	}
}

<?php
// composer require bitrix24/b24phpsdk:"^3.0"
require_once 'vendor/autoload.php';

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('b24');
$log->pushHandler(new StreamHandler('php://stdout'));

$sb = (new ServiceBuilderFactory(new EventDispatcher(), $log))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

$result = $sb->getSaleScope()->basketItem()->add([
    'orderId' => 891,
    'productId' => 0, // позиции нет в каталоге
    'name' => 'Настройка оборудования',
    'quantity' => 2,
    'currency' => 'RUB',
    'customPrice' => 'Y',
    'basePrice' => 1000, // цена без скидки
    'price' => 900, // цена продажи
    'discountPrice' => 100, // скидка, поэтому значение положительное
    'canBuy' => 'Y',
    'weight' => 40,
    'measureCode' => '796',
    'measureName' => 'шт',
    'sort' => 400,
    'xmlId' => 'service-setup-1',
    'dimensions' => 'a:3:{s:5:"WIDTH";i:244;s:6:"HEIGHT";i:100;s:6:"LENGTH";i:31;}', // сериализованный массив
    'vatRate' => 0.1, // ставка 10 %
    'vatIncluded' => 'Y',
    'productXmlId' => 'service-setup',
]);

echo '<PRE>';
print_r($result->getId());
echo '</PRE>';

from b24pysdk import BitrixWebhook, Client
from b24pysdk.errors import BitrixAPIError

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.com",
        webhook_token="user_id/webhook_key",
    )
)

try:
    result = client.sale.basketitem.add(
        fields={
            "orderId": 891,
            "productId": 0,  # позиции нет в каталоге
            "name": "Настройка оборудования",
            "quantity": 2,
            "currency": "RUB",
            "customPrice": "Y",
            "basePrice": 1000,  # цена без скидки
            "price": 900,  # цена продажи
            "discountPrice": 100,  # скидка, поэтому значение положительное
            "canBuy": "Y",
            "weight": 40,
            "measureCode": "796",
            "measureName": "шт",
            "sort": 400,
            "xmlId": "service-setup-1",
            "dimensions": 'a:3:{s:5:"WIDTH";i:244;s:6:"HEIGHT";i:100;s:6:"LENGTH";i:31;}',  # сериализованный массив
            "vatRate": 0.1,  # ставка 10 %
            "vatIncluded": "Y",
            "productXmlId": "service-setup",
        },
    ).response.result
    print(result)
except BitrixAPIError as error:
    print(error)

$result = $sb->getSaleScope()->basketItem()->list(
    ['id', 'productId', 'name', 'quantity', 'basePrice', 'price', 'discountPrice', 'customPrice'],
    ['=orderId' => 891]
);

echo '<PRE>';
print_r($result->getBasketItems());
echo '</PRE>';

try:
    result = client.sale.basketitem.list(
        select=["id", "productId", "name", "quantity", "basePrice", "price", "discountPrice", "customPrice"],
        filter={"=orderId": 891},
    ).response.result
    print(result)
except BitrixAPIError as error:
    print(error)