Skip to content

Đang trong quá trình Xây dựng

Các chi tiết tính năng trong tài liệu này có thể thay đổi trong các giai đoạn nghiên cứu, thảo luận, thiết kế và triển khai.

Tổ chức / Organization

Quản lý thực thể kinh doanh và cấp công ty.

Tổng quan

Thuộc tínhGiá trị
ID ModuleCORE-03
Giai đoạnGiai đoạn 2
Mức độ ưu tiênCAO
Phụ thuộcQuản lý Người dùng

Module Tổ chức quản lý thực thể kinh doanh cấp cao nhất (Hộ kinh doanh / Doanh nghiệp). Đây là container cha cho tất cả các cửa hàng, người dùng và hoạt động. Các tổ chức có thể được tạo thông qua tự đăng ký bởi chủ sở hữu hoặc đăng ký có hỗ trợ từ nhân viên kinh doanh, cả hai đều yêu cầu xác minh từ operator nội bộ trước khi kích hoạt.

┌─────────────────────────────────────────────────────────────────┐
│                   HIERARCHY TỔ CHỨC                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│    ┌─────────────────────────────────────────────┐              │
│    │            TỔ CHỨC                          │              │
│    │   (Hộ kinh doanh / Doanh nghiệp)           │              │
│    │                                             │              │
│    │   - Đăng ký kinh doanh                      │              │
│    │   - Mã số thuế (MST)                        │              │
│    │   - Trạng thái Onboarding                   │              │
│    │   - Cài đặt Công ty                         │              │
│    └─────────────────┬───────────────────────────┘              │
│                      │                                          │
│          ┌───────────┴───────────┐                              │
│          ▼                       ▼                              │
│    ┌───────────┐           ┌───────────┐                        │
│    │ Merchant 1│           │ Merchant 2│   → Xem Module Merchant│
│    │ (Cửa hàng)│           │ (Cửa hàng)│                        │
│    │ (MO #1)   │           │ (MO #2)   │   → Mỗi cửa hàng có thể có MO riêng│
│    └───────────┘           └───────────┘                        │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Các phương thức Đăng ký

Phương thứcMô tảNgười khởi tạo
Tự Đăng kýChủ sở hữu đăng ký trực tiếp trên ứng dụng/web PMBHChủ sở hữu
Hỗ trợ từ Kinh doanhNhân viên kinh doanh đăng ký thay mặt chủ sở hữuNhân viên Kinh doanh

Cả hai phương thức đều tuân theo cùng một quy trình onboarding sau khi đăng ký.

Trạng thái Onboarding

Các tổ chức trải qua một quy trình onboarding thủ công trước khi hoạt động đầy đủ:

Trạng tháiMô tảCó thể Vận hànhTính năng có sẵn
PENDINGĐã đăng ký trong PMBH, đang chờ gửi lên VNPAY MOKhôngChỉ xem trạng thái
MO_SUBMITTEDĐã gửi lên VNPAY MO, đang chờ duyệtKhôngChỉ xem trạng thái
MO_APPROVEDVNPAY đã duyệt, đang chờ operator kích hoạtKhôngChỉ xem trạng thái
ACTIVATEDĐã kích hoạt đầy đủ, sẵn sàng sử dụngTất cả các tính năng
SUSPENDEDTạm thời bị vô hiệu hóaKhôngChỉ xem

Lưu ý: Mỗi Merchant thuộc một Tổ chức có thể có đăng ký MO riêng. Nếu chủ sở hữu muốn có khả năng thanh toán cho nhiều cửa hàng, họ cần đăng ký các tài khoản MO riêng cho mỗi Merchant tại VNPAY.


User Stories

Tự Đăng ký (Chủ sở hữu)

IDVới vai trò...Tôi muốn...Để...
US-REG-01Chủ doanh nghiệpTự đăng ký bản thân và tổ chức của mìnhtôi có thể bắt đầu quy trình onboarding
US-REG-02Chủ doanh nghiệpNhập thông tin kinh doanh của mình (MST, địa chỉ)tổ chức của tôi được thiết lập đúng cách
US-REG-03Chủ doanh nghiệpXem trạng thái đăng ký của mìnhtôi biết mình đang ở đâu trong quy trình
US-REG-04Chủ doanh nghiệpNhận thông báo về thay đổi trạng tháitôi biết khi nào có thể bắt đầu sử dụng hệ thống
US-REG-05Chủ doanh nghiệpTruy cập đầy đủ các tính năng sau khi kích hoạttôi có thể vận hành doanh nghiệp của mình

Đăng ký được Hỗ trợ từ Kinh doanh

IDVới vai trò...Tôi muốn...Để...
US-SALES-01Nhân viên Kinh doanhĐăng ký tổ chức thay mặt chủ sở hữuchủ sở hữu không cần phải tự làm
US-SALES-02Nhân viên Kinh doanhGửi tổ chức lên VNPAY MOquy trình duyệt có thể bắt đầu
US-SALES-03Nhân viên Kinh doanhTheo dõi các tổ chức tôi đã đăng kýtôi biết trạng thái onboarding của họ

Onboarding (Người dùng Nội bộ)

IDVới vai trò...Tôi muốn...Để...
US-INT-01OperatorXem các tổ chức đang chờ xử lýtôi biết những tổ chức nào cần chú ý
US-INT-02OperatorGửi tổ chức lên VNPAY MOquy trình duyệt có thể bắt đầu
US-INT-03OperatorĐồng bộ dữ liệu duyệt MOthông tin tổ chức được cập nhật
US-INT-04OperatorHoàn thành chi tiết tổ chứctất cả thông tin cần thiết được điền đầy đủ
US-INT-05OperatorKích hoạt tổ chứcchủ sở hữu có thể bắt đầu sử dụng đầy đủ các tính năng
US-INT-06AdminXem dashboard onboardingtôi có thể giám sát quy trình
US-INT-07AdminĐình chỉ/kích hoạt lại các tổ chứctôi có thể quản lý các vấn đề tuân thủ

Quản lý Tổ chức (Sau khi Kích hoạt)

IDVới vai trò...Tôi muốn...Để...
US-OWN-01Chủ doanh nghiệpCấu hình các cài đặt toàn công tytất cả các cửa hàng tuân theo các quy tắc nhất quán
US-OWN-02Chủ doanh nghiệpQuản lý giấy phép kinh doanhcác yêu cầu tuân thủ được đáp ứng
US-OWN-03Chủ doanh nghiệpĐặt thuế suất mặc địnhhóa đơn sử dụng đúng thuế suất VAT
US-OWN-04Chủ doanh nghiệpCấu hình mẫu hóa đơnhóa đơn phù hợp với nhận diện thương hiệu
US-OWN-05Chủ doanh nghiệpXem dashboard của tổ chứctôi thấy hiệu suất kinh doanh tổng thể
US-OWN-06Chủ doanh nghiệpYêu cầu thêm MO cho các merchantmỗi cửa hàng có thể xử lý thanh toán

Ma trận Tính năng

Đăng ký & Onboarding

Tính năngGĐ 1GĐ 2GĐ 3Mô tả
Chủ sở hữu tự đăng kýChủ sở hữu đăng ký trực tiếp trên app/web
Đăng ký có hỗ trợ từ kinh doanhKinh doanh đăng ký thay mặt chủ sở hữu
Theo dõi trạng thái OnboardingTheo dõi PENDING → MO_SUBMITTED → MO_APPROVED → ACTIVATED
Thông báo trạng tháiThông báo cho chủ sở hữu về thay đổi trạng thái
Gửi MO (Operator)Operator gửi lên VNPAY MO
Đồng bộ MO (Operator)Operator đồng bộ dữ liệu duyệt MO
Kích hoạt tổ chứcOperator kích hoạt để truy cập đầy đủ
Dashboard Onboarding (Admin)Xem tất cả các onboarding đang chờ xử lý

Quản lý Tổ chức (Sau khi Kích hoạt)

Tính năngGĐ 1GĐ 2GĐ 3Mô tả
Hồ sơ tổ chức đầy đủThiết lập thực thể kinh doanh hoàn chỉnh
Cài đặt toàn công tyCài đặt mặc định cho tất cả các cửa hàng
Cấu hình mẫu hóa đơnTùy chỉnh giao diện hóa đơn
Nhiều MO cho mỗi merchantĐăng ký MO riêng cho mỗi cửa hàng
Quản lý giấy phépTheo dõi giấy phép kinh doanh
Hỗ trợ đa thương hiệuNhiều thương hiệu dưới một tổ chức

Các Luồng chính

Luồng Tự Đăng ký của Chủ sở hữu

Luồng Đăng ký được Hỗ trợ từ Kinh doanh

Sơ đồ Trạng thái Onboarding

Chủ sở hữu có thể làm gì ở mỗi Trạng thái

┌─────────────────────────────────────────────────────────────────────────────┐
│                    TRUY CẬP TÍNH NĂNG THEO TRẠNG THÁI                          │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  PENDING / MO_SUBMITTED / MO_APPROVED:                                       │
│  ├── ✓ Xem trạng thái onboarding                                             │
│  ├── ✓ Xem/sửa hồ sơ cơ bản                                                  │
│  ├── ✗ Tạo merchants/cửa hàng                                                │
│  ├── ✗ Tạo sản phẩm                                                          │
│  ├── ✗ Xử lý đơn hàng                                                        │
│  └── ✗ Truy cập báo cáo                                                      │
│                                                                              │
│  ACTIVATED:                                                                  │
│  ├── ✓ Quản lý tổ chức đầy đủ                                                │
│  ├── ✓ Tạo merchants/cửa hàng                                                │
│  ├── ✓ Quản lý sản phẩm & tồn kho                                             │
│  ├── ✓ Xử lý đơn hàng & thanh toán                                           │
│  ├── ✓ Xuất hóa đơn                                                          │
│  ├── ✓ Truy cập tất cả báo cáo                                               │
│  └── ✓ Quản lý người dùng & phân quyền                                       │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Luồng Đăng ký Nhiều MO

Luồng Thiết lập Tổ chức (Sau Onboarding)


Quy tắc Nghiệp vụ

Quy tắc Đăng ký

ID Quy tắcQuy tắcMô tả
BR-REG-01Cho phép tự đăng kýChủ sở hữu có thể tự đăng ký trực tiếp
BR-REG-02Cho phép hỗ trợ từ kinh doanhKinh doanh có thể đăng ký thay mặt chủ sở hữu
BR-REG-03Yêu cầu MST khi đăng kýMã số thuế (MST) phải được cung cấp khi đăng ký
BR-REG-04MST duy nhấtMST phải là duy nhất trên toàn hệ thống
BR-REG-05Xác minh điện thoạiĐiện thoại của chủ sở hữu phải được xác minh khi đăng ký
BR-REG-06Trạng thái ban đầu PENDINGCác đăng ký mới bắt đầu với trạng thái PENDING

Quy tắc Onboarding

ID Quy tắcQuy tắcMô tả
BR-ONB-01Operator gửi lên MOChỉ Operator có thể gửi tổ chức lên VNPAY MO
BR-ONB-02Không thể hoạt động cho đến khi ACTIVATEDCác tính năng đầy đủ chỉ có sẵn sau trạng thái ACTIVATED
BR-ONB-03Operator kích hoạtChỉ Operator nội bộ có thể kích hoạt tổ chức
BR-ONB-04Thông báo trạng tháiChủ sở hữu được thông báo về mỗi thay đổi trạng thái
BR-ONB-05Trạng thái tuần tựTrạng thái phải tuân theo: PENDING → MO_SUBMITTED → MO_APPROVED → ACTIVATED
BR-ONB-06Truy cập hạn chế trước khi kích hoạtChủ sở hữu chỉ có thể xem trạng thái và sửa hồ sơ cơ bản trước khi ACTIVATED

Quy tắc Tổ chức

ID Quy tắcQuy tắcMô tả
BR-ORG-01Tổ chức duy nhấtMỗi chủ sở hữu có đúng một tổ chức
BR-ORG-02Cài đặt theo tầngCài đặt của tổ chức được áp dụng xuống các merchant
BR-ORG-03Xác thực thuế suất VATThuế suất VAT phải là các mức thuế hợp lệ của Việt Nam
BR-ORG-04Yêu cầu địa chỉĐịa chỉ kinh doanh là bắt buộc
BR-ORG-05Chủ sở hữu bất biếnChủ sở hữu của tổ chức không thể thay đổi
BR-ORG-06Chỉ xóa mềmCác tổ chức chỉ có thể bị đình chỉ, không bị xóa
BR-ORG-07Nhật ký kiểm toánTất cả các thay đổi đều được ghi lại để tuân thủ

Quy tắc Đăng ký MO

ID Quy tắcQuy tắcMô tả
BR-MO-01MO cho mỗi merchantMỗi Merchant có thể có đăng ký MO riêng
BR-MO-02Cho phép nhiều MOChủ sở hữu có thể đăng ký nhiều MO cho nhiều merchant
BR-MO-03Yêu cầu MO để thanh toánMerchant cần MO để xử lý thanh toán
BR-MO-04MO được liên kết bởi OperatorOperator liên kết việc duyệt MO với Merchant cụ thể

Tiêu chí Chấp nhận

Tự Đăng ký

AC-REG-01: Chủ sở hữu Tự Đăng ký

CHO   một chủ doanh nghiệp muốn sử dụng PMBH
KHI   họ tự đăng ký trên app/web
THÌ   - Tài khoản chủ sở hữu được tạo
      - Tổ chức được tạo với trạng thái PENDING
      - Chủ sở hữu nhận được xác nhận đăng ký
      - Chủ sở hữu có thể xem trạng thái onboarding của họ
      - Chủ sở hữu không thể truy cập các tính năng vận hành

AC-REG-02: Xác thực Dữ liệu Đăng ký

CHO   một người dùng đang đăng ký tổ chức
KHI   họ gửi biểu mẫu đăng ký
THÌ   - Định dạng MST được xác thực
      - Tính duy nhất của MST được kiểm tra
      - Số điện thoại được xác minh
      - Các trường bắt buộc được thực thi
      - Thông báo lỗi rõ ràng khi xác thực thất bại

Đăng ký được Hỗ trợ từ Kinh doanh

AC-REG-03: Kinh doanh Đăng ký Tổ chức

CHO   một nhân viên kinh doanh có thông tin chủ doanh nghiệp
KHI   họ đăng ký tổ chức trong PMBH
THÌ   - Tổ chức được tạo với trạng thái PENDING
      - Tài khoản chủ sở hữu được tạo với thông tin đăng nhập tạm thời
      - Chủ sở hữu nhận được thông báo tạo tài khoản
      - Kinh doanh có thể theo dõi trạng thái đăng ký

Onboarding (Xử lý Nội bộ)

AC-ONB-01: Operator Gửi lên MO

CHO   một tổ chức có trạng thái PENDING
KHI   operator gửi lên VNPAY MO
THÌ   - Trạng thái tổ chức thay đổi thành MO_SUBMITTED
      - Dấu thời gian gửi được ghi lại
      - Chủ sở hữu được thông báo về thay đổi trạng thái
      - Tổ chức vẫn chưa thể hoạt động

AC-ONB-02: Operator Đồng bộ Duyệt MO

CHO   VNPAY đã duyệt MO và thông báo cho kinh doanh qua email
KHI   operator đồng bộ việc duyệt MO trong Cổng Admin
THÌ   - Trạng thái tổ chức thay đổi thành MO_APPROVED
      - ID tham chiếu MO được liên kết
      - Dữ liệu duyệt được ghi lại
      - Chủ sở hữu được thông báo về thay đổi trạng thái
      - Tổ chức vẫn chưa thể hoạt động

AC-ONB-03: Operator Kích hoạt Tổ chức

CHO   một tổ chức có trạng thái MO_APPROVED
KHI   operator điền chi tiết và kích hoạt
THÌ   - Tất cả các trường bắt buộc đã hoàn tất
      - Trạng thái tổ chức thay đổi thành ACTIVATED
      - Dấu thời gian kích hoạt được ghi lại
      - Chủ sở hữu được thông báo về việc kích hoạt
      - Tổ chức giờ đây có thể hoạt động đầy đủ

AC-ONB-04: Thông báo Trạng thái

CHO   một tổ chức đang trong quá trình onboarding
KHI   trạng thái thay đổi (bất kỳ chuyển đổi nào)
THÌ   - Chủ sở hữu nhận được thông báo đẩy
      - Chủ sở hữu nhận được thông báo qua email (nếu được cấu hình)
      - Thay đổi trạng thái được ghi lại với dấu thời gian
      - Trạng thái trước đó được lưu trong lịch sử

Đăng ký MO

AC-MO-01: Đăng ký Nhiều MO

CHO   một chủ sở hữu muốn thanh toán cho một merchant bổ sung
KHI   kinh doanh đăng ký MO mới tại VNPAY
THÌ   - MO mới có thể được liên kết với merchant cụ thể
      - Operator liên kết MO với merchant
      - Merchant có thể xử lý thanh toán
      - Chi tiết MO được ghi lại cho mỗi merchant

Quản lý Tổ chức (Sau khi Kích hoạt)

AC-ORG-01: Thiết lập Hồ sơ Tổ chức

CHO   một chủ sở hữu có tổ chức đã ACTIVATED
KHI   họ truy cập cài đặt tổ chức
THÌ   - Dữ liệu hiện có được hiển thị
      - Các trường bắt buộc được đánh dấu rõ ràng
      - Định dạng MST được xác thực
      - Hồ sơ có thể được cập nhật
      - Các thay đổi được ghi lại

AC-ORG-02: Cài đặt Toàn công ty

CHO   một chủ sở hữu đang cấu hình cài đặt tổ chức
KHI   họ đặt các giá trị mặc định (thuế suất, tiền tệ, v.v.)
THÌ   - Cài đặt áp dụng cho tất cả các merchant theo mặc định
      - Các merchant có thể ghi đè nếu được phép
      - Các thay đổi được ghi lại

AC-ORG-03: Cấu hình Mẫu Hóa đơn

CHO   một chủ sở hữu đang thiết lập mẫu hóa đơn
KHI   họ cấu hình logo, chân trang, điều khoản
THÌ   - Xem trước mẫu hiển thị các thay đổi
      - Tất cả các merchant sử dụng mẫu này
      - Các thay đổi chỉ áp dụng cho các hóa đơn mới

Đình chỉ & Kích hoạt lại

AC-SUS-01: Đình chỉ Tổ chức

CHO   một tổ chức đã ACTIVATED có vấn đề tuân thủ
KHI   admin đình chỉ tổ chức
THÌ   - Trạng thái tổ chức thay đổi thành SUSPENDED
      - Chủ sở hữu được thông báo ngay lập tức
      - Tất cả các tính năng vận hành bị vô hiệu hóa
      - Dữ liệu lịch sử vẫn có thể truy cập
      - Lý do được ghi lại trong nhật ký kiểm toán

AC-SUS-02: Kích hoạt lại Tổ chức

CHO   một tổ chức bị SUSPENDED
KHI   admin kích hoạt lại tổ chức
THÌ   - Trạng thái tổ chức thay đổi thành ACTIVATED
      - Chủ sở hữu được thông báo ngay lập tức
      - Tất cả các tính năng vận hành được khôi phục
      - Việc kích hoạt lại được ghi lại

Phụ thuộc

Tổ chức
├── Yêu cầu: Quản lý Người dùng (Chủ sở hữu)
├── Yêu cầu bởi: Merchant, Phân quyền, Báo cáo
└── Tích hợp: VNPAY MO, Nhà cung cấp CA
ModuleMối quan hệ
Quản lý Người dùngChủ sở hữu thuộc về Tổ chức
Phân quyềnCác vai trò có phạm vi trong Tổ chức
MerchantCác cửa hàng thuộc về Tổ chức
Thuế & Hóa đơnCài đặt thuế từ Tổ chức

Điểm Tích hợp

VNPAY Management Office (MO)

┌─────────────────────────────────────────────────────────────────┐
│                    TÍCH HỢP VNPAY MO                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  QUY TRÌNH HIỆN TẠI: Thủ công (Không có đồng bộ tự động)         │
│                                                                  │
│  Luồng Tự Đăng ký:                                               │
│  1. Chủ sở hữu đăng ký trong PMBH (trạng thái: PENDING)        │
│  2. Operator xem xét và gửi lên VNPAY MO                        │
│  3. VNPAY xem xét và duyệt                                       │
│  4. VNPAY thông báo cho Operator qua EMAIL                       │
│  5. Operator đồng bộ duyệt trong Cổng Admin (trạng thái: MO_APPROVED)│
│  6. Operator kích hoạt tổ chức (trạng thái: ACTIVATED)          │
│                                                                  │
│  Luồng Hỗ trợ từ Kinh doanh:                                     │
│  1. Kinh doanh đăng ký tổ chức trong PMBH (trạng thái: PENDING)│
│  2. Operator gửi lên VNPAY MO (trạng thái: MO_SUBMITTED)         │
│  3. VNPAY xem xét và duyệt                                       │
│  4. VNPAY thông báo cho Operator qua EMAIL                       │
│  5. Operator đồng bộ duyệt (trạng thái: MO_APPROVED)             │
│  6. Operator kích hoạt tổ chức (trạng thái: ACTIVATED)          │
│                                                                  │
│  Dữ liệu MO (đồng bộ thủ công):                                  │
│  ├── ID Tham chiếu MO                                           │
│  ├── Chi tiết đăng ký kinh doanh                                 │
│  ├── Mã số thuế (MST)                                            │
│  ├── Các phương thức thanh toán được duyệt                      │
│  └── Thông tin merchant/cửa hàng                                 │
│                                                                  │
│  Đăng ký MO:                                                     │
│  ├── Một MO cho mỗi Merchant (để có khả năng thanh toán)         │
│  ├── Chủ sở hữu có thể có nhiều MO (một cho mỗi cửa hàng)        │
│  └── Mỗi MO được liên kết với Merchant cụ thể bởi Operator       │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Cổng Admin (Người dùng Nội bộ)

┌─────────────────────────────────────────────────────────────────┐
│                 CỔNG ADMIN - ONBOARDING                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Chức năng của Operator:                                         │
│  ├── Xem các tổ chức đang chờ (trạng thái PENDING)               │
│  ├── Gửi tổ chức lên VNPAY MO                                    │
│  ├── Đồng bộ dữ liệu duyệt MO                                    │
│  ├── Điền chi tiết tổ chức                                       │
│  ├── Liên kết MO với Merchants                                   │
│  └── Kích hoạt tổ chức (trạng thái: ACTIVATED)                    │
│                                                                  │
│  Chức năng của Admin:                                            │
│  ├── Dashboard Onboarding (tất cả các trạng thái)                │
│  ├── Đình chỉ/kích hoạt lại các tổ chức                           │
│  └── Ghi đè/sửa dữ liệu tổ chức                                   │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Nhà cung cấp CA (Certificate Authority)

┌─────────────────────────────────────────────────────────┐
│                 TÍCH HỢP NHÀ CUNG CẤP CA                │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Mục đích: Quản lý chứng thư số Hóa đơn điện tử         │
│                                                         │
│  Trao đổi Dữ liệu:                                      │
│  ├── MST của Tổ chức                                    │
│  ├── Đăng ký kinh doanh                                  │
│  ├── Yêu cầu chứng thư số                                │
│  └── Trạng thái chứng thư                                │
│                                                         │
│  Trạng thái: Được quản lý thông qua module Thuế & Hóa đơn│
│                                                         │
└─────────────────────────────────────────────────────────┘

Ảnh chụp màn hình

Ảnh chụp màn hình

Ảnh chụp màn hình sẽ được thêm sau khi triển khai giao diện người dùng.


Các Module Liên quan

Proprietary and Confidential. Unauthorized copying, distribution, or use of this software is strictly prohibited.