From 2584b36a1e800cf9a094545e466e7e010daf828f Mon Sep 17 00:00:00 2001
From: Dani Vansia <41837012+vansia43@users.noreply.github.com>
Date: Mon, 30 Sep 2024 16:21:41 -0400
Subject: [PATCH 1/2] Add currency conversion docs

---
 docs/connecting_custom_providers.md |  8 ++++++++
 docs/vantage_account.md             | 24 ++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/docs/connecting_custom_providers.md b/docs/connecting_custom_providers.md
index dfdd6cc3..c130a8ac 100644
--- a/docs/connecting_custom_providers.md
+++ b/docs/connecting_custom_providers.md
@@ -60,6 +60,14 @@ The following table provides details for each field within the template, as well
     </tr>
   </thead>
   <tbody>
+      <tr>
+      <td><code>BillingCurrency</code></td>
+      <td>No</td>
+      <td>Billing currency costs are displayed in</td>
+      <td>A currency code, like <code>GBP</code>. <br/><br/>If you enter a currency code not available in Vantage, an error is displayed on validation. Check that currency conversion is also enabled. See the <a href="/vantage_account#currency-conversion">Currency Conversion</a> documentation for details. </td>
+      <td><code><a href="https://focus.finops.org/focus-columns/?prod_focus_columns%5Bquery%5D=currency#modal-column-14236">BillingCurrency</a></code></td>
+      <td><code>JPY</code>, <code>AUD</code>, <code>USD</code></td>
+    </tr>
     <tr>
       <td><code>ChargeCategory</code></td>
       <td>No</td>
diff --git a/docs/vantage_account.md b/docs/vantage_account.md
index 5f6fdfed..9195fafc 100644
--- a/docs/vantage_account.md
+++ b/docs/vantage_account.md
@@ -19,6 +19,30 @@ Only Organization Owners can configure organization settings. See the [Role-Base
 
 From the top navigation bar of the Vantage console, click **Settings**. On the side navigation bar, review the options under **General Settings**.
 
+### Currency Conversion {#currency-conversion}
+
+:::note
+At this time, presentational currency conversion is available only on Vantage reports, such as Cost Reports, Kubernetes Efficiency Reports, Financial Commitment Reports, and Provider Resource Reports. Additional scopes will be added soon.
+:::
+
+By default, Vantage displays costs in US Dollars (USD). You can set a presentational currency, on a per-workspace basis, to visualize cost reporting data in a currency of your choice. When you configure currency for a workspace, you can choose between using the previous month’s closing exchange rate or the daily exchange rate.
+
+To enable currency conversion:
+
+1. From the top navigation, click **Settings**
+2. On the side navigation, click **Workspaces**. All your existing workspaces are displayed. Select the workspace where you want to enable currency conversion.
+3. At the top of the **Workspaces** page, under **Preferred Currency**, click the toggle to enable this setting. (You can click this toggle again to disable the setting.)
+4. Select your preferred currency from the list.
+5. For **Exchange Rate Dates**, select one of the following conversion date options. For the most accurate results, use the currency method in which you are billed:
+   - **Daily Rate:** Vantage maintains a daily snapshot of exchange rates to provide estimated currency conversions. With the **Daily Rate** option, the rate is calculated and updated daily.
+   - **End of Billing Period Rate:** The previous month’s closing exchange rate. Some providers use this method for displaying currency conversion, where the exchange rate for the next month is captured at the end of the billing period (e.g., [Azure](https://learn.microsoft.com/en-us/marketplace/currencies)).
+
+Your settings are automatically saved and available on your reports.
+
+:::note
+If you disable currency, your presentational currency will default back to USD.
+:::
+
 ### Manage Workspaces
 
 Provider integrations are organized into workspaces. From the **Workspaces** section, you can manage each of your workspaces as well as create a new one. See the [Workspaces](/workspaces) documentation for more information.

From c429aa22f41b12c153f5655d9e752236c9467f54 Mon Sep 17 00:00:00 2001
From: Dani Vansia <41837012+vansia43@users.noreply.github.com>
Date: Mon, 30 Sep 2024 16:50:31 -0400
Subject: [PATCH 2/2] Update steps based on feedback

---
 docs/vantage_account.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/vantage_account.md b/docs/vantage_account.md
index 9195fafc..f47e8942 100644
--- a/docs/vantage_account.md
+++ b/docs/vantage_account.md
@@ -34,8 +34,8 @@ To enable currency conversion:
 3. At the top of the **Workspaces** page, under **Preferred Currency**, click the toggle to enable this setting. (You can click this toggle again to disable the setting.)
 4. Select your preferred currency from the list.
 5. For **Exchange Rate Dates**, select one of the following conversion date options. For the most accurate results, use the currency method in which you are billed:
-   - **Daily Rate:** Vantage maintains a daily snapshot of exchange rates to provide estimated currency conversions. With the **Daily Rate** option, the rate is calculated and updated daily.
-   - **End of Billing Period Rate:** The previous month’s closing exchange rate. Some providers use this method for displaying currency conversion, where the exchange rate for the next month is captured at the end of the billing period (e.g., [Azure](https://learn.microsoft.com/en-us/marketplace/currencies)).
+   - **Daily Rate:** Vantage maintains a daily snapshot of exchange rates to provide estimated currency conversions. With the **Daily Rate** option, the costs' corresponding daily exchange rate will be used for the conversion.
+   - **End of Billing Period Rate:** Vantage matches each cost entry to the last date of the corresponding month in which the cost was incurred. 
 
 Your settings are automatically saved and available on your reports.