> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/faq/vi/nhan-ma-vach/khac-phuc-su-co.md).

# Khắc phục sự cố

***

#### **Làm thế nào để tôi thiết lập quét mã vạch trong BoxHero?**

Để bắt đầu quét mã vạch:

1. Kết nối một thiết bị hỗ trợ Bluetooth **mã vạch** **máy quét**, hoặc
2. Dùng **điện thoại** **camera** thông qua ứng dụng di động BoxHero.

Ứng dụng sẽ tự động phát hiện và đọc mã vạch sau khi được kết nối.

#### **Vì sao mã vạch của tôi in ra màu đỏ?**

Đường viền đỏ trong khu vực mã vạch thường có nghĩa là mặt hàng chưa được gán mã vạch. Thêm một mã vạch hợp lệ cho mặt hàng và thử in lại.

Nếu mã vạch đã được gán, hãy kiểm tra xem nó có chứa ký tự đặc biệt nào không — mã vạch chỉ được chứa số hoặc chữ cái.

<figure><img src="/files/c1e7c603ad805940e546c7204006d929affb7515" alt=""><figcaption></figcaption></figure>

#### **Nhãn của tôi bị lệch. Làm sao để sửa?**

Nếu nhãn của bạn đang in sai vị trí (ví dụ: bị lệch, xoay ngang, hoặc ở góc 90 độ), hãy thử các bước sau theo thứ tự.

1. Hãy đảm bảo giấy nhãn được nạp đúng cách và căn chỉnh bên trong máy in.
2. Xác nhận rằng kích thước nhãn bạn chọn trong BoxHero khớp với tờ nhãn hoặc cuộn nhãn thực tế bạn đang dùng.
3. Kiểm tra cài đặt máy in của bạn:
   1. Đối với **máy in** **thông thường**, hãy đảm bảo tờ nhãn được đặt đúng chiều — nếu bị lộn ngược hoặc đảo chiều, vị trí in có thể bị lệch.
   2. Đối với **nhiệt** **thông thường**, hãy xác minh rằng kích thước giấy chính xác đã được cấu hình trong cài đặt máy in của hệ thống (*Bảng điều khiển* > *Bluetooth & Thiết bị* > *Máy in & Máy quét* > *Tùy chọn in)*.

<figure><img src="/files/d44ab201fbf9b7fd4d7d0f93a10aee704e718873" alt=""><figcaption></figcaption></figure>

#### **Mã vạch của tôi không quét được sau khi in.**

Kiểm tra xem mã vạch đã in rõ ràng, không bị nhòe, mờ hay biến dạng chưa. Nếu nó trông bị mờ, hãy thử điều chỉnh độ đậm khi in và tắt tạo tông màu (dithering) trong cài đặt máy in của bạn.&#x20;

Nếu bạn đang dùng máy quét ngoài, hãy thử quét mã vạch vào một trình soạn thảo văn bản như **Notepad**. Số mã vạch sẽ xuất hiện, sau đó là một dòng mới tự động. Nếu không, hãy xem hướng dẫn sử dụng của máy quét để bật <mark style="color:$primary;">`Enter`</mark> hậu tố phím.

#### **Xem trước khi in của tôi khác với bản in thực tế.**

Hãy đảm bảo kích thước nhãn được chọn trong BoxHero và kích thước giấy trong cài đặt máy in của bạn đều khớp với kích thước nhãn thực tế của bạn. Đối với máy in nhiệt, kích thước giấy cũng phải được đặt ở cấp hệ thống trong tùy chọn máy in của hệ điều hành.

#### **Nhãn của tôi in ra trắng hoặc bị cắt mất.**

Kiểm tra xem vật liệu đã được nạp đúng cách và định dạng nhãn trong BoxHero có khớp với giấy thực tế của bạn không. Đối với máy in nhiệt, hãy tắt dithering trong trình điều khiển máy in — đây là một nguyên nhân phổ biến khiến đầu ra bị trắng hoặc mờ.

* Trên trình điều khiển Zebra, đặt dithering thành "**Clipart**" trong phần **Đồ họa** **Tùy chọn** > **Dithering**.
* Trên trình điều khiển BarTender, đặt thành "**Không**" trong tab **Đồ họa** > **Dithering**Nếu nhãn bị cắt mất, có lẽ kích thước giấy trong cài đặt máy in của hệ thống không khớp với cuộn giấy bạn đang dùng.

{% tabs %}
{% tab title="Zebra" %}

<figure><img src="/files/9c39b120816f97bdcfc137ff0561cc7ba00d918a" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="BarTender" %}

<figure><img src="/files/6961970352eb7b43a8d615e826aac91787b4e8d8" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/faq/vi/nhan-ma-vach/khac-phuc-su-co.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.