View Source AWS.TaxSettings (aws-elixir v1.0.12)
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
Link to this section Summary
Functions
Deletes tax registration for multiple accounts in batch.
Get the active tax exemptions for a given list of accounts.
Adds or updates tax registration for multiple accounts in batch.
Deletes a supplemental tax registration for a single account.
Deletes tax registration for a single account.
Get supported tax exemption types.
The get account tax inheritance status.
Retrieves tax registration for a single account.
Downloads your tax documents to the Amazon S3 bucket that you specify in your request.
Retrieves supplemental tax registrations for a single account.
Retrieves the tax exemption of accounts listed in a consolidated billing family.
Retrieves the tax registration of accounts listed in a consolidated billing family.
Stores supplemental tax registration for a single account.
Adds the tax exemption for a single account or all accounts listed in a consolidated billing family.
The updated tax inheritance status.
Adds or updates tax registration for a single account.
Link to this section Functions
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.
Get the active tax exemptions for a given list of accounts.
The IAM action is tax:GetExemptions.
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
Bangladesh
- You must specify the tax registration certificate document in the
taxRegistrationDocumentsfield of theVerificationDetailsobject.
brazil
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
Georgia
- The valid
personTypevalues arePhysical PersonandBusiness.
indonesia
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
taxRegistrationNumberTypein theindonesiaAdditionalInfofield of theadditionalTaxInformationobject.If you specify
decisionNumber, you must specify theppnExceptionDesignationCodein theindonesiaAdditionalInfofield of theadditionalTaxInformationobject. If thetaxRegistrationNumberTypeis set to NPWP or NITKU, valid values forppnExceptionDesignationCodeare either01,02,03,07, or08.
For other taxRegistrationNumberType values, ppnExceptionDesignationCode must
be either 01, 07, or 08.
- If
ppnExceptionDesignationCodeis07or08, you must specify thedecisionNumberin theindonesiaAdditionalInfofield of theadditionalTaxInformationobject.
kenya
Kenya
You must specify the
personTypein thekenyaAdditionalInfofield of theadditionalTaxInformationobject.If the
personTypeisPhysical Person, you must specify the tax registration certificate document in thetaxRegistrationDocumentsfield of theVerificationDetailsobject.
malaysia
Malaysia
The sector valid values are
BusinessandIndividual.RegistrationTypevalid values areNRICfor individual, and TIN and sales and service tax (SST) for Business.For individual, you can specify the
taxInformationNumberinMalaysiaAdditionalInfowith NRIC type, and a validMyKador NRIC number.For business, you must specify a
businessRegistrationNumberinMalaysiaAdditionalInfowith a TIN type and tax identification number.For business resellers, you must specify a
businessRegistrationNumberandtaxInformationNumberinMalaysiaAdditionalInfowith a sales and service tax (SST) type and a valid SST number.For business resellers with service codes, you must specify
businessRegistrationNumber,taxInformationNumber, and distinctserviceTaxCodesinMalaysiaAdditionalInfowith 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
mexico
Mexico
You must provide a Constancia de Situación fiscal (CSF) document in the verificationDetails field.
You do not need to provide address and legal name. These will be populated based on your tax registration number.
nepal
Nepal
- The sector valid values are
BusinessandIndividual.
saudi-arabia
Saudi Arabia
- For
address, you must specifyaddressLine3.
south-korea
South Korea
You must specify the
certifiedEmailIdandlegalNamein theTaxRegistrationEntryobject. Use Korean characters forlegalName.You must specify the
businessRepresentativeName,itemOfBusiness, andlineOfBusinessin thesouthKoreaAdditionalInfofield of theadditionalTaxInformationobject. Use Korean characters for these fields.You must specify the tax registration certificate document in the
taxRegistrationDocumentsfield of theVerificationDetailsobject.For the
addressobject, use Korean characters foraddressLine1,addressLine2city,postalCode, andstateOrRegion.
spain
Spain
You must specify the
registrationTypein thespainAdditionalInfofield of theadditionalTaxInformationobject.If the
registrationTypeisLocal, you must specify the tax registration certificate document in thetaxRegistrationDocumentsfield of theVerificationDetailsobject.
turkey
Turkey
You must specify the
sectorin thetaxRegistrationEntryobject.If your
sectorisBusiness,Individual, orGovernment:- Specify the
taxOffice. If yoursectoris
- Specify the
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 Billingconsole, Government appears as ## Public institutions
If your
sectorisBusinessand you're subject to KDV tax, you must specify your industry in theindustriesfield.For
address, you must specifydistrictOrCounty.
ukraine
Ukraine
- The sector valid values are
BusinessandIndividual.
philippines
Philippines
- You can optionally specify the
isVatRegisteredin thephilippinesAdditionalInfofield of theadditionalTaxInformationobject to indicate your VAT registration status with the Bureau of Internal Revenue (BIR).
belgium
Belgium
- You can optionally specify the
peppolIdin thebelgiumAdditionalInfofield of theadditionalTaxInformationobject.
chile
Chile
- You can optionally specify the
documentTypeandbusinessActivityin thechileAdditionalInfofield of theadditionalTaxInformationobject.
france
France
- You must specify the
sirenNumberin thefranceAdditionalInfofield of theadditionalTaxInformationobject.
poland
Poland
- You can optionally specify the
taxRegistrationNumberTypein thepolandAdditionalInfofield of theadditionalTaxInformationobject. Valid values areEUTaxRegistrationNumber,LocalTaxRegistrationNumber, orLocalRegistrationNumber.
delete_supplemental_tax_registration(client, input, options \\ [])
View SourceDeletes a supplemental tax registration for a single account.
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.
Get supported tax exemption types.
The IAM action is tax:GetExemptions.
The get account tax inheritance status.
Retrieves tax registration for a single account.
Downloads your tax documents to the Amazon S3 bucket that you specify in your request.
Retrieves supplemental tax registrations for a single account.
Retrieves the tax exemption of accounts listed in a consolidated billing family.
The IAM action is tax:GetExemptions.
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).
Stores supplemental tax registration for a single account.
Adds the tax exemption for a single account or all accounts listed in a consolidated billing family.
The IAM action is tax:UpdateExemptions.
The updated tax inheritance status.
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
Bangladesh
- You must specify the tax registration certificate document in the
taxRegistrationDocumentsfield of theVerificationDetailsobject.
brazil
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
Georgia
- The valid
personTypevalues arePhysical PersonandBusiness.
indonesia
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
taxRegistrationNumberTypein theindonesiaAdditionalInfofield of theadditionalTaxInformationobject.If you specify
decisionNumber, you must specify theppnExceptionDesignationCodein theindonesiaAdditionalInfofield of theadditionalTaxInformationobject. If thetaxRegistrationNumberTypeis set to NPWP or NITKU, valid values forppnExceptionDesignationCodeare either01,02,03,07, or08.
For other taxRegistrationNumberType values, ppnExceptionDesignationCode must
be either 01, 07, or 08.
- If
ppnExceptionDesignationCodeis07or08, you must specify thedecisionNumberin theindonesiaAdditionalInfofield of theadditionalTaxInformationobject.
kenya
Kenya
You must specify the
personTypein thekenyaAdditionalInfofield of theadditionalTaxInformationobject.If the
personTypeisPhysical Person, you must specify the tax registration certificate document in thetaxRegistrationDocumentsfield of theVerificationDetailsobject.
malaysia
Malaysia
The sector valid values are
BusinessandIndividual.RegistrationTypevalid values areNRICfor individual, and TIN and sales and service tax (SST) for Business.For individual, you can specify the
taxInformationNumberinMalaysiaAdditionalInfowith NRIC type, and a validMyKador NRIC number.For business, you must specify a
businessRegistrationNumberinMalaysiaAdditionalInfowith a TIN type and tax identification number.For business resellers, you must specify a
businessRegistrationNumberandtaxInformationNumberinMalaysiaAdditionalInfowith a sales and service tax (SST) type and a valid SST number.For business resellers with service codes, you must specify
businessRegistrationNumber,taxInformationNumber, and distinctserviceTaxCodesinMalaysiaAdditionalInfowith 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
mexico
Mexico
You must provide a Constancia de Situación fiscal (CSF) document in the verificationDetails field.
You do not need to provide address and legal name. These will be populated based on your tax registration number.
nepal
Nepal
- The sector valid values are
BusinessandIndividual.
saudi-arabia
Saudi Arabia
- For
address, you must specifyaddressLine3.
south-korea
South Korea
You must specify the
certifiedEmailIdandlegalNamein theTaxRegistrationEntryobject. Use Korean characters forlegalName.You must specify the
businessRepresentativeName,itemOfBusiness, andlineOfBusinessin thesouthKoreaAdditionalInfofield of theadditionalTaxInformationobject. Use Korean characters for these fields.You must specify the tax registration certificate document in the
taxRegistrationDocumentsfield of theVerificationDetailsobject.For the
addressobject, use Korean characters foraddressLine1,addressLine2city,postalCode, andstateOrRegion.
spain
Spain
You must specify the
registrationTypein thespainAdditionalInfofield of theadditionalTaxInformationobject.If the
registrationTypeisLocal, you must specify the tax registration certificate document in thetaxRegistrationDocumentsfield of theVerificationDetailsobject.
turkey
Turkey
You must specify the
sectorin thetaxRegistrationEntryobject.If your
sectorisBusiness,Individual, orGovernment:- Specify the
taxOffice. If yoursectoris
- Specify the
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 Billingconsole, Government appears as ## Public institutions
If your
sectorisBusinessand you're subject to KDV tax, you must specify your industry in theindustriesfield.For
address, you must specifydistrictOrCounty.
ukraine
Ukraine
- The sector valid values are
BusinessandIndividual.
philippines
Philippines
- You can optionally specify the
isVatRegisteredin thephilippinesAdditionalInfofield of theadditionalTaxInformationobject to indicate your VAT registration status with the Bureau of Internal Revenue (BIR).
belgium
Belgium
- You can optionally specify the
peppolIdin thebelgiumAdditionalInfofield of theadditionalTaxInformationobject.
chile
Chile
- You can optionally specify the
documentTypeandbusinessActivityin thechileAdditionalInfofield of theadditionalTaxInformationobject.
france
France
- You must specify the
sirenNumberin thefranceAdditionalInfofield of theadditionalTaxInformationobject.
poland
Poland
- You can optionally specify the
taxRegistrationNumberTypein thepolandAdditionalInfofield of theadditionalTaxInformationobject. Valid values areEUTaxRegistrationNumber,LocalTaxRegistrationNumber, orLocalRegistrationNumber.