Переменные

Общие сведения

Переменные предназначены для вставки в печатную форму необходимых данных. Все переменные начинаются с символа $.

Числовые переменные можно выводить прописью и с указанием денежных единиц. Также есть возможность задавать ширину строки вывода переменной в символах и выравнивание в пределах этой ширины (см. «Параметры вывода переменных»).

Переменные контрагентов

Доступны следующие префиксы к переменным контрагентов:

Agent — собственная фирма мобильного сотрудника, выбранная в документе.
Supplier — вторая собственная фирма мобильного сотрудника, используется в документах по отгрузке ТМЦ в случаях, когда поставщиком товара является головная организация, а отгрузчиком — филиал, как отдельное юридическое лицо.
JurPerson — юридическое лицо.
Client — клиент.
SalesAgent — мобильный сотрудник.

Например, переменная $ClientName содержит значение имени клиента, а $SalesAgentName — имя мобильного сотрудника.

Имя переменной	Описание	Технические сведения
`Name`	Наименование (имя)	DS_Faces.Fname
`ShortName`	Сокращенное наименование	DS_Faces.FShortName
`Address`	Адрес	DS_Faces.Address
`JurAddress`	Юридический адрес	DS_Faces.FurAddress
`AddressRequisite`	Адресные реквизиты	Набор переменных в определенном порядке, с вставками пояснительного текста: `$Address`, тел. `$Phone`, ИНН `$INN`. Если отсутствует значение переменной в БД, то пояснительное слово опускается.
`BankRequisite`	Банковские реквизиты	Набор переменных в определенном порядке, с вставками пояснительного текста: р/с `$BankAccount` в `$BankName` БИК `$BIK`, корр/с `$CorrAccount` Если отсутствует значение переменной в БД, то пояснительное слово опускается.
`BankAccount`	Банковский счет	DS_Faces.FbankAccount
`BankName`	Название банка	DS_Faces.FbankName
`BIK`	БИК банка	DS_Faces.Fbik
`CorrAccount`	Корреспондентский счет	DS_Faces.FcorrAccount
`Phone`	Телефон	DS_Faces.FPhone
`INN`	Индивидуальный налоговый номер (ИНН) и код причины постановки на учет (КПП) в формате ИНН/КПП	DS_Faces.Finn
`OKONH`	Общероссийский классификатор отраслей народного хозяйства (ОКОНХ)	DS_Faces.OKONH
`OKPO`	Общероссийский классификатор предприятий и организаций (ОКПО). Восьми- или десятизначный номер юридического лица в классификаторе, указываемый в бухгалтерских документах	DS_Faces.OKPO
`VIP`	Руководитель организации или контактное лицо	DS_Faces.Fvip
`AttrN`	N-й атрибут клиента, например `Attr303`	DS_FacesAttributes.AttrText, где N — номер атрибута
`INNOnly`	Только ИНН лица	Из поля DS_Faces.Finn берется только значение ИНН.
`KPP`	Код причины постановки на учет (КПП) лица	Из поля DS_Faces.Finn берется только значение КПП.
`INNKPP`	Равна `$INN`	Равна `$INN`

Переменные позиции документа

Переменные позиции документа можно использовать с префиксом Item или без него.

Имя переменной	Описание	Технические сведения
`Name`	Наименование товара	DS_Items.Iname
`ShortName`	Сокращенное наименование товара	DS_Items.IShortName
`UnitSign`	Сокращенное наименование единицы измерения	DS_Units.UnitSign
`UnitName`	Наименование единицы измерения	DS_Units.UnitName
`UnitName1`	Наименование единицы измерения 1—го уровня	DS_Units.UnitName
`UnitName2`	Наименование единицы измерения 2—го уровня	DS_Units.UnitName
`UnitGostName`	Коды единиц измерения по ГОСТ	DS_UnitTypes.GostName
`Rate`	Кратность минимальной единицы измерения (коэффициент, относительно базовой единицы измерения)	DS_UnitsItems.Rate
`Rate1`	Кратность первой единицы измерения (коэффициент, относительно базовой единицы измерения)	DS_UnitsItems.Rate
`Rate2`	Кратность второй единицы измерения (коэффициент, относительно базовой единицы измерения)	DS_UnitsItems.Rate
`Amount`	Количество товара в документе	DS_Orders_Items.Amount Возможные типы представления поля: Quantity(q) - с точностью 3 знака после запятой; Currency(m) - с точностью 2 знака после запятой, дробная часть печатается всегда; Double(d) - с точностью 2 знака после запятой, если число не имеет дробной части, то она не печатается (по умолчанию). Пример использования: $Amount:q - переменная $Amount с типом Quantity. #ALIAS $Am=$Amount:q;
`Amount1`	Количество товара в единицах первого уровня	`$Amount`?`$Rate1`
`Amount2`	Количество товара в единицах второго уровня	`$Amount`?`$Rate2`
`Cost`	Цена одной единицы товара (в базовых единицах измерения)	DS_Orders_Items.Cost
`CostNonNds`	Цена без НДС	Рассчитывается по формуле `$Cost` – (`$Cost`?`$Nds`)/100
`CostNonNdsU`	Цена за минимальную единицу товара без НДС	(`$SumNonNDS`/`$Amount`)?`$Rate`
`Sum`	Суммарная стоимость позиции товара, в рублях	DS_Orders_Items.Sum
`SumNonNds`	Суммарная стоимость позиции без НДС, в рублях	`$Sum` / (1 + `$Nds` / 100)
`Nds`	Ставка НДС (в виде «18.0»)	DS_Items.NDS
`SumNds`	Сумма НДС	`$Sum` - `$SumNonNds`
`Country`	Страна происхождения	Опция 500
`Gtd`	Номер таможенной декларации	Опция 501
`Exid`	Поле exid товара	DS_Items.Iidtext
`Weight`	Вес товара (минимальной единицы товара)	DS_Items.Weight
`Id`	Код товара	DS_Items.Iid
`AttrN`	N-й атрибут товара, например `Attr303`	DS_ItemsAttributes.AttrText, где N — номер атрибута

Переменные заказа

Переменные заказа начинаются с префикса Order.

Имя переменной	Описание	Технические сведения
`OrderNumber`	Номер заказа	DS_Orders.OrNumber
`OrderDate`	Дата заказа	DS_Orders.OrDate
`OrderDateMonthInWords`	Дата заказа, месяц записан прописью	`$OrderDate`, месяц записан прописью, например: 1 июля 2008.
`OrderItemCount`	Количество позиций в заказе	DS_Orders_Items.Amount
`OrderItemsAmountSum` (только для Мобильной части (Android))	Общее количество всех товаров документа в базовых единицах измерения	Сумма количеств всех товаров документа в базовых единицах измерения.
`OrderSum`	Суммарная стоимость по документу	В общем случае DS_Orders.OrSum (N * DS_Orders_items.CostRoubles всех товаров документа, где N - количество товара). Для документа типа "Оплата" DS_Orders.orSumRoubles.
`OrderSumNonNDS`	Суммарная стоимость заказа без НДС	(`$OrderSum` – `$OrderSum`?`$Nds`)/100
`OrderSumNDS`	Сумма НДС	`$OrderSum` – `$OrderSumNonNDS`
`OrderSumWhereNDS`	Сумма НДС, где # — ставка НДС. Например, `$OrderSumWhereNDS18`	(`$OrderSumNonNDS`?N)/100, где N — указанная ставка НДС.
`OrderDiscountSum`	Сумма общей скидки по документу в рублях	Разность суммы по прайс-листу и реальной суммы, где сумма по прайс-листу=DS_Orders_items.Cost * Кол-во всех товаров в док-те, а реальная сумма=Кол-во всех товаров в док-те * DS_Orders_items.CostRoubles.
`OrderDiscountPTypeSum`	Скидка на тип оплаты по документу в рублях	`$OrderDiscountSum`

Переменные заказа, на основании которого был создан текущий

Все переменные аналогичны переменным заказа, но префикс OrderMaster, вместо Order.

Другие переменные

Имя переменной	Описание	Технические сведения
`CurrentTime`	Текущее время в формате "DD.MM.YY hh:mm:ss"
`PageNumber`	Текущий номер страницы
`PageAmount`	Общее количество страниц
`PaymentTypeName`	Тип оплаты	DS_PaymentType.pType
`TAgentVanName`	Наименование склада мобильного сотрудника	DS_Faces.Name, где DS_Faces.HFid равен DS_Faces.Fid мобильного сотрудника.
`DocAttr`	Атрибут документа, например `DocAttr303`	DS_DocAttributes.AttrText, где N — номер атрибута
`OrderIsActionsAvail`	При формировании печатной формы возвращает: 1, если имеются активные акции на момент формирования печатной формы для клиента, на которого оформлен данный документ. Пустое значение в противном случае.