Liberated Model – API Data Structures and Reference Data Help

Print This Post Print This Post

Data Structures

Taxpayer Profile

Sr. Name Description
1 Taxpayer registration No. Registration No. of taxpayer
2 Taxpayer Name Name of Taxpayer
3 Taxpayer Type Individual/AOP/Company
4 Accounting period Tax period of the taxpayer
5 Third Party ID Third party recognition ID
6 Third Party Registration No. Registration No of Third Party
7 Third Party Name Name of third party
8 Third Party Authorization Type Either is an authorized ‘Intermediary’ or ‘e-return Partner’
9 Third Party Software ID Recognition ID of third-party software
10 Medium Code To represent third party medium from which return has been submitted
11 EI Reg No. The registration No of the linked person as EI
12 EI Name Name of the linked person as EI
13 EI Type The type code of the EI

Return Validations

For Income Tax Return on submit of data by third party

Sr. Validation Condition  Description Taxpayer Type
1. Check weather income tax return for the tax year has already been filed or not. Either Previous transaction is drafted or submitted for the same tax year. This check verifies task already initiated for the selected year i.e. either the return task is in draft folder yet not completed or the task is already completed and submitted by the taxpayer. In case the application verification system finds an existing instance, it will not allow duplication or creation of same task again. All taxpayers
2. Statement of Assets / Liabilities must be filed Wealth Statement must be submitted It is a mandatory condition or prerequisite for submitting the tax return that the tax payer must have already submitted Statement of Assets/Wealth Statement. Individuals Only
3. Total Assets and Total Equity / Liabilities against Codes 3349 and 3399 must be entered. Details of assets and liabilities cannot be null Return filing with no data provided against the value of total assets and Liabilities is not allowed. This condition verifies null/empty fields against amount codes 3349 and 3399. For Business Individuals
4. Check whether amount code is allowed multiply entries or not Only amount codes configured for multiple entries shall be allowed Not all codes support multiple entries like taxpayer may add multiple bank accounts etc. The condition verifies multiple entries shall only be allowed if the relevant amount code allows. All taxpayers
5. Please select at least one business sector on Attributes Annexure Details of business sector must be selected in Attributes For return filing by business individuals, AOP, Company there must be at least one business sector selected by the tax payer. Taxpayer can select their respective business sector under attributes section. For Business Individuals, AOP, Company
6. Mandatory document in Attachment Tab must be entered. Mandatory documents must be attached The condition verifies all attachments provided against the required documents section. The section is known as Attachments and incase of any missing attachment against the desired document the taxpayer will not be able to complete the return filing process. AOP, Company

Amount Types

The income tax return is divided into the following types based on the input column labels.

Sr. Category Sub Category No. of Input Columns Column Labels Sample API Reference
1 Employment Salary 3 Total Amount_

 

Amount Exempt from Tax / Subject to Fixed / Final Tax_

 

Amount Subject to Normal Tax

Annex B
2 Property Receipts / Deductions 3 Total Amount_

 

Amount Exempt from Tax / Subject to Fixed / Final Tax_

 

Amount Subject to Normal Tax

Annex B
3 Business

 

Manufacturing / Trading Items, Other Revenues,

Management, Administrative, Selling & Financial Expenses,

Inadmissible / Admissible Deductions, Adjustments

3 Total Amount_

 

Amount Exempt from Tax / Subject to Fixed / Final Tax_

 

Amount Subject to Normal Tax

Annex B
Business Assets / Equity / Liabilities 1 Amount Annex B
Business Assets / Equity / Liabilities 2 Receipts, Payments Annex B
4 Capital Assets Capital Gains / (Loss),

Long Term, Short Term,

Adjustments

3 Total Amount,

Amount Exempt from Tax / Subject to Fixed / Final Tax,

Amount Subject to Normal Tax

 Annex B
5 Other Sources Receipts / Deductions 3 Total Amount,

Amount Exempt from Tax / Subject to Fixed / Final Tax,

Amount Subject to Normal Tax

 Annex B

 

 

6          Foreign Sources / Agriculture Foreign Sources 3 Total Amount,

Amount Exempt from Tax / Subject to Fixed / Final Tax,

Amount Subject to Normal Tax

Annex B
Agriculture 1 Amount Annex B
7 Tax Chargeable Deductible Allowances 3 Total, Inadmissible, Admissible Annex B

 

Tax Chargeable 1 Amount Annex B
 Tax Reductions 1 Amount Annex B
 Tax Credits 3  Eligible Amount, Ineligible Amount, Tax Credit Annex B
Adjustable Tax

 

 3  Receipts / Value, Tax Collected / Deducted, Tax Chargeable Annex B
Final / Fixed / Minimum / Average / Relevant / Reduced Tax 3 Receipts / Value, Tax Collected / Deducted, Tax Chargeable Annex B
Computations 3 Total Amount, Amount Exempt from Tax / Subject to Fixed / Final Tax, Amount Subject to Normal Tax Annex B
8 Amortization Amortization 4 WDV (BF), Remaining Useful Years,

Extent of Use,

Amortization

Annex B

 

9 Depreciation Depreciation 9 WDV (BF), Deletion, Addition (Used in Pakistan), Extent of Use, Addition (New), Extent of Use, Initial Allowance, Depreciation, WDV (CF) Annex B
10 Minimum Tax Minimum Tax Regime 6 Receipts / Value, Tax Collected / Deducted / Paid, Tax Chargeable, Attributable Taxable Income, Tax on Attributable Taxable Income, Difference of Minimum Tax Chargeable Annex B
11 Option out of PTR Option out of Final Tax Regime 6 Receipts / Value Tax, Collected / Deducted / Paid, Tax Chargeable, Attributable Taxable Income, Tax on Attributable Taxable Income, Difference (Option Valid if <=0) Annex B
12

 

 

Personal Assets / Liabilities /

 

Personal Assets / Liabilities 1 Amount Annex B
Personal Expenses 1 Amount Annex B
Reconciliation of Net Assets 1 Amount Annex B

Amount Code Data Details(Reference Data)

Reference Data Types

Reference Code Description Detail Reference
35 Property Property Dialog
35 Investment Investment Dialog
35 Vehicle Vehicle Dialog
35 Utility Utility Dialog
35 Precious Possession Precious possession Dialog
35 Debtor / Creditor Debtor Dialog
16 Contents Contents Dialog
13 Business Capital Business Capital Dialog

Referential Data Details

Property Details

All third party users shall enter structured input against specific amount codes related to property in the below mentioned format.

The property details shall contain the following inputs:

  • <Property> – (Address of property)
  • <Contents> – (Type, Area, City, etc.)

All third parties shall be required to provide structured input for property details as mentioned above to be saved along with value and tax deducted / collected information.

Investment Details

All third party users shall enter structured input against specific amount codes related to investment in the below mentioned format.

The investment details shall contain the following inputs:

  • <Investment> – (IBAN/ IBFT No.)
  • <Contents> – (Bank Name, Account Type, Branch Address, etc.)

All third parties shall be required to provide structured input for investment details as mentioned above to be saved along with value and tax deducted / collected information.

Vehicle Details

All third party users shall enter structured input against specific amount codes related to vehicle in the below mentioned format.

The vehicle details shall contain the following inputs:

  • <Vehicle> – (Registration No.)
  • <Contents> – (Make, Model, etc.)

All third parties shall be required to provide structured input for vehicle details as mentioned above to be saved along with value and tax deducted / collected information.

Utility Details

All third party users shall enter structured input against specific amount codes related to utility in the below mentioned format.

The utility details shall contain the following inputs:

  • <Utility> – (Reference No.)
  • <Contents> – (Type, Form, Connection date, etc.)

All third parties shall be required to provide structured input for utility details as mentioned above to be saved along with value and tax deducted / collected information.

Precious Possessions Details

All third party users shall enter structured input against specific amount codes related to precious possessions in the below mentioned format.

The precious possessions details shall contain the following inputs:

  • < precious possessions> – (Nature of Asset)
  • <Contents> – (Quantity, type, Form, etc.)

All third parties shall be required to provide structured input for precious possessions details as mentioned above to be saved along with value information.

Debt Details

All third party users shall enter structured input against specific amount codes related to debt in the below mentioned format.

The debt details shall contain the following inputs:

  • <Debtor> – (Reg no. / Name of Debtor)
  • <Contents> – (Type of Account, etc.)

All third parties shall be required to provide structured input for debt details as mentioned above to be saved along with value information.

Contents Details

All third party users shall enter structured input against specific amount codes related to general contents in the below mentioned format.

The contents details shall contain the following inputs:

  • <Contents>

All third parties shall be required to provide structured input for contents details as mentioned above to be saved along with value and tax deducted / collected information.

Business Capital Details

All third party users shall enter structured input against specific amount codes related to business capital in the below mentioned format.

The utility details shall contain the following inputs:

  • <Business Name>

All third parties shall be required to provide structured input for business capital details as mentioned above to be saved along with value and tax deducted / collected information.

Structured Attributes

Business Sector Details

All third party users shall enter structured input against specific attributes. The current Iris System has the following structured input parameters for the mentioned attribute.

The system shall only allow a single selection from the LOV for list of business sectors. Click here to view the list of business sectors.

Residence Status

All third party users shall enter structured input against specific attributes. The current Iris System has the following structured input parameters for the mentioned attribute.

The system shall only allow a single selection from the below mentioned LOV list of options.

Attribute Value  Code Attribute Value Description
14 Small Company
21 Non_Resident

Professional AOP Details

All third party users shall enter structured input against specific attributes. The current Iris System has the following structured input parameters for the mentioned attribute.

The system shall only allow a single selection from the below mentioned LOV list of options.

Attribute Value  Code Attribute Value Description
221 Yes
222 No

Person Status Details

All third party users shall enter structured input against specific attributes. The current Iris System has the following structured input parameters for the mentioned attribute.

The system shall only allow a single selection from the below mentioned LOV list of business sectors.

Attribute Value  Code Attribute Value Description
11 Private Company
12 Public Listed Company
13 Public Non-Listed Company
14 Small Company

Click here to view detail Amount Code for Tax Return – 2018.

Click on the following links to view related articles for Liberated Model:

Technical Support:

 

Leave a Reply

Your email address will not be published. Required fields are marked *

5 × 2 =