feat(client-taxsettings): Add support for supplemental tax registrati…

…ons via these new APIs: PutSupplementalTaxRegistration, ListSupplementalTaxRegistrations, and DeleteSupplementalTaxRegistration.
aws · Nov 1, 2024 · 23a1507 · 23a1507
1 parent 3fc175f
commit 23a1507
Show file tree

Hide file tree

Showing 16 changed files with 1,336 additions and 49 deletions.
diff --git a/clients/client-taxsettings/README.md b/clients/client-taxsettings/README.md
@@ -21,7 +21,7 @@ the console.</p>
 
 ## Installing
 
-To install the this package, simply type add or install @aws-sdk/client-taxsettings
+To install this package, simply type add or install @aws-sdk/client-taxsettings
 using your favorite package manager:
 
 - `npm install @aws-sdk/client-taxsettings`
@@ -229,6 +229,14 @@ BatchPutTaxRegistration
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/BatchPutTaxRegistrationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/BatchPutTaxRegistrationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/BatchPutTaxRegistrationCommandOutput/)
 
+</details>
+<details>
+<summary>
+DeleteSupplementalTaxRegistration
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/DeleteSupplementalTaxRegistrationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/DeleteSupplementalTaxRegistrationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/DeleteSupplementalTaxRegistrationCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -253,6 +261,14 @@ GetTaxRegistrationDocument
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/GetTaxRegistrationDocumentCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/GetTaxRegistrationDocumentCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/GetTaxRegistrationDocumentCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListSupplementalTaxRegistrations
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/ListSupplementalTaxRegistrationsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/ListSupplementalTaxRegistrationsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/ListSupplementalTaxRegistrationsCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -261,6 +277,14 @@ ListTaxRegistrations
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/ListTaxRegistrationsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/ListTaxRegistrationsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/ListTaxRegistrationsCommandOutput/)
 
+</details>
+<details>
+<summary>
+PutSupplementalTaxRegistration
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/taxsettings/command/PutSupplementalTaxRegistrationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/PutSupplementalTaxRegistrationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-taxsettings/Interface/PutSupplementalTaxRegistrationCommandOutput/)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-taxsettings/src/TaxSettings.ts b/clients/client-taxsettings/src/TaxSettings.ts
@@ -12,6 +12,11 @@ import {
   BatchPutTaxRegistrationCommandInput,
   BatchPutTaxRegistrationCommandOutput,
 } from "./commands/BatchPutTaxRegistrationCommand";
+import {
+  DeleteSupplementalTaxRegistrationCommand,
+  DeleteSupplementalTaxRegistrationCommandInput,
+  DeleteSupplementalTaxRegistrationCommandOutput,
+} from "./commands/DeleteSupplementalTaxRegistrationCommand";
 import {
   DeleteTaxRegistrationCommand,
   DeleteTaxRegistrationCommandInput,
@@ -27,11 +32,21 @@ import {
   GetTaxRegistrationDocumentCommandInput,
   GetTaxRegistrationDocumentCommandOutput,
 } from "./commands/GetTaxRegistrationDocumentCommand";
+import {
+  ListSupplementalTaxRegistrationsCommand,
+  ListSupplementalTaxRegistrationsCommandInput,
+  ListSupplementalTaxRegistrationsCommandOutput,
+} from "./commands/ListSupplementalTaxRegistrationsCommand";
 import {
   ListTaxRegistrationsCommand,
   ListTaxRegistrationsCommandInput,
   ListTaxRegistrationsCommandOutput,
 } from "./commands/ListTaxRegistrationsCommand";
+import {
+  PutSupplementalTaxRegistrationCommand,
+  PutSupplementalTaxRegistrationCommandInput,
+  PutSupplementalTaxRegistrationCommandOutput,
+} from "./commands/PutSupplementalTaxRegistrationCommand";
 import {
   PutTaxRegistrationCommand,
   PutTaxRegistrationCommandInput,
@@ -42,10 +57,13 @@ import { TaxSettingsClient, TaxSettingsClientConfig } from "./TaxSettingsClient"
 const commands = {
   BatchDeleteTaxRegistrationCommand,
   BatchPutTaxRegistrationCommand,
+  DeleteSupplementalTaxRegistrationCommand,
   DeleteTaxRegistrationCommand,
   GetTaxRegistrationCommand,
   GetTaxRegistrationDocumentCommand,
+  ListSupplementalTaxRegistrationsCommand,
   ListTaxRegistrationsCommand,
+  PutSupplementalTaxRegistrationCommand,
   PutTaxRegistrationCommand,
 };
 
@@ -84,6 +102,23 @@ export interface TaxSettings {
     cb: (err: any, data?: BatchPutTaxRegistrationCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DeleteSupplementalTaxRegistrationCommand}
+   */
+  deleteSupplementalTaxRegistration(
+    args: DeleteSupplementalTaxRegistrationCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DeleteSupplementalTaxRegistrationCommandOutput>;
+  deleteSupplementalTaxRegistration(
+    args: DeleteSupplementalTaxRegistrationCommandInput,
+    cb: (err: any, data?: DeleteSupplementalTaxRegistrationCommandOutput) => void
+  ): void;
+  deleteSupplementalTaxRegistration(
+    args: DeleteSupplementalTaxRegistrationCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DeleteSupplementalTaxRegistrationCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DeleteTaxRegistrationCommand}
    */
@@ -137,6 +172,24 @@ export interface TaxSettings {
     cb: (err: any, data?: GetTaxRegistrationDocumentCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListSupplementalTaxRegistrationsCommand}
+   */
+  listSupplementalTaxRegistrations(): Promise<ListSupplementalTaxRegistrationsCommandOutput>;
+  listSupplementalTaxRegistrations(
+    args: ListSupplementalTaxRegistrationsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListSupplementalTaxRegistrationsCommandOutput>;
+  listSupplementalTaxRegistrations(
+    args: ListSupplementalTaxRegistrationsCommandInput,
+    cb: (err: any, data?: ListSupplementalTaxRegistrationsCommandOutput) => void
+  ): void;
+  listSupplementalTaxRegistrations(
+    args: ListSupplementalTaxRegistrationsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListSupplementalTaxRegistrationsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListTaxRegistrationsCommand}
    */
@@ -155,6 +208,23 @@ export interface TaxSettings {
     cb: (err: any, data?: ListTaxRegistrationsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link PutSupplementalTaxRegistrationCommand}
+   */
+  putSupplementalTaxRegistration(
+    args: PutSupplementalTaxRegistrationCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<PutSupplementalTaxRegistrationCommandOutput>;
+  putSupplementalTaxRegistration(
+    args: PutSupplementalTaxRegistrationCommandInput,
+    cb: (err: any, data?: PutSupplementalTaxRegistrationCommandOutput) => void
+  ): void;
+  putSupplementalTaxRegistration(
+    args: PutSupplementalTaxRegistrationCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: PutSupplementalTaxRegistrationCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link PutTaxRegistrationCommand}
    */

diff --git a/clients/client-taxsettings/src/TaxSettingsClient.ts b/clients/client-taxsettings/src/TaxSettingsClient.ts
@@ -61,6 +61,10 @@ import {
   BatchPutTaxRegistrationCommandInput,
   BatchPutTaxRegistrationCommandOutput,
 } from "./commands/BatchPutTaxRegistrationCommand";
+import {
+  DeleteSupplementalTaxRegistrationCommandInput,
+  DeleteSupplementalTaxRegistrationCommandOutput,
+} from "./commands/DeleteSupplementalTaxRegistrationCommand";
 import {
   DeleteTaxRegistrationCommandInput,
   DeleteTaxRegistrationCommandOutput,
@@ -70,10 +74,18 @@ import {
   GetTaxRegistrationDocumentCommandInput,
   GetTaxRegistrationDocumentCommandOutput,
 } from "./commands/GetTaxRegistrationDocumentCommand";
+import {
+  ListSupplementalTaxRegistrationsCommandInput,
+  ListSupplementalTaxRegistrationsCommandOutput,
+} from "./commands/ListSupplementalTaxRegistrationsCommand";
 import {
   ListTaxRegistrationsCommandInput,
   ListTaxRegistrationsCommandOutput,
 } from "./commands/ListTaxRegistrationsCommand";
+import {
+  PutSupplementalTaxRegistrationCommandInput,
+  PutSupplementalTaxRegistrationCommandOutput,
+} from "./commands/PutSupplementalTaxRegistrationCommand";
 import { PutTaxRegistrationCommandInput, PutTaxRegistrationCommandOutput } from "./commands/PutTaxRegistrationCommand";
 import {
   ClientInputEndpointParameters,
@@ -92,10 +104,13 @@ export { __Client };
 export type ServiceInputTypes =
   | BatchDeleteTaxRegistrationCommandInput
   | BatchPutTaxRegistrationCommandInput
+  | DeleteSupplementalTaxRegistrationCommandInput
   | DeleteTaxRegistrationCommandInput
   | GetTaxRegistrationCommandInput
   | GetTaxRegistrationDocumentCommandInput
+  | ListSupplementalTaxRegistrationsCommandInput
   | ListTaxRegistrationsCommandInput
+  | PutSupplementalTaxRegistrationCommandInput
   | PutTaxRegistrationCommandInput;
 
 /**
@@ -104,10 +119,13 @@ export type ServiceInputTypes =
 export type ServiceOutputTypes =
   | BatchDeleteTaxRegistrationCommandOutput
   | BatchPutTaxRegistrationCommandOutput
+  | DeleteSupplementalTaxRegistrationCommandOutput
   | DeleteTaxRegistrationCommandOutput
   | GetTaxRegistrationCommandOutput
   | GetTaxRegistrationDocumentCommandOutput
+  | ListSupplementalTaxRegistrationsCommandOutput
   | ListTaxRegistrationsCommandOutput
+  | PutSupplementalTaxRegistrationCommandOutput
   | PutTaxRegistrationCommandOutput;
 
 /**

diff --git a/clients/client-taxsettings/src/commands/BatchPutTaxRegistrationCommand.ts b/clients/client-taxsettings/src/commands/BatchPutTaxRegistrationCommand.ts
@@ -85,26 +85,27 @@ export interface BatchPutTaxRegistrationCommandOutput extends BatchPutTaxRegistr
  *          </p>
  *          <ul>
  *             <li>
- *                <p>If you use this operation to set a tax registration number (TRN) in Malaysia, only
- *           resellers with a valid sales and service tax (SST) number are required to provide tax
- *           registration information.</p>
+ *                <p>The sector valid values are <code>Business</code> and <code>Individual</code>.</p>
  *             </li>
  *             <li>
- *                <p>By using this API operation to set a TRN in Malaysia, Amazon Web Services will regard you as
- *           self-declaring that you're an authorized business reseller registered with the Royal
- *           Malaysia Customs Department (RMCD) and have a valid SST number.</p>
+ *                <p>
+ *                   <code>RegistrationType</code> valid values are <code>NRIC</code> for individual, and TIN and sales and service tax (SST) for Business.</p>
  *             </li>
  *             <li>
- *                <p>Amazon Web Services reserves the right to seek additional information and/or take other actions to
- *           support your self-declaration as appropriate.</p>
+ *                <p>For individual, you can specify the <code>taxInformationNumber</code> in <code>MalaysiaAdditionalInfo</code> with NRIC type, and a valid <code>MyKad</code> or NRIC number.</p>
+ *             </li>
+ *             <li>
+ *                <p>For business, you must specify a <code>businessRegistrationNumber</code> in <code>MalaysiaAdditionalInfo</code> with a TIN type and tax identification number.</p>
  *             </li>
  *             <li>
- *                <p>If you're not a reseller of Amazon Web Services, we don't recommend that you use
- *           this operation to set the TRN in Malaysia.</p>
+ *                <p>For business resellers, you must specify a <code>businessRegistrationNumber</code> and <code>taxInformationNumber</code> in <code>MalaysiaAdditionalInfo</code> with a sales and service tax (SST) type and a valid SST number.</p>
  *             </li>
  *             <li>
- *                <p>Only use this API operation to upload the TRNs for accounts through which you're
- *           reselling Amazon Web Services.</p>
+ *                <p>For business resellers with service codes, you must specify <code>businessRegistrationNumber</code>, <code>taxInformationNumber</code>, and distinct <code>serviceTaxCodes</code> in <code>MalaysiaAdditionalInfo</code> 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.</p>
+ *             </li>
+ *             <li>
+ *                <p>Amazon Web Services reserves the right to seek additional information and/or take other actions to
+ *           support your self-declaration as appropriate.</p>
  *             </li>
  *             <li>
  *                <p>Amazon Web Services is currently registered under the following service tax codes. You must include
@@ -227,7 +228,7 @@ export interface BatchPutTaxRegistrationCommandOutput extends BatchPutTaxRegistr
  *   ],
  *   taxRegistrationEntry: { // TaxRegistrationEntry
  *     registrationId: "STRING_VALUE", // required
- *     registrationType: "VAT" || "GST" || "CPF" || "CNPJ" || "SST", // required
+ *     registrationType: "VAT" || "GST" || "CPF" || "CNPJ" || "SST" || "TIN" || "NRIC", // required
  *     legalName: "STRING_VALUE",
  *     legalAddress: { // Address
  *       addressLine1: "STRING_VALUE", // required
@@ -242,9 +243,11 @@ export interface BatchPutTaxRegistrationCommandOutput extends BatchPutTaxRegistr
  *     sector: "Business" || "Individual" || "Government",
  *     additionalTaxInformation: { // AdditionalInfoRequest
  *       malaysiaAdditionalInfo: { // MalaysiaAdditionalInfo
- *         serviceTaxCodes: [ // MalaysiaServiceTaxCodesList // required
+ *         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