ERPNext tiếng Việt
Thiết lậpKhách hàng

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ình soạn Mẫu địa chỉ Hoa Kỳ với các trường Jinja và trạng thái 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ỉ

  1. Mở Trang chủ > CRM > Mẫu địa chỉ (Address Template).
  2. Chọn Thêm mẫu địa chỉ (Add Address Template).
  3. Chọn Quốc gia (Country).
  4. Nhập nội dung mẫu bằng Jinja và HTML.
  5. 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.
  6. 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

  1. Mở mẫu của quốc gia cần sửa.
  2. Sao chép nội dung hiện tại để có thể khôi phục.
  3. Chỉ sửa tối thiểu những gì cần.
  4. Lưu.
  5. 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ị.
  6. 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.

Địa chỉ thanh toán và giao hàng đã định dạng, hiển thị trên khách hàng.

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ệmTá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_line1Dòng đầu: đường hoặc tòa nhà
address_line2Dòng địa chỉ thứ hai (tùy chọn)
cityThành phố hoặc thị trấn
countyQuận/huyện hoặc đơn vị hành chính tương đương
stateTiểu bang, tỉnh hoặc vùng
pincodeMã bưu chính, ZIP hoặc PIN
countryTê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ạngKiể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êngERPNext 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ệnKiể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ỗiKiể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ỗiKiể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

Chủ đề liên quan

Trong trang này