TaxSettings / Client / put_supplemental_tax_registration

put_supplemental_tax_registration

TaxSettings.Client.put_supplemental_tax_registration(**kwargs)

Stores supplemental tax registration for a single account.

See also: AWS API Documentation

Request Syntax

response = client.put_supplemental_tax_registration(
    taxRegistrationEntry={
        'address': {
            'addressLine1': 'string',
            'addressLine2': 'string',
            'addressLine3': 'string',
            'city': 'string',
            'countryCode': 'string',
            'districtOrCounty': 'string',
            'postalCode': 'string',
            'stateOrRegion': 'string'
        },
        'legalName': 'string',
        'registrationId': 'string',
        'registrationType': 'VAT'
    }
)

Parameters:

taxRegistrationEntry (dict) –

[REQUIRED]

The supplemental TRN information that will be stored for the caller account ID.

• address (dict) – [REQUIRED]

  The details of the address associated with the TRN information.

  • addressLine1 (string) – [REQUIRED]

    The first line of the address.

  • addressLine2 (string) –

    The second line of the address, if applicable.

  • addressLine3 (string) –

    The third line of the address, if applicable. Currently, the Tax Settings API accepts the addressLine3 parameter only for Saudi Arabia. When you specify a TRN in Saudi Arabia, you must enter the addressLine3 and specify the building number for the address. For example, you might enter 1234.

  • city (string) – [REQUIRED]

    The city that the address is in.

  • countryCode (string) – [REQUIRED]

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

  • districtOrCounty (string) –

    The district or county the address is located.

    Note

    For addresses in Brazil, this parameter uses the name of the neighborhood. When you set a TRN in Brazil, use districtOrCounty for the neighborhood name.

  • postalCode (string) – [REQUIRED]

    The postal code associated with the address.

  • stateOrRegion (string) –

    The state, region, or province that the address is located. This field is only required for Canada, India, United Arab Emirates, Romania, and Brazil (CPF). It is optional for all other countries.

    If this is required for tax settings, use the same name as shown on the Tax Settings page.

• legalName (string) – [REQUIRED]

  The legal name associated with your TRN registration.

• registrationId (string) – [REQUIRED]

  The supplemental TRN unique identifier.

• registrationType (string) – [REQUIRED]

  Type of supplemental TRN. Currently, this can only be VAT.

Return type:

dict

Returns:

Response Syntax

{
    'authorityId': 'string',
    'status': 'Verified'|'Pending'|'Deleted'|'Rejected'
}

Response Structure

• (dict) –

  • authorityId (string) –

    Unique authority ID for the supplemental TRN information that was stored.

  • status (string) –

    The status of the supplemental TRN stored in the system after processing. Based on the validation occurring on the TRN, the status can be Verified, Pending, Rejected, or Deleted.

Exceptions

• TaxSettings.Client.exceptions.ValidationException

• TaxSettings.Client.exceptions.ConflictException

• TaxSettings.Client.exceptions.InternalServerException