1. Thông tin thương hiệu
Để cài đặt thông tin thương hiệu trên eShop, bạn thực hiện theo các bước sau:
Bước 1: Truy cập Trang quản trị → Chọn Cài đặt.
Bước 2: Ở danh mục Thương hiệu, điền đầy đủ các thông tin:
Logo thương hiệu (Header, Footer) | Kích thước 256×256 px (tỷ lệ 1:1), định dạng PNG nền trong suốt, dung lượng ≤ 50KB. |
ID thương hiệu | ID định danh của thương hiệu trên hệ thống. |
Mã thương hiệu | Mã dùng để định danh/quản lý thương hiệu. |
Tên thương hiệu | Tên thương hiệu hiển thị trên hệ thống. |
Ngày đăng ký | Ngày thương hiệu được đăng ký trên hệ thống. |
Tiền tệ | Chọn đơn vị tiền tệ sử dụng cho thương hiệu, ví dụ VND (₫). |
Múi giờ | Chọn múi giờ phù hợp với khu vực hoạt động của thương hiệu. |
Mã số thuế | Mã số thuế của thương hiệu/doanh nghiệp. |
Hotline | Số điện thoại liên hệ của thương hiệu. |
Địa chỉ email liên hệ của thương hiệu | |
Địa chỉ đăng ký kinh doanh | Địa chỉ đăng ký kinh doanh của thương hiệu. |
Quyền thực hiện: Chỉ chủ thương hiệu (tài khoản Root) mới có thể thực hiện thao tác này.
⚠️ Lưu ý: Các thao tác trong Vùng nguy hiểm có thể ảnh hưởng đến dữ liệu của toàn bộ thương hiệu. Cần kiểm tra kỹ trước khi thực hiện.
1.1 Thuế (VAT)
Ở cuối tab Thương hiệu có mục Thuế (VAT), áp dụng cho sản phẩm mới và sản phẩm chưa cài thuế riêng.
% Thuế mặc định: nhập mức VAT (ví dụ 8 hoặc 10). Để trống nếu cửa hàng chưa áp VAT.
Giá niêm yết – Đã bao gồm thuế: giá hiển thị là giá khách trả; hệ thống tự bóc tách VAT khi xuất hoá đơn.
Giá niêm yết – Chưa bao gồm thuế: VAT được cộng thêm khi tính tiền; giá hiển thị chưa có VAT.
Bấm Lưu cấu hình để áp dụng.
1.2 Vùng nguy hiểm
Các thao tác xóa dữ liệu hàng loạt, không thể khôi phục. Chỉ dùng khi thật sự cần và nên liên hệ PEKO trước khi thực hiện.
Xóa toàn bộ đơn hàng: xóa vĩnh viễn mọi đơn hàng của tất cả chi nhánh (giữ lại thương hiệu và tài khoản người dùng).
Xóa toàn bộ dữ liệu kho: xóa sản phẩm kho, vị trí kho, tồn kho, phiếu điều chỉnh, chuyển kho và nhập hàng.
Xóa toàn bộ khách hàng: xóa mềm toàn bộ khách hàng; có thể khôi phục trong 30 ngày.
Hủy tài khoản thương hiệu: xóa vĩnh viễn thương hiệu cùng toàn bộ chi nhánh, người dùng và dữ liệu. Chỉ chủ thương hiệu mới thực hiện được.
2. Quản lý chi nhánh
Để cài đặt chi nhánh trên eShop, bạn thực hiện theo các bước sau:
Bước 1: Truy cập Trang quản trị → Chọn Cài đặt.
Bước 2: Ở danh mục Chi nhánh → Chọn Thêm Chi nhánh để mở biểu mẫu khởi tạo.
Tại biểu mẫu thông tin:
Nhập Tên hiển thị Chi Nhánh.
Nhập Số điện thoại liên hệ của chi nhánh.
Mật khẩu Wifi
Sau khi điền đầy đủ thông tin, chọn Tạo mới để lưu dữ liệu và hoàn tất việc thêm chi nhánh vào hệ thống.
Có giới hạn số lượng: Tính năng có giới hạn số lượng theo gói dịch vụ. Khi đạt giới hạn, cần nâng cấp gói để tiếp tục cấu hình.
2.1 Sửa hoặc xóa chi nhánh
Trong danh sách chi nhánh, cột Thao tác có nút Chỉnh sửa (sửa Tên hiển thị, Số điện thoại, SĐT phụ, Mật khẩu WiFi – mật khẩu WiFi được in trên hoá đơn nếu có cấu hình) và nút Xóa. Khi xóa, hệ thống yêu cầu tick ô xác nhận "hành động này không thể khôi phục và tất cả dữ liệu liên quan sẽ bị xóa vĩnh viễn" rồi mới bấm được Xóa chi nhánh.
3. Người dùng
Tài khoản quản lý / nhân viên (đăng nhập Trang quản trị và ứng dụng POS) được quản lý tại Trang quản trị → Cài đặt → tab Người dùng. Tab này có 3 mục con: Người dùng (danh sách và tạo nhân viên), Vai trò (mục 3.1) và Hoạt động (mục 3.3). Các bước tạo nhân viên và phân quyền xem mục 3.2.
Đang phát triển: Tính năng Phân quyền / Vai trò (mục 3.1 và bước Chọn cách Phân quyền ở mục 3.2) đang được hoàn thiện và chưa áp dụng. Hướng dẫn bên dưới sẽ có hiệu lực khi tính năng ra mắt.
Lưu ý: Hệ thống chỉ có 3 vai trò mặc định: Cashier (Thu ngân), OutletManager (Quản lý chi nhánh), BrandManager (Quản lý thương hiệu); không có vai trò "Bếp" có sẵn. Nếu cần tài khoản riêng cho bếp/bar, hãy tạo vai trò mới tại tab Vai trò và cấp quyền xem màn hình bếp (KDS).
Có giới hạn số lượng: Tính năng có giới hạn số lượng theo gói dịch vụ. Khi đạt giới hạn, cần nâng cấp gói để tiếp tục cấu hình.
3.1 Vai trò
Tab Người dùng → Vai trò liệt kê các vai trò và số nhân viên đang dùng. Vai trò mặc định (Cashier – Thu ngân, OutletManager – Quản lý chi nhánh, BrandManager – Quản lý thương hiệu) chỉ xem được, không sửa/xóa. Bấm + Tạo vai trò để tạo vai trò riêng: nhập Tên vai trò, Mô tả và tick các Quyền hạn cần cấp (hiện có 78 quyền).
3.2 Tạo nhân viên và phân quyền
Tab Người dùng → bấm Tạo nhân viên.
Nhập Họ, Tên (bắt buộc), Email, Số điện thoại (bắt buộc), Mật khẩu (bắt buộc, tối thiểu 8 ký tự).
Chọn cách Phân quyền:
Sử dụng vai trò: chọn một vai trò có sẵn.
Quyền tùy chỉnh: tick từng quyền; dùng ô Tìm quyền, Chọn tất cả hoặc Cấp cả nhóm. Quyền có nhãn Nâng cao (ví dụ xóa toàn bộ, duyệt điều chỉnh kho) chỉ nên cấp cho quản lý.
Chọn Phạm vi chi nhánh: Tất cả chi nhánh (bao gồm chi nhánh thêm sau này) hoặc Chi nhánh cụ thể.
Bấm Lưu.
Các nhóm quyền: Kho (Inventory, điều chỉnh tồn, vị trí kho, xem tồn), Màn hình bếp (KDS), Banner, Chiến dịch (Campaign), Thành viên (Member, điểm, voucher, ví trả trước), Menu (danh mục, món), Thương hiệu (Merchant), Giảm giá (Discount), Phụ thu (ExtraFee), Đơn online (Ecom Order), Đơn bán hàng (Sale Order), Gọi món tại bàn (TableOrder), Ca làm việc (Shift), Chi nhánh (Shop, Billing), Vai trò (Role), Người dùng (User).
3.3 Hoạt động
Tab Hoạt động xem nhật ký thao tác của nhân viên, lọc theo chi nhánh và thời gian (Mọi thời điểm, Theo ngày, Theo tháng, Theo năm).
Ở danh sách người dùng, mỗi dòng có nút Sửa và Xóa; có ô tìm theo tên, email, số điện thoại.
4. Tích hợp
Để tích hợp các nội dung Kênh khách hàng, Cổng/Ví thanh toán, Đối tác giao hàng Hoá đơn điện tử trên eShop, bạn thực hiện theo các bước sau:
Bước 1: Truy cập Trang quản trị → Chọn Cài đặt.
Bước 2: Ở danh mục Tích hợp → Chọn tích hợp các tính năng liên quan
Trang Tích hợp chia 4 nhóm. Mỗi thẻ có trạng thái Đã kết nối, Chưa kết nối hoặc Cần cấu hình; bấm Cấu hình hoặc Thiết lập để mở trang chi tiết.
4.1 Kênh khách hàng
Zalo PEKO OA (mặc định đã kết nối): OA chung của PEKO, gửi tin ZNS theo mẫu ZBS có sẵn, không cần đăng ký. Các mẫu đang có: Mã OTP, Cảm ơn khách hàng, Xác nhận đặt hàng, Huỷ đơn hàng, Tích điểm, Sinh nhật.
Zalo OA: kết nối Zalo OA riêng của thương hiệu để gửi ZNS dưới tên và logo của quán, tự động hóa ZBS cho voucher, tích điểm, sự kiện thành viên. Cần mua gói: bấm Mở gói và bắt đầu kết nối OA.
Zalo Mini App (tính năng cao cấp): đặt hàng, tích điểm và đổi voucher ngay trong Zalo. Bấm Xem gói & mua.
Mobile app (iOS / Android) (tính năng cao cấp): ứng dụng riêng của thương hiệu để khách đặt hàng, tích điểm, nhận thông báo đẩy. Bấm Xem gói & mua.
4.2 Cổng/Ví thanh toán
ZaloPay Gateway: nhập appId, key1, key2 do ZaloPay cấp rồi bấm Lưu (xem bài "Cổng thanh toán ZaloPay").
4.3 Đối tác giao hàng
GrabExpress - PEKO: PEKO đã tích hợp sẵn, không cần API. Bật Sử dụng đối tác này rồi bấm Lưu. Chỉ một đối tác giao hàng được bật cùng lúc. Phí giao được trừ vào số dư General Credit; cửa hàng cần tuân thủ điều khoản của Grab (đóng gói, thời gian chuẩn bị, phí giao).
4.4 Hoá đơn điện tử
MInvoice: bật Bật MInvoice, chọn chi nhánh, nhập MST, Username, Password, Mã cơ quan thuế cấp, InvoiceSeries (ký hiệu hoá đơn), Mã đơn vị cơ sở (Ma dvcs).
SInvoice: bật Bật SInvoice, chọn chi nhánh, nhập Username, Password, MST, InvoiceSeries, TemplateCode.
Chỉ một nhà cung cấp hoá đơn điện tử được bật cùng lúc; bật cái này sẽ tắt cái còn lại (xem bài "Tích hợp hóa đơn điện tử với MInvoice").
5. Gói đăng ký
Tab Gói đăng ký hiển thị các gói đang dùng (ví dụ PEKO Rewards Hub, F&B Inventory, POS), trạng thái, tự động gia hạn, số chi nhánh đã dùng / tối đa và thời điểm gói kết thúc.
Thêm chi nhánh: chọn số chi nhánh muốn thêm bằng nút − / +, hệ thống hiển thị chi phí thêm cho từng gói và Tổng chi phí; bấm Xác nhận thêm chi nhánh.
Đăng ký gói mới: chọn sản phẩm (POS, PEKO Rewards Hub, F&B Inventory, Native App, Zalo Miniapp, Custom Domain, Zalo OA), so sánh các gói và bấm Nâng cấp hoặc Hạ cấp. Gói đang dùng có nhãn Gói hiện tại.
Đổi gói: nâng cấp hoặc hạ cấp gói hiện tại.
Hủy gói: ngừng gói. Nên liên hệ PEKO trước khi hủy.
6. Sử dụng
Tab Sử dụng theo dõi số dư Credit và hạn mức của gói.
General Credit: số dư dùng chung cho các dịch vụ tính phí theo lượt (AI, quét hoá đơn OCR, SMS, tin Zalo ZBS, GrabExpress...). Nút Nạp thêm: chọn gói hoặc nhập số tiền, chọn phương thức thanh toán (Zalopay, Stripe), nhập thông tin xuất hoá đơn rồi bấm Thanh toán. Nút Xem chi tiết: danh sách credit. Nút Lịch sử giao dịch: các giao dịch nạp và sử dụng credit, lọc theo ngày.
Hạn mức (đã dùng / tối đa): File & Media (dung lượng lưu trữ), Sms, OcrInvoice (lượt quét hoá đơn), AiToken (Trợ lý AI), Nhân viên, Thành viên Loyalty, Email / tháng (có thời điểm reset), Món trên menu, Mẫu hóa đơn OCR.
Bấm Xem thống kê dưới một hạn mức để xem biểu đồ sử dụng.
Khi số dư Credit thấp, các dịch vụ như tin nhắn Zalo hoặc giao hàng có thể bị gián đoạn. Hãy nạp thêm kịp thời.











