(DOCSP-40109): Charts billing dashboard linked invoice updates (#664)

* document charts billing dashboard updates

* tech review feedback

* Update screenshot + add linked invoice toggle

* tech review feedback

Author: davidhou17

source/dashboards/manage-dashboards/billing-dashboards.txt

@@ -26,7 +26,7 @@ Billing Dashboards
 ------------------
 
 Billing dashboards provide metrics and detailed charts about the 
-usage in your organization across different categories 
+usage in an organization across different categories 
 and periods of time. The insights from your dashboard 
 can help you optimize your |service| spending.
 
@@ -37,11 +37,17 @@ can help you optimize your |service| spending.
 By default, billing dashboards include the following metrics 
 and charts:
 
-- Total spending across your organization
-- Biggest spenders in your organization
+- Total spending across the organization
+- Biggest spenders in the organization
 - Total spending by instance size, project, cluster, product category, or SKU
 - Total cost by product category
 
+You can also customize your billing dashboard by applying 
+:ref:`dashboard filters <billing-dashboard-filter>`
+and adding new charts, including any charts 
+that use :atlas:`tags </tags>` that you've 
+applied to your billing data.
+
 Required Access
 ---------------
 
@@ -51,14 +57,24 @@ To create a billing dashboard, you must have at least
 Limitations
 -----------
 
-At any given time, billing dashboards use 
-the last twelve months of your organization's billing data.
+At any given time, billing dashboards use the last twelve 
+months of the specified organization's billing data.
+
+If you enable linked invoices on an existing ingestion, the
+billing dashboard uses the last three months of each linked
+organization's billing data. If you enable linked invoices
+on a new ingestion, it uses the last twelve months of data.
 
 If you change an existing invoice, |service| updates the
 billing data in your ingestion only if you've incurred 
 the invoice within the last three months. Any invoice changes
 reflect in your dashboard after the next scheduled ingestion.
 
+If you've created an ingestion previously and want to create a 
+new ingestion, you must specify a new database to store the
+billing data for the ingestion or delete the old database
+if you want to use the same database name.
+
 Create a Billing Dashboard
 --------------------------
 
@@ -79,12 +95,28 @@ To ingest your billing data and add a billing dashboard:
 
    .. step:: Configure the |service| Billing Ingestion.
 
-      a. Enter your :guilabel:`Organization public API key` and :guilabel:`Organization private API key`.
+      a. Specify the organization for which to create the billing dashboard. 
+         By default, |charts-short| selects the current organization.
+         
+         To use a different organization, select :guilabel:`Another` 
+         and specify the Organization ID. You can find the 
+         Organization ID in the specified organization's settings.
+
+         .. note::
+
+            If you use :atlas:`cross-organization billing 
+            </billing/#cross-organization-billing>`, specify the 
+            Organization ID for the paying organization.
+
+      #. Enable or disable ingesting invoices from linked organizations.
+
+      #. Enter the :guilabel:`Public API key` and 
+         :guilabel:`Private API key` for the specified organization.
 
          Your key pair must have at least :authrole:`Organization Billing Admin`
          and :authrole:`Organization Billing Viewer` access.
 
-         To learn how to create and view an API key for your organization,
+         To learn how to create and view an API key for an organization,
          see :atlas:`Grant Programmatic Access to Atlas 
          </configure-api-access/#grant-programmatic-access-to-service>`.
 
@@ -95,7 +127,7 @@ To ingest your billing data and add a billing dashboard:
    .. step:: Click :guilabel:`Save`.
 
       |charts-short| uses the :oas-atlas-tag:`Invoices API </Invoices>`
-      to ingest the last twelve months of your organization's billing 
+      to ingest the last twelve months of the specified organization's billing 
       data into the specified deployment and database. After you create
       the initial ingestion, |service| ingests billing data daily.