SDK for PHP 3.x

AWS Invoicing 2024-12-01

Client: Aws\Invoicing\InvoicingClient
Service ID: invoicing
Version: 2024-12-01

This page describes the parameters and results for the operations of the AWS Invoicing (2024-12-01), and shows how to use the Aws\Invoicing\InvoicingClient object to call the described operations. This documentation is specific to the 2024-12-01 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

BatchGetInvoiceProfile ( array $params = [] )
This gets the invoice profile associated with a set of accounts.
CreateInvoiceUnit ( array $params = [] )
This creates a new invoice unit with the provided definition.
DeleteInvoiceUnit ( array $params = [] )
This deletes an invoice unit with the provided invoice unit ARN.
GetInvoiceUnit ( array $params = [] )
This retrieves the invoice unit definition.
ListInvoiceUnits ( array $params = [] )
This fetches a list of all invoice unit definitions for a given account, as of the provided AsOf date.
ListTagsForResource ( array $params = [] )
Lists the tags for a resource.
TagResource ( array $params = [] )
Adds a tag to a resource.
UntagResource ( array $params = [] )
Removes a tag from a resource.
UpdateInvoiceUnit ( array $params = [] )
You can update the invoice unit configuration at any time, and Amazon Web Services will use the latest configuration at the end of the month.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListInvoiceUnits

Operations

BatchGetInvoiceProfile 

$result = $client->batchGetInvoiceProfile([/* ... */]);
$promise = $client->batchGetInvoiceProfileAsync([/* ... */]);

This gets the invoice profile associated with a set of accounts. The accounts must be linked accounts under the requester management account organization.

Parameter Syntax

$result = $client->batchGetInvoiceProfile([
    'AccountIds' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
AccountIds
Required: Yes
Type: Array of strings

Retrieves the corresponding invoice profile data for these account IDs.

Result Syntax

[
    'Profiles' => [
        [
            'AccountId' => '<string>',
            'Issuer' => '<string>',
            'ReceiverAddress' => [
                'AddressLine1' => '<string>',
                'AddressLine2' => '<string>',
                'AddressLine3' => '<string>',
                'City' => '<string>',
                'CompanyName' => '<string>',
                'CountryCode' => '<string>',
                'DistrictOrCounty' => '<string>',
                'PostalCode' => '<string>',
                'StateOrRegion' => '<string>',
            ],
            'ReceiverEmail' => '<string>',
            'ReceiverName' => '<string>',
            'TaxRegistrationNumber' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
Profiles
Type: Array of InvoiceProfile structures

A list of invoice profiles corresponding to the requested accounts.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: BatchGetInvoiceProfile 
$result = $client->batchGetInvoiceProfile([
    'AccountIds' => [
        '111111111111',
    ],
]);

Result syntax:

[
    'Profiles' => [
        [
            'AccountId' => '111111111111',
            'Issuer' => 'Test',
            'ReceiverAddress' => [
                'AddressLine1' => 'Test',
                'City' => 'Test',
                'CountryCode' => 'LU',
                'PostalCode' => 'Test',
                'StateOrRegion' => 'Test',
            ],
            'ReceiverEmail' => 'test@amazon.com',
            'ReceiverName' => 'TestAccount',
        ],
    ],
]

CreateInvoiceUnit 

$result = $client->createInvoiceUnit([/* ... */]);
$promise = $client->createInvoiceUnitAsync([/* ... */]);

This creates a new invoice unit with the provided definition.

Parameter Syntax

$result = $client->createInvoiceUnit([
    'Description' => '<string>',
    'InvoiceReceiver' => '<string>', // REQUIRED
    'Name' => '<string>', // REQUIRED
    'ResourceTags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'Rule' => [ // REQUIRED
        'LinkedAccounts' => ['<string>', ...],
    ],
    'TaxInheritanceDisabled' => true || false,
]);

Parameter Details

Members
Description
Type: string

The invoice unit's description. This can be changed at a later time.

InvoiceReceiver
Required: Yes
Type: string

The Amazon Web Services account ID chosen to be the receiver of an invoice unit. All invoices generated for that invoice unit will be sent to this account ID.

Name
Required: Yes
Type: string

The unique name of the invoice unit that is shown on the generated invoice. This can't be changed once it is set. To change this name, you must delete the invoice unit recreate.

ResourceTags
Type: Array of ResourceTag structures

The tag structure that contains a tag key and value.

Rule
Required: Yes
Type: InvoiceUnitRule structure

The InvoiceUnitRule object used to create invoice units.

TaxInheritanceDisabled
Type: boolean

Whether the invoice unit based tax inheritance is/ should be enabled or disabled.

Result Syntax

[
    'InvoiceUnitArn' => '<string>',
]

Result Details

Members
InvoiceUnitArn
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Examples

Example 1: CreateInvoiceUnit 
$result = $client->createInvoiceUnit([
    'Description' => 'Example Invoice Unit Description',
    'InvoiceReceiver' => '111111111111',
    'Name' => 'Example Invoice Unit',
    'ResourceTags' => [
        [
            'Key' => 'TagKey',
            'Value' => 'TagValue',
        ],
    ],
    'Rule' => [
        'LinkedAccounts' => [
            '222222222222',
        ],
    ],
    'TaxInheritanceDisabled' => ,
]);

Result syntax:

[
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]

DeleteInvoiceUnit 

$result = $client->deleteInvoiceUnit([/* ... */]);
$promise = $client->deleteInvoiceUnitAsync([/* ... */]);

This deletes an invoice unit with the provided invoice unit ARN.

Parameter Syntax

$result = $client->deleteInvoiceUnit([
    'InvoiceUnitArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
InvoiceUnitArn
Required: Yes
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Result Syntax

[
    'InvoiceUnitArn' => '<string>',
]

Result Details

Members
InvoiceUnitArn
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: DeleteInvoiceUnit 
$result = $client->deleteInvoiceUnit([
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]);

Result syntax:

[
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]

GetInvoiceUnit 

$result = $client->getInvoiceUnit([/* ... */]);
$promise = $client->getInvoiceUnitAsync([/* ... */]);

This retrieves the invoice unit definition.

Parameter Syntax

$result = $client->getInvoiceUnit([
    'AsOf' => <integer || string || DateTime>,
    'InvoiceUnitArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
AsOf
Type: timestamp (string|DateTime or anything parsable by strtotime)

The state of an invoice unit at a specified time. You can see legacy invoice units that are currently deleted if the AsOf time is set to before it was deleted. If an AsOf is not provided, the default value is the current time.

InvoiceUnitArn
Required: Yes
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Result Syntax

[
    'Description' => '<string>',
    'InvoiceReceiver' => '<string>',
    'InvoiceUnitArn' => '<string>',
    'LastModified' => <DateTime>,
    'Name' => '<string>',
    'Rule' => [
        'LinkedAccounts' => ['<string>', ...],
    ],
    'TaxInheritanceDisabled' => true || false,
]

Result Details

Members
Description
Type: string

The assigned description for an invoice unit.

InvoiceReceiver
Type: string

The Amazon Web Services account ID chosen to be the receiver of an invoice unit. All invoices generated for that invoice unit will be sent to this account ID.

InvoiceUnitArn
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent date the invoice unit response was updated.

Name
Type: string

The unique name of the invoice unit that is shown on the generated invoice.

Rule
Type: InvoiceUnitRule structure

This is used to categorize the invoice unit. Values are Amazon Web Services account IDs. Currently, the only supported rule is LINKED_ACCOUNT.

TaxInheritanceDisabled
Type: boolean

Whether the invoice unit based tax inheritance is/ should be enabled or disabled.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: GetInvoiceUnit as of current time 
$result = $client->getInvoiceUnit([
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]);

Result syntax:

[
    'Description' => 'Description changed on 1733788800',
    'InvoiceReceiver' => '111111111111',
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
    'LastModified' => ,
    'Name' => 'Example Invoice Unit A',
    'Rule' => [
        'LinkedAccounts' => [
            '222222222222',
        ],
    ],
    'TaxInheritanceDisabled' => ,
]
Example 2: GetInvoiceUnit as of specified time 
$result = $client->getInvoiceUnit([
    'AsOf' => ,
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/87654321',
]);

Result syntax:

[
    'Description' => 'Description changed on 1733011200',
    'InvoiceReceiver' => '333333333333',
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/87654321',
    'LastModified' => ,
    'Name' => 'Example Invoice Unit B',
    'Rule' => [
        'LinkedAccounts' => [
            '333333333333',
        ],
    ],
    'TaxInheritanceDisabled' => ,
]

ListInvoiceUnits 

$result = $client->listInvoiceUnits([/* ... */]);
$promise = $client->listInvoiceUnitsAsync([/* ... */]);

This fetches a list of all invoice unit definitions for a given account, as of the provided AsOf date.

Parameter Syntax

$result = $client->listInvoiceUnits([
    'AsOf' => <integer || string || DateTime>,
    'Filters' => [
        'Accounts' => ['<string>', ...],
        'InvoiceReceivers' => ['<string>', ...],
        'Names' => ['<string>', ...],
    ],
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
AsOf
Type: timestamp (string|DateTime or anything parsable by strtotime)

The state of an invoice unit at a specified time. You can see legacy invoice units that are currently deleted if the AsOf time is set to before it was deleted. If an AsOf is not provided, the default value is the current time.

Filters
Type: Filters structure

An optional input to the list API. If multiple filters are specified, the returned list will be a configuration that match all of the provided filters. Supported filter types are InvoiceReceivers, Names, and Accounts.

MaxResults
Type: int

The maximum number of invoice units that can be returned.

NextToken
Type: string

The next token used to indicate where the returned list should start from.

Result Syntax

[
    'InvoiceUnits' => [
        [
            'Description' => '<string>',
            'InvoiceReceiver' => '<string>',
            'InvoiceUnitArn' => '<string>',
            'LastModified' => <DateTime>,
            'Name' => '<string>',
            'Rule' => [
                'LinkedAccounts' => ['<string>', ...],
            ],
            'TaxInheritanceDisabled' => true || false,
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
InvoiceUnits
Type: Array of InvoiceUnit structures

An invoice unit is a set of mutually exclusive accounts that correspond to your business entity.

NextToken
Type: string

The next token used to indicate where the returned list should start from.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Examples

Example 1: ListInvoiceUnits without filters as of current time 
$result = $client->listInvoiceUnits([
]);

Result syntax:

[
    'InvoiceUnits' => [
        [
            'Description' => 'Description changed on 1733788800',
            'InvoiceReceiver' => '111111111111',
            'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
            'LastModified' => ,
            'Name' => 'Example Invoice Unit A',
            'Rule' => [
                'LinkedAccounts' => [
                    '222222222222',
                ],
            ],
            'TaxInheritanceDisabled' => ,
        ],
        [
            'Description' => 'Description changed on 1733788800',
            'InvoiceReceiver' => '333333333333',
            'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/87654321',
            'LastModified' => ,
            'Name' => 'Example Invoice Unit B',
            'Rule' => [
                'LinkedAccounts' => [
                    '333333333333',
                ],
            ],
            'TaxInheritanceDisabled' => 1,
        ],
    ],
]
Example 2: ListInvoiceUnits with filters as of specified time 
$result = $client->listInvoiceUnits([
    'AsOf' => ,
    'Filters' => [
        'InvoiceReceivers' => [
            '333333333333',
        ],
    ],
]);

Result syntax:

[
    'InvoiceUnits' => [
        [
            'Description' => 'Description changed on 1733011200',
            'InvoiceReceiver' => '333333333333',
            'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/87654321',
            'LastModified' => ,
            'Name' => 'Example Invoice Unit B',
            'Rule' => [
                'LinkedAccounts' => [
                    '333333333333',
                ],
            ],
            'TaxInheritanceDisabled' => ,
        ],
    ],
]
Example 3: ListInvoiceUnits with pagination - first page 
$result = $client->listInvoiceUnits([
    'MaxResults' => 1,
]);

Result syntax:

[
    'InvoiceUnits' => [
        [
            'Description' => 'Description changed on 1733788800',
            'InvoiceReceiver' => '111111111111',
            'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
            'LastModified' => ,
            'Name' => 'Example Invoice Unit A',
            'Rule' => [
                'LinkedAccounts' => [
                    '222222222222',
                ],
            ],
            'TaxInheritanceDisabled' => ,
        ],
    ],
    'NextToken' => 'nextTokenExample',
]
Example 4: ListInvoiceUnits with pagination - second page 
$result = $client->listInvoiceUnits([
    'MaxResults' => 1,
    'NextToken' => 'nextTokenExample',
]);

Result syntax:

[
    'InvoiceUnits' => [
        [
            'Description' => 'Description changed on 1733788800',
            'InvoiceReceiver' => '333333333333',
            'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/87654321',
            'LastModified' => ,
            'Name' => 'Example Invoice Unit B',
            'Rule' => [
                'LinkedAccounts' => [
                    '333333333333',
                ],
            ],
            'TaxInheritanceDisabled' => 1,
        ],
    ],
]

ListTagsForResource 

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Lists the tags for a resource.

Parameter Syntax

$result = $client->listTagsForResource([
    'ResourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of tags to list.

Result Syntax

[
    'ResourceTags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
ResourceTags
Type: Array of ResourceTag structures

Adds a tag to a resource.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: ListTagsForResource 
$result = $client->listTagsForResource([
    'ResourceArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]);

Result syntax:

[
    'ResourceTags' => [
        [
            'Key' => 'TagKey',
            'Value' => 'TagValue',
        ],
    ],
]

TagResource 

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Adds a tag to a resource.

Parameter Syntax

$result = $client->tagResource([
    'ResourceArn' => '<string>', // REQUIRED
    'ResourceTags' => [ // REQUIRED
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the tags.

ResourceTags
Required: Yes
Type: Array of ResourceTag structures

Adds a tag to a resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ServiceQuotaExceededException:

The request was rejected because it attempted to create resources beyond the current Amazon Web Services account limits. The error message describes the limit exceeded.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: TagResource 
$result = $client->tagResource([
    'ResourceArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
    'ResourceTags' => [
        [
            'Key' => 'TagKey',
            'Value' => 'TagValue',
        ],
    ],
]);

Result syntax:

[
]

UntagResource 

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes a tag from a resource.

Parameter Syntax

$result = $client->untagResource([
    'ResourceArn' => '<string>', // REQUIRED
    'ResourceTagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to untag.

ResourceTagKeys
Required: Yes
Type: Array of strings

Keys for the tags to be removed.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: UntagResource 
$result = $client->untagResource([
    'ResourceArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
    'ResourceTagKeys' => [
        'TagKey',
    ],
]);

Result syntax:

[
]

UpdateInvoiceUnit 

$result = $client->updateInvoiceUnit([/* ... */]);
$promise = $client->updateInvoiceUnitAsync([/* ... */]);

You can update the invoice unit configuration at any time, and Amazon Web Services will use the latest configuration at the end of the month.

Parameter Syntax

$result = $client->updateInvoiceUnit([
    'Description' => '<string>',
    'InvoiceUnitArn' => '<string>', // REQUIRED
    'Rule' => [
        'LinkedAccounts' => ['<string>', ...],
    ],
    'TaxInheritanceDisabled' => true || false,
]);

Parameter Details

Members
Description
Type: string

The assigned description for an invoice unit. This information can't be modified or deleted.

InvoiceUnitArn
Required: Yes
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Rule
Type: InvoiceUnitRule structure

The InvoiceUnitRule object used to update invoice units.

TaxInheritanceDisabled
Type: boolean

Whether the invoice unit based tax inheritance is/ should be enabled or disabled.

Result Syntax

[
    'InvoiceUnitArn' => '<string>',
]

Result Details

Members
InvoiceUnitArn
Type: string

The ARN to identify an invoice unit. This information can't be modified or deleted.

Errors

ThrottlingException:

The request was denied due to request throttling.

InternalServerException:

The processing request failed because of an unknown error, exception, or failure.

AccessDeniedException:

You don't have sufficient access to perform this action.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The resource could not be found.

Examples

Example 1: UpdateInvoiceUnit with all updatable fields 
$result = $client->updateInvoiceUnit([
    'Description' => 'Updated IU description',
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
    'Rule' => [
        'LinkedAccounts' => [
            '111111111111',
            '222222222222',
        ],
    ],
    'TaxInheritanceDisabled' => ,
]);

Result syntax:

[
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]
Example 2: UpdateInvoiceUnit with specific fields 
$result = $client->updateInvoiceUnit([
    'Description' => 'Updated IU description. All other fields remain unchanged',
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]);

Result syntax:

[
    'InvoiceUnitArn' => 'arn:aws:invoicing::000000000000:invoice-unit/12345678',
]

Shapes

AccessDeniedException

Description

You don't have sufficient access to perform this action.

Members
message
Type: string
resourceName
Type: string

You don't have sufficient access to perform this action.

Filters

Description

An optional input to the list API. If multiple filters are specified, the returned list will be a configuration that match all of the provided filters. Supported filter types are InvoiceReceivers, Names, and Accounts.

Members
Accounts
Type: Array of strings

You can specify a list of Amazon Web Services account IDs inside filters to return invoice units that match only the specified accounts. If multiple accounts are provided, the result is an OR condition (match any) of the specified accounts. The specified account IDs are matched with either the receiver or the linked accounts in the rules.

InvoiceReceivers
Type: Array of strings

You can specify a list of Amazon Web Services account IDs inside filters to return invoice units that match only the specified accounts. If multiple accounts are provided, the result is an OR condition (match any) of the specified accounts. This filter only matches the specified accounts on the invoice receivers of the invoice units.

Names
Type: Array of strings

An optional input to the list API. You can specify a list of invoice unit names inside filters to return invoice units that match only the specified invoice unit names. If multiple names are provided, the result is an OR condition (match any) of the specified invoice unit names.

InternalServerException

Description

The processing request failed because of an unknown error, exception, or failure.

Members
message
Type: string
retryAfterSeconds
Type: int

The processing request failed because of an unknown error, exception, or failure.

InvoiceProfile

Description

Contains high-level information about the invoice receiver.

Members
AccountId
Type: string

The account ID the invoice profile is generated for.

Issuer
Type: string

This specifies the issuing entity of the invoice.

ReceiverAddress
Type: ReceiverAddress structure

The address of the receiver that will be printed on the invoice.

ReceiverEmail
Type: string

The email address for the invoice profile receiver.

ReceiverName
Type: string

The name of the person receiving the invoice profile.

TaxRegistrationNumber
Type: string

Your Tax Registration Number (TRN) information.

InvoiceUnit

Description

An invoice unit is a set of mutually exclusive accounts that correspond to your business entity. Invoice units allow you separate Amazon Web Services account costs and configures your invoice for each business entity going forward.

Members
Description
Type: string

The assigned description for an invoice unit. This information can't be modified or deleted.

InvoiceReceiver
Type: string

The account that receives invoices related to the invoice unit.

InvoiceUnitArn
Type: string

ARN to identify an invoice unit. This information can't be modified or deleted.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The last time the invoice unit was updated. This is important to determine the version of invoice unit configuration used to create the invoices. Any invoice created after this modified time will use this invoice unit configuration.

Name
Type: string

A unique name that is distinctive within your Amazon Web Services.

Rule
Type: InvoiceUnitRule structure

An InvoiceUnitRule object used the categorize invoice units.

TaxInheritanceDisabled
Type: boolean

Whether the invoice unit based tax inheritance is/ should be enabled or disabled.

InvoiceUnitRule

Description

This is used to categorize the invoice unit. Values are Amazon Web Services account IDs. Currently, the only supported rule is LINKED_ACCOUNT.

Members
LinkedAccounts
Type: Array of strings

The list of LINKED_ACCOUNT IDs where charges are included within the invoice unit.

ReceiverAddress

Description

The details of the address associated with the receiver.

Members
AddressLine1
Type: string

The first line of the address.

AddressLine2
Type: string

The second line of the address, if applicable.

AddressLine3
Type: string

The third line of the address, if applicable.

City
Type: string

The city that the address is in.

CompanyName
Type: string

A unique company name.

CountryCode
Type: string

The country code for the country the address is in.

DistrictOrCounty
Type: string

The district or country the address is located in.

PostalCode
Type: string

The postal code associated with the address.

StateOrRegion
Type: string

The state, region, or province the address is located.

ResourceNotFoundException

Description

The resource could not be found.

Members
message
Type: string
resourceName
Type: string

The resource could not be found.

ResourceTag

Description

The tag structure that contains a tag key and value.

Members
Key
Required: Yes
Type: string

The object key of your of your resource tag.

Value
Required: Yes
Type: string

The specific value of the resource tag.

ServiceQuotaExceededException

Description

The request was rejected because it attempted to create resources beyond the current Amazon Web Services account limits. The error message describes the limit exceeded.

Members
message
Required: Yes
Type: string

ThrottlingException

Description

The request was denied due to request throttling.

Members
message
Type: string

ValidationException

Description

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Members
fieldList
Type: Array of ValidationExceptionField structures

The input fails to satisfy the constraints specified by an Amazon Web Services service.

message
Type: string
reason
Type: string

You don't have sufficient access to perform this action.

resourceName
Type: string

You don't have sufficient access to perform this action.

ValidationExceptionField

Description

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Members
message
Required: Yes
Type: string

The input fails to satisfy the constraints specified by an Amazon Web Services service.

name
Required: Yes
Type: string

The input fails to satisfy the constraints specified by an Amazon Web Services service.