> ## 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이 사용됩니다.
* 그다음 두 숫자는 인쇄될 너비와 높이를 밀리미터 단위로 설정합니다. 예를 들어 배송 라벨에는 60 × 12mm를 사용합니다.

지원되는 유형: `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/ko/template-editor/block-catalogue.md)
* [템플릿의 품목](https://foliant-help.iforiti.com/ko/template-editor/liquid-line-items.md)
* [템플릿의 문서 번호](https://foliant-help.iforiti.com/ko/template-editor/liquid-document-numbers.md)
* [Liquid 필터](https://foliant-help.iforiti.com/ko/template-editor/liquid-filters.md)


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