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

# US-MER-35: Trình hướng dẫn Thiết lập Cửa hàng (Merchant Setup Wizard)

> Luồng Onboarding bắt buộc giúp cửa hàng mới khai báo các thông tin kinh doanh cốt lõi trước khi được phép sử dụng Dashboard.

## 1. Điều kiện tiên quyết (Pre-conditions)

* Tài khoản Merchant vừa được Admin ILU PET duyệt và cấp quyền.
* Hệ thống phát hiện Merchant cần thực hiện Onboarding dựa trên việc **các trường thông tin bắt buộc (Tên cửa hàng, Logo, Địa chỉ, Số tài khoản...) đang có giá trị `null`**, chứ **không sử dụng cờ (flag) `is_first_login`**.

## 2. Tiêu chí chấp nhận (Acceptance Criteria)

Luồng Onboarding này là dạng **Hard-stop**, nghĩa là Merchant bắt buộc phải hoàn thành các bước dưới đây mới được vào giao diện Dashboard kinh doanh chính thức.

> [accordion] Bước 1: Thông tin Cửa hàng cơ bản
>
> * Merchant bắt buộc phải hoàn thiện: Tên Cửa hàng, Ảnh đại diện (Logo) và Số điện thoại liên hệ.
> * **Địa chỉ:** Hệ thống yêu cầu nhập theo chuẩn API hành chính quốc gia:
>   * Chọn Tỉnh/Thành phố (Dropdown).
>   * Chọn Quận/Huyện (Dropdown).
>   * Chọn Phường/Xã (Dropdown).
>   * Nhập tay: Số nhà, Tên đường (Textbox).

> [accordion] Bước 2: Cấu hình Pháp lý & Thanh toán
>
> * **Khai báo Pháp lý:** Nhập **Số Giấy phép kinh doanh / Đăng ký kinh doanh** hợp lệ. *(Ghi chú: Không yêu cầu tải lên ảnh chụp giấy phép).*
> * **Tài khoản đối soát (Bank Account):**
>   * Bắt buộc nhập Số tài khoản ngân hàng **MB Bank**.
>   * Hệ thống sẽ gọi API ngân hàng để **kiểm tra tự động** xem Số tài khoản này có tồn tại hợp lệ ở hệ thống MB Bank hay không (Valid Check).
>   * *(Lưu ý: Không bắt buộc STK phải là Unique đối với từng Merchant, nhiều gian hàng có thể dùng chung 1 STK).*

> [accordion] Hoàn tất Onboarding
>
> * Sau khi hoàn tất 2 bước trên, tài khoản Merchant chính thức được kích hoạt hoàn toàn.
> * Hệ thống mở khóa toàn quyền truy cập vào Dashboard để quản lý sản phẩm, dịch vụ.

## 3. Ràng buộc về "Nhắc nhở (Deferred Onboarding)"

Để giữ cho luồng Onboarding lần đầu ngắn gọn, 2 thông tin sau đây đã được dời lại và sẽ hiển thị dưới dạng **Cảnh báo nhắc nhở (Popup Warning)** ở các luồng chức năng khác:

* **Giờ mở cửa (`US-MER-03`):** Merchant sẽ bị ép buộc phải cấu hình khi họ tiến hành **Tạo Dịch vụ Booking mới (`US-MER-04`)**.
* **Phương thức Giao hàng (`US-MER-30`):** Merchant sẽ bị ép buộc phải cấu hình khi họ tiến hành **Đăng bán Sản phẩm hàng hóa đầu tiên (`US-MER-21`)**.


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