GetList

Описание и параметры

CDBResult
CSaleTaxRate::GetList(
	array arOrder = array("APPLY_ORDER"=>"ASC"),
	array arFilter = array()
);

Метод возвращает набор ставок налога, удовлетворяющих фильтру arFilter. Набор упорядочен в соответствии с массивом arOrder. Нестатический метод.

Параметры вызова

Параметр	Описание
arOrder	Ассоциативный массив для сортировки результирующего набора ставок налогов. Набор сортируется последовательно по каждой паре ключ-значение массива. Ключами массива являются названия параметров ставки налога, по значениям которых осуществляется сортировка. Значениями являются направления сортировки. Допустимые ключи: APPLY_ORDER - порядок применения; ID - код ставки налога; LID - сайт налога; CODE - символьный код налога; TIMESTAMP_X - дата последнего изменения параметров ставки; ACTIVE - флаг (Y/N) активности ставки; NAME - название налога; PERSON_TYPE_ID - тип плательщика ставки; IS_IN_PRICE - флаг (Y/N) входит ли ставка налога в цену Допустимые значения: ASC - по возрастанию; DESC - по убыванию.
arFilter	Ассоциативный массив условий для отбора (фильтрации) ставок налогов. Ключами являются названия фильтруемых параметров ставки налога, а значениями - условия на значения. Допустимые ключи: ID - код ставки налога; LID - сайт налога; CODE - символьный код налога; TAX_ID - код налога; PERSON_TYPE_ID - тип плательщика ставки налога; IS_IN_PRICE - флаг (Y/N) входит ли налог в цену; ACTIVE - флаг (Y/N) активности ставки налога; APPLY_ORDER - порядок применения; LOCATION - код местоположения, в котором действует ставка.

Параметр

Описание

arOrder

Ассоциативный массив для сортировки результирующего набора ставок налогов. Набор сортируется последовательно по каждой паре ключ-значение массива. Ключами массива являются названия параметров ставки налога, по значениям которых осуществляется сортировка. Значениями являются направления сортировки.

Допустимые ключи:

APPLY_ORDER - порядок применения;
ID - код ставки налога;
LID - сайт налога;
CODE - символьный код налога;
TIMESTAMP_X - дата последнего изменения параметров ставки;
ACTIVE - флаг (Y/N) активности ставки;
NAME - название налога;
PERSON_TYPE_ID - тип плательщика ставки;
IS_IN_PRICE - флаг (Y/N) входит ли ставка налога в цену

Допустимые значения:

ASC - по возрастанию;
DESC - по убыванию.

arFilter

Ассоциативный массив условий для отбора (фильтрации) ставок налогов. Ключами являются названия фильтруемых параметров ставки налога, а значениями - условия на значения.

Допустимые ключи:

ID - код ставки налога;
LID - сайт налога;
CODE - символьный код налога;
TAX_ID - код налога;
PERSON_TYPE_ID - тип плательщика ставки налога;
IS_IN_PRICE - флаг (Y/N) входит ли налог в цену;
ACTIVE - флаг (Y/N) активности ставки налога;
APPLY_ORDER - порядок применения;
LOCATION - код местоположения, в котором действует ставка.

Возвращаемые значения

Возвращается объект класса CDBResult, содержащий ассоциативные массивы параметров ставок налогов с ключами:

Ключ	Описание
ID	Код ставки налога.
TAX_ID	Код налога.
PERSON_TYPE_ID	Тип плательщика.
VALUE	Величина налога (в процентах)
CURRENCY	Валюта.
IS_PERCENT	Y
IS_IN_PRICE	Флаг (Y/N) входит ли уже налог в цену.
APPLY_ORDER	Порядок применения.
TIMESTAMP_X	Дата последнего изменения записи.
LID	Сайт налога.
NAME	Название налога.
CODE	Символьный код налога.
DESCRIPTION	Описание налога.
ACTIVE	Флаг (Y/N) активности ставки.

Пример использования

<?
// Заполним массив активных ставок налогов на текущем сайте для типа плательщика 
// с кодом $PERSON_TYPE и местоположением плательщика с кодом $TAX_LOCATION

$arTaxList = array();

$arTaxFilter = array(
	"LID" => SITE_ID,
	"PERSON_TYPE_ID" => $PERSON_TYPE,
	"ACTIVE" => "Y",
	"LOCATION" => $TAX_LOCATION
);

$db_tax_rate_tmp = CSaleTaxRate::GetList(array("APPLY_ORDER"=>"ASC"), $arTaxFilter);
while ($ar_tax_rate_tmp = $db_tax_rate_tmp->Fetch())
{
	$arTaxList[] = $ar_tax_rate_tmp;
}
?>