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 — công ty, địa chỉ, mã số thuế, phương thức thanh toán, email nhận invoice — để in chính xác lên invoice PDF. Đồng thời quản lý tên gọi khác (alias) của advertiser, giúp bill gửi về từ Telegram 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). Cả hai đều mở ngay trong drawer đăng ký.
Cách dùng
A. Sửa thông tin thanh toán (billing)
- Vào Sổ đăng ký, bấm một dòng để mở drawer đăng ký của ADV.
- Cuộn tới thẻ "Billing & Invoice — {tên ADV}". Thẻ này chỉ xuất hiện khi đăng ký đã lên trạng thái ĐANG HOẠT ĐỘNG (đã có advertiser thật).
- Bấm nút "✎ Sửa" ở góc phải thẻ để chuyển sang chế độ nhập. Nút này chỉ hiện với AM chủ ADV (hoặc ADMIN).

- Điền các ô:
- Company — tên công ty in trên PDF (VD: FUEGO LEADS).
- Address — địa chỉ đầy đủ.
- Phone — số điện thoại.
- VAT và Reg. code — mã số thuế / mã đăng ký (mặc định "0" nếu không có).
- Payment — chọn ACH hoặc PayPal (bắt buộc, mặc định ACH).
- PayPal email — chỉ hiện khi chọn PayPal; là nơi nhận tiền.
- Billing email — email nhận invoice.
- Bấm "Lưu" (nút đổi thành "Đang lưu…"). Lưu xong hiện thông báo "Đã lưu billing." và thẻ trở về chế độ xem. Muốn bỏ dở thì bấm "Huỷ".

B. Quản lý tên gọi khác (alias)
- Ở chế độ xem của thẻ billing, bấm link "🏷 Tên gọi khác" → mở hộp "Quản lý tên gọi khác — {tên ADV}".
- Gõ tên vào ô "Nhập tên gọi khác…" rồi bấm "Thêm" (hoặc nhấn Enter). Thành công hiện "Đã thêm alias." và tên xuất hiện trong danh sách.
- Mỗi dòng alias có nhãn nguồn: "Thủ công" (do bạn tự thêm) hoặc "Tự học" (hệ thống tự thêm khi khớp bill). Bấm 🗑 để xoá → xác nhận "Xoá" trong hộp thoại.

TIP
Càng thêm các biến thể tên hay xuất hiện trên bill (VD tên rút gọn, tên marketing) thì bill từ Telegram càng dễ tự khớp về đúng ADV, đỡ phải khớp tay.
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 |
| 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(viết thường; giữ nguyên vì không có đuôi công ty), nhãn "Thủ công". - Từ lúc này, bill Telegram mang tên "Fuego Leads Marketing" sẽ 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.
Xem thêm thuật ngữ tại Từ điển thuật ngữ và luồng khớp bill ở Xử lý bill.