Accounting

Методы

Сервис предназначен для работы с информацией, связанной с деньгами - типы плательщиков, расчеты сумм и т.д.

Основной сценарий использования - расчет итоговой суммы для элемента CRM по списку привязанных к нему товарных позиций с учетом налогов, скидок и т.д.

В процессе расчета вычисляется сразу несколько сумм, при этом сам расчет может быть достаточно затратной операцией.

Чтобы не выполнять одинаковые расчеты несколько раз, внутри сервиса производится кеширование результатов расчета на уровне элемента.

Кеш можно сбросить отдельным методом. Также есть метод, выполняющий расчеты без кеширования.

Экземпляр сервиса следует получать из контейнера.

public function isTaxMode(): 
bool

public function setTaxMode(bool $isTaxMode): 
self

public function clearCache(): 
self

public function calculateByItem(Item $item): 
Accounting\Result

public function calculate
(array $productRows, string $currencyId, int $personTypeId, 
?string $locationId = null): 
?array

public function resolvePersonTypeId(Item $item): 
int

public function calculatePriceWithoutTax
(float $priceWithTax, float $taxRate): float

public function calculatePriceWithTax
(float $priceWithoutTax, float $taxRate): 
float

Accounting\Result

Результат расчета итоговых сумм отдается в виде отдельного класса наследника Bitrix\Main\Result.

Он содержит в себе как сами результаты расчетов, так и информацию об ошибках.

Информация об ошибках редко используется. Как правило, надо выполнить расчет и получить одно из полей результата.

Чтобы обеспечить работоспособность этого сценария у класса есть ряд публичных методов.

Если при выполнении расчетов возникла ошибка, то эти методы вернут null.

public function getPrice(): ?float

public function getCurrencyId(): ?string

public function getPersonTypeId(): ?int

public function getLocationId(): ?string

public function getTaxValue(): ?float

Примеры

use Bitrix\Crm\Service;

$factory = Service\Container::getInstance()->getFactory(\CCrmOwnerType::Quote);

$item = $factory->createItem();

$productRow = \Bitrix\Crm\ProductRow::createFromArray([
	'PRODUCT_NAME' => 'new product',
	'PRICE' => 999,
	'QUANTITY' => 3,
	'DISCOUNT_RATE' => 20,
]);

$item->addToProductRows($productRow);

$price = Service\Container::getInstance()->getAccounting()->calculateByItem($item)->getPrice();

$item->setOpportunity($price);