> ## 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.

# Chi nhánh

> Tạo và quản lý chi nhánh trong XanhCard để tách số liệu máy quét, biểu mẫu và phân tích theo từng địa điểm kinh doanh.

## Chi nhánh là gì?

Chi nhánh là một địa điểm kinh doanh trong dự án — cửa hàng, quầy, chi nhánh, hoặc điểm tổ chức sự kiện. Gán chi nhánh cho máy quét và dùng liên kết biểu mẫu kèm chi nhánh để hệ thống biết mỗi lượt quét và mỗi thẻ đến từ đâu.

Nhờ đó bạn trả lời được những câu như: chi nhánh nào thu hút khách mới nhiều nhất, chi nhánh nào khách quay lại đông hơn, và địa điểm nào đang chậm hơn mức trung bình.

<Info>
  Chi nhánh chỉ có ích khi bạn gán nó cho máy quét hoặc dùng liên kết biểu mẫu có chi nhánh. Tạo chi nhánh mà không gán gì thì số liệu vẫn nằm ở nhóm **Chưa gán**.
</Info>

## Tạo chi nhánh

<Steps>
  <Step title="Vào Settings">
    Chọn **Settings** từ thanh điều hướng bên trái, rồi mở tab **Branches**.
  </Step>

  <Step title="Nhấn Create Branch">
    Nhấn **Create Branch**.
  </Step>

  <Step title="Đặt tên và ngày khai trương">
    Nhập **Branch Name**, và chọn **Opening Date**.
  </Step>

  <Step title="Lưu">
    Nhấn **Save**.
  </Step>
</Steps>

## Ngày khai trương

**Opening Date** là mốc bắt đầu tính số liệu của chi nhánh. Bạn có thể đặt ngày trong quá khứ để khai báo một cửa hàng đã hoạt động từ lâu.

* Đặt **trong quá khứ**: số liệu của chi nhánh chỉ tính từ ngày đó trở đi, không tính ngược về trước.
* Đặt **trong tương lai**: chi nhánh chưa có số liệu cho tới khi tới ngày đó.

<Note>
  Ngày khai trương không ảnh hưởng tới lượt quét hay thẻ — nó chỉ giới hạn khoảng thời gian được đem ra tính toán. Dữ liệu cũ vẫn được giữ nguyên.
</Note>

## Trạng thái chi nhánh

| Trạng thái   | Nghĩa                                                           |
| ------------ | --------------------------------------------------------------- |
| **Active**   | Chi nhánh đang hoạt động. Máy quét có thể gán vào chi nhánh này |
| **Archived** | Chi nhánh đã ngừng hoạt động                                    |

### Lưu trữ chi nhánh

Chọn **Archive** trên chi nhánh bạn muốn ngừng dùng.

Lưu trữ có ba hệ quả:

1. Máy quét đang gán vào chi nhánh đó được **gỡ liên kết** và trở về trạng thái không gán chi nhánh.
2. Chi nhánh **không nhận thêm lượt quét mới**.
3. **Dữ liệu lịch sử vẫn được giữ nguyên.** Các lượt quét cũ vẫn thuộc chi nhánh đó khi xem lại số liệu.

<Warning>
  Không có thao tác xoá chi nhánh. Chi nhánh chỉ được lưu trữ. Nhờ vậy số liệu lịch sử không bao giờ mất, nhưng cũng có nghĩa là bạn không thể xoá hẳn một chi nhánh đã tạo nhầm — chỉ có thể lưu trữ nó.
</Warning>

Sau khi lưu trữ, máy quét vẫn hoạt động bình thường. Nếu bạn muốn máy quét tiếp tục được tính theo địa điểm, hãy gán nó sang chi nhánh khác.

## Số liệu được quy về chi nhánh như thế nào

Có hai đường dẫn tới việc gán chi nhánh, và chúng hoạt động độc lập.

### Từ máy quét

Khi bạn gán chi nhánh cho một máy quét, mọi lượt quét của máy quét đó được ghi nhớ thuộc chi nhánh tại **thời điểm quét**.

<Note>
  Mỗi lượt quét ghi nhớ chi nhánh tại lúc nó xảy ra. Đổi chi nhánh của máy quét **không** làm những lượt quét đã xảy ra chuyển sang chi nhánh mới, và đổi tên chi nhánh cũng không làm hỏng số liệu cũ.
</Note>

### Từ liên kết biểu mẫu

Mỗi [biểu mẫu](/distribution/forms) có thêm một liên kết riêng cho từng chi nhánh, dạng:

```
https://get.xanhcard.com/form/<slug>?branch=<branchId>
```

Thẻ tạo từ liên kết này được gán chi nhánh ngay lúc tạo. Nếu mã chi nhánh không hợp lệ — không thuộc dự án, hoặc chi nhánh đã bị lưu trữ — thẻ vẫn được tạo, chỉ là không gắn chi nhánh nào.

### Nhóm chưa gán

Dữ liệu không thuộc chi nhánh nào được gom vào nhóm **Chưa gán**, gồm:

* Lượt quét của máy quét chưa gán chi nhánh
* Thẻ tạo từ liên kết biểu mẫu không kèm `?branch=`
* Toàn bộ dữ liệu tạo ra **trước khi** dự án có chi nhánh

<Info>
  Dữ liệu cũ không bị mất và không bị gán nhầm. Nó nằm ở nhóm **Chưa gán** cho tới khi bạn chủ động gán chi nhánh cho máy quét.
</Info>

## Xem số liệu theo chi nhánh

Vào [Dashboard](/analytics/dashboard) và dùng bộ lọc chi nhánh để xem riêng một địa điểm, xem nhóm **Chưa gán**, hoặc **Compare** để đối chiếu nhiều chi nhánh trên cùng một biểu đồ.

## Gỡ chi nhánh khỏi máy quét

Mở máy quét trong **Scanners** và để trống trường **Branch**, rồi nhấn **Save**. Từ đó máy quét được tính vào nhóm **Chưa gán**.

Xem thêm [Gán máy quét cho chi nhánh](/scanners/overview#gán-máy-quét-cho-chi-nhánh).