Navigation Guide
You are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.

PutTaxRegistrationCommand

Adds or updates tax registration for a single account. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first.

To call this API operation for specific countries, see the following country-specific requirements.

Bangladesh

You must specify the tax registration certificate document in the taxRegistrationDocuments field of the VerificationDetails object.

Brazil

You must complete the tax registration process in the Payment preferences page in the Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation.
For Amazon Web Services accounts created through Organizations, you can call this API operation when you don't have a billing address.

Georgia

The valid personType values are Physical Person and Business.

Kenya

You must specify the personType in the kenyaAdditionalInfo field of the additionalTaxInformation object.
If the personType is Physical Person, you must specify the tax registration certificate document in the taxRegistrationDocuments field of the VerificationDetails object.

Malaysia

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.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { TaxSettingsClient, PutTaxRegistrationCommand } from "@aws-sdk/client-taxsettings"; // ES Modules import
// const { TaxSettingsClient, PutTaxRegistrationCommand } = require("@aws-sdk/client-taxsettings"); // CommonJS import
const client = new TaxSettingsClient(config);
const input = { // PutTaxRegistrationRequest
  accountId: "STRING_VALUE",
  taxRegistrationEntry: { // TaxRegistrationEntry
    registrationId: "STRING_VALUE", // required
    registrationType: "VAT" || "GST" || "CPF" || "CNPJ" || "SST" || "TIN" || "NRIC", // required
    legalName: "STRING_VALUE",
    legalAddress: { // Address
      addressLine1: "STRING_VALUE", // required
      addressLine2: "STRING_VALUE",
      addressLine3: "STRING_VALUE",
      districtOrCounty: "STRING_VALUE",
      city: "STRING_VALUE", // required
      stateOrRegion: "STRING_VALUE",
      postalCode: "STRING_VALUE", // required
      countryCode: "STRING_VALUE", // required
    },
    sector: "Business" || "Individual" || "Government",
    additionalTaxInformation: { // AdditionalInfoRequest
      malaysiaAdditionalInfo: { // MalaysiaAdditionalInfo
        serviceTaxCodes: [ // MalaysiaServiceTaxCodesList
          "Consultancy" || "Digital Service And Electronic Medium" || "IT Services" || "Training Or Coaching",
        ],
        taxInformationNumber: "STRING_VALUE",
        businessRegistrationNumber: "STRING_VALUE",
      },
      israelAdditionalInfo: { // IsraelAdditionalInfo
        dealerType: "Authorized" || "Non-authorized", // required
        customerType: "Business" || "Individual", // required
      },
      estoniaAdditionalInfo: { // EstoniaAdditionalInfo
        registryCommercialCode: "STRING_VALUE", // required
      },
      canadaAdditionalInfo: { // CanadaAdditionalInfo
        provincialSalesTaxId: "STRING_VALUE",
        canadaQuebecSalesTaxNumber: "STRING_VALUE",
        canadaRetailSalesTaxNumber: "STRING_VALUE",
        isResellerAccount: true || false,
      },
      spainAdditionalInfo: { // SpainAdditionalInfo
        registrationType: "Intra-EU" || "Local", // required
      },
      kenyaAdditionalInfo: { // KenyaAdditionalInfo
        personType: "Legal Person" || "Physical Person" || "Business", // required
      },
      southKoreaAdditionalInfo: { // SouthKoreaAdditionalInfo
        businessRepresentativeName: "STRING_VALUE", // required
        lineOfBusiness: "STRING_VALUE", // required
        itemOfBusiness: "STRING_VALUE", // required
      },
      turkeyAdditionalInfo: { // TurkeyAdditionalInfo
        taxOffice: "STRING_VALUE",
        kepEmailId: "STRING_VALUE",
        secondaryTaxId: "STRING_VALUE",
        industries: "CirculatingOrg" || "ProfessionalOrg" || "Banks" || "Insurance" || "PensionAndBenefitFunds" || "DevelopmentAgencies",
      },
      georgiaAdditionalInfo: { // GeorgiaAdditionalInfo
        personType: "Legal Person" || "Physical Person" || "Business", // required
      },
      italyAdditionalInfo: { // ItalyAdditionalInfo
        sdiAccountId: "STRING_VALUE",
        cigNumber: "STRING_VALUE",
        cupNumber: "STRING_VALUE",
        taxCode: "STRING_VALUE",
      },
      romaniaAdditionalInfo: { // RomaniaAdditionalInfo
        taxRegistrationNumberType: "TaxRegistrationNumber" || "LocalRegistrationNumber", // required
      },
      ukraineAdditionalInfo: { // UkraineAdditionalInfo
        ukraineTrnType: "Business" || "Individual", // required
      },
      polandAdditionalInfo: { // PolandAdditionalInfo
        individualRegistrationNumber: "STRING_VALUE",
        isGroupVatEnabled: true || false,
      },
      saudiArabiaAdditionalInfo: { // SaudiArabiaAdditionalInfo
        taxRegistrationNumberType: "TaxRegistrationNumber" || "TaxIdentificationNumber" || "CommercialRegistrationNumber",
      },
      vietnamAdditionalInfo: { // VietnamAdditionalInfo
        enterpriseIdentificationNumber: "STRING_VALUE",
        electronicTransactionCodeNumber: "STRING_VALUE",
        paymentVoucherNumber: "STRING_VALUE",
        paymentVoucherNumberDate: "STRING_VALUE",
      },
      egyptAdditionalInfo: { // EgyptAdditionalInfo
        uniqueIdentificationNumber: "STRING_VALUE",
        uniqueIdentificationNumberExpirationDate: "STRING_VALUE",
      },
      greeceAdditionalInfo: { // GreeceAdditionalInfo
        contractingAuthorityCode: "STRING_VALUE",
      },
    },
    verificationDetails: { // VerificationDetails
      dateOfBirth: "STRING_VALUE",
      taxRegistrationDocuments: [ // TaxRegistrationDocuments
        { // TaxRegistrationDocument
          s3Location: { // SourceS3Location
            bucket: "STRING_VALUE", // required
            key: "STRING_VALUE", // required
          },
          file: { // TaxRegistrationDocFile
            fileName: "STRING_VALUE", // required
            fileContent: new Uint8Array(), // e.g. Buffer.from("") or new TextEncoder().encode("")             // required
          },
        },
      ],
    },
    certifiedEmailId: "STRING_VALUE",
  },
};
const command = new PutTaxRegistrationCommand(input);
const response = await client.send(command);
// { // PutTaxRegistrationResponse
//   status: "Verified" || "Pending" || "Deleted" || "Rejected",
// };

PutTaxRegistrationCommand Input

See PutTaxRegistrationCommandInput for more details

Parameter	Type	Description
`taxRegistrationEntry` Required	`TaxRegistrationEntry \| undefined`	Your TRN information that will be stored to the account mentioned in `accountId`.
`accountId`	`string \| undefined`	Your unique account identifier.

PutTaxRegistrationCommand Output

See PutTaxRegistrationCommandOutput for details

Parameter	Type	Description
`$metadata` Required	`ResponseMetadata`	Metadata pertaining to this request.
`status`	`TaxRegistrationStatus \| undefined`	The status of your TRN stored in the system after processing. Based on the validation occurring on the TRN, the status can be `Verified`, `Pending` or `Rejected`.

Throws

Name	Fault	Details
ConflictException	client	The exception when the input is creating conflict with the given state.
InternalServerException	server	The exception thrown when an unexpected error occurs when processing a request.
ValidationException	client	The exception when the input doesn't pass validation for at least one of the input parameters.
TaxSettingsServiceException		Base exception class for all service exceptions from TaxSettings service.

Getting Started

References

PutTaxRegistrationCommand

Example Syntax

PutTaxRegistrationCommand Input

PutTaxRegistrationCommand Output

Throws

Table of Contents

Search