Interface TaxSettingsAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface TaxSettingsAsyncClient extends AwsClient
Service client for accessing Tax Settings asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

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

  • Field Details

  • Method Details

    • batchDeleteTaxRegistration

      default CompletableFuture<BatchDeleteTaxRegistrationResponse> batchDeleteTaxRegistration(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.

      Parameters:
      batchDeleteTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the BatchDeleteTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchDeleteTaxRegistration

      default CompletableFuture<BatchDeleteTaxRegistrationResponse> batchDeleteTaxRegistration(Consumer<BatchDeleteTaxRegistrationRequest.Builder> 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.


      This is a convenience which creates an instance of the BatchDeleteTaxRegistrationRequest.Builder avoiding the need to create one manually via BatchDeleteTaxRegistrationRequest.builder()

      Parameters:
      batchDeleteTaxRegistrationRequest - A Consumer that will call methods on BatchDeleteTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the BatchDeleteTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetTaxExemptions

      default CompletableFuture<BatchGetTaxExemptionsResponse> batchGetTaxExemptions(BatchGetTaxExemptionsRequest batchGetTaxExemptionsRequest)

      Get the active tax exemptions for a given list of accounts. The IAM action is tax:GetExemptions.

      Parameters:
      batchGetTaxExemptionsRequest -
      Returns:
      A Java Future containing the result of the BatchGetTaxExemptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetTaxExemptions

      default CompletableFuture<BatchGetTaxExemptionsResponse> batchGetTaxExemptions(Consumer<BatchGetTaxExemptionsRequest.Builder> batchGetTaxExemptionsRequest)

      Get the active tax exemptions for a given list of accounts. The IAM action is tax:GetExemptions.


      This is a convenience which creates an instance of the BatchGetTaxExemptionsRequest.Builder avoiding the need to create one manually via BatchGetTaxExemptionsRequest.builder()

      Parameters:
      batchGetTaxExemptionsRequest - A Consumer that will call methods on BatchGetTaxExemptionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the BatchGetTaxExemptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchPutTaxRegistration

      default CompletableFuture<BatchPutTaxRegistrationResponse> batchPutTaxRegistration(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.

      Indonesia

      • PutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022.

      • BatchPutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022, through our third-party partner PT Achilles Advanced Management (OnlinePajak).

      • You must specify the taxRegistrationNumberType in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      • If you specify decisionNumber, you must specify the ppnExceptionDesignationCode in the indonesiaAdditionalInfo field of the additionalTaxInformation object. If the taxRegistrationNumberType is set to NPWP or NITKU, valid values for ppnExceptionDesignationCode are either 01, 02, 03, 07, or 08.

        For other taxRegistrationNumberType values, ppnExceptionDesignationCode must be either 01, 07, or 08.

      • If ppnExceptionDesignationCode is 07, you must specify the decisionNumber in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      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

      • The sector valid values are Business and Individual.

      • RegistrationType valid values are NRIC for individual, and TIN and sales and service tax (SST) for Business.

      • For individual, you can specify the taxInformationNumber in MalaysiaAdditionalInfo with NRIC type, and a valid MyKad or NRIC number.

      • For business, you must specify a businessRegistrationNumber in MalaysiaAdditionalInfo with a TIN type and tax identification number.

      • For business resellers, you must specify a businessRegistrationNumber and taxInformationNumber in MalaysiaAdditionalInfo with a sales and service tax (SST) type and a valid SST number.

      • For business resellers with service codes, you must specify businessRegistrationNumber, taxInformationNumber, and distinct serviceTaxCodes in MalaysiaAdditionalInfo with a SST type and valid sales and service tax (SST) number. By using this API operation, Amazon Web Services registers your self-declaration 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.

      • 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.

      Parameters:
      batchPutTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the BatchPutTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchPutTaxRegistration

      default CompletableFuture<BatchPutTaxRegistrationResponse> batchPutTaxRegistration(Consumer<BatchPutTaxRegistrationRequest.Builder> 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.

      Indonesia

      • PutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022.

      • BatchPutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022, through our third-party partner PT Achilles Advanced Management (OnlinePajak).

      • You must specify the taxRegistrationNumberType in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      • If you specify decisionNumber, you must specify the ppnExceptionDesignationCode in the indonesiaAdditionalInfo field of the additionalTaxInformation object. If the taxRegistrationNumberType is set to NPWP or NITKU, valid values for ppnExceptionDesignationCode are either 01, 02, 03, 07, or 08.

        For other taxRegistrationNumberType values, ppnExceptionDesignationCode must be either 01, 07, or 08.

      • If ppnExceptionDesignationCode is 07, you must specify the decisionNumber in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      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

      • The sector valid values are Business and Individual.

      • RegistrationType valid values are NRIC for individual, and TIN and sales and service tax (SST) for Business.

      • For individual, you can specify the taxInformationNumber in MalaysiaAdditionalInfo with NRIC type, and a valid MyKad or NRIC number.

      • For business, you must specify a businessRegistrationNumber in MalaysiaAdditionalInfo with a TIN type and tax identification number.

      • For business resellers, you must specify a businessRegistrationNumber and taxInformationNumber in MalaysiaAdditionalInfo with a sales and service tax (SST) type and a valid SST number.

      • For business resellers with service codes, you must specify businessRegistrationNumber, taxInformationNumber, and distinct serviceTaxCodes in MalaysiaAdditionalInfo with a SST type and valid sales and service tax (SST) number. By using this API operation, Amazon Web Services registers your self-declaration 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.

      • 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.


      This is a convenience which creates an instance of the BatchPutTaxRegistrationRequest.Builder avoiding the need to create one manually via BatchPutTaxRegistrationRequest.builder()

      Parameters:
      batchPutTaxRegistrationRequest - A Consumer that will call methods on BatchPutTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the BatchPutTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteSupplementalTaxRegistration

      default CompletableFuture<DeleteSupplementalTaxRegistrationResponse> deleteSupplementalTaxRegistration(DeleteSupplementalTaxRegistrationRequest deleteSupplementalTaxRegistrationRequest)

      Deletes a supplemental tax registration for a single account.

      Parameters:
      deleteSupplementalTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the DeleteSupplementalTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteSupplementalTaxRegistration

      default CompletableFuture<DeleteSupplementalTaxRegistrationResponse> deleteSupplementalTaxRegistration(Consumer<DeleteSupplementalTaxRegistrationRequest.Builder> deleteSupplementalTaxRegistrationRequest)

      Deletes a supplemental tax registration for a single account.


      This is a convenience which creates an instance of the DeleteSupplementalTaxRegistrationRequest.Builder avoiding the need to create one manually via DeleteSupplementalTaxRegistrationRequest.builder()

      Parameters:
      deleteSupplementalTaxRegistrationRequest - A Consumer that will call methods on DeleteSupplementalTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteSupplementalTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTaxRegistration

      default CompletableFuture<DeleteTaxRegistrationResponse> deleteTaxRegistration(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.

      Parameters:
      deleteTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the DeleteTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTaxRegistration

      default CompletableFuture<DeleteTaxRegistrationResponse> deleteTaxRegistration(Consumer<DeleteTaxRegistrationRequest.Builder> 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.


      This is a convenience which creates an instance of the DeleteTaxRegistrationRequest.Builder avoiding the need to create one manually via DeleteTaxRegistrationRequest.builder()

      Parameters:
      deleteTaxRegistrationRequest - A Consumer that will call methods on DeleteTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxExemptionTypes

      default CompletableFuture<GetTaxExemptionTypesResponse> getTaxExemptionTypes(GetTaxExemptionTypesRequest getTaxExemptionTypesRequest)

      Get supported tax exemption types. The IAM action is tax:GetExemptions.

      Parameters:
      getTaxExemptionTypesRequest -
      Returns:
      A Java Future containing the result of the GetTaxExemptionTypes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxExemptionTypes

      default CompletableFuture<GetTaxExemptionTypesResponse> getTaxExemptionTypes(Consumer<GetTaxExemptionTypesRequest.Builder> getTaxExemptionTypesRequest)

      Get supported tax exemption types. The IAM action is tax:GetExemptions.


      This is a convenience which creates an instance of the GetTaxExemptionTypesRequest.Builder avoiding the need to create one manually via GetTaxExemptionTypesRequest.builder()

      Parameters:
      getTaxExemptionTypesRequest - A Consumer that will call methods on GetTaxExemptionTypesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTaxExemptionTypes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxInheritance

      default CompletableFuture<GetTaxInheritanceResponse> getTaxInheritance(GetTaxInheritanceRequest getTaxInheritanceRequest)

      The get account tax inheritance status.

      Parameters:
      getTaxInheritanceRequest -
      Returns:
      A Java Future containing the result of the GetTaxInheritance operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxInheritance

      default CompletableFuture<GetTaxInheritanceResponse> getTaxInheritance(Consumer<GetTaxInheritanceRequest.Builder> getTaxInheritanceRequest)

      The get account tax inheritance status.


      This is a convenience which creates an instance of the GetTaxInheritanceRequest.Builder avoiding the need to create one manually via GetTaxInheritanceRequest.builder()

      Parameters:
      getTaxInheritanceRequest - A Consumer that will call methods on GetTaxInheritanceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTaxInheritance operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxRegistration

      default CompletableFuture<GetTaxRegistrationResponse> getTaxRegistration(GetTaxRegistrationRequest getTaxRegistrationRequest)

      Retrieves tax registration for a single account.

      Parameters:
      getTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the GetTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxRegistration

      default CompletableFuture<GetTaxRegistrationResponse> getTaxRegistration(Consumer<GetTaxRegistrationRequest.Builder> getTaxRegistrationRequest)

      Retrieves tax registration for a single account.


      This is a convenience which creates an instance of the GetTaxRegistrationRequest.Builder avoiding the need to create one manually via GetTaxRegistrationRequest.builder()

      Parameters:
      getTaxRegistrationRequest - A Consumer that will call methods on GetTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxRegistrationDocument

      default CompletableFuture<GetTaxRegistrationDocumentResponse> getTaxRegistrationDocument(GetTaxRegistrationDocumentRequest getTaxRegistrationDocumentRequest)

      Downloads your tax documents to the Amazon S3 bucket that you specify in your request.

      Parameters:
      getTaxRegistrationDocumentRequest -
      Returns:
      A Java Future containing the result of the GetTaxRegistrationDocument operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTaxRegistrationDocument

      default CompletableFuture<GetTaxRegistrationDocumentResponse> getTaxRegistrationDocument(Consumer<GetTaxRegistrationDocumentRequest.Builder> getTaxRegistrationDocumentRequest)

      Downloads your tax documents to the Amazon S3 bucket that you specify in your request.


      This is a convenience which creates an instance of the GetTaxRegistrationDocumentRequest.Builder avoiding the need to create one manually via GetTaxRegistrationDocumentRequest.builder()

      Parameters:
      getTaxRegistrationDocumentRequest - A Consumer that will call methods on GetTaxRegistrationDocumentRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTaxRegistrationDocument operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSupplementalTaxRegistrations

      default CompletableFuture<ListSupplementalTaxRegistrationsResponse> listSupplementalTaxRegistrations(ListSupplementalTaxRegistrationsRequest listSupplementalTaxRegistrationsRequest)

      Retrieves supplemental tax registrations for a single account.

      Parameters:
      listSupplementalTaxRegistrationsRequest -
      Returns:
      A Java Future containing the result of the ListSupplementalTaxRegistrations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSupplementalTaxRegistrations

      default CompletableFuture<ListSupplementalTaxRegistrationsResponse> listSupplementalTaxRegistrations(Consumer<ListSupplementalTaxRegistrationsRequest.Builder> listSupplementalTaxRegistrationsRequest)

      Retrieves supplemental tax registrations for a single account.


      This is a convenience which creates an instance of the ListSupplementalTaxRegistrationsRequest.Builder avoiding the need to create one manually via ListSupplementalTaxRegistrationsRequest.builder()

      Parameters:
      listSupplementalTaxRegistrationsRequest - A Consumer that will call methods on ListSupplementalTaxRegistrationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListSupplementalTaxRegistrations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSupplementalTaxRegistrationsPaginator

      default ListSupplementalTaxRegistrationsPublisher listSupplementalTaxRegistrationsPaginator(ListSupplementalTaxRegistrationsRequest listSupplementalTaxRegistrationsRequest)

      This is a variant of listSupplementalTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListSupplementalTaxRegistrationsPublisher publisher = client.listSupplementalTaxRegistrationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListSupplementalTaxRegistrationsPublisher publisher = client.listSupplementalTaxRegistrationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listSupplementalTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsRequest) operation.

      Parameters:
      listSupplementalTaxRegistrationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSupplementalTaxRegistrationsPaginator

      default ListSupplementalTaxRegistrationsPublisher listSupplementalTaxRegistrationsPaginator(Consumer<ListSupplementalTaxRegistrationsRequest.Builder> listSupplementalTaxRegistrationsRequest)

      This is a variant of listSupplementalTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListSupplementalTaxRegistrationsPublisher publisher = client.listSupplementalTaxRegistrationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListSupplementalTaxRegistrationsPublisher publisher = client.listSupplementalTaxRegistrationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listSupplementalTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListSupplementalTaxRegistrationsRequest) operation.


      This is a convenience which creates an instance of the ListSupplementalTaxRegistrationsRequest.Builder avoiding the need to create one manually via ListSupplementalTaxRegistrationsRequest.builder()

      Parameters:
      listSupplementalTaxRegistrationsRequest - A Consumer that will call methods on ListSupplementalTaxRegistrationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxExemptions

      default CompletableFuture<ListTaxExemptionsResponse> listTaxExemptions(ListTaxExemptionsRequest listTaxExemptionsRequest)

      Retrieves the tax exemption of accounts listed in a consolidated billing family. The IAM action is tax:GetExemptions.

      Parameters:
      listTaxExemptionsRequest -
      Returns:
      A Java Future containing the result of the ListTaxExemptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxExemptions

      default CompletableFuture<ListTaxExemptionsResponse> listTaxExemptions(Consumer<ListTaxExemptionsRequest.Builder> listTaxExemptionsRequest)

      Retrieves the tax exemption of accounts listed in a consolidated billing family. The IAM action is tax:GetExemptions.


      This is a convenience which creates an instance of the ListTaxExemptionsRequest.Builder avoiding the need to create one manually via ListTaxExemptionsRequest.builder()

      Parameters:
      listTaxExemptionsRequest - A Consumer that will call methods on ListTaxExemptionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTaxExemptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxExemptionsPaginator

      default ListTaxExemptionsPublisher listTaxExemptionsPaginator(ListTaxExemptionsRequest listTaxExemptionsRequest)

      This is a variant of listTaxExemptions(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxExemptionsPublisher publisher = client.listTaxExemptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxExemptionsPublisher publisher = client.listTaxExemptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTaxExemptions(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsRequest) operation.

      Parameters:
      listTaxExemptionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxExemptionsPaginator

      default ListTaxExemptionsPublisher listTaxExemptionsPaginator(Consumer<ListTaxExemptionsRequest.Builder> listTaxExemptionsRequest)

      This is a variant of listTaxExemptions(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxExemptionsPublisher publisher = client.listTaxExemptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxExemptionsPublisher publisher = client.listTaxExemptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTaxExemptions(software.amazon.awssdk.services.taxsettings.model.ListTaxExemptionsRequest) operation.


      This is a convenience which creates an instance of the ListTaxExemptionsRequest.Builder avoiding the need to create one manually via ListTaxExemptionsRequest.builder()

      Parameters:
      listTaxExemptionsRequest - A Consumer that will call methods on ListTaxExemptionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxRegistrations

      default CompletableFuture<ListTaxRegistrationsResponse> listTaxRegistrations(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).

      Parameters:
      listTaxRegistrationsRequest -
      Returns:
      A Java Future containing the result of the ListTaxRegistrations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxRegistrations

      default CompletableFuture<ListTaxRegistrationsResponse> listTaxRegistrations(Consumer<ListTaxRegistrationsRequest.Builder> 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).


      This is a convenience which creates an instance of the ListTaxRegistrationsRequest.Builder avoiding the need to create one manually via ListTaxRegistrationsRequest.builder()

      Parameters:
      listTaxRegistrationsRequest - A Consumer that will call methods on ListTaxRegistrationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTaxRegistrations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxRegistrationsPaginator

      default ListTaxRegistrationsPublisher listTaxRegistrationsPaginator(ListTaxRegistrationsRequest listTaxRegistrationsRequest)

      This is a variant of listTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxRegistrationsPublisher publisher = client.listTaxRegistrationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxRegistrationsPublisher publisher = client.listTaxRegistrationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsRequest) operation.

      Parameters:
      listTaxRegistrationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTaxRegistrationsPaginator

      default ListTaxRegistrationsPublisher listTaxRegistrationsPaginator(Consumer<ListTaxRegistrationsRequest.Builder> listTaxRegistrationsRequest)

      This is a variant of listTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxRegistrationsPublisher publisher = client.listTaxRegistrationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.taxsettings.paginators.ListTaxRegistrationsPublisher publisher = client.listTaxRegistrationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTaxRegistrations(software.amazon.awssdk.services.taxsettings.model.ListTaxRegistrationsRequest) operation.


      This is a convenience which creates an instance of the ListTaxRegistrationsRequest.Builder avoiding the need to create one manually via ListTaxRegistrationsRequest.builder()

      Parameters:
      listTaxRegistrationsRequest - A Consumer that will call methods on ListTaxRegistrationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putSupplementalTaxRegistration

      default CompletableFuture<PutSupplementalTaxRegistrationResponse> putSupplementalTaxRegistration(PutSupplementalTaxRegistrationRequest putSupplementalTaxRegistrationRequest)

      Stores supplemental tax registration for a single account.

      Parameters:
      putSupplementalTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the PutSupplementalTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putSupplementalTaxRegistration

      default CompletableFuture<PutSupplementalTaxRegistrationResponse> putSupplementalTaxRegistration(Consumer<PutSupplementalTaxRegistrationRequest.Builder> putSupplementalTaxRegistrationRequest)

      Stores supplemental tax registration for a single account.


      This is a convenience which creates an instance of the PutSupplementalTaxRegistrationRequest.Builder avoiding the need to create one manually via PutSupplementalTaxRegistrationRequest.builder()

      Parameters:
      putSupplementalTaxRegistrationRequest - A Consumer that will call methods on PutSupplementalTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutSupplementalTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxExemption

      default CompletableFuture<PutTaxExemptionResponse> putTaxExemption(PutTaxExemptionRequest putTaxExemptionRequest)

      Adds the tax exemption for a single account or all accounts listed in a consolidated billing family. The IAM action is tax:UpdateExemptions.

      Parameters:
      putTaxExemptionRequest -
      Returns:
      A Java Future containing the result of the PutTaxExemption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • AccessDeniedException The access is denied for the Amazon Web ServicesSupport API.
      • CaseCreationLimitExceededException You've exceeded the Amazon Web ServicesSupport case creation limit for your account.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • AttachmentUploadException Failed to upload the tax exemption document to Amazon Web ServicesSupport case.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxExemption

      default CompletableFuture<PutTaxExemptionResponse> putTaxExemption(Consumer<PutTaxExemptionRequest.Builder> putTaxExemptionRequest)

      Adds the tax exemption for a single account or all accounts listed in a consolidated billing family. The IAM action is tax:UpdateExemptions.


      This is a convenience which creates an instance of the PutTaxExemptionRequest.Builder avoiding the need to create one manually via PutTaxExemptionRequest.builder()

      Parameters:
      putTaxExemptionRequest - A Consumer that will call methods on PutTaxExemptionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTaxExemption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • AccessDeniedException The access is denied for the Amazon Web ServicesSupport API.
      • CaseCreationLimitExceededException You've exceeded the Amazon Web ServicesSupport case creation limit for your account.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • AttachmentUploadException Failed to upload the tax exemption document to Amazon Web ServicesSupport case.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxInheritance

      default CompletableFuture<PutTaxInheritanceResponse> putTaxInheritance(PutTaxInheritanceRequest putTaxInheritanceRequest)

      The updated tax inheritance status.

      Parameters:
      putTaxInheritanceRequest -
      Returns:
      A Java Future containing the result of the PutTaxInheritance operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxInheritance

      default CompletableFuture<PutTaxInheritanceResponse> putTaxInheritance(Consumer<PutTaxInheritanceRequest.Builder> putTaxInheritanceRequest)

      The updated tax inheritance status.


      This is a convenience which creates an instance of the PutTaxInheritanceRequest.Builder avoiding the need to create one manually via PutTaxInheritanceRequest.builder()

      Parameters:
      putTaxInheritanceRequest - A Consumer that will call methods on PutTaxInheritanceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTaxInheritance operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • ResourceNotFoundException The exception thrown when the input doesn't have a resource associated to it.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxRegistration

      default CompletableFuture<PutTaxRegistrationResponse> putTaxRegistration(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.

      Indonesia

      • PutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022.

      • BatchPutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022, through our third-party partner PT Achilles Advanced Management (OnlinePajak).

      • You must specify the taxRegistrationNumberType in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      • If you specify decisionNumber, you must specify the ppnExceptionDesignationCode in the indonesiaAdditionalInfo field of the additionalTaxInformation object. If the taxRegistrationNumberType is set to NPWP or NITKU, valid values for ppnExceptionDesignationCode are either 01, 02, 03, 07, or 08.

        For other taxRegistrationNumberType values, ppnExceptionDesignationCode must be either 01, 07, or 08.

      • If ppnExceptionDesignationCode is 07, you must specify the decisionNumber in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      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

      • The sector valid values are Business and Individual.

      • RegistrationType valid values are NRIC for individual, and TIN and sales and service tax (SST) for Business.

      • For individual, you can specify the taxInformationNumber in MalaysiaAdditionalInfo with NRIC type, and a valid MyKad or NRIC number.

      • For business, you must specify a businessRegistrationNumber in MalaysiaAdditionalInfo with a TIN type and tax identification number.

      • For business resellers, you must specify a businessRegistrationNumber and taxInformationNumber in MalaysiaAdditionalInfo with a sales and service tax (SST) type and a valid SST number.

      • For business resellers with service codes, you must specify businessRegistrationNumber, taxInformationNumber, and distinct serviceTaxCodes in MalaysiaAdditionalInfo with a SST type and valid sales and service tax (SST) number. By using this API operation, Amazon Web Services registers your self-declaration 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.

      • 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.

      Parameters:
      putTaxRegistrationRequest -
      Returns:
      A Java Future containing the result of the PutTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTaxRegistration

      default CompletableFuture<PutTaxRegistrationResponse> putTaxRegistration(Consumer<PutTaxRegistrationRequest.Builder> 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.

      Indonesia

      • PutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022.

      • BatchPutTaxRegistration: The use of this operation to submit tax information is subject to the Amazon Web Services service terms. By submitting, you’re providing consent for Amazon Web Services to validate NIK, NPWP, and NITKU data, provided by you with the Directorate General of Taxes of Indonesia in accordance with the Minister of Finance Regulation (PMK) Number 112/PMK.03/2022, through our third-party partner PT Achilles Advanced Management (OnlinePajak).

      • You must specify the taxRegistrationNumberType in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      • If you specify decisionNumber, you must specify the ppnExceptionDesignationCode in the indonesiaAdditionalInfo field of the additionalTaxInformation object. If the taxRegistrationNumberType is set to NPWP or NITKU, valid values for ppnExceptionDesignationCode are either 01, 02, 03, 07, or 08.

        For other taxRegistrationNumberType values, ppnExceptionDesignationCode must be either 01, 07, or 08.

      • If ppnExceptionDesignationCode is 07, you must specify the decisionNumber in the indonesiaAdditionalInfo field of the additionalTaxInformation object.

      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

      • The sector valid values are Business and Individual.

      • RegistrationType valid values are NRIC for individual, and TIN and sales and service tax (SST) for Business.

      • For individual, you can specify the taxInformationNumber in MalaysiaAdditionalInfo with NRIC type, and a valid MyKad or NRIC number.

      • For business, you must specify a businessRegistrationNumber in MalaysiaAdditionalInfo with a TIN type and tax identification number.

      • For business resellers, you must specify a businessRegistrationNumber and taxInformationNumber in MalaysiaAdditionalInfo with a sales and service tax (SST) type and a valid SST number.

      • For business resellers with service codes, you must specify businessRegistrationNumber, taxInformationNumber, and distinct serviceTaxCodes in MalaysiaAdditionalInfo with a SST type and valid sales and service tax (SST) number. By using this API operation, Amazon Web Services registers your self-declaration 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.

      • 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.


      This is a convenience which creates an instance of the PutTaxRegistrationRequest.Builder avoiding the need to create one manually via PutTaxRegistrationRequest.builder()

      Parameters:
      putTaxRegistrationRequest - A Consumer that will call methods on PutTaxRegistrationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTaxRegistration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The exception when the input doesn't pass validation for at least one of the input parameters.
      • ConflictException The exception when the input is creating conflict with the given state.
      • InternalServerException The exception thrown when an unexpected error occurs when processing a request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • TaxSettingsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default TaxSettingsServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration

    • create

      static TaxSettingsAsyncClient create()
      Create a TaxSettingsAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static TaxSettingsAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a TaxSettingsAsyncClient.