@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSTaxSettingsAsync extends AWSTaxSettings
AsyncHandler can be used to receive
notification when an asynchronous operation completes.
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSTaxSettingsAsync instead.
You can use the tax setting API to programmatically set, modify, and delete the tax registration number (TRN), associated business legal name, and address (Collectively referred to as "TRN information"). You can also programmatically view TRN information and tax addresses ("Tax profiles").
You can use this API to automate your TRN information settings instead of manually using the console.
Service Endpoint
https://tax.us-east-1.amazonaws.com
ENDPOINT_PREFIXbatchDeleteTaxRegistration, batchPutTaxRegistration, deleteTaxRegistration, getCachedResponseMetadata, getTaxRegistration, getTaxRegistrationDocument, listTaxRegistrations, putTaxRegistration, shutdownFuture<BatchDeleteTaxRegistrationResult> batchDeleteTaxRegistrationAsync(BatchDeleteTaxRegistrationRequest batchDeleteTaxRegistrationRequest)
Deletes tax registration for multiple accounts in batch. This can be used to delete tax registrations for up to five accounts in one batch.
This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in the Billing and Cost Management console instead.
batchDeleteTaxRegistrationRequest - Future<BatchDeleteTaxRegistrationResult> batchDeleteTaxRegistrationAsync(BatchDeleteTaxRegistrationRequest batchDeleteTaxRegistrationRequest, AsyncHandler<BatchDeleteTaxRegistrationRequest,BatchDeleteTaxRegistrationResult> asyncHandler)
Deletes tax registration for multiple accounts in batch. This can be used to delete tax registrations for up to five accounts in one batch.
This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in the Billing and Cost Management console instead.
batchDeleteTaxRegistrationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<BatchPutTaxRegistrationResult> batchPutTaxRegistrationAsync(BatchPutTaxRegistrationRequest batchPutTaxRegistrationRequest)
Adds or updates tax registration for multiple accounts in batch. This can be used to add or update tax registrations for up to five accounts in one batch. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first.
To call this API operation for specific countries, see the following country-specific requirements.
Bangladesh
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
Brazil
You must complete the tax registration process in the Payment preferences page in the Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation.
For Amazon Web Services accounts created through Organizations, you can call this API operation when you don't have a billing address.
Georgia
The valid personType values are Physical Person and Business.
Kenya
You must specify the personType in the kenyaAdditionalInfo field of the
additionalTaxInformation object.
If the personType is Physical Person, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Malaysia
If you use this operation to set a tax registration number (TRN) in Malaysia, only resellers with a valid sales and service tax (SST) number are required to provide tax registration information.
By using this API operation to set a TRN in Malaysia, Amazon Web Services will regard you as self-declaring that you're an authorized business reseller registered with the Royal Malaysia Customs Department (RMCD) and have a valid SST number.
Amazon Web Services reserves the right to seek additional information and/or take other actions to support your self-declaration as appropriate.
If you're not a reseller of Amazon Web Services, we don't recommend that you use this operation to set the TRN in Malaysia.
Only use this API operation to upload the TRNs for accounts through which you're reselling Amazon Web Services.
Amazon Web Services is currently registered under the following service tax codes. You must include at least one of the service tax codes in the service tax code strings to declare yourself as an authorized registered business reseller.
Taxable service and service tax codes:
Consultancy - 9907061674
Training or coaching service - 9907071685
IT service - 9907101676
Digital services and electronic medium - 9907121690
Nepal
The sector valid values are Business and Individual.
Saudi Arabia
For address, you must specify addressLine3.
South Korea
You must specify the certifiedEmailId and legalName in the
TaxRegistrationEntry object. Use Korean characters for legalName.
You must specify the businessRepresentativeName, itemOfBusiness, and
lineOfBusiness in the southKoreaAdditionalInfo field of the
additionalTaxInformation object. Use Korean characters for these fields.
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
For the address object, use Korean characters for addressLine1,
addressLine2 city, postalCode, and stateOrRegion.
Spain
You must specify the registrationType in the spainAdditionalInfo field of the
additionalTaxInformation object.
If the registrationType is Local, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Turkey
You must specify the sector in the taxRegistrationEntry object.
If your sector is Business, Individual, or Government:
Specify the taxOffice. If your sector is Individual, don't enter this
value.
(Optional) Specify the kepEmailId. If your sector is Individual, don't
enter this value.
Note: In the Tax Settings page of the Billing console, Government appears as Public
institutions
If your sector is Business and you're subject to KDV tax, you must specify your
industry in the industries field.
For address, you must specify districtOrCounty.
Ukraine
The sector valid values are Business and Individual.
batchPutTaxRegistrationRequest - Future<BatchPutTaxRegistrationResult> batchPutTaxRegistrationAsync(BatchPutTaxRegistrationRequest batchPutTaxRegistrationRequest, AsyncHandler<BatchPutTaxRegistrationRequest,BatchPutTaxRegistrationResult> asyncHandler)
Adds or updates tax registration for multiple accounts in batch. This can be used to add or update tax registrations for up to five accounts in one batch. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first.
To call this API operation for specific countries, see the following country-specific requirements.
Bangladesh
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
Brazil
You must complete the tax registration process in the Payment preferences page in the Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation.
For Amazon Web Services accounts created through Organizations, you can call this API operation when you don't have a billing address.
Georgia
The valid personType values are Physical Person and Business.
Kenya
You must specify the personType in the kenyaAdditionalInfo field of the
additionalTaxInformation object.
If the personType is Physical Person, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Malaysia
If you use this operation to set a tax registration number (TRN) in Malaysia, only resellers with a valid sales and service tax (SST) number are required to provide tax registration information.
By using this API operation to set a TRN in Malaysia, Amazon Web Services will regard you as self-declaring that you're an authorized business reseller registered with the Royal Malaysia Customs Department (RMCD) and have a valid SST number.
Amazon Web Services reserves the right to seek additional information and/or take other actions to support your self-declaration as appropriate.
If you're not a reseller of Amazon Web Services, we don't recommend that you use this operation to set the TRN in Malaysia.
Only use this API operation to upload the TRNs for accounts through which you're reselling Amazon Web Services.
Amazon Web Services is currently registered under the following service tax codes. You must include at least one of the service tax codes in the service tax code strings to declare yourself as an authorized registered business reseller.
Taxable service and service tax codes:
Consultancy - 9907061674
Training or coaching service - 9907071685
IT service - 9907101676
Digital services and electronic medium - 9907121690
Nepal
The sector valid values are Business and Individual.
Saudi Arabia
For address, you must specify addressLine3.
South Korea
You must specify the certifiedEmailId and legalName in the
TaxRegistrationEntry object. Use Korean characters for legalName.
You must specify the businessRepresentativeName, itemOfBusiness, and
lineOfBusiness in the southKoreaAdditionalInfo field of the
additionalTaxInformation object. Use Korean characters for these fields.
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
For the address object, use Korean characters for addressLine1,
addressLine2 city, postalCode, and stateOrRegion.
Spain
You must specify the registrationType in the spainAdditionalInfo field of the
additionalTaxInformation object.
If the registrationType is Local, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Turkey
You must specify the sector in the taxRegistrationEntry object.
If your sector is Business, Individual, or Government:
Specify the taxOffice. If your sector is Individual, don't enter this
value.
(Optional) Specify the kepEmailId. If your sector is Individual, don't
enter this value.
Note: In the Tax Settings page of the Billing console, Government appears as Public
institutions
If your sector is Business and you're subject to KDV tax, you must specify your
industry in the industries field.
For address, you must specify districtOrCounty.
Ukraine
The sector valid values are Business and Individual.
batchPutTaxRegistrationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<DeleteTaxRegistrationResult> deleteTaxRegistrationAsync(DeleteTaxRegistrationRequest deleteTaxRegistrationRequest)
Deletes tax registration for a single account.
This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in the Billing and Cost Management console instead.
deleteTaxRegistrationRequest - Future<DeleteTaxRegistrationResult> deleteTaxRegistrationAsync(DeleteTaxRegistrationRequest deleteTaxRegistrationRequest, AsyncHandler<DeleteTaxRegistrationRequest,DeleteTaxRegistrationResult> asyncHandler)
Deletes tax registration for a single account.
This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in the Billing and Cost Management console instead.
deleteTaxRegistrationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<GetTaxRegistrationResult> getTaxRegistrationAsync(GetTaxRegistrationRequest getTaxRegistrationRequest)
Retrieves tax registration for a single account.
getTaxRegistrationRequest - Future<GetTaxRegistrationResult> getTaxRegistrationAsync(GetTaxRegistrationRequest getTaxRegistrationRequest, AsyncHandler<GetTaxRegistrationRequest,GetTaxRegistrationResult> asyncHandler)
Retrieves tax registration for a single account.
getTaxRegistrationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<GetTaxRegistrationDocumentResult> getTaxRegistrationDocumentAsync(GetTaxRegistrationDocumentRequest getTaxRegistrationDocumentRequest)
Downloads your tax documents to the Amazon S3 bucket that you specify in your request.
getTaxRegistrationDocumentRequest - Future<GetTaxRegistrationDocumentResult> getTaxRegistrationDocumentAsync(GetTaxRegistrationDocumentRequest getTaxRegistrationDocumentRequest, AsyncHandler<GetTaxRegistrationDocumentRequest,GetTaxRegistrationDocumentResult> asyncHandler)
Downloads your tax documents to the Amazon S3 bucket that you specify in your request.
getTaxRegistrationDocumentRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<ListTaxRegistrationsResult> listTaxRegistrationsAsync(ListTaxRegistrationsRequest listTaxRegistrationsRequest)
Retrieves the tax registration of accounts listed in a consolidated billing family. This can be used to retrieve up to 100 accounts' tax registrations in one call (default 50).
listTaxRegistrationsRequest - Future<ListTaxRegistrationsResult> listTaxRegistrationsAsync(ListTaxRegistrationsRequest listTaxRegistrationsRequest, AsyncHandler<ListTaxRegistrationsRequest,ListTaxRegistrationsResult> asyncHandler)
Retrieves the tax registration of accounts listed in a consolidated billing family. This can be used to retrieve up to 100 accounts' tax registrations in one call (default 50).
listTaxRegistrationsRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Future<PutTaxRegistrationResult> putTaxRegistrationAsync(PutTaxRegistrationRequest putTaxRegistrationRequest)
Adds or updates tax registration for a single account. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first.
To call this API operation for specific countries, see the following country-specific requirements.
Bangladesh
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
Brazil
You must complete the tax registration process in the Payment preferences page in the Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation.
For Amazon Web Services accounts created through Organizations, you can call this API operation when you don't have a billing address.
Georgia
The valid personType values are Physical Person and Business.
Kenya
You must specify the personType in the kenyaAdditionalInfo field of the
additionalTaxInformation object.
If the personType is Physical Person, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Malaysia
If you use this operation to set a tax registration number (TRN) in Malaysia, only resellers with a valid sales and service tax (SST) number are required to provide tax registration information.
By using this API operation to set a TRN in Malaysia, Amazon Web Services will regard you as self-declaring that you're an authorized business reseller registered with the Royal Malaysia Customs Department (RMCD) and have a valid SST number.
Amazon Web Services reserves the right to seek additional information and/or take other actions to support your self-declaration as appropriate.
If you're not a reseller of Amazon Web Services, we don't recommend that you use this operation to set the TRN in Malaysia.
Only use this API operation to upload the TRNs for accounts through which you're reselling Amazon Web Services.
Amazon Web Services is currently registered under the following service tax codes. You must include at least one of the service tax codes in the service tax code strings to declare yourself as an authorized registered business reseller.
Taxable service and service tax codes:
Consultancy - 9907061674
Training or coaching service - 9907071685
IT service - 9907101676
Digital services and electronic medium - 9907121690
Nepal
The sector valid values are Business and Individual.
Saudi Arabia
For address, you must specify addressLine3.
South Korea
You must specify the certifiedEmailId and legalName in the
TaxRegistrationEntry object. Use Korean characters for legalName.
You must specify the businessRepresentativeName, itemOfBusiness, and
lineOfBusiness in the southKoreaAdditionalInfo field of the
additionalTaxInformation object. Use Korean characters for these fields.
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
For the address object, use Korean characters for addressLine1,
addressLine2 city, postalCode, and stateOrRegion.
Spain
You must specify the registrationType in the spainAdditionalInfo field of the
additionalTaxInformation object.
If the registrationType is Local, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Turkey
You must specify the sector in the taxRegistrationEntry object.
If your sector is Business, Individual, or Government:
Specify the taxOffice. If your sector is Individual, don't enter this
value.
(Optional) Specify the kepEmailId. If your sector is Individual, don't
enter this value.
Note: In the Tax Settings page of the Billing console, Government appears as Public
institutions
If your sector is Business and you're subject to KDV tax, you must specify your
industry in the industries field.
For address, you must specify districtOrCounty.
Ukraine
The sector valid values are Business and Individual.
putTaxRegistrationRequest - Future<PutTaxRegistrationResult> putTaxRegistrationAsync(PutTaxRegistrationRequest putTaxRegistrationRequest, AsyncHandler<PutTaxRegistrationRequest,PutTaxRegistrationResult> asyncHandler)
Adds or updates tax registration for a single account. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first.
To call this API operation for specific countries, see the following country-specific requirements.
Bangladesh
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
Brazil
You must complete the tax registration process in the Payment preferences page in the Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation.
For Amazon Web Services accounts created through Organizations, you can call this API operation when you don't have a billing address.
Georgia
The valid personType values are Physical Person and Business.
Kenya
You must specify the personType in the kenyaAdditionalInfo field of the
additionalTaxInformation object.
If the personType is Physical Person, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Malaysia
If you use this operation to set a tax registration number (TRN) in Malaysia, only resellers with a valid sales and service tax (SST) number are required to provide tax registration information.
By using this API operation to set a TRN in Malaysia, Amazon Web Services will regard you as self-declaring that you're an authorized business reseller registered with the Royal Malaysia Customs Department (RMCD) and have a valid SST number.
Amazon Web Services reserves the right to seek additional information and/or take other actions to support your self-declaration as appropriate.
If you're not a reseller of Amazon Web Services, we don't recommend that you use this operation to set the TRN in Malaysia.
Only use this API operation to upload the TRNs for accounts through which you're reselling Amazon Web Services.
Amazon Web Services is currently registered under the following service tax codes. You must include at least one of the service tax codes in the service tax code strings to declare yourself as an authorized registered business reseller.
Taxable service and service tax codes:
Consultancy - 9907061674
Training or coaching service - 9907071685
IT service - 9907101676
Digital services and electronic medium - 9907121690
Nepal
The sector valid values are Business and Individual.
Saudi Arabia
For address, you must specify addressLine3.
South Korea
You must specify the certifiedEmailId and legalName in the
TaxRegistrationEntry object. Use Korean characters for legalName.
You must specify the businessRepresentativeName, itemOfBusiness, and
lineOfBusiness in the southKoreaAdditionalInfo field of the
additionalTaxInformation object. Use Korean characters for these fields.
You must specify the tax registration certificate document in the taxRegistrationDocuments field of
the VerificationDetails object.
For the address object, use Korean characters for addressLine1,
addressLine2 city, postalCode, and stateOrRegion.
Spain
You must specify the registrationType in the spainAdditionalInfo field of the
additionalTaxInformation object.
If the registrationType is Local, you must specify the tax registration certificate
document in the taxRegistrationDocuments field of the VerificationDetails object.
Turkey
You must specify the sector in the taxRegistrationEntry object.
If your sector is Business, Individual, or Government:
Specify the taxOffice. If your sector is Individual, don't enter this
value.
(Optional) Specify the kepEmailId. If your sector is Individual, don't
enter this value.
Note: In the Tax Settings page of the Billing console, Government appears as Public
institutions
If your sector is Business and you're subject to KDV tax, you must specify your
industry in the industries field.
For address, you must specify districtOrCounty.
Ukraine
The sector valid values are Business and Individual.
putTaxRegistrationRequest - asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.Copyright © 2025. All rights reserved.