Mô tả chi tiết tính năng quản lý các loại tiền tệ và tỉ giá
Back to ecommerce
Updated at
1793612889000
Mọi số tiền trong E-Commerce (giá sản phẩm, đơn hàng, phí vận chuyển, voucher) đều gắn với một loại tiền. Bài viết này hướng dẫn quản lý các loại tiền trong E-Commerce > Các loại tiền, chọn loại tiền mặc định của website, và khai báo tỉ giá trong E-Commerce > Các tỉ giá để plugin quy đổi khi hai bên dùng hai loại tiền khác nhau.
Quản lý các loại tiền
Ở lần chạy đầu tiên, plugin tạo sẵn 7 loại tiền phổ biến: USD, EUR, VND, JPY, CNY, KRW và INR. Tất cả đều ở trạng thái Chưa kích hoạt, và USD được chọn làm mặc định. Vì vậy, việc đầu tiên sau khi cài plugin là kích hoạt loại tiền bạn bán hàng. Chừng nào chưa có loại tiền nào được kích hoạt, các form sản phẩm, đơn hàng, dịch vụ thanh toán và dịch vụ vận chuyển sẽ nhắc bạn kích hoạt ít nhất một loại tiền.
Danh sách các loại tiền
Trang Các loại tiền liệt kê mã ISO, ký hiệu (kèm vị trí trước hay sau giá), tên hiển thị, định dạng, số thập phân, trạng thái và loại tiền mặc định. Bạn có thể lọc theo trạng thái hoặc tìm theo mã ISO.

- Thêm mới: mở form tạo loại tiền mới (xem phần tiếp theo).
- Mặc định: loại tiền mặc định được đánh dấu Mặc định. Bấm Lựa chọn ở một dòng khác để đổi loại tiền mặc định. Loại tiền mặc định được chọn sẵn khi tạo sản phẩm hay dịch vụ thanh toán, và được website dùng để lấy giá sản phẩm khi theme không chỉ định loại tiền.
- Kích hoạt / Vô hiệu hoá: biểu tượng máy bay giấy màu xanh kích hoạt một loại tiền chưa kích hoạt, biểu tượng ngắt liên kết màu xám vô hiệu hoá một loại tiền đang dùng. Chỉ những loại tiền đã kích hoạt mới xuất hiện trong các ô chọn loại tiền.
- Sửa / Xoá: mở form sửa thông tin hoặc xoá loại tiền.
Thêm mới và chỉnh sửa loại tiền
Bấm Thêm mới để mở form Thêm mới loại tiền. Form sửa có các trường giống hệt.

- Mã ISO (bắt buộc): mã theo chuẩn ISO 4217, ví dụ
USD,VND,GBP. Mỗi mã chỉ được dùng cho một loại tiền. - Ký hiệu (bắt buộc): ký hiệu hiển thị cạnh số tiền, ví dụ
$,₫,£. - Vị trí kí hiệu: Trước giá (
$100) hoặc Sau giá (100₫). - Tên hiển thị (bắt buộc): tên đầy đủ, ví dụ
British pound. Tên này cũng không được trùng với loại tiền khác. - Định dạng (bắt buộc): mẫu định dạng số.
#,###hiển thị số nguyên có dấu phân cách hàng nghìn (26,000),#,###.##hiển thị thêm tối đa 2 chữ số thập phân (19.99). - Số thập phân: số chữ số sau dấu thập phân của loại tiền.
- Trạng thái: Đã kích hoạt để dùng ngay, hoặc Chưa kích hoạt để chuẩn bị trước.
Bấm Thêm (hoặc Sửa trong form sửa) để lưu. Nếu mã ISO hoặc tên hiển thị đã tồn tại, form báo lỗi ngay trên trường đó.
Lưu ý khi xoá loại tiền
Plugin không chặn việc xoá một loại tiền đang được sản phẩm, đơn hàng, tỉ giá hay dịch vụ thanh toán sử dụng. Khi đã có dữ liệu bán hàng, hãy vô hiệu hoá loại tiền thay vì xoá, để giữ đúng giá trị của các đơn hàng cũ.
Quản lý các tỉ giá
Tỉ giá cho plugin biết 1 đơn vị loại tiền này bằng bao nhiêu đơn vị loại tiền khác. Bạn chỉ cần khai báo tỉ giá khi website dùng nhiều hơn một loại tiền. Nếu mọi thứ đều dùng một loại tiền (ví dụ chỉ VND), trang này có thể để trống.
Khi nào plugin cần tỉ giá
Plugin tra tỉ giá trong những trường hợp sau:
- Thanh toán: mỗi dịch vụ thanh toán có một Loại tiền riêng (ô số 1 trong hình dưới). Khi khách thanh toán một đơn hàng bằng loại tiền khác, plugin quy đổi số tiền theo tỉ giá từ loại tiền của đơn hàng sang loại tiền của dịch vụ thanh toán. Nếu chưa có tỉ giá này, khách sẽ không tạo được yêu cầu thanh toán.
- Phí vận chuyển: phí tối thiểu của dịch vụ vận chuyển được khai báo theo một loại tiền và được quy đổi sang loại tiền của đơn hàng.
- Theme: website có thể gọi API
/api/v1/currencies/exchange-amountđể quy đổi một số tiền giữa hai loại tiền, ví dụ để hiển thị giá tham khảo bằng ngoại tệ.
- Loại tiền: loại tiền mà dịch vụ thanh toán nhận. Ví dụ một cổng thanh toán nội địa nhận VND: đơn hàng bằng USD cần có tỉ giá USD → VND để thanh toán qua cổng này.
Danh sách các tỉ giá
Trang Các tỉ giá liệt kê các cặp tiền đã khai báo. Bạn có thể lọc theo loại tiền Từ và Đến.

- Thêm mới: mở form thêm tỉ giá.
- Từ / Đến / Giá trị: mỗi dòng có nghĩa là 1 đơn vị loại tiền Từ bằng Giá trị đơn vị loại tiền Đến. Ví dụ dòng cuối: 1 USD = 26,000 VND.
- Sửa / Xoá: cập nhật giá trị hoặc xoá tỉ giá.
Tỉ giá chỉ có một chiều: dòng USD → VND không được dùng để quy đổi VND → USD. Nếu cần quy đổi cả hai chiều, hãy khai báo cả hai dòng.
Thêm mới tỉ giá
Bấm Thêm mới để mở form Thêm tỉ giá mới:

- Từ: loại tiền nguồn, ví dụ
United States dollar (USD). - Đến: loại tiền đích, ví dụ
Việt Nam đồng (VND). - Giá trị: số đơn vị loại tiền đích của 1 đơn vị loại tiền nguồn, phải lớn hơn 0. Với ví dụ trên, nhập
26000nghĩa là 1 USD = 26,000 VND.
Mỗi cặp Từ - Đến chỉ được khai báo một lần. Nếu cặp đó đã có, form báo trùng và bạn cần sửa dòng tỉ giá đang có.
Chỉnh sửa và xoá tỉ giá
Bấm biểu tượng sửa ở cột Các hành động để mở form Sửa tỉ giá. Form này chỉ cho đổi Giá trị, còn cặp Từ - Đến được giữ nguyên. Muốn đổi cặp tiền, hãy xoá dòng cũ và thêm dòng mới.

Bấm biểu tượng thùng rác để xoá một tỉ giá. Sau khi xoá, các thanh toán và phép quy đổi cần đến cặp tiền đó sẽ báo lỗi cho tới khi bạn khai báo lại.
Gợi ý thiết lập
Nếu bạn bán hàng bằng một loại tiền duy nhất:
- Kích hoạt loại tiền đó và chọn Lựa chọn để đặt làm mặc định.
- Vô hiệu hoá các loại tiền không dùng, để các ô chọn loại tiền gọn hơn.
- Chọn đúng loại tiền này cho các dịch vụ thanh toán và dịch vụ vận chuyển. Khi đó không cần khai báo tỉ giá.
Nếu bạn bán hàng bằng nhiều loại tiền, hãy thêm tỉ giá từ mỗi loại tiền bán hàng sang loại tiền của từng dịch vụ thanh toán, và cập nhật giá trị định kỳ, vì tỉ giá không tự cập nhật theo thị trường.