Hướng dẫn triển khai cho công ty / đại lý

Từng bước từ lúc nhận tài khoản đến lúc khách hàng của bạn dùng được các app: tạo cửa hàng, cấp mã, nối website, chỉnh giao diện và bàn giao.

1. Chuẩn bị

• Tài khoản bảng điều khiển do chủ hệ thống MARZI cấp: tên đăng nhập và mật khẩu ban đầu. Đổi mật khẩu ngay lần đầu.
• Một gói đang dùng được. Gói quy định bạn tạo được tối đa bao nhiêu khách hàng và dùng được những tính năng nào. Gói hết hạn, bị tạm dừng hoặc chưa được cấp thì không tạo thêm khách hàng được.
• Thông tin của từng khách: tên cửa hàng, ngành nghề, màu thương hiệu, ngôn ngữ và tiền tệ.
• Nếu khách có website bán hàng riêng: một lập trình viên cài connector lên website đó, theo Tài liệu kết nối website. Bạn cần địa chỉ connector và khóa bí mật.
• Nếu khách chưa có website: chọn nguồn dữ liệu "nằm ở MARZI". Nơi lưu sản phẩm và đơn đã có; công cụ nhập sản phẩm trên trình duyệt đang được xây dựng.

2. Quy trình tổng quan

1. Đăng nhập bảng điều khiển và bật xác thực hai bước.
2. Tạo khách hàng: đặt tên và mã cửa hàng.
3. Chọn mẫu ngành, màu, kiểu điều hướng, các khối trang chủ và tính năng.
4. Nối website của khách (nếu có) và bấm "Thử kết nối". Sản phẩm nhiều lựa chọn (màu, size, hương vị...) do website tự gửi theo tài liệu kết nối; đại lý không phải cài đặt thêm gì.
5. Tạo khách hàng. Hệ thống cấp sẵn mã.
6. Kiểm tra bằng khung xem trước và bằng app thật.
7. Bàn giao: gửi mã cho chủ cửa hàng cùng hướng dẫn sử dụng app.

3. Đăng nhập và bảo mật tài khoản

Mở địa chỉ bảng điều khiển do chủ hệ thống cung cấp (dạng https://.../console/) và đăng nhập. Nhập sai mật khẩu 5 lần, tài khoản bị khóa tạm 15 phút.

Bật xác thực hai bước (nên làm ngay)

Tài khoản đại lý nắm danh sách khách hàng và khóa kết nối website, nên hãy bật xác thực hai bước: ngoài mật khẩu, mỗi lần đăng nhập cần thêm mã 6 số từ ứng dụng xác thực trên điện thoại (Google Authenticator, Microsoft Authenticator, Authy...).

1. Mở "Xác thực hai bước" ở menu bên trái và nhập lại mật khẩu.
2. Nhập khóa vào ứng dụng xác thực (chọn thêm tài khoản bằng khóa cài đặt, loại theo thời gian), rồi nhập mã 6 số đang hiện để xác nhận.
3. Chép 8 mã khôi phục và cất nơi an toàn. Mỗi mã dùng được một lần khi mất điện thoại và chỉ hiện một lần.

Từ lần sau, sau khi nhập mật khẩu bạn sẽ được hỏi mã:

Đăng nhập bảng điều khiển bằng mã QR

Thay vì gõ mật khẩu trên máy tính, bạn có thể đăng nhập bằng điện thoại: bảng điều khiển hiện mã QR, bạn quét bằng app MARZI Quản lý và đồng ý.

1. Trên máy tính, ở trang đăng nhập bấm Đăng nhập bằng mã QR. Trang hiện mã QR (sống 2 phút, dùng một lần).
2. Trên điện thoại, mở app MARZI Quản lý. Ở màn đăng nhập cửa hàng, bấm Tài khoản đại lý (đăng nhập bảng điều khiển) và đăng nhập bằng tên đăng nhập, mật khẩu (và mã hai bước nếu có). Chỉ cần làm lần đầu.
3. Bấm "Quét mã đăng nhập bảng điều khiển" và quét mã trên máy tính. Nếu camera không dùng được, dán nội dung mã vào ô bên dưới khung quét.
4. Kiểm tra màn xác nhận: trình duyệt, địa chỉ IP, giờ và tài khoản sẽ đăng nhập, rồi bấm Đăng nhập. Máy tính tự vào bảng điều khiển ngay.

• Điện thoại giữ phiên đại lý tối đa 12 giờ, sau đó phải đăng nhập lại (giống phiên trên máy tính). Bấm "Đăng xuất tài khoản đại lý" trong app khi dùng điện thoại chung hoặc khi mất máy.
• Mỗi lần đồng ý và mỗi lần đăng nhập bằng QR đều ghi vào Nhật ký kèm địa chỉ IP.
• Tài khoản bật xác thực hai bước vẫn dùng được: lần đăng nhập đầu trên điện thoại đã có mã hai bước, lần quét sau không hỏi lại mã.

Đổi mật khẩu ở nút Đổi mật khẩu (mật khẩu từ 10 ký tự, kết hợp ít nhất hai loại ký tự, không chứa tên đăng nhập). Đổi mật khẩu sẽ đăng xuất mọi thiết bị khác của bạn.

4. Tổng quan và gói

Trang Tổng quan cho biết gói đang dùng, ngày hết hạn, số khách hàng đã tạo so với giới hạn của gói, và các khách hàng mới nhất. Gói của tôi liệt kê các gói hiện có (theo tháng hoặc theo năm, giới hạn số khách và tính năng).

5. Tạo khách hàng

Vào Khách hàng rồi bấm Thêm khách hàng. Khung điện thoại bên phải xem trước app ngay khi bạn chỉnh.

Bước 1: tên và mã

• Tên cửa hàng và tên hiển thị trong app (mặc định giống nhau).
• Mã doanh nghiệp (mã cửa hàng): đây là thứ khách hàng và nhân viên nhập vào app để vào đúng cửa hàng. Gồm chữ thường, số và dấu gạch ngang, từ 3 đến 32 ký tự, và không trùng với bất kỳ cửa hàng nào của mọi đại lý. Bảng điều khiển kiểm tra ngay khi bạn gõ ("Mã này dùng được"). Một số mã được giữ riêng (admin, api, www, marzi, console, support, help, app, shop, test, root).
• Mã không đổi được sau khi tạo, nên chọn ngắn, dễ nhớ, dễ đọc qua điện thoại.

Bước 2: mẫu ngành

Chọn mẫu sẽ tự đặt màu, kiểu điều hướng, khối trang chủ và tính năng phù hợp, rồi bạn chỉnh tiếp.

Bước 3: giao diện và tính năng

• Màu chính (nút, giá, điểm nhấn) và màu nền tiêu đề, menu.
• Kiểu điều hướng: Thanh tab dưới, Menu trượt, hoặc Cả hai.
• Các phần trên trang chủ: ô tìm kiếm, danh mục, khám phá (trang và tin tức), lưới sản phẩm. Bật/tắt từng phần.
• Tính năng (module): Sản phẩm, Đặt hàng, App quản lý, Trang và tin tức. Chỉ chọn được những module nằm trong gói của bạn; bật một module sẽ tự bật module nó cần (ví dụ Đặt hàng cần Sản phẩm).
• Ngôn ngữ và tiền tệ: Tiếng Việt, English, 한국어; tiền tệ 3 chữ cái (VND, KRW...).

6. Nối website của khách

Ở mục Nguồn dữ liệu, chọn Nối website của khách nếu khách có website bán hàng riêng (nếu không, giữ "Dữ liệu nằm ở MARZI").

1. Địa chỉ connector trên website, ví dụ https://www.tenmien.com/marzi-connector. Phải bắt đầu bằng https://. Hai ô "Thư mục ảnh" và "Địa chỉ website" được gợi ý theo địa chỉ này; sửa lại nếu website khác.
2. Khóa bí mật: bấm Tạo khóa để tạo khóa ngẫu nhiên (hoặc dán khóa có sẵn, từ 32 ký tự), bấm Chép, rồi gửi cho lập trình viên dán vào cấu hình connector trên website. Khóa được lưu mã hóa và không hiển thị lại sau khi lưu.
3. Thư mục ảnh sản phẩm: nơi website để ảnh sản phẩm. Địa chỉ website: trang chủ của khách (dùng cho ảnh bài viết).
4. Bấm Thử kết nối. Thành công sẽ liệt kê những gì website cung cấp (Sản phẩm, Danh mục, Đăng nhập khách, Xem đơn, Đặt hàng, Đăng nhập quản lý...). Bạn có thể thử tối đa 10 lần mỗi phút.

7. Cấp mã cho chủ cửa hàng

Bấm Tạo khách hàng. Màn hình tiếp theo hiện mã cửa hàng thật lớn cùng nút Sao chép mã. Gửi mã này cho chủ cửa hàng.

• App người mua: nhập mã khi mở app lần đầu.
• App quản lý: nhập mã, tên đăng nhập và mật khẩu quản trị của website (khách dùng website riêng). Đăng nhập app quản lý dùng chính tài khoản quản trị của website, nên chủ cửa hàng không phải nhớ thêm mật khẩu nào.

Mã QR để vào cửa hàng

Ngoài mã chữ, mỗi cửa hàng có hai mã QR, hiện ở màn "Đã tạo khách hàng" và ở trang chỉnh sửa cửa hàng: một cho app người mua, một cho app quản lý. Quét mã bằng nút "Quét mã QR của cửa hàng" trong app (hoặc bằng camera điện thoại khi đã cài app) là vào đúng cửa hàng, khỏi gõ mã. Mã QR chỉ chứa mã cửa hàng, không có thông tin bí mật.

• Tải ảnh PNG để dùng trên website, danh thiếp, tin nhắn.
• In áp phích mở hộp thoại in với một trang gọn (tên cửa hàng, hai mã QR, mã chữ) để dán ở quầy hoặc in lên hóa đơn.
• Liên kết trong mã (marzi-shop://shop/<mã> và marzi-merchant://shop/<mã>) chỉ mở được khi đã cài app. Khách chưa có app cần cài app trước rồi quét lại bằng nút trong app.

8. Chỉnh sửa sau khi tạo

Trong danh sách Khách hàng (cột mã, mẫu ngành, tính năng, trạng thái), bấm vào một cửa hàng để chỉnh. Mọi thay đổi áp dụng cho app ngay, không cần cập nhật app trên điện thoại. Khung xem trước hiện sản phẩm thật của website sau khi nối.

• Đang hoạt động: tắt để tạm khóa cửa hàng. App của cửa hàng đó sẽ báo không dùng được. Bật lại để mở.
• Nguồn dữ liệu: "Thử kết nối", "Đổi địa chỉ / khóa" (để trống khóa nếu giữ khóa cũ), hoặc "Ngắt kết nối".
• Muốn đổi khóa bí mật: đổi ở website và ở đây cùng lúc.

9. Hồ sơ cửa hàng và bán trên sàn

Trong trang chỉnh sửa khách hàng có hai thẻ liên quan đến việc bán trên sàn Marzi Market (app thứ ba gom sản phẩm của nhiều cửa hàng):

• Hồ sơ cửa hàng: bật Hiển thị trên sàn (cửa hàng cần mã doanh nghiệp và mô tả ngắn), chọn loại, tỉnh/thành, mô tả ngắn, logo (địa chỉ https). Hai ô Giấy phép kinh doanh và Mã số thuế hiện trong app người mua của cửa hàng (màn "Thông tin cửa hàng"); để trống cả hai thì mục đó ẩn. Phần này cũng có lựa chọn khi khách chia sẻ sản phẩm: người chưa cài app thấy trang giới thiệu của MARZI hoặc được chuyển thẳng sang trang sản phẩm trên website (cần website báo địa chỉ trang sản phẩm).
• Bán trên sàn MARZI: hiển thị phí sàn mà chủ hệ thống đã ký với cửa hàng (nếu có). Chỉ chủ hệ thống ký, đổi hoặc kết thúc thỏa thuận; đại lý chỉ xem. Có thỏa thuận (và có website nhận đơn cùng tài khoản nhận đơn) thì đơn mua trên sàn của cửa hàng này về thẳng website và app quản lý của họ; chưa có thì đơn ở lại MARZI để chủ hệ thống xử lý.

10. Thanh toán chuyển khoản QR

Thẻ Thanh toán chuyển khoản QR trong trang chỉnh sửa là nơi bạn nhập tài khoản ngân hàng của cửa hàng (tiền khách chuyển vào thẳng tài khoản này), quét thử mã QR bằng app ngân hàng và, nếu muốn đơn tự chuyển sang "đã thanh toán", nối với SePay. Thẻ cũng liệt kê tiền vào gần đây và thay đổi gần đây (kể cả thay đổi do nhân viên cửa hàng làm trong app quản lý). Hướng dẫn từng bước, quy tắc xử lý tiền và cách xử lý sự cố nằm ở Thanh toán chuyển khoản bằng mã QR.

11. Phản hồi và vận chuyển

• Phản hồi (menu Phản hồi): nhân viên cửa hàng gửi câu hỏi, báo lỗi, góp ý từ app quản lý lên bạn. Bạn trả lời nhiều lượt, đóng hoặc mở lại; số chưa đọc hiện trên menu. Cần chuyển lên chủ hệ thống (hỏi về gói, thanh toán, lỗi hệ thống) thì bấm gửi phản hồi mới, loại "Gói & thanh toán" hoặc loại phù hợp.
• Vận chuyển: trang chỉnh sửa khách hàng có thẻ để nhập khóa của GHN, GHTK và địa chỉ lấy hàng. Chỉ nhập khi cửa hàng thật sự dùng hãng đó; khóa được mã hóa và không hiện lại. Hiện app quản lý chỉ có phần nhập vận đơn bằng tay (mục Vận chuyển trong chi tiết đơn); nút tạo vận đơn tự động qua hãng chưa có trong app.

12. Bàn giao cho khách

1. Thử trước khi bàn giao. Tự cài app, nhập mã, đăng nhập bằng một tài khoản thử, xem sản phẩm, đặt một đơn thử, đăng nhập app quản lý và đổi trạng thái đơn đó.
2. Gửi cho chủ cửa hàng: mã cửa hàng; hướng dẫn App quản lý; hướng dẫn App người mua để chia sẻ với khách của họ; và nếu cửa hàng nhận chuyển khoản QR, trang Thanh toán chuyển khoản QR.
3. Nhắc chủ cửa hàng: người mua dùng tài khoản thành viên của website (đăng ký trên website); quên mật khẩu thì dùng chức năng của website.

13. Quản lý hằng ngày

• Nhật ký: ghi mọi thao tác của tài khoản đại lý (đăng nhập, tạo/sửa khách hàng, nối hoặc ngắt website, đổi mật khẩu, bật tắt xác thực hai bước) kèm giờ và địa chỉ IP. Chỉ xem, không sửa hay xóa được. Dùng để biết "ai đã làm gì, lúc nào".
• Gói và hạn dùng: theo dõi ở Tổng quan. Gần hết hạn hãy liên hệ chủ hệ thống để gia hạn hoặc nâng gói.
• Nhân sự: nhờ chủ hệ thống thêm tài khoản đăng nhập cho nhân viên của bạn.

14. Xử lý sự cố

Khi "Thử kết nối" báo lỗi

Lập trình viên của bạn có thể chạy bộ kiểm tra tự động trong Tài liệu kết nối website để thấy chính xác đường dẫn nào sai.

Khi tạo hoặc sửa khách hàng

Khi khách báo lỗi trong app

• "Không tìm thấy mã này": sai mã, hoặc cửa hàng đang bị tắt ("Đang hoạt động" bị tắt). Đối chiếu mã trong danh sách.
• Không đăng nhập được app quản lý: thử đúng tài khoản ở trang quản trị của website; tài khoản đó phải có quyền xem đơn.
• Không thấy sản phẩm hay đơn mới: bấm "Thử kết nối" xem website còn đáp ứng, và đã khai báo đủ khả năng chưa.

15. Cửa hàng không có website: tài khoản quản lý trên web

Khi cửa hàng chọn Dữ liệu nằm ở MARZI (không nối website), sản phẩm và đơn hàng nằm ở MARZI và chủ cửa hàng quản lý bằng trang /shop/ trên trình duyệt (xem Quản lý cửa hàng trên web). Bạn tạo tài khoản đăng nhập cho họ ngay trong bảng điều khiển.

1. Mở cửa hàng: Khách hàng → chọn cửa hàng → kéo xuống thẻ Tài khoản quản lý cửa hàng (web) (thẻ chỉ có ở cửa hàng chưa nối website, và cần đã có mã cửa hàng).
2. Tạo tài khoản: nhập tên đăng nhập (chữ thường không dấu, số, dấu chấm, ví dụ lan.nguyen), tên người dùng, và mật khẩu (từ 8 ký tự; để trống thì MARZI tự tạo).
3. Gửi cho chủ cửa hàng: mật khẩu chỉ hiện một lần trong khung xanh cùng địa chỉ trang, mã cửa hàng và tên đăng nhập; bấm Sao chép rồi gửi qua tin nhắn. Đóng trang là mất mật khẩu (chỉ còn cách đặt lại).
4. Về sau: Đặt lại mật khẩu tạo mật khẩu mới (cũ hết dùng ngay); công tắc Đang bật tắt một tài khoản (nhân viên nghỉ việc): có hiệu lực ngay, kể cả người đang đăng nhập.

• Mỗi nhân viên một tài khoản riêng để biết ai làm gì; tất cả đều xem và sửa được sản phẩm, đơn hàng của cửa hàng đó và không thấy cửa hàng khác.
• Mọi thao tác tạo, đặt lại, bật tắt tài khoản đều ghi vào Nhật ký.
• Cửa hàng nối website thì thẻ này báo "dùng tài khoản của website": họ dùng app quản lý như thường lệ.

16. Trợ lý AI cho khách hàng của bạn

Khi gói của công ty bạn có tính năng Trợ lý AI (hỏi chủ hệ thống nếu chưa thấy), cửa hàng của bạn có thêm hai trợ lý chat:

• Trong app người mua: nút tròn ở các tab chính; trợ lý tư vấn bán hàng cho khách của cửa hàng, trả lời dựa trên sản phẩm thật của cửa hàng và hiện thẻ sản phẩm để khách bấm xem.
• Trong app quản lý: trợ lý giúp chủ cửa hàng và nhân viên dùng app, thay mặt công ty bạn: nó biết tên, điện thoại, email của công ty bạn (lấy từ hồ sơ công ty) để chỉ khách liên hệ khi cần.
• Ngoài ra bảng điều khiển có nút chat riêng (của MARZI) giúp bạn giải đáp và làm theo các bước trong tài liệu này.

1. Bật tắt cho cả công ty: menu Trợ lý AI: ba công tắc (người mua, app quản lý, bảng điều khiển). Tắt là tắt cho mọi cửa hàng của công ty.
2. Bật tắt từng cửa hàng: trang sửa khách hàng, thẻ Trợ lý AI; mỗi công tắc kèm dòng cho biết trợ lý đang chạy hay vì sao chưa (gói chưa có AI, đã tắt, hệ thống chưa cài dịch vụ chat).
3. Đừng quên cập nhật thông tin công ty (điện thoại, email) ở trang chi tiết công ty để trợ lý chỉ đúng nơi liên hệ.