Paypal - Mở rộng hỗ trợ tiền tệ
| Số dòng Code | 318 |
| Tên kỹ thuật | to_paypal_unsupported_currencies |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/to_paypal_unsupported_currencies |
| Đọc mô tả cho | v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Mô-đun Cơ Sở Nền tảng Kế toán Quy đổi Tiền tệ cho Cổng Thanh toán |
Để khách hàng nước ngoài thanh toán hóa đơn VND của bạn bằng PayPal - thu bằng USD
Dành cho doanh nghiệp xuất khẩu Việt Nam và mọi doanh nghiệp có loại tiền tệ mà PayPal không chấp nhận.
Thanh toán chứng từ bằng loại tiền PayPal không chấp nhận: PayPal thu số tiền đã quy đổi.
Mở rộng to_currency_conversion_diff - xem tài liệu của mô-đun này.
Bạn có đang gặp những điều này?
Khách hàng nước ngoài muốn thanh toán bằng PayPal, nhưng hóa đơn VND của bạn không hiển thị PayPal.
Bạn đành xin khách chuyển khoản ngân hàng, hoặc phát hành thêm hóa đơn USD chỉ để được thanh toán.
Khi khoản USD về, bạn tự quy đổi sang VND và hạch toán phần chênh lệch bằng bút toán thủ công.
Khách hàng không chắc mình sẽ bị thu chính xác bao nhiêu tiền.
Bạn lo thay đổi quy trình thanh toán có thể ảnh hưởng đến cấu hình PayPal đang dùng.
Bạn nhận được gì
Hóa đơn VND không có PayPal
→ PayPal được hiển thị cho chứng từ bằng loại tiền PayPal không chấp nhận; nút PayPal và đơn hàng PayPal dùng loại tiền đã quy đổi, ví dụ USD
Khách không chắc số tiền bị thu
→ Trang thanh toán hiển thị số tiền sẽ bị thu
Rủi ro thu sai số tiền
→ Khoản PayPal thu được đối chiếu với số tiền và loại tiền đã quy đổi; sai lệch sẽ chuyển giao dịch sang trạng thái lỗi
Bút toán quy đổi thủ công
→ Khoản thanh toán được ghi nhận bằng loại tiền đã quy đổi với đúng số tiền PayPal đã thu, chứng từ được thanh toán, và chênh lệch quy đổi so với số tiền chứng từ theo tỷ giá Odoo được hạch toán tự động vào tài khoản lãi hoặc lỗ chênh lệch quy đổi
Lo ngại làm hỏng quy trình thanh toán
→ Công ty có loại tiền PayPal chấp nhận vẫn dùng PayPal tiêu chuẩn; gỡ mô-đun sẽ khôi phục lại PayPal tiêu chuẩn
Ví dụ: hóa đơn 2.500.000 VND theo tỷ giá Odoo 1 USD = 25.400 VND được thu 98,43 USD. Khoản thanh toán này có giá trị 2.500.122 VND, nên hóa đơn được thanh toán và phần chênh lệch 122 VND được ghi nhận là thu nhập chênh lệch quy đổi.
Cách hoạt động
Khách hàng thanh toán (Draft)
Khách hàng mở hóa đơn trên cổng thông tin, chọn PayPal và thấy số tiền quy đổi sẽ bị thu.
Khách hàng phê duyệt (Pending)
Khách hàng phê duyệt thanh toán trên PayPal bằng loại tiền đã quy đổi. Odoo xác nhận khi PayPal báo đúng số tiền và loại tiền đó, sau đó ghi nhận khoản thanh toán và đánh dấu hóa đơn đã thanh toán.
Thiết lập rất nhẹ. Quản trị hệ thống cài mô-đun (mô-đun tự động cài cùng PayPal và Quy đổi Tiền tệ cho Cổng Thanh toán). Khi cài đặt, USD trở thành tiền tệ quy đổi của nhà cung cấp PayPal thuộc các công ty có loại tiền PayPal không chấp nhận, với điều kiện USD đang hoạt động và nằm trong các loại tiền của nhà cung cấp, công ty đã thiết lập đầy đủ quy đổi tiền tệ (tài khoản, sổ nhật ký) và Odoo có tỷ giá USD. Các công ty khác có thể đặt Tiền tệ Quy đổi Mặc định trên nhà cung cấp PayPal sau.
Tính năng chính
Thanh toán PayPal cho chứng từ bằng loại tiền không được hỗ trợ
Cho phép khách hàng thanh toán hóa đơn bằng loại tiền PayPal không chấp nhận, với nút PayPal tải theo loại tiền đã quy đổi (ví dụ USD).
Đơn hàng và khoản thu PayPal theo số tiền đã quy đổi
PayPal thu số tiền đã quy đổi, và khoản PayPal thu được đối chiếu với số tiền và loại tiền đó.
Tự động dùng USD khi cài đặt và hoàn tác khi gỡ
Công ty có loại tiền PayPal không chấp nhận được dùng PayPal bằng USD ngay khi cài đặt, nếu đã có thiết lập quy đổi và tỷ giá; gỡ mô-đun sẽ khôi phục PayPal tiêu chuẩn.
Dành cho ai
Chủ doanh nghiệp hoặc giám đốc công ty xuất khẩu
Bạn muốn khách nước ngoài thanh toán mà không phải phát hành lại hóa đơn. Lợi ích: PayPal xuất hiện trên hóa đơn bằng nội tệ của bạn.
Kế toán trưởng hoặc giám đốc tài chính
Bạn đối soát khoản thu PayPal với hóa đơn bằng nội tệ. Lợi ích: khoản thanh toán bằng đúng số PayPal quyết toán, và chênh lệch quy đổi được hạch toán giúp bạn.
Khách hàng thanh toán từ nước ngoài
Bạn muốn trả bằng PayPal và biết rõ số tiền. Lợi ích: có nút PayPal và số tiền bị thu hiển thị trên trang thanh toán.
Quản trị hệ thống
Bạn giữ quy trình thanh toán ổn định. Lợi ích: tự động thiết lập USD khi cần, PayPal tiêu chuẩn ở mọi trường hợp khác, gỡ cài đặt gọn gàng.
Phù hợp nhất với: doanh nghiệp xuất khẩu Việt Nam, và doanh nghiệp ở nước khác có loại tiền PayPal không chấp nhận, lập hóa đơn bằng nội tệ và thu tiền từ khách hàng nước ngoài bằng USD qua PayPal.
Thấy số tiền trước khi thanh toán
Khách hàng thấy PayPal trên hóa đơn VND và đúng số tiền USD sẽ bị thu.
Ghi nhận khoản thanh toán bằng USD
Hóa đơn được thanh toán bằng khoản thanh toán theo loại tiền đã quy đổi, đúng số tiền PayPal đã thu.
Chọn loại tiền quy đổi
Đặt Tiền tệ Quy đổi Mặc định trên nhà cung cấp PayPal; hiển thị Chế độ Thử nghiệm với thông tin xác thực mẫu.
Xem Paypal - Mở rộng hỗ trợ tiền tệ hoạt động
Câu hỏi thường gặp
Hỗ trợ những loại tiền nào?
Mọi loại tiền PayPal không chấp nhận, với điều kiện loại tiền chứng từ hoặc loại tiền quy đổi là loại tiền của công ty. VND là trường hợp điển hình.
Khách hàng có thấy số tiền sẽ trả không?
Có. Trang thanh toán hiển thị số tiền sẽ bị thu bằng loại tiền đã quy đổi.
Nếu PayPal thu số tiền khác thì sao?
Giao dịch chuyển sang trạng thái lỗi và không có khoản thanh toán nào được ghi nhận.
Chênh lệch quy đổi được hạch toán vào đâu?
Vào tài khoản lãi hoặc lỗ chênh lệch quy đổi đã thiết lập trong Thiết lập, mục Quy đổi tiền tệ cổng thanh toán.
Tôi có phải cấu hình gì không?
Khi cài đặt, USD được tự động thiết lập nếu thỏa các điều kiện nêu trên. Nếu không, hãy đặt Tiền tệ Quy đổi Mặc định trên nhà cung cấp PayPal.
Mô-đun có làm thay đổi PayPal của các công ty không cần đến nó không?
Không. Công ty có loại tiền PayPal chấp nhận vẫn dùng PayPal tiêu chuẩn, và gỡ mô-đun sẽ khôi phục lại PayPal tiêu chuẩn.
Hỗ trợ những ấn bản nào?
Community và Enterprise.
Cần hỗ trợ về Paypal - Mở rộng hỗ trợ tiền tệ?
Yêu cầu kỹ thuật
- Phiên bản Odoo: 19.0
- Ấn bản: Community và Enterprise
- Mô-đun yêu cầu: Nhà cung cấp thanh toán: PayPal (
payment_paypal), to_currency_conversion_diff - Giấy phép: OPL-1
Paypal - Mở rộng hỗ trợ tiền tệ
Note
Mở rộng to_currency_conversion_diff - xem tài liệu của mô-đun này.
Tổng quan
PayPal chỉ chấp nhận một số loại tiền tệ. Nếu không có mô-đun này, PayPal sẽ biến mất khỏi trang thanh toán ngay khi hóa đơn hoặc đơn bán hàng bằng loại tiền khác, ví dụ Việt Nam Đồng (VND). Với mô-đun này, khách hàng vẫn có thể thanh toán chứng từ đó bằng PayPal:
- PayPal được hiển thị cho chứng từ, còn nút PayPal và đơn hàng PayPal dùng loại tiền đã quy đổi (mặc định là USD) với số tiền đã quy đổi.
- Khách hàng thấy số tiền sẽ bị thu trước khi xác nhận và bị thu đúng số tiền đó.
- Khoản PayPal thu được đối chiếu với số tiền đã quy đổi và loại tiền đã quy đổi. Nếu PayPal thu số tiền khác hoặc loại tiền khác, giao dịch chuyển sang trạng thái Lỗi và không có khoản thanh toán nào được ghi nhận.
- Khoản thanh toán được ghi nhận bằng loại tiền đã quy đổi với số tiền PayPal đã thu, hóa đơn được thanh toán, và phần chênh lệch nhỏ so với số tiền chứng từ được hạch toán vào tài khoản lãi hoặc lỗ chênh lệch quy đổi.
Mô-đun được cài đặt tự động khi đã cài Thanh toán online với PayPal và Quy đổi tiền tệ qua cổng thanh toán. Phần quy đổi, các tài khoản và quy tắc hạch toán được mô tả trong hướng dẫn của to_currency_conversion_diff, còn hướng dẫn này chỉ nói về những gì riêng của PayPal.
Một khoản thanh toán đi qua những ai
- Quản trị viên hệ thống kiểm tra Tiền tệ quy đổi mặc định của PayPal và bật nhà cung cấp.
- Khách hàng mở hóa đơn, nhấn nút thanh toán, thấy ghi chú như "Bạn sẽ được thu khoảng USD 98,43" và phê duyệt khoản thanh toán trong PayPal.
Ai sử dụng mô-đun này
| Vai trò | Công việc | Quyền truy cập cần gán |
|---|---|---|
| Quản trị viên hệ thống | Cài đặt mô-đun và đặt Tiền tệ quy đổi mặc định, thông tin đăng nhập và trạng thái hiển thị của nhà cung cấp PayPal. | Role / Administrator |
| Khách hàng | Thanh toán hóa đơn bằng loại tiền PayPal không chấp nhận bằng cách trả số tiền đã quy đổi qua PayPal. | Cổng thông tin (không cần gán quyền: khách hàng dùng cổng thông tin) |
Ví dụ minh họa: khoản thanh toán được hạch toán thế nào
Công ty của bạn dùng VND. Bạn lập hóa đơn S-18 trị giá 2.500.000 VND và khách hàng thanh toán bằng PayPal. PayPal được đặt để thu bằng USD, tỷ giá trong Odoo là 1 USD = 25.400 VND.
- Khách hàng bị thu 2.500.000 / 25.400 = 98,43 USD.
- Khoản thanh toán 98,43 USD được ghi nhận vào ngày giao dịch. Theo tỷ giá ngày đó, nó có giá trị 2.500.122 VND, nên hóa đơn được thanh toán đủ và phần dư 122 VND được hạch toán là thu nhập chênh lệch quy đổi vào Tài khoản lãi của mục Quy đổi tiền tệ qua cổng thanh toán.
- Nếu khoản thanh toán được ghi nhận vào ngày hôm sau, khi 1 USD = 25.300 VND, thì chính 98,43 USD đó chỉ có giá trị 2.490.279 VND. Hóa đơn vẫn được thanh toán đủ, và phần thiếu 9.721 VND được hạch toán là chi phí chênh lệch quy đổi vào Tài khoản lỗ.
- Nếu hóa đơn có chiết khấu thanh toán sớm 2% và khách hàng thanh toán trong thời hạn chiết khấu, số tiền phải trả là 2.450.000 VND và khách hàng bị thu 2.450.000 / 25.400 = 96,46 USD. Bút toán thanh toán chứa các dòng chiết khấu, đều bằng USD, và hóa đơn được thanh toán.
Vì loại tiền của công ty cũng là loại tiền của chứng từ nên không có khoản phải thu bằng ngoại tệ, do đó không có lãi hay lỗ tỷ giá: toàn bộ phần chênh lệch là chênh lệch quy đổi.
Thiết lập (dành cho Quản trị viên hệ thống)
Cài đặt
- Mở Ứng dụng.
- Bỏ bộ lọc Ứng dụng nếu cần và tìm Paypal - Mở rộng hỗ trợ tiền tệ.
- Nhấn Cài đặt.
Mô-đun được cài cùng các ứng dụng nó cần (PayPal và Quy đổi tiền tệ qua cổng thanh toán). Hãy hoàn tất thiết lập tài khoản của Quy đổi tiền tệ qua cổng thanh toán trước: làm theo phần thiết lập trong hướng dẫn của to_currency_conversion_diff (Tài khoản lãi, Tài khoản lỗ và sổ nhật ký chênh lệch tỷ giá).
Cấu hình
Thiết lập tự động khi cài đặt
Khi cài mô-đun, PayPal chỉ được đặt để thu bằng USD cho một công ty nếu tất cả các điều kiện sau đều đúng:
- loại tiền của công ty không nằm trong các loại tiền PayPal chấp nhận (ví dụ VND);
- USD đang hoạt động và nằm trong các loại tiền của nhà cung cấp PayPal;
- công ty đã thiết lập đầy đủ mục Quy đổi tiền tệ qua cổng thanh toán (Tài khoản lãi, Tài khoản lỗ và sổ nhật ký chênh lệch tỷ giá);
- Odoo có tỷ giá USD.
Nếu một điều kiện không đúng, không có gì thay đổi và PayPal hoạt động như PayPal tiêu chuẩn đối với công ty đó. Bạn có thể đặt loại tiền thủ công bất cứ lúc nào, như bên dưới.
Đặt Tiền tệ quy đổi mặc định thủ công
- Mở Hóa đơn ‣ Cấu hình ‣ Khoản thanh toán online ‣ Cổng thanh toán và mở PayPal.
- Điền thông tin đăng nhập của tài khoản PayPal và đặt Trạng thái (ví dụ Chế độ kiểm thử khi bạn đang dùng thử).
- Mở tab Cấu hình. Trong phần Trạng thái khả dụng, trường Tiền tệ liệt kê các loại tiền PayPal chấp nhận.
- Tại Tiền tệ quy đổi mặc định, chọn loại tiền PayPal sẽ thu cho chứng từ bằng loại tiền khác, ví dụ USD. Loại tiền này phải nằm trong danh sách đã liệt kê.
- Nhấn Lưu.
Những điều cần biết:
- Để trống Tiền tệ quy đổi mặc định nếu muốn giữ PayPal như Odoo tiêu chuẩn: khi đó PayPal bị ẩn với chứng từ bằng loại tiền PayPal không chấp nhận.
- Chỉ bật được nhà cung cấp khi công ty đã có Tài khoản lãi, Tài khoản lỗ và sổ nhật ký chênh lệch tỷ giá. Nếu thiếu, Odoo nêu tên các thiết lập còn thiếu.
- PayPal chỉ được hiển thị cho chứng từ nếu loại tiền chứng từ hoặc loại tiền quy đổi là loại tiền của công ty. Chứng từ bằng loại tiền thứ ba sẽ không có PayPal.
- PayPal phải được hiển thị (đã xuất bản) thì khách hàng mới thấy.
- Thanh toán thật cần Client ID và Client Secret của tài khoản PayPal của bạn.
Gán quyền truy cập
- Mở Thiết lập ‣ Người dùng & Công ty ‣ Người dùng và mở người dùng cần gán.
- Gán cho Quản trị viên hệ thống quyền truy cập Role / Administrator.
- Nhấn Lưu.
Khách hàng: thanh toán hóa đơn bằng PayPal
Thanh toán hóa đơn bằng loại tiền PayPal không chấp nhận
- Mở hóa đơn từ đường dẫn bạn nhận được, hoặc từ cổng thông tin khách hàng tại Hóa đơn bán ra & hóa đơn mua hàng.
- Nhấn Trả ngay.
- Trong cửa sổ Thanh toán, PayPal được liệt kê kèm ghi chú như Bạn sẽ được thu khoảng USD 98,43. Đó là số tiền sẽ bị thu, được cố định khi bạn bắt đầu thanh toán.
- Phê duyệt khoản thanh toán trong cửa sổ PayPal. PayPal thu đúng số tiền được hiển thị.
Khi PayPal xác nhận khoản thanh toán, hóa đơn được thanh toán và trang xác nhận hiển thị số tiền đã thu cạnh số tiền hóa đơn.
Note
Số tiền được hiển thị là "khoảng" vì PayPal có thể áp dụng tỷ giá riêng. Công ty hạch toán phần chênh lệch nhỏ đó thành chênh lệch quy đổi, như trong ví dụ minh họa.
Công ty thấy gì sau đó
Khoản thanh toán được ghi nhận tự động. Để xem lại, mở Hóa đơn ‣ Khách hàng ‣ Thanh toán và mở khoản thanh toán: Số tiền và loại tiền là những gì PayPal đã thu (98,43 USD), và hóa đơn đã được thanh toán. Nhấn Phát sinh kế toán trên bút toán thanh toán để xem dòng chứa chênh lệch quy đổi.
Về giao dịch, cột số tiền đã thu và các giao dịch được xác nhận nhưng chưa có khoản thanh toán, xem hướng dẫn của to_currency_conversion_diff.
Hoàn tiền
PayPal không hỗ trợ hoàn tiền từ Odoo: trường Hoàn tiền của nhà cung cấp hiển thị Không hỗ trợ. Hãy hoàn tiền cho khách hàng trong tài khoản PayPal của bạn, sau đó ghi nhận khoản chi tương ứng cho giấy báo có trong Odoo.
Gỡ cài đặt
Gỡ mô-đun sẽ xóa Tiền tệ quy đổi mặc định của các nhà cung cấp PayPal. PayPal khi đó quay lại chỉ chấp nhận các loại tiền nó hỗ trợ và lại bị ẩn với chứng từ bằng loại tiền khác. Các khoản thanh toán đã ghi nhận không bị thay đổi.
Xử lý sự cố
- PayPal không xuất hiện khi thanh toán.
- Kiểm tra PayPal đang ở Chế độ kiểm thử hoặc Đã bật và đã hiển thị, Tiền tệ quy đổi mặc định đã được đặt (trường này vẫn trống nếu các điều kiện thiết lập tự động không đúng khi cài đặt), và loại tiền của công ty là loại tiền chứng từ hoặc Tiền tệ quy đổi mặc định.
- Odoo từ chối bật PayPal.
- Thông báo nêu tên các thiết lập còn thiếu. Hãy điền Tài khoản lãi và Tài khoản lỗ của mục Quy đổi tiền tệ qua cổng thanh toán cùng sổ nhật ký chênh lệch tỷ giá, hoặc xóa Tiền tệ quy đổi mặc định.
- Odoo từ chối lưu Tiền tệ quy đổi mặc định.
- Loại tiền đó không nằm trong danh sách Tiền tệ của PayPal. Hãy chọn một loại tiền trong danh sách.
- Giao dịch chuyển sang trạng thái Lỗi.
- PayPal báo về số tiền hoặc loại tiền đã thu khác với số tiền đã quy đổi hiển thị cho khách hàng. Không có khoản thanh toán nào được ghi nhận. Hãy kiểm tra giao dịch trong tài khoản PayPal trước khi đề nghị khách hàng thanh toán lại.
Câu hỏi thường gặp
- Khách hàng thanh toán bằng loại tiền nào?
- Tiền tệ quy đổi mặc định của nhà cung cấp PayPal, mặc định là USD với công ty dùng VND.
- Khách hàng có phải trả số tiền khác với hóa đơn không?
- Khách hàng trả số tiền hóa đơn được quy đổi theo tỷ giá lưu trong Odoo. Hóa đơn được thanh toán đủ và phần chênh lệch do quy đổi được hạch toán vào tài khoản lãi hoặc lỗ của bạn.
- Tôi có thể hoàn tiền từ Odoo không?
- Không. Việc hoàn tiền PayPal thực hiện trong tài khoản PayPal của bạn.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.
