TaxSettings / Client / batch_get_tax_exemptions

batch_get_tax_exemptions

TaxSettings.Client.batch_get_tax_exemptions(**kwargs)

Get the active tax exemptions for a given list of accounts.

See also: AWS API Documentation

Request Syntax

response = client.batch_get_tax_exemptions(
    accountIds=[
        'string',
    ]
)

Parameters:

accountIds (list) –

[REQUIRED]

List of unique account identifiers.

• (string) –

Return type:

dict

Returns:

Response Syntax

{
    'failedAccounts': [
        'string',
    ],
    'taxExemptionDetailsMap': {
        'string': {
            'heritageObtainedDetails': True|False,
            'heritageObtainedParentEntity': 'string',
            'heritageObtainedReason': 'string',
            'taxExemptions': [
                {
                    'authority': {
                        'country': 'string',
                        'state': 'string'
                    },
                    'effectiveDate': datetime(2015, 1, 1),
                    'expirationDate': datetime(2015, 1, 1),
                    'status': 'None'|'Valid'|'Expired'|'Pending',
                    'systemEffectiveDate': datetime(2015, 1, 1),
                    'taxExemptionType': {
                        'applicableJurisdictions': [
                            {
                                'country': 'string',
                                'state': 'string'
                            },
                        ],
                        'description': 'string',
                        'displayName': 'string'
                    }
                },
            ]
        }
    }
}

Response Structure

• (dict) –

  • failedAccounts (list) –

    The list of accounts that failed to get tax exemptions.

    • (string) –

  • taxExemptionDetailsMap (dict) –

    The tax exemption details map of accountId and tax exemption details.

    • (string) –

      • (dict) –

        The tax exemption details.

        • heritageObtainedDetails (boolean) –

          The indicator if the tax exemption is inherited from the consolidated billing family management account.

        • heritageObtainedParentEntity (string) –

          The consolidated billing family management account the tax exemption inherited from.

        • heritageObtainedReason (string) –

          The reason of the heritage inheritance.

        • taxExemptions (list) –

          Tax exemptions.

          • (dict) –

            The tax exemption.

            • authority (dict) –

              The address domain associate with tax exemption.

              • country (string) –

                The country code for the country that the address is in.

              • state (string) –

                The state that the address is located.

            • effectiveDate (datetime) –

              The tax exemption effective date.

            • expirationDate (datetime) –

              The tax exemption expiration date.

            • status (string) –

              The tax exemption status.

            • systemEffectiveDate (datetime) –

              The tax exemption recording time in the TaxSettings system.

            • taxExemptionType (dict) –

              The tax exemption type.

              • applicableJurisdictions (list) –

                The tax exemption’s applicable jurisdictions.

                • (dict) –

                  The address domain associate with the tax information.

                  • country (string) –

                    The country code for the country that the address is in.

                  • state (string) –

                    The state that the address is located.

              • description (string) –

                The tax exemption’s type description.

              • displayName (string) –

                The tax exemption’s type display name.

Exceptions

• TaxSettings.Client.exceptions.ValidationException

• TaxSettings.Client.exceptions.ResourceNotFoundException

• TaxSettings.Client.exceptions.InternalServerException