Giao diện
Invoice — billing & alias
Mục đích
Cập nhật thông tin thanh toán (billing) của một advertiser để in chính xác lên invoice PDF, và quản lý tên gọi khác (alias) giúp bill gửi về từ Telegram tự khớp đúng ADV kể cả khi tên trên bill khác tên trong hệ thống. Người dùng: AM_ADV phụ trách chính ADV đó (và ADMIN cho phần billing).
Luồng hoạt động
Tham chiếu nhanh:
- Thẻ Billing & Invoice chỉ hiện khi đăng ký lên ĐANG HOẠT ĐỘNG; nút ✎ Sửa chỉ AM chủ ADV (hoặc ADMIN) thấy.
- Sửa billing: điền Company, Address, Phone, VAT / Reg. code, Payment (ACH / PayPal), Billing email, CC email → Lưu (hiện "Đã lưu billing.").
- Tên gọi khác: thêm biến thể tên hay xuất hiện trên bill để bill Telegram tự khớp; mỗi alias có nhãn Thủ công / Tự học, bấm 🗑 để xoá.
CC email — chỉ lưu để dành, chưa gửi tự động
Ô CC email trong dialog Sửa billing cho nhập nhiều email, ngăn cách bằng dấu chấm phẩy — placeholder cc1@partner.com; cc2@partner.com, gợi ý 'Nhiều email ngăn cách bằng dấu ";"'. Hiện hệ thống chỉ lưu lại giá trị này; chưa có tính năng tự gửi invoice qua email, nên nhập vào cũng chưa gửi cho ai.
Các tình huống có thể gặp
| Tình huống | Hệ thống xử lý | Bạn cần làm gì |
|---|---|---|
| Đăng ký chưa lên ĐANG HOẠT ĐỘNG | Thẻ "Billing & Invoice" chưa xuất hiện | Hoàn tất đăng ký cho ADV lên Active trước |
| Bạn không phải AM chủ ADV | Không thấy nút "✎ Sửa"; thao tác alias sẽ bị chặn | Nhờ đúng AM phụ trách (hoặc ADMIN) sửa |
| Nhập nhiều địa chỉ vào CC email | Ngăn cách bằng dấu chấm phẩy; giá trị được lưu nhưng chưa dùng để gửi | Nhập đúng định dạng, không cần chờ email tự gửi |
| Chọn Payment = PayPal, email sai định dạng | Hiện dòng đỏ "Email không hợp lệ", không cho lưu | Nhập email đúng dạng ten@mien.com |
| Gõ alias trùng tên đã có | Báo "Alias này đã tồn tại cho ADV.", không thêm | Bỏ qua, alias đã có sẵn |
| Gõ alias chỉ gồm ký tự đặc biệt / đuôi công ty | Sau chuẩn hoá còn rỗng → báo "Alias rỗng sau khi normalize." | Nhập tên có chữ hoặc số |
| Alias hiển thị khác chữ bạn gõ (viết thường, mất "Corp/Inc/LLC") | Bình thường — hệ thống chuẩn hoá tên trước khi lưu | Không cần làm gì |
| Dòng alias có nhãn "Tự học" | Hệ thống tự thêm khi một bill khớp về ADV này | Giữ lại; chỉ xoá nếu sai |
⚠ Lưu ý
WARNING
Billing dùng để in PDF invoice. Sai địa chỉ, sai VAT hay sai Billing email → invoice gửi partner cũng sai. Kiểm tra kỹ trước khi tạo invoice.
WARNING
Tên gọi khác được chuẩn hoá trước khi lưu: viết thường, bỏ dấu, gỡ đuôi công ty (Ltd, Inc, Corp, LLC, Co, Limited) và bỏ ký tự đặc biệt. Vì vậy "ABC Corp." và "abc" được xem là một alias — thêm lại sẽ báo trùng.
DANGER
Xoá alias không hoàn tác. Sau khi xoá, bill từ Telegram mang tên đó sẽ không còn tự khớp về ADV này — bạn sẽ phải khớp tay. Chỉ xoá alias thật sự sai.
Lỗi thường gặp & cách xử lý
| Triệu chứng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Không thấy nút "✎ Sửa" trên thẻ billing | Bạn không phải AM chủ ADV (và không phải ADMIN) | Nhờ AM phụ trách chính hoặc ADMIN chỉnh |
| "Bạn không có quyền cập nhật billing info của advertiser này." | Cố lưu billing của ADV không thuộc bạn | Chỉ sửa billing của ADV mình phụ trách |
| "Bạn không phụ trách ADV này." (khi thêm/xoá alias) | Thao tác alias trên ADV không thuộc bạn | Nhờ đúng AM chủ ADV thao tác |
| "Email không hợp lệ" / "PayPal email không hợp lệ." / "Billing email không hợp lệ." | Email sai định dạng | Nhập đúng dạng ten@mien.com |
| "Phương thức thanh toán mặc định là bắt buộc." | Chưa chọn Payment | Chọn ACH hoặc PayPal rồi lưu |
| "Alias này đã tồn tại cho ADV." | Tên (sau chuẩn hoá) đã có trong danh sách | Không cần thêm lại |
| "Alias rỗng sau khi normalize." | Tên chỉ gồm ký tự đặc biệt hoặc bị gỡ hết sau chuẩn hoá | Nhập tên có chữ hoặc số |
| "Không tải được danh sách alias." | Lỗi mạng khi mở hộp | Đóng và mở lại hộp, hoặc tải lại trang |
| "Xoá alias thất bại." | Lỗi mạng khi xoá | Thử xoá lại |
Ví dụ minh hoạ
ADV tên chính trong hệ thống là "FUEGO LEADS LLC". Bill gửi về từ Telegram lại thường ghi "Fuego Leads Marketing" nên không tự khớp.
- Mở drawer đăng ký của ADV → thẻ "Billing & Invoice — FUEGO LEADS LLC".
- Bấm "🏷 Tên gọi khác", gõ
Fuego Leads Marketing, bấm "Thêm". - Hệ thống chuẩn hoá và lưu thành
fuego leads marketing, nhãn "Thủ công". Từ đây, bill Telegram mang tên đó tự khớp về đúng ADV, không cần khớp tay ở màn Bills.
Song song, bấm "✎ Sửa" để nhập billing: Company FUEGO LEADS, Address đầy đủ, Payment ACH, Billing email billing@fuego.com → "Lưu". Khi tạo invoice cho ADV này, PDF sẽ tự điền đúng các thông tin trên.
Liên quan
- Tạo & quản lý invoice — dùng billing này để in lên PDF.
- Xử lý bill — luồng khớp bill dựa trên alias.
- Từ điển thuật ngữ — giải nghĩa các thuật ngữ liên quan.