GET /vat/calculate
计算给定金额和国家的增值税金额和总价(净额 + 增值税)。自动为指定的 EU/EEA 国家应用正确的增值税税率。可选使用实时汇率将总额转换为其他货币。适用于构建定价计算器、结账摘要和需要以客户首选货币显示净额、增值税和总额的发票生成器。
amount
必填
Net amount
country
必填
Country code
currency
可选
Convert total to currency
| 名称 | 必填 | 默认值 | 描述 |
|---|---|---|---|
amount |
是 | - | Net amount |
country |
是 | - | Country code |
currency |
否 | - | Convert total to currency |
curl "https://nordapi.ee/api/v1/vat/calculate?amount=100&country=DE¤cy=USD"
curl "https://nordapi.ee/api/v1/vat/calculate?amount=100&country=DE¤cy=USD"
curl "https://nordapi.ee/api/v1/vat/calculate?amount=499&country=NO"
curl "https://nordapi.ee/api/v1/vat/calculate?amount=250&country=FR¤cy=GBP"
HTTP 500: "# UndefinedFunctionError at GET /api/v1/vat/calculate\n\nException:\n\n ** (UndefinedFunctionError) function App.Commodities.calculate_vat/3 is undefined (module App.Commodities is not available)\n (app 0.1.0) App.Commodities.calculate_vat(100.0, \"DE\", [rate_type: nil])\n (app 0.1.0) lib/app_web/controllers/api/v1/commodities_controller.ex:154: AppWeb.API.V1.CommoditiesController.vat_calculate/2\n (app 0.1.0) lib/app_web/controllers/api/v1/commodities_controller.ex:1: AppWeb.API.V1.CommoditiesController.action/2\n (app 0.1.0) lib/app_web/controllers/api/v1/commodities_controller.ex:1: AppWeb.API.V1.CommoditiesController.phoenix_controller_pipeline/2\n (phoenix 1.8.5) lib/phoenix/router.ex:416: Phoenix.Router.__call__/5\n (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.plug_builder_call/2\n (app 0.1.0) deps/plug/lib/plug/debugger.ex:155: AppWeb.Endpoint.\"call (overridable 3)\"/2\n (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.call/2\n (phoenix 1.8.5) lib/phoenix/endpoint/sync_code_reload_plug.ex:22: Phoenix.Endpoint.SyncCodeReloadPlug.do_call/4\n (bandit 1.10.4) lib/bandit/pipeline.ex:131: Bandit.Pipeline.call_plug!/2\n (bandit 1.10.4) lib/bandit/pipeline.ex:42: Bandit.Pipeline.run/5\n (bandit 1.10.4) lib/bandit/http1/handler.ex:13: Bandit.HTTP1.Handler.handle_data/3\n (bandit 1.10.4) lib/bandit/delegating_handler.ex:18: Bandit.DelegatingHandler.handle_data/3\n (bandit 1.10.4) lib/bandit/delegating_handler.ex:8: Bandit.DelegatingHandler.handle_continue/2\n (stdlib 7.3) gen_server.erl:2424: :gen_server.try_handle_continue/3\n (stdlib 7.3) gen_server.erl:2291: :gen_server.loop/4\n (stdlib 7.3) proc_lib.erl:333: :proc_lib.init_p_do_apply/3\n \n\n## Connection details\n\n### Params\n\n %{\"amount\" => \"100\", \"country\" => \"DE\", \"currency\" => \"USD\"}\n\n### Request info\n\n * URI: http://localhost:4000/api/v1/vat/calculate\n * Query string: amount=100&country=DE¤cy=USD\n\n### Headers\n \n * accept-encoding: gzip\n * host: localhost:4000\n * user-agent: req/0.5.17\n\n### Session\n\n %{}\n"
{"success":true,"net_amount":100.0,"vat_rate":19.0,"vat_amount":19.0,"total_amount":119.0,"converted_total":137.50}