feat: billing addresses

Author: staceysalamon-aiven

docs/platform/concepts/billing-and-payment.md

@@ -6,6 +6,10 @@ import RelatedPages from "@site/src/components/RelatedPages";
 
 You can make payments by credit card, bank transfer, or using your AWS, Google Cloud, or Azure [marketplace subscriptions](/docs/platform/howto/list-marketplace-payments).
 
+The [costs of services](#service-charges) in a project are charged to the
+[payment methods](/docs/platform/howto/manage-payment-card) of the
+[billing group](#billing-groups) assigned to that project.
+
 Billing information, invoices, and a breakdown of charges by category and billing group
 are available in the **Billing** section of the Aiven Console.
 To access this section, you must be an
@@ -18,9 +22,10 @@ and invoices using the API.
 
 [Billing groups](/docs/platform/howto/use-billing-groups)
 store your billing details in one place,
-including [payment methods](/docs/platform/howto/manage-payment-card), billing addresses,
-and billing contacts. This lets you use the same payment details across all projects
-within your organization, including those in organizational units.
+including payment methods,
+[billing and shipping addresses](/docs/platform/howto/manage-billing-addresses),
+and billing contacts. This lets you use the same payment details across
+all projects within your organization, including those in organizational units.
 
 You can use billing groups to combine costs based on categories like your organization's
 departments or IT environments. You receive a

docs/platform/howto/manage-billing-addresses.md

@@ -0,0 +1,52 @@
+---
+title: Manage billing and shipping addresses
+---
+
+import ConsoleLabel from "@site/src/components/ConsoleIcons"
+
+Create addresses in the billing section of the Aiven Platform and use them as billing and shipping addresses in your billing groups.
+
+You must be an
+[organization admin](/docs/platform/concepts/permissions#organization-roles-and-permissions)
+to access this feature in the Aiven Console.
+
+## Create an address
+
+1.  In the organization, click **Billing**.
+1.  Click **Addresses**.
+1.  Click **Create address**.
+1.  Enter the address details and click **Create address**.
+1.  Optional: Assign the address to your billing groups.
+    :::note
+    The address is added as both the billing and shipping address for the billing group.
+    You can [change the billing or shipping address](#assign-addresses-to-a-billing-group)
+    in the billing group.
+
+## Update an address
+
+1.  In the organization, click **Billing**.
+1.  Click **Addresses**.
+1.  In the address to update, click **Edit**.
+1.  Edit the address and click **Save changes**.
+
+## Assign addresses to a billing group
+
+1.  In the organization, click **Billing**.
+1.  Click **Billing groups**.
+1.  Select the name of the billing group and click the **Billing information** tab.
+1.  In the **Company addresses** section, click **Edit**.
+1.  Select an address for the billing address or shipping address.
+    :::note
+    The shipping address is used to calculate [tax](/docs/platform/concepts/tax-information).
+
+1.  Click **Save**.
+
+## Delete an address
+
+You cannot delete an address that you assigned to a billing group. To delete an address
+that is used for a billing group
+[assign a different address](#assign-addresses-to-a-billing-group).
+
+1.  In the organization, click **Billing**.
+1.  Click **Addresses**.
+1.  In the address to update, click **Delete**.

docs/platform/howto/use-billing-groups.md

@@ -13,6 +13,7 @@ to access this feature in the Aiven Console.
 ## Create a billing group
 
 1.  In the organization, click **Billing**.
+1.  Click **Billing groups**.
 1.  Click **Create billing group**.
 1.  Enter a name for the billing group and click **Continue**.
 1.  Enter the billing details. You can also copy these details from
@@ -32,8 +33,8 @@ to access this feature in the Aiven Console.
 
 ## Update a billing group
 
-To change the payment method, address, billing contact emails, invoice emails,
-or other billing details:
+To change the payment method, billing and shipping address, VAT ID,
+billing contact emails, invoice emails, or other billing details:
 
 1.  In the organization, click **Billing**.
 1.  Select the name of the billing group to update.

sidebars.ts

@@ -87,7 +87,10 @@ const sidebars: SidebarsConfig = {
             {
               type: 'category',
               label: 'Billing groups',
-              items: ['platform/howto/use-billing-groups'],
+              items: [
+                'platform/howto/use-billing-groups',
+                'platform/howto/manage-billing-addresses',
+              ],
             },
             'platform/howto/download-invoices',
           ],