> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Штрихкоды и QR-коды

> Добавляйте штрихкоды и QR-коды в документы с помощью блока «Штрихкод / QR» или Liquid-фильтров barcode и qr.

Штрихкоды и QR-коды позволяют вашей команде сканировать данные, а не вводить их вручную: номер заказа на упаковочном листе, каждый SKU в листе сборки или ссылку на статус заказа для покупателя. Foliant создаёт их как чёткие векторные изображения, поэтому они хорошо сканируются при любом размере печати и выглядят одинаково в предпросмотре, в распечатанных документах и в PDF.

## В визуальном редакторе

Добавьте блок **Штрихкод / QR** (в разделе **Содержимое**) и настройте:

* **Тип**: **Штрихкод (Code 128)** или **QR-код**.
* **Кодирует**: **Название заказа (#1042)**, **Номер заказа (1042)**, **Номер документа** или **Своё значение**. Для варианта **Своё значение** укажите **Текст для кодирования**, используя данные заказа, например `SO-{{ order_number }}`.

В **Таблице товаров** также есть столбцы **Штрихкод SKU** и **Штрихкод варианта**, а блок **Строки сборки** может показывать штрихкоды заказов для сканирования.

## В коде

### Штрихкоды

```liquid theme={null}
{{ order_number | barcode }}
{{ line_item.sku | barcode }}
{{ line_item.variant.barcode | barcode: 'ean13' }}
{{ name | barcode: 'code128', 60, 12 }}
```

* Первый параметр — тип штрихкода. Если он не указан, используется Code 128.
* Ещё два числа задают ширину и высоту при печати в миллиметрах, например 60 × 12 мм для транспортной этикетки.

Поддерживаемые типы: `code128`, `code39`, `code39ext`, `code93`, `ean13`, `ean8`, `upca`, `upce`, `itf14`, `interleaved2of5`, `codabar` и `msi`.

### QR-коды

```liquid theme={null}
{{ order_status_url | qr }}
{{ order_status_url | qr: 'H', 120 }}
```

* Первый параметр — уровень коррекции ошибок: `L`, `M` (по умолчанию), `Q` или `H`. Чем выше уровень, тем лучше код переносит повреждения, но тем он плотнее.
* Второй параметр — размер в пикселях (по умолчанию 96).

## Полезно знать

* Пустое значение ничего не выводит, поэтому у товаров без штрихкода его просто нет.
* Если значение не подходит для типа штрихкода (например, буквы в EAN-13), выводится небольшая красная рамка с описанием ошибки, чтобы вы заметили её в предпросмотре.
* Штрихкод **Номер документа** ничего не печатает, пока документу не присвоен номер.
* `{{ order_status_url }}` доступен только для онлайн-заказов.

## Похожие статьи

* [Справочник блоков](https://foliant-help.iforiti.com/ru/template-editor/block-catalogue.md)
* [Товары в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-line-items.md)
* [Номера документов в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-document-numbers.md)
* [Фильтры Liquid](https://foliant-help.iforiti.com/ru/template-editor/liquid-filters.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.