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

# Tổng quan về máy quét

> Tạo và quản lý máy quét XanhCard để xác thực thẻ ví tại điểm bán, sự kiện hoặc cửa hàng, kết hợp với hành động tự động và báo cáo lượt quét.

## Máy quét (Scanner) là gì?

Máy quét là ứng dụng dùng để quét mã vạch hoặc QR code trên thẻ kỹ thuật số. Khi quét, máy quét có thể thực hiện các hành động như xác thực, cập nhật dữ liệu, hoặc kích hoạt thông báo.

Bạn có thể sử dụng máy quét trên điện thoại di động hoặc máy tính bảng bằng cách mở URL máy quét trong trình duyệt.

## Truy cập danh sách máy quét

Vào **Scanners** từ thanh điều hướng bên trái.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/scanners/01-scanners-list-empty.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=1c4f030fea640ec4468431c99358c7a1" alt="Danh sách máy quét" width="2796" height="1334" data-path="images/scanners/01-scanners-list-empty.png" />

## Tạo máy quét mới

<Steps>
  <Step title="Vào Scanners">
    Chọn **Scanners** từ thanh điều hướng.
  </Step>

  <Step title="Nhấn Create Scanner">
    Nhấn nút **Create Scanner** ở góc trên bên phải.
  </Step>

  <Step title="Điền thông tin">
    Trong hộp thoại **Create Scanner**, bạn điền các thông tin chi tiết.

    <img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/scanners/02-create-scanner-dialog.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=f9bae247aca537f6dee9001f09f2ff31" alt="Hộp thoại tạo máy quét" width="1823" height="1718" data-path="images/scanners/02-create-scanner-dialog.png" />
  </Step>

  <Step title="Cấu hình hành động">
    Thêm và cấu hình các hành động sẽ thực hiện khi quét thẻ.
  </Step>

  <Step title="Nhấn Save">
    Nhấn **Save** để lưu máy quét.
  </Step>
</Steps>

## Cấu hình máy quét

### Thông tin cơ bản

* **Scanner Name**: Tên máy quét (bắt buộc)
* **Headline**: Tiêu đề hiển thị trên giao diện quét
* **Instructions**: Hướng dẫn cho người quét (ví dụ: "Đưa thẻ vào trước camera để quét")
* **Success Message**: Thông báo khi quét thành công
* **Active**: Bật/tắt máy quét

### Giao diện (Appearance)

* **Button Color**: Màu nút trên giao diện quét
* **Text Color**: Màu chữ
* **Background**: Màu nền
* **Icon URL**: URL biểu tượng hiển thị trên giao diện quét (đề xuất: 256×256 px)
* **Logo URL**: URL logo hiển thị trên giao diện quét (đề xuất: 200×50 px)

## Hành động (Actions)

Mỗi máy quét có thể có một hoặc nhiều hành động. Các hành động được thực hiện theo thứ tự từ trên xuống dưới.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/scanners/03-scanner-two-actions.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=98c3561fd3c6ec382d04b18a904e583d" alt="Nhiều hành động" width="1825" height="1715" data-path="images/scanners/03-scanner-two-actions.png" />

Bạn có thể:

* **Add Action**: Thêm hành động mới
* **Move up / Move down**: Thay đổi thứ tự thực hiện
* **Xóa hành động**: Nhấn nút xóa bên cạnh mỗi hành động

Xem chi tiết về từng loại hành động tại [Hành động quét](/scanners/actions).

## Điều kiện hành động (CEL Rule Expression)

Mỗi hành động có thể có điều kiện ràng buộc bằng biểu thức CEL (Common Expression Language).

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/scanners/07-scanner-with-cel-rule.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=cc5b094774b9fe79afec25504db511b1" alt="Hành động với CEL rule" width="1839" height="1772" data-path="images/scanners/07-scanner-with-cel-rule.png" />

* **CEL Rule Expression**: Điều kiện để hành động được thực hiện (ví dụ: `pass.data.status == "active"`)
* **Error Message**: Thông báo hiển thị khi điều kiện không thỏa mãn

<Info>
  Nếu điều kiện CEL không thỏa mãn, quá trình quét sẽ dừng lại và hiển thị thông báo lỗi.
</Info>

## Sử dụng máy quét

Sau khi tạo máy quét, bạn có thể:

1. Mở URL máy quét trên điện thoại hoặc máy tính bảng
2. Đưa camera vào mã vạch hoặc QR code trên thẻ
3. Hệ thống tự động thực hiện các hành động đã cấu hình

<Tip>
  Bạn có thể chia sẻ URL máy quét cho nhiều nhân viên để cùng sử dụng.
</Tip>