:doc:`TaxSettings <../../taxsettings>` / Client / put_supplemental_tax_registration

*********************************
put_supplemental_tax_registration
*********************************



.. py:method:: TaxSettings.Client.put_supplemental_tax_registration(**kwargs)

  

  Stores supplemental tax registration for a single account.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/taxsettings-2018-05-10/PutSupplementalTaxRegistration>`_  


  **Request Syntax**
  ::

    response = client.put_supplemental_tax_registration(
        taxRegistrationEntry={
            'address': {
                'addressLine1': 'string',
                'addressLine2': 'string',
                'addressLine3': 'string',
                'city': 'string',
                'countryCode': 'string',
                'districtOrCounty': 'string',
                'postalCode': 'string',
                'stateOrRegion': 'string'
            },
            'legalName': 'string',
            'registrationId': 'string',
            'registrationType': 'VAT'
        }
    )
    
  :type taxRegistrationEntry: dict
  :param taxRegistrationEntry: **[REQUIRED]** 

    The supplemental TRN information that will be stored for the caller account ID.

    

  
    - **address** *(dict) --* **[REQUIRED]** 

      The details of the address associated with the TRN information.

      

    
      - **addressLine1** *(string) --* **[REQUIRED]** 

        The first line of the address.

        

      
      - **addressLine2** *(string) --* 

        The second line of the address, if applicable.

        

      
      - **addressLine3** *(string) --* 

        The third line of the address, if applicable. Currently, the Tax Settings API accepts the ``addressLine3`` parameter only for Saudi Arabia. When you specify a TRN in Saudi Arabia, you must enter the ``addressLine3`` and specify the building number for the address. For example, you might enter ``1234``.

        

      
      - **city** *(string) --* **[REQUIRED]** 

        The city that the address is in.

        

      
      - **countryCode** *(string) --* **[REQUIRED]** 

        The country code for the country that the address is in.

        

      
      - **districtOrCounty** *(string) --* 

        The district or county the address is located.

         

        .. note::

          

          For addresses in Brazil, this parameter uses the name of the neighborhood. When you set a TRN in Brazil, use ``districtOrCounty`` for the neighborhood name.

          

        

      
      - **postalCode** *(string) --* **[REQUIRED]** 

        The postal code associated with the address.

        

      
      - **stateOrRegion** *(string) --* 

        The state, region, or province that the address is located. This field is only required for Canada, India, United Arab Emirates, Romania, and Brazil (CPF). It is optional for all other countries.

         

        If this is required for tax settings, use the same name as shown on the **Tax Settings** page.

        

      
    
    - **legalName** *(string) --* **[REQUIRED]** 

      The legal name associated with your TRN registration.

      

    
    - **registrationId** *(string) --* **[REQUIRED]** 

      The supplemental TRN unique identifier.

      

    
    - **registrationType** *(string) --* **[REQUIRED]** 

      Type of supplemental TRN. Currently, this can only be VAT.

      

    
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'authorityId': 'string',
          'status': 'Verified'|'Pending'|'Deleted'|'Rejected'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **authorityId** *(string) --* 

        Unique authority ID for the supplemental TRN information that was stored.

        
      

      - **status** *(string) --* 

        The status of the supplemental TRN stored in the system after processing. Based on the validation occurring on the TRN, the status can be ``Verified``, ``Pending``, ``Rejected``, or ``Deleted``.

        
  
  **Exceptions**
  
  *   :py:class:`TaxSettings.Client.exceptions.ValidationException`

  
  *   :py:class:`TaxSettings.Client.exceptions.ConflictException`

  
  *   :py:class:`TaxSettings.Client.exceptions.InternalServerException`

  