Hướng dẫn kết nối

Hệ thống dùng Service Account (tài khoản robot của Google) để tự động tải file lên Drive — không cần đăng nhập thủ công. Bạn chỉ cần chia sẻ thư mục Drive cho email robot một lần duy nhất.

1. 1
   Truy cập Google Drive

   Mở drive.google.com bằng tài khoản Google của công ty (hoặc tài khoản cá nhân bạn muốn lưu file).
2. 2
   Tạo thư mục gốc (nếu chưa có)

   Nhấn + Mới → Thư mục → đặt tên, ví dụ: SFGF - Chè Liên

   Mỗi chi nhánh có thể dùng thư mục riêng hoặc chung 1 thư mục.

3. 3
   Lấy Folder ID từ URL

   Mở thư mục vừa tạo. Nhìn URL trên trình duyệt:

   https://drive.google.com/drive/folders/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms

   Phần được tô vàng chính là Folder ID. Copy lại.

4. 4
   Chia sẻ thư mục cho Service Account

   Nhấn chuột phải vào thư mục → Chia sẻ → Chia sẻ

   Nhập email Service Account vào ô "Thêm người":

   Email Service Account của hệ thống:

   invoice-agent@che-lien-agents.iam.gserviceaccount.com

   Quyền truy cập: chọn Người chỉnh sửa (Editor).

   Bỏ tick "Thông báo cho mọi người" → nhấn Chia sẻ.

5. 5
   Điền Folder ID vào Setup

   Vào trang Setup → tìm chi nhánh tương ứng → dán Folder ID vào ô Google Drive Folder ID → nhấn Lưu.

   Mỗi chi nhánh (HP, ĐBP) có thể điền folder riêng. Để trống → dùng folder mặc định cấu hình bởi admin.

📁 SFGF - Chè Liên                    ← Thư mục gốc (bạn tạo)
   📁 File Dữ Liệu                     ← Tự động tạo
      📁 Dữ Liệu GF T3/2026            ← Tự động tạo theo tháng
         📄 HP_19032026_dulieu_GF.xlsx
         📄 DBP_19032026_dulieu_GF.xlsx
      📁 Dữ Liệu SF T3/2026
         📄 HP_19032026_dulieu_SF.xlsx
         📄 DBP_19032026_dulieu_SF.xlsx
   📁 File ASP                         ← Tự động tạo
      📁 ASP GF T3/2026
         📄 HP_19032026_ASP_GF.xlsx
         📄 DBP_19032026_ASP_GF.xlsx
      📁 ASP SF T3/2026
         📄 HP_19032026_ASP_SF.xlsx
         📄 DBP_19032026_ASP_SF.xlsx

Hệ thống cần quyền đọc Gmail để tự động tải file báo cáo từ ShopeeFood và GrabFood. Mỗi chi nhánh kết nối một lần — hệ thống sẽ tự gia hạn token mà không cần làm lại.

1. 1
   Vào trang Setup

   Truy cập Setup → chọn chi nhánh cần kết nối.
2. 2
   Nhấn Kết nối Gmail

   Nhấn nút Kết nối Gmail màu xanh. Trình duyệt sẽ chuyển sang trang đăng nhập Google.
3. 3
   Đăng nhập đúng tài khoản Gmail

   Đăng nhập bằng Gmail của chi nhánh đó (email nhận báo cáo từ ShopeeFood/GrabFood).

   Lưu ý: Nếu bạn đang đăng nhập nhiều tài khoản Google, hãy chọn đúng tài khoản của chi nhánh. Nhầm tài khoản sẽ không scan được email.
4. 4
   Cấp quyền

   Google sẽ hiển thị màn hình yêu cầu quyền. Nhấn Tiếp tục / Allow để đồng ý. Hệ thống chỉ đọc email — không gửi, không xóa.
5. 5
   Hoàn tất

   Sau khi cấp quyền, trang sẽ tự chuyển về Setup và hiện thông báo Kết nối thành công kèm email vừa kết nối.

Hệ thống gửi thông báo Telegram khi scan xong, có lỗi parse, email bất thường hoặc dữ liệu không khớp kế toán. Mỗi chi nhánh có thể nhận cảnh báo vào group/chat riêng.

1. 1
   Mở BotFather

   Mở Telegram → tìm kiếm @BotFather → nhấn Start.
2. 2
   Tạo bot mới

   Gửi lệnh /newbot → BotFather hỏi tên bot → nhập tên hiển thị, ví dụ: Chè Liên SFGF

   Tiếp theo nhập username (phải kết thúc bằng bot), ví dụ: chelien_sfgf_bot

3. 3
   Lưu Bot Token

   BotFather trả về token dạng:

   7123456789:AAGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

   Admin điền vào .env trên VPS:

   TELEGRAM_BOT_TOKEN=7123456789:AAGxxx...

{
  "result": [{
    "message": {
      "chat": {
        "id": -1009876543210,    ← Chat ID (copy số này)
        "title": "Chè Liên HP - Báo cáo",
        "type": "group"
      }
    }
  }]
}

1. 1
   Vào trang Setup

   Truy cập Setup → tìm card chi nhánh tương ứng.
2. 2
   Điền Telegram Chat ID

   Dán Chat ID vào ô Telegram Chat ID → nhấn Lưu. Mỗi chi nhánh (HP, ĐBP) có thể điền chat ID khác nhau.
3. 3
   Kiểm tra

   Chạy 1 lần scan tại Auto Scan → sau khi xong sẽ nhận được tin nhắn tóm tắt kết quả.

1. 1
   Kiểm tra Gmail

   Vào Auto Scan → nhấn Scan ngay cho chi nhánh vừa kết nối. Nếu có email chưa xử lý, hệ thống sẽ liệt kê file và trạng thái bên dưới.
2. 2
   Kiểm tra Drive

   Sau khi scan thành công, vào thư mục Drive đã chia sẻ — kiểm tra có thư mục tháng và 2 file XLSX được tạo không.
3. 3
   Kiểm tra lịch sử

   Vào Lịch sử — bản ghi mới nhất sẽ hiện link Drive trực tiếp.