feat: currency exchange settings

[rtdany10]

Currency Exchange Settings will enable users to use exchange rate provider of their choice.

Closes #27317
#no-docs (temp)

[coveralls]

Coverage decreased (-0.01%) to 51.499% when pulling f460229 on rtdany10:currency-exchange-settings into ceaa804 on frappe:develop.

[ankush]

@marination @deepeshgarg007 @nextchamp-saqib @barredterra

Your comments? From UX perspective most users won't understand what endpoint/parameters etc even means. It might be a better idea to have a list of providers from which users can choose the one they want.

[marination]

@ankush I agree with your solution but have a different reasoning.

@rtdany10
My concern is error handling. Most APIs have their quirks and will need special error handling. Making something as generic (the API field) for currency exchange rates doesn't sound like the best idea stability wise. Setup may go through, but what about after that ? Things like unsupported currencies and the service being down need to be handled separately.

I would also suggest giving a list of services, that we support, to choose from so that we know that these are well handled and compatible with ERPNext. We can incrementally build on these services as and when there is demand for them.

[rtdany10]

Things like unsupported currencies and the service being down need to be handled separately.

I believe that the function to get exchange rate from the provider does handle this. It returns 0.00 and logs an error.

But again, as pointed out, having some select-able pre-configured options will make it easier for the end user, like in the case of Email Accounts where certain service providers can be selected without configuring Email Domain.

I can add some service providers; would be nice if someone shares a preferred list of service providers. @barredterra and other end users.

@ankush @marination

[barredterra]

@rtdany10 let's go with exchangerate.host and frankfurter.app for now. The official API of the European Central Bank would also be interesting: https://sdw-wsrest.ecb.europa.eu/help/

[codecov]

Codecov Report

Merging #27318 (93d784d) into develop (9d36e30) will increase coverage by 9.07%.
The diff coverage is 59.52%.

@@             Coverage Diff             @@
##           develop   #27318      +/-   ##
===========================================
+ Coverage    48.84%   57.92%   +9.07%     
===========================================
  Files         1107     1110       +3     
  Lines        67910    67991      +81     
===========================================
+ Hits         33174    39386    +6212     
+ Misses       34736    28605    -6131     

Impacted Files	Coverage Δ
erpnext/setup/install.py	0.00% <0.00%> (ø)
...cy_exchange_settings/currency_exchange_settings.py	62.26% <62.26%> (ø)
...ings_details/currency_exchange_settings_details.py	100.00% <100.00%> (ø)
...ttings_result/currency_exchange_settings_result.py	100.00% <100.00%> (ø)
erpnext/setup/utils.py	89.69% <100.00%> (+2.05%)	⬆️
...eorder_level/itemwise_recommended_reorder_level.py	92.45% <0.00%> (-1.89%)	⬇️
...ctype/accounting_dimension/accounting_dimension.py	64.34% <0.00%> (-1.56%)	⬇️
...e/period_closing_voucher/period_closing_voucher.py	88.23% <0.00%> (-1.48%)	⬇️
...ype/account/chart_of_accounts/chart_of_accounts.py	77.39% <0.00%> (-0.69%)	⬇️
erpnext/stock/report/stock_ageing/stock_ageing.py	93.06% <0.00%> (ø)
... and 211 more

[rtdany10]

CES-1.mp4

I hope this is fine. Will make the fields read only.

[stale]

This pull request has been automatically marked as inactive because it has not had recent activity. It will be closed within 3 days if no further activity occurs, but it only takes a comment to keep a contribution alive :) Also, even if it is closed, you can always reopen the PR when you're ready. Thank you for contributing.

[deepeshgarg007]

@Mergifyio backport version-13-hotfix

[mergify]

backport version-13-hotfix

❌ No backport have been created

• Backport to branch version-13-hotfix failed
  Pull request with merge commit are not supported