backend_order_print

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

Доступно начиная с версии 7.2.18.

Shop-Script

Входящие параметры (передаются по ссылке)

$params array Информация о заказе в виде массива со следующими ключами:
$params['id'] int ID заказа.
$params['contact_id'] int ID контакта покупателя.
$params['create_datetime'] datetime Дата и время создания.
$params['update_datetime'] datetime Дата и время обновления.
$params['state_id'] string Идентификатор статуса.
$params['total'] float Стоимость заказа.
$params['currency'] string 3-буквенное обозначение валюты заказа.
$params['rate'] float 3-буквенное обозначение валюты заказа.
$params['tax'] float Размер рассчитанной суммы налога.
$params['shipping'] float Стоимость доставки.
$params['discount'] float Размер скидки.
$params['paid_year'] int Номер года из даты оплаты заказа.
$params['paid_quarter'] int Номер квартала года из даты оплаты заказа.
$params['paid_month'] int Номер месяца из даты оплаты заказа.
$params['paid_date'] date Дата оплаты заказа.
$params['paid_datetime'] datetime Дата и время оплаты заказа.
$params['is_first'] datetime Дата и время оплаты заказа.
$params['comment'] string Комментарий к заказу.
$params['shipping_datetime'] datetime|null Дата и время, соответствующие концу периода времени, выбранному в поле «Доставка курьером» при выполнении действия «Изменить параметры доставки».
$params['courier_contact_id'] int|null ID контакта выбранного курьера.
$params['id_str'] string Форматированный ID заказа.
$params['total_str'] string Локализованное обозначение стоимости заказа в валюте, подготовленное для отображения в HTML-коде веб-страницы.
$params['create_datetime_str'] string Локализованное обозначение даты и времени создания заказа.
$params['paid_date_str'] string Локализованное обозначение даты оплаты заказа.
$params['paid_datetime_str'] string Локализованное обозначение даты и времени оплаты заказа.
$params['payment_url'] string URL ссылки на оплату.
$params['state'] object Экземпляр класса shopWorkflowState, соответствующий статусу заказа.
$params['shop_order'] object Экземпляр класса shopOrder, соответствующий данному заказу.
$params['coupon'] array|null Информация о применённом купоне в виде массива со следующими ключами:
$params['coupon']['id'] int ID купона.
$params['coupon']['code'] string Название.
$params['coupon']['type'] string Тип купона: '%' (скидка в процентах), '$FS' (бесплатная доставка), 'RUB' (скидка в виде суммы в рублях в данном примере).
$params['coupon']['limit'] int|null Максимальное количество использований купона.
$params['coupon']['used'] int Количество использований купона.
$params['coupon']['value'] float|null Значение для вычисления размера скидки (количество процентов или сумма в выбранной валюте).
$params['coupon']['url'] string Ссылка на описание акции, с которой связан купон.
$params['coupon']['comment'] string Комментарий.
$params['coupon']['expire_datetime'] datetime|null Время истечения срока действия.
$params['coupon']['create_datetime'] datetime Время создания.
$params['coupon']['create_contact_id'] int ID сотрудника, создавшего купон.
$params['coupon']['products_hash'] string Хеш-строка для фильтрации товаров, к которым может применяться купон.
$params['coupon']['right'] bool Признак наличия доступа у текущего сотрудника к инструментам маркетинга.
$params['items'] array Список заказанных товаров в виде массива.
$params['items'][]['id'] int ID позиции заказа.
$params['items'][]['name'] string Название позиции заказа.
$params['items'][]['product_id'] int ID товара, которому соответствует позиция заказа.
$params['items'][]['sku_id'] int ID модификации товара, которой соответствует позиция заказа.
$params['items'][]['sku_code'] string Код артикула модификации товара, которой соответствует позиция заказа.
$params['items'][]['type'] string Тип позиции заказа: 'product' (товар), 'service' (услуга).
$params['items'][]['service_id'] int|null ID заказанной услуги.
$params['items'][]['service_variant_id'] int|null ID варианта заказанной услуги.
$params['items'][]['price'] float Стоимость позиции заказа.
$params['items'][]['quantity'] float Количество позиции заказа.
$params['items'][]['quantity_denominator'] int Доступная точность указания складских остатков заказанного товара: 1 (целые штуки), 10 (точность до десятых), 100 (точность до сотых), 1000 (точность до тысячных).
$params['items'][]['parent_id'] int|null ID позиции с товаром, к которой относится заказанная услуга.
$params['items'][]['stock_id'] int|null ID склада, выбранного для списания остатков заказанного товара.
$params['items'][]['purchase_price'] float Закупочная цена заказанного товара.
$params['items'][]['total_discount'] float Размер скидки, применённой к заказанному товару.
$params['items'][]['tax_percent'] float|null Размер налоговой ставки, применённой к заказанному товару.
$params['items'][]['tax_included'] bool Признак включения размера налога в цену заказанного товара.
$params['items'][]['stock_unit_id'] int ID складской единицы измерения количества заказанного товара.
$params['items'][]['image_id'] int ID изображения товара.
$params['items'][]['sku_image_id'] int ID изображения модификации товара.
$params['items'][]['file_name'] string Имя загруженного файла.
$params['items'][]['current_product_name'] string Текущее название заказанного товара (может отличаться от названия товара в заказе, если впоследствии был переименован).
$params['items'][]['expected_product_code_blocks_count'] int Количество доступных в заказе полей для ввода товарных кодов (кодов маркировки).
$params['items'][]['product_codes'] array Список доступных для заполнения товарных кодов (кодов маркировки). Ключи массива — ID кодов. Каждый элемент списка — массив со следующими ключами:
$params['items'][]['product_codes'][code_id]['id'] int ID кода.
$params['items'][]['product_codes'][code_id]['code'] string Идентификатор кода.
$params['items'][]['product_codes'][code_id]['name'] string Название.
$params['items'][]['product_codes'][code_id]['code'] string Редактируемый идентификатор.
$params['items'][]['product_codes'][code_id]['values'] array Список значений кода, если они ранее уже были введены в свойствах данного заказа.
$params['items'][]['stock'] array Информация о складе заказанного товара в виде массива со следующими ключами:
$params['items'][]['stock']['id'] int ID склада.
$params['items'][]['stock']['name'] string Название.
$params['items'][]['stock']['public'] bool Признак видимости витрине.
$params['items'][]['stock']['low_count'] int Порог низкого количества (жёлтый).
$params['items'][]['stock']['critical_count'] int Порог критически низкого количества (красный).
$params['params'] array Параметры заказа в виде массива со следующими ключами:
$params['params']['coupon_code'] string|null Название применённого купона.
$params['params']['coupon_discount'] float|null Размер скидки по применённому купону.
$params['params']['coupon_id'] int ID применённого купона.
$params['params']['customer_timezone'] string Обозначение часового пояса покупателя.
$params['params']['departure_datetime'] datetime Рассчитанные дата и время готовности заказа к отправке.
$params['params']['ip'] string IP-адрес покупателя.
$params['params']['landing'] string Относительный URL страницы, с которой покупатель начал посещение сайта.
$params['params']['payment_id'] int ID выбранного способа оплаты.
$params['params']['payment_name'] string Название выбранного способа оплаты.
$params['params']['payment_plugin'] string Идентификатор плагина выбранного способа оплаты.
$params['params']['reduced'] bool Признак списания складских остатков заказанных товаров.
$params['params']['reduce_times'] int Количество раз списания складских остатков заказанных товаров в истории заказа.
$params['params']['sales_channel'] string Обозначение канала продаж.
$params['params']['shipping_address.city'] string Название населённого пункта в адресе доставки.
$params['params']['shipping_address.country'] string 3-буквенное обозначение страны в адресе доставки.
$params['params']['shipping_address.region'] mixed Код региона в адресе доставки.
$params['params']['shipping_currency'] string 3-буквенное обозначение валюты стоимости доставки.
$params['params']['shipping_currency_rate'] float Курс валюты стоимости доставки к основной валюте магазина.
$params['params']['shipping_id'] int ID выбранного способа доставки.
$params['params']['shipping_name'] string Название выбранного способа доставки.
$params['params']['shipping_rate_id'] string Название выбранного варианта доставки.
$params['params']['storefront'] string Адрес витрины, на которой оформлен заказ.
$params['params']['storefront_decoded'] string Адрес витрины, на которой оформлен заказ, раскодированный из Punycode.
$params['params']['user_agent'] string Обозначение User-Agent браузера покупателя.
$params['contact'] array Информация о покупателе в виде массива со следующими ключами:
$params['contact']['id'] int ID контакта покупателя.
$params['contact']['name'] string Имя покупателя.
$params['contact']['email'] string Email-адрес.
$params['contact']['phone'] string Номер телефона.
$params['contact']['registered'] bool Признак зарегистрированного покупателя.
$params['contact']['photo_50x50'] string URL отображаемого изображения.
… код плагина …

Результат работы плагина

{$backend_order_print.info_section}
Дополнительный HTML-код.
Shop-Script

Пример кода плагина

PHP

public function backendOrderPrint($params)
{
    return [
        'info_section' => '<div class="box">' . shopMyPluginHelper::getCustomerInfo($params['id']) . '</div>',
    ];
}