Mẫu địa chỉ (Address Template)
Tài liệu ERPNext tiếng Việt: Mẫu địa chỉ (Address Template)
Mẫu địa chỉ (Address Template) quy định cách ERPNext định dạng một địa chỉ khi hiện trên chứng từ, mẫu in, bản xem trước và thư từ. Mẫu theo từng quốc gia giúp mỗi nơi dùng đúng thứ tự, nhãn và các trường tùy chọn mà người dân địa phương quen đọc.
ERPNext chọn mẫu dựa trên Quốc gia (Country) của địa chỉ. Nếu quốc gia đó chưa có mẫu riêng, hệ thống dùng mẫu được đánh dấu là mặc định.

Trước khi bắt đầu
Bạn cần:
- quyền System Manager hoặc tương đương;
- quốc gia mà định dạng này áp dụng;
- một địa chỉ mẫu có đủ các trường liên quan;
- biết cơ bản về HTML và mẫu Jinja;
- một chứng từ thử hoặc mẫu in để kiểm tra kết quả.
Hãy sao chép nội dung mẫu hiện có trước khi sửa lớn. Lỗi cú pháp có thể ảnh hưởng đến mọi chứng từ hiển thị địa chỉ của quốc gia đó.
Tạo mẫu địa chỉ
- Mở Trang chủ > CRM > Mẫu địa chỉ (Address Template).
- Chọn Thêm mẫu địa chỉ (Add Address Template).
- Chọn Quốc gia (Country).
- Nhập nội dung mẫu bằng Jinja và HTML.
- Chỉ bật Là mặc định (Is Default) khi mẫu này là mẫu dự phòng cho các quốc gia chưa có mẫu riêng.
- Lưu mẫu địa chỉ.
Thông thường mỗi quốc gia một mẫu. Chỉ giữ một mẫu mặc định phù hợp làm dự phòng.
Sửa mẫu có sẵn
- Mở mẫu của quốc gia cần sửa.
- Sao chép nội dung hiện tại để có thể khôi phục.
- Chỉ sửa tối thiểu những gì cần.
- Lưu.
- Mở một địa chỉ khách hàng hoặc nhà cung cấp tiêu biểu và kiểm tra kết quả hiển thị.
- Thử ít nhất một báo giá, hóa đơn bán hàng hoặc bản xem trước in liên quan.

Lưu được chưa có nghĩa là kết quả đúng. Hãy kiểm tra ngắt dòng, giá trị bị thiếu, nhãn, dấu câu và bố cục in khổ hẹp.
Các trường và khái niệm quan trọng
| Trường hoặc khái niệm | Tác dụng |
|---|---|
| Quốc gia (Country) | Xác định địa chỉ nào dùng mẫu này |
| Là mặc định (Is Default) | Đặt mẫu làm dự phòng khi không có mẫu riêng của quốc gia |
| Mẫu (Template) | Mã Jinja và HTML dùng để hiển thị địa chỉ đã định dạng |
address_line1 | Dòng đầu: đường hoặc tòa nhà |
address_line2 | Dòng địa chỉ thứ hai (tùy chọn) |
city | Thành phố hoặc thị trấn |
county | Quận/huyện hoặc đơn vị hành chính tương đương |
state | Tiểu bang, tỉnh hoặc vùng |
pincode | Mã bưu chính, ZIP hoặc PIN |
country | Tên quốc gia |
| Trường liên hệ | Điện thoại, fax và email (tùy chọn) mà mẫu có thể dùng |
| Trường tùy chỉnh (Custom Fields) | Các trường địa chỉ bổ sung, gọi theo tên trường |
Tên trường phân biệt chữ hoa, chữ thường. Dùng đúng tên trường hiển thị trong Tùy chỉnh biểu mẫu (Customize Form) hoặc siêu dữ liệu DocType, không dùng nhãn người dùng thấy.
Viết Jinja an toàn
Đặt các giá trị tùy chọn trong điều kiện để trường trống không để lại nhãn hay dấu câu thừa:
{{ address_line1 }}<br>
{% if address_line2 %}{{ address_line2 }}<br>{% endif %}
{{ city }}{% if state %}, {{ state }}{% endif %} {{ pincode }}<br>
{{ country }}Dùng <br> để chủ động xuống dòng trong địa chỉ. Không đưa logic nghiệp vụ phức tạp vào mẫu. Hãy lưu dữ liệu đã chuẩn hóa trong địa chỉ.
Công cụ mẫu cung cấp cả trường chuẩn và trường tùy chỉnh của địa chỉ. Xem Tùy chỉnh biểu mẫu trước khi dùng trường tùy chỉnh.
Mẫu theo quốc gia và mẫu mặc định
Với địa chỉ Hoa Kỳ, mẫu có thể in thành phố, tiểu bang và ZIP trên cùng một dòng, và chỉ in quận/huyện khi cần. Ở quốc gia khác, mã bưu chính có thể đứng trước thành phố.
ERPNext chọn mẫu tại thời điểm hiển thị, dựa trên quốc gia của địa chỉ. Vì vậy:
- sửa quốc gia nếu hiện sai mẫu;
- tạo mẫu riêng cho quốc gia khi thực sự có khác biệt về định dạng;
- dùng mẫu mặc định làm dự phòng chung an toàn;
- đừng đánh dấu mặc định cho nhiều mẫu mâu thuẫn nhau.
Mẫu địa chỉ ảnh hưởng đến khách hàng, nhà cung cấp, công ty, kho, liên hệ và các chứng từ như phiếu xuất kho, ở bất kỳ đâu có hiển thị địa chỉ đã định dạng.
Lưu và các bước tiếp theo
Mẫu địa chỉ chỉ cần Lưu, không cần Gửi. Sau khi lưu:
- thử nhiều địa chỉ đầy đủ và thiếu thông tin;
- kiểm tra kết quả địa chỉ thanh toán và giao hàng;
- xem trước một đơn bán hàng và một hóa đơn mua hàng;
- thử các mẫu in tùy chỉnh liên quan;
- ghi lại các trường tùy chỉnh mà mẫu phụ thuộc, để quản trị viên sau này nắm được.
Xử lý sự cố
| Vấn đề | Cần kiểm tra |
|---|---|
| Hiện sai định dạng | Kiểm tra quốc gia của địa chỉ và mẫu riêng của quốc gia đó |
| Quốc gia chưa có mẫu riêng | ERPNext sẽ dùng mẫu được đánh dấu mặc định |
| Hiện nhãn hoặc dấu câu trống | Đặt cả dòng hoặc nhãn tùy chọn trong một điều kiện Jinja |
| Một trường không bao giờ hiện | Kiểm tra đúng tên trường và địa chỉ có giá trị ở trường đó |
| Lưu được nhưng bản in bị lỗi | Kiểm tra cấu trúc HTML, các khối Jinja và độ rộng khả dụng của mẫu in |
| Trường tùy chỉnh gây lỗi | Kiểm tra trường có tồn tại ở mọi môi trường đích, hoặc bọc trường trong điều kiện |
Câu hỏi thường gặp
Được. Trường tùy chỉnh của địa chỉ dùng được trong mẫu qua tên trường.
Không. Chỉ tạo mẫu riêng ở nơi định dạng khác nhau. Mẫu mặc định lo phần còn lại.
Được. Viết trực tiếp nhãn mong muốn vào mẫu riêng của quốc gia.
Có thể làm đổi cách hiển thị địa chỉ khi in lại, tùy chứng từ hoặc mẫu in lưu hay lấy địa chỉ thế nào. Hãy thử đúng loại chứng từ đó trước khi dựa vào hành vi với dữ liệu cũ.
Nên giữ kiểu dáng đơn giản và tương thích với mẫu in đích. Ưu tiên HTML thuần và ngắt dòng đơn giản cho địa chỉ.