> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# vantage_billing_profile (Resource)

> Terraform resource reference for vantage_billing_profile (Resource). Auto-generated from the vantage-sh/terraform-provider-vantage repository.

<Note>
  This page is auto-generated based on the official [Terraform documentation](https://registry.terraform.io/providers/vantage-sh/vantage/latest/docs).
</Note>

## Overview

Use this resource with the [Vantage Terraform provider](/terraform). For installation and authentication, see the [Terraform provider quickstart](/terraform#quickstart). The schema below is generated directly from the provider source.

## Example Usage

```terraform theme={null}
# Fetch all billing profiles
data "vantage_billing_profiles" "all_profiles" {}

# Basic billing profile with minimal configuration
resource "vantage_billing_profile" "basic_profile" {
  nickname = "Basic Company Profile Test"
}

# Billing profile with nested billing information attributes
resource "vantage_billing_profile" "complete_profile_nested" {
  nickname = "Complete Company Profile Testng"

  billing_information_attributes = {
    company_name   = "Example Corp"
    address_line_1 = "123 Business Ave"
    address_line_2 = "Suite 100"
    city           = "New York"
    state          = "NY"
    postal_code    = "10001"
    country_code   = "US"
    billing_email  = ["billing@example.com"]
  }

  banking_information_attributes = {
    beneficiary_name = "John Doe"
    bank_name        = "Example Bank"
  }

  business_information_attributes = {
    metadata = {
      custom_fields = [
        {
          name  = "VAT"
          value = "123456789"
        }
      ]
    }
  }
}
```

## Schema

### Required

* `nickname` (String) Display name for the billing profile

### Optional

* `banking_information_attributes` (Attributes) Banking details (MSP accounts only) (see [below for nested schema](#nestedatt--banking_information_attributes))
* `billing_information_attributes` (Attributes) Billing address and contact information (see [below for nested schema](#nestedatt--billing_information_attributes))
* `business_information_attributes` (Attributes) Business information and custom fields (see [below for nested schema](#nestedatt--business_information_attributes))
* `invoice_adjustment_attributes` (Attributes) Invoice adjustments (taxes, fees, etc.) (see [below for nested schema](#nestedatt--invoice_adjustment_attributes))

### Read-Only

* `created_at` (String) The date and time, in UTC, the billing profile was created. ISO 8601 formatted.
* `id` (String) The id of the billing profile
* `managed_accounts_count` (String) Number of managed accounts using this billing profile
* `token` (String) The token of the billing profile
* `updated_at` (String) The date and time, in UTC, the billing profile was last updated. ISO 8601 formatted.

<a id="nestedatt--banking_information_attributes" />

### Nested Schema for `banking_information_attributes`

Optional:

* `bank_name` (String) Name of the bank
* `beneficiary_name` (String) Name of the account beneficiary
* `secure_data` (Attributes) Encrypted banking details (see [below for nested schema](#nestedatt--banking_information_attributes--secure_data))
* `tax_id` (String) Tax identification number
* `token` (String)

<a id="nestedatt--banking_information_attributes--secure_data" />

### Nested Schema for `banking_information_attributes.secure_data`

Optional:

* `account_number` (String) Bank account number (US)
* `iban` (String) International Bank Account Number (EU)
* `routing_number` (String) Bank routing number (US)
* `swift_bic` (String) SWIFT/BIC code (EU)

<a id="nestedatt--billing_information_attributes" />

### Nested Schema for `billing_information_attributes`

Optional:

* `address_line_1` (String) First line of billing address
* `address_line_2` (String) Second line of billing address
* `billing_email` (List of String) Array of billing email addresses
* `city` (String) City for billing address
* `company_name` (String) Company name for billing
* `country_code` (String) ISO country code
* `postal_code` (String) Postal or ZIP code
* `state` (String) State or province for billing address
* `token` (String)

<a id="nestedatt--business_information_attributes" />

### Nested Schema for `business_information_attributes`

Optional:

* `metadata` (Attributes) Business metadata including custom fields (see [below for nested schema](#nestedatt--business_information_attributes--metadata))
* `token` (String)

<a id="nestedatt--business_information_attributes--metadata" />

### Nested Schema for `business_information_attributes.metadata`

Optional:

* `custom_fields` (Attributes List) Array of custom field objects (see [below for nested schema](#nestedatt--business_information_attributes--metadata--custom_fields))

<a id="nestedatt--business_information_attributes--metadata--custom_fields" />

### Nested Schema for `business_information_attributes.metadata.custom_fields`

Optional:

* `name` (String) Custom field name
* `value` (String) Custom field value

<a id="nestedatt--invoice_adjustment_attributes" />

### Nested Schema for `invoice_adjustment_attributes`

Optional:

* `adjustment_items` (Attributes List) Array of adjustment items (see [below for nested schema](#nestedatt--invoice_adjustment_attributes--adjustment_items))
* `token` (String)

<a id="nestedatt--invoice_adjustment_attributes--adjustment_items" />

### Nested Schema for `invoice_adjustment_attributes.adjustment_items`

Required:

* `amount` (Number) Amount or percentage value
* `calculation_type` (String) How the adjustment is calculated
* `name` (String) Name of the adjustment

Optional:

* `adjustment_type` (String) Type of adjustment