BatchPutTaxRegistration
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 theVerificationDetails
object.
Brazil
-
You must complete the tax registration process in the Payment preferences
page in the AWS Billing and Cost Management console. After your TRN and billing address are verified, you can call this API operation. -
For AWS accounts created through AWS Organizations, you can call this API operation when you don't have a billing address.
Georgia
-
The valid
personType
values arePhysical Person
andBusiness
.
Kenya
-
You must specify the
personType
in thekenyaAdditionalInfo
field of theadditionalTaxInformation
object. -
If the
personType
isPhysical Person
, you must specify the tax registration certificate document in thetaxRegistrationDocuments
field of theVerificationDetails
object.
Malaysia
-
The sector valid values are
Business
andIndividual
. -
RegistrationType
valid values areNRIC
for individual, and TIN and sales and service tax (SST) for Business. -
For individual, you can specify the
taxInformationNumber
inMalaysiaAdditionalInfo
with NRIC type, and a validMyKad
or NRIC number. -
For business, you must specify a
businessRegistrationNumber
inMalaysiaAdditionalInfo
with a TIN type and tax identification number. -
For business resellers, you must specify a
businessRegistrationNumber
andtaxInformationNumber
inMalaysiaAdditionalInfo
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 distinctserviceTaxCodes
inMalaysiaAdditionalInfo
with a SST type and valid sales and service tax (SST) number. By using this API operation, AWS 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. -
AWS reserves the right to seek additional information and/or take other actions to support your self-declaration as appropriate.
-
AWS 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
andIndividual
.
Saudi Arabia
-
For
address
, you must specifyaddressLine3
.
South Korea
-
You must specify the
certifiedEmailId
andlegalName
in theTaxRegistrationEntry
object. Use Korean characters forlegalName
. -
You must specify the
businessRepresentativeName
,itemOfBusiness
, andlineOfBusiness
in thesouthKoreaAdditionalInfo
field of theadditionalTaxInformation
object. Use Korean characters for these fields. -
You must specify the tax registration certificate document in the
taxRegistrationDocuments
field of theVerificationDetails
object. -
For the
address
object, use Korean characters foraddressLine1
,addressLine2
city
,postalCode
, andstateOrRegion
.
Spain
-
You must specify the
registrationType
in thespainAdditionalInfo
field of theadditionalTaxInformation
object. -
If the
registrationType
isLocal
, you must specify the tax registration certificate document in thetaxRegistrationDocuments
field of theVerificationDetails
object.
Turkey
-
You must specify the
sector
in thetaxRegistrationEntry
object. -
If your
sector
isBusiness
,Individual
, orGovernment
:-
Specify the
taxOffice
. If yoursector
isIndividual
, don't enter this value. -
(Optional) Specify the
kepEmailId
. If yoursector
isIndividual
, don't enter this value. -
Note: In the Tax Settings page of the AWS Billing console,
Government
appears as Public institutions
-
-
If your
sector
isBusiness
and you're subject to KDV tax, you must specify your industry in theindustries
field. -
For
address
, you must specifydistrictOrCounty
.
Ukraine
-
The sector valid values are
Business
andIndividual
.
Request Syntax
POST /BatchPutTaxRegistration HTTP/1.1
Content-type: application/json
{
"accountIds": [ "string
" ],
"taxRegistrationEntry": {
"additionalTaxInformation": {
"canadaAdditionalInfo": {
"canadaQuebecSalesTaxNumber": "string
",
"canadaRetailSalesTaxNumber": "string
",
"isResellerAccount": boolean
,
"provincialSalesTaxId": "string
"
},
"estoniaAdditionalInfo": {
"registryCommercialCode": "string
"
},
"georgiaAdditionalInfo": {
"personType": "string
"
},
"israelAdditionalInfo": {
"customerType": "string
",
"dealerType": "string
"
},
"italyAdditionalInfo": {
"cigNumber": "string
",
"cupNumber": "string
",
"sdiAccountId": "string
",
"taxCode": "string
"
},
"kenyaAdditionalInfo": {
"personType": "string
"
},
"malaysiaAdditionalInfo": {
"businessRegistrationNumber": "string
",
"serviceTaxCodes": [ "string
" ],
"taxInformationNumber": "string
"
},
"polandAdditionalInfo": {
"individualRegistrationNumber": "string
",
"isGroupVatEnabled": boolean
},
"romaniaAdditionalInfo": {
"taxRegistrationNumberType": "string
"
},
"saudiArabiaAdditionalInfo": {
"taxRegistrationNumberType": "string
"
},
"southKoreaAdditionalInfo": {
"businessRepresentativeName": "string
",
"itemOfBusiness": "string
",
"lineOfBusiness": "string
"
},
"spainAdditionalInfo": {
"registrationType": "string
"
},
"turkeyAdditionalInfo": {
"industries": "string
",
"kepEmailId": "string
",
"secondaryTaxId": "string
",
"taxOffice": "string
"
},
"ukraineAdditionalInfo": {
"ukraineTrnType": "string
"
}
},
"certifiedEmailId": "string
",
"legalAddress": {
"addressLine1": "string
",
"addressLine2": "string
",
"addressLine3": "string
",
"city": "string
",
"countryCode": "string
",
"districtOrCounty": "string
",
"postalCode": "string
",
"stateOrRegion": "string
"
},
"legalName": "string
",
"registrationId": "string
",
"registrationType": "string
",
"sector": "string
",
"verificationDetails": {
"dateOfBirth": "string
",
"taxRegistrationDocuments": [
{
"file": {
"fileContent": blob
,
"fileName": "string
"
},
"s3Location": {
"bucket": "string
",
"key": "string
"
}
}
]
}
}
}
URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in JSON format.
- accountIds
-
List of unique account identifiers.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 5 items.
Length Constraints: Fixed length of 12.
Pattern:
^\d+$
Required: Yes
- taxRegistrationEntry
-
Your TRN information that will be stored to the accounts mentioned in
putEntries
.Type: TaxRegistrationEntry object
Required: Yes
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"errors": [
{
"accountId": "string",
"code": "string",
"message": "string"
}
],
"status": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- errors
-
List of errors for the accounts the TRN information could not be added or updated to.
Type: Array of BatchPutTaxRegistrationError objects
- status
-
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
orRejected
.Type: String
Valid Values:
Verified | Pending | Deleted | Rejected
Errors
For information about the errors that are common to all actions, see Common Errors.
- ConflictException
-
The exception when the input is creating conflict with the given state.
HTTP Status Code: 409
- InternalServerException
-
The exception thrown when an unexpected error occurs when processing a request.
HTTP Status Code: 500
- ValidationException
-
The exception when the input doesn't pass validation for at least one of the input parameters.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: