Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

Печать заказов

Форма Печать документов по заказу служит для печати документов по заказам клиентов магазина. С помощью этой формы вы можете печатать документы как на основании предустановленных, так и на основании ваших собственных шаблонов. Переход к данной форме осуществляется со страницы Заказы (Магазин > Заказы), выбирая пункт Печать документов из меню действий.


Контекстная панель

КнопкаОписание
Список заказовПереход на страницу со списком заказов.
Изменить заказПереход на страницу с формой для редактирования заказа.
Подробности заказаПереход на страницу с подробной информацией о заказе.


Форма "Печать документов"

ПолеОписание
Номер заказаНомер заказа в системе.
Дата заказаДата и время оформления или последнего изменения заказа.
Сайт заказаСайт, на котором был оформлен данный заказ.
СтатусТекущий статус заказа.
Отменён/Оплачен/Доставка разрешенаТекущее состояние заказа.
Выводить свойства товара[Y|N] При отмеченной опии свойства товара будут отображены в печатных формах.
В данном разделе формы представлен список позиций заказа.
ПолеОписание
ВключенУказывается, будет ли данная позиция (товар) включена в печатный документ.
Некоторые шаблоны документов позволяют печатать данные не по всем, а по произвольной части товаров заказа. В данном поле вы можете указать, что в печатном документе должны присутствовать не все товарные позиции, а так же изменить их количество. Если шаблон не предусматривает печать только части заказа, то он отобразит все товарные позиции вне зависимости от установок на форме.
НазваниеНазвание товара.
КоличествоКоличество приобретаемого товара.
ЦенаСтоимость единицы товара с учётом скидки.
СуммаОбщая стоимость данной позиции заказа.

[Налог]Перечень налогов, применяемых к данному заказу, с указанием их сумм.
ДоставкаСтоимость доставки товара.
ИтогоОбщая сумма заказа (включая сумму налога и стоимость доставки).
Шаблон документаПоле для выбора шаблонов, на основе которых будет выводиться печатная форма документов.
Для того чтобы выбрать более одного шаблона, используйте клавишу Ctrl.


Техническая информация для администраторов

Файлы, содержащие Пользовательские шаблоны документов, должны быть расположены в каталоге /bitrix/admin/reports/. Если в каталоге /bitrix/admin/ отсутствует папка reports - создайте её.

Файлы, содержащие Предустановленные шаблоны, находятся:

  • В каталоге /bitrix/modules/sale/reports/;
  • или
  • В каталогах /bitrix/modules/sale/[язык]/reports/. Например, для русскоязычных документов, путь к шаблонам выглядит так: /bitrix/modules/sale/ru/reports/.

В качестве шаблонов система предлагает все файлы этих каталогов с расширением .php. Если пользовательский шаблон имеет то же имя файла, что и предустановленный шаблон, то используется пользовательский шаблон. В качестве имени шаблона используется содержимое тега <title>.

Если вас не устраивает какой-либо предустановленный шаблон, то вам следует скопировать файл этого шаблона из каталога предустановленных шаблонов в каталог пользовательских шаблонов и изменить его соответствующим образом. В каталог пользовательских шаблонов можно добавить любое количество произвольных шаблонов документов.

В окне документа текст, который можно изменить, представляет собой обычные строки редактирования (input type="text"), их границы не отображаются на экране.

Шаблон документа

Шаблон документа представляет собой обычный php-скрипт. В этом скрипте доступны следующие переменные.

ПеременнаяОписание
$ORDER_IDID (код) текущего заказа.
$arOrderМассив атрибутов заказа (ID, доставка, стоимость, дата создания и т.д.). Вы можете узнать полное содержимое этого массива для вашей версии модуля, если выполните в шаблоне документа следующий PHP код: print_r($arOrder)
$arOrderPropsМассив свойств заказа. Свойства заказа настраиваются на странице управления свойствами заказа модуля продаж. Значения свойств заказа вводятся покупателями при оформлении заказа. Массив свойств заказа имеет следующую структуру:
array(
"мнемонический код
 (или ID, если мнем. код пуст) свойства"
=>
"значение свойства"
)
$arBasketIDsМассив кодов товарных позиций в заказе (кодов соответствующих записей в корзине), которые выбраны для печати. Шаблон может не учитывать этот массив.
$arQuantitiesМассив количеств товарных позиций в заказе, которые выбраны для печати. Элементы этого массива соответствуют элементам массива $arBasketIDs (т.е. товарная позиция с кодом $arBasketIDs[$i] появится в печатном документе в количестве $arQuantities[$i]). Шаблон может не учитывать этот массив.

Названием шаблона документа является содержимое тега <title> этого документа. Если у тега <title> установлен необязательный атрибут langs, то шаблон документа показывается только в том случае, если среди сайтов существуют перечисленные в качестве значения этого атрибута. Например, если в шаблоне присутствует строчка

<title langs="ru,s1">Счет-фактура</title>

то шаблон будет иметь имя Счет-фактура и будет показан только на сайтах ru или s1.



© «Битрикс», 2001-2024, «1С-Битрикс», 2024