> ## 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 ブロック、または barcode と qr の Liquid フィルターで、書類にバーコードと 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 になります。
* 続く 2 つの数値で、印刷時の幅と高さをミリメートル単位で指定します。たとえば配送ラベルなら 60 × 12 mm です。

対応タイプ: `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`。レベルが高いほど汚れや破損に強くなりますが、コードの密度が高くなります。
* 2 つ目はピクセル単位のサイズです（デフォルトは 96）。

## 補足

* 値が空の場合は何も描画されません。そのため、バーコードのない商品には何も表示されません。
* バーコードのタイプで扱えない値（たとえば EAN-13 に含まれる文字）の場合は、理由を記した小さな赤いエラーボックスが描画されます。そのため、プレビューで確認できます。
* **書類番号** のバーコードは、書類に番号が付くまで何も印刷されません。
* `{{ order_status_url }}` はオンライン注文でのみ使用できます。

## 関連記事

* [ブロックリファレンス](https://foliant-help.iforiti.com/jp/template-editor/block-catalogue.md)
* [テンプレートの明細項目](https://foliant-help.iforiti.com/jp/template-editor/liquid-line-items.md)
* [テンプレートの書類番号](https://foliant-help.iforiti.com/jp/template-editor/liquid-document-numbers.md)
* [Liquid フィルター](https://foliant-help.iforiti.com/jp/template-editor/liquid-filters.md)


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