AA TECH E-Invoicing

AA Tech E-Invoicing API

This page documents Authentication and the /e-invoicing/api/ endpoint. Use Authorization: Bearer <access> for protected requests.

1) Authentication

Endpoint: /auth/jwt/create/ · Method: POST

{
  "username": "demo_user",
  "password": "demo_password_123"
}

2) Refresh Token

Endpoint: /auth/jwt/refresh/ · Method: POST

{
  "refresh": "<refresh-token>"
}

3) Verify Token

Endpoint: /auth/jwt/verify/ · Method: POST

{
  "token": "<access-or-refresh-token>"
}

4) E-Invoicing API

Endpoint: /e-invoicing/api/ · Method: POST

Allowed Task Values: "validate", "validate-iris", "submit"

{
  "task": "submit",
  "invoices": [ { ... } ]
}

AA Tech E-Invoicing API — Parameters & Allowed Values

Allowed values are pulled from the Excel Drop downs sheet and shown in expandable lists.

Field	Type	Required	Description	Allowed values (from Excel)
`Invoice Type`	string	Yes	Type of invoice	Debit Note, Sale Invoice
`Invoice Date`	string (YYYY-MM-DD)	Yes	Date of invoice
`Seller Business Name`	string	Yes	Seller name
`Seller Province`	string	Yes	Seller province	BALOCHISTAN, AZAD JAMMU AND KASHMIR, CAPITAL TERRITORY, KHYBER PAKHTUNKHWA, PUNJAB … Show 7 options BALOCHISTAN AZAD JAMMU AND KASHMIR CAPITAL TERRITORY KHYBER PAKHTUNKHWA PUNJAB SINDH GILGIT BALTISTAN
`Seller Address`	string	Yes	Seller address
`Seller NTN CNIC`	string	Yes	Seller NTN/CNIC
`Customer NTN CNIC`	string	Yes	Buyer NTN/CNIC
`Customer Business Name`	string	Yes	Buyer name
`Customer Province`	string	Yes	Buyer province	BALOCHISTAN, AZAD JAMMU AND KASHMIR, CAPITAL TERRITORY, KHYBER PAKHTUNKHWA, PUNJAB … Show 7 options BALOCHISTAN AZAD JAMMU AND KASHMIR CAPITAL TERRITORY KHYBER PAKHTUNKHWA PUNJAB SINDH GILGIT BALTISTAN
`Customer Address`	string	Yes	Buyer address
`Invoice Ref No`	string	Yes	Reference number
`Customer Registration Type`	string	Yes	Registered/Unregistered	Registered, Unregistered
`Scenario ID`	string	Yes	Scenario code
`HS Code`	string	Yes	HS code
`Product Description`	string	Yes	Item/service description
`Rate`	string	Yes	Tax rate	Exempt, 0%, 5%, 15%, 16% … Show 10 options Exempt 0% 5% 15% 16% 17% 18.5% 50/SqY 100/SqY Rs.1000
`UOM`	string	Yes	Unit of measurement	MT, Bill of lading, SET, KWH, 40KG … Show 32 options MT Bill of lading SET KWH 40KG Liter SqY Bag KG MMBTU Meter Pcs Carat Cubic Metre Dozen Gram Gallon Kilogram Pound Timber Logs Numbers, pieces, units Packs Pair Square Foot Square Metre Thousand Unit Mega Watt Foot Barrels NO Others 1000 kWh
`Quantity`	number	Yes	Quantity
`Total Values`	number	Yes	Total inc. tax
`Value Sales Excluding ST`	number	Yes	Net value
`Sales Tax Applicable`	number	Yes	Sales tax
`Fixed Notified Value Or Retail Price`	number	Optional	Retail/notified price
`Sales Tax Withheld At Source`	number	Optional	WHT sales tax
`Extra Tax`	number	Optional	Extra tax
`Further Tax`	number	Optional	Further tax
`SRO Schedule No`	string	Optional	SRO reference	237(I)/2020, 327(I)/2008, 3rd Schd Table II, 495(I)/2016, 587(I)/2017 … Show 33 options 237(I)/2020 327(I)/2008 3rd Schd Table II 495(I)/2016 587(I)/2017 590(I)/2017 6th Schd Table I 6th Schd Table II 6th Schd Table III EIGHTH SCHEDULE Table 1 EIGHTH SCHEDULE Table 2 FIFTH SCHEDULE NINTH SCHEDULE 1450(I)/2021 1579 (1)/2021 1604(I)/2021 01(I)/2022 88(I)/2022 183(I)/2022 SECTION 49 Section 4(b) ICTO ICTO TABLE I ICTO TABLE II 321(I)/2022 1212(I)/2018 1636(1)/2022 178(I)/2023 179(I)/2023 297(I)/2023-Table-I 297(I)/2023-Table-II 581(1)/2024 3rd Schedule goods
`FED Payable`	number	Optional	FED amount
`Discount`	number	Optional	Discount
`Sale Type`	string	Yes	Goods / Services	Goods at standard rate (default), Goods at Reduced Rate, Goods at zero-rate, Petroleum Products, Electricity Supply to Retailers … Show 26 options Goods at standard rate (default) Goods at Reduced Rate Goods at zero-rate Petroleum Products Electricity Supply to Retailers SIM Gas to CNG stations Mobile Phones Processing/Conversion of Goods 3rd Schedule Goods Goods (FED in ST Mode) Services (FED in ST Mode) Services Exempt goods DTRE goods Cotton ginners Electric Vehicle Cement /Concrete Block Telecommunication services Steel melting and re-rolling Ship breaking Potassium Chlorate CNG Sales Toll Manufacturing Non-Adjustable Supplies Goods as per SRO.297(\|)/2023
`SRO Item Serial No`	string	Optional	SRO item serial
`Seller Telephone/Mobile`	string	Optional	Seller contact
`Seller Email`	string	Optional	Seller email
`Seller STRN`	string	Optional	Seller STRN
`Invoice Month`	string	Optional	Invoice month	__Invoice Month__
`Delivery Region`	string	Optional	Region	BALOCHISTAN, AZAD JAMMU AND KASHMIR, CAPITAL TERRITORY, KHYBER PAKHTUNKHWA, PUNJAB … Show 7 options BALOCHISTAN AZAD JAMMU AND KASHMIR CAPITAL TERRITORY KHYBER PAKHTUNKHWA PUNJAB SINDH GILGIT BALTISTAN
`Due Date`	string (YYYY-MM-DD)	Optional	Due date
`Customer Telephone/Mobile`	string	Optional	Buyer contact
`Customer Email`	string	Optional	Buyer email
`Customer STRN`	string	Optional	Buyer STRN

5) Sample Request Body

Below is a full example of a valid submit request body with multiple invoices (same keys supported for validate / validate-iris).

{
  "task": "submit",
  "invoices": [
    {
      "Invoice Type": "Sale Invoice",
      "Invoice Date": "2025-10-05",
      "Seller Business Name": "AA TECH",
      "Seller Province": "CAPITAL TERRITORY",
      "Seller Address": "Rafi Centre  G 7/1 Islambad",
      "Seller NTN CNIC": 9629958,
      "Customer NTN CNIC": 4000412,
      "Customer Business Name": "JASB",
      "Customer Province": "CAPITAL TERRITORY",
      "Customer Address": "Rafi Centre  G 7/1 Islambad",
      "Invoice Ref No": "AAT-Test-20",
      "Customer Registration Type": "Registered",
      "Scenario ID": "SN019",
      "HS Code": "9805.0000",
      "Product Description": " -  - SERVICES PROVIDED OR RENDERED BY PERSONS AUTHORIZED TO TRANSACT BUSINESS ON BEHALF OF OTHERS.",
      "Rate": "16%",
      "UOM": "Numbers, pieces, units",
      "Quantity": 1,
      "Total Values": 116,
      "Value Sales Excluding ST": 100,
      "Sales Tax Applicable": 16,
      "Fixed Notified Value Or Retail Price": 116,
      "Sales Tax Withheld At Source": "0",
      "Extra Tax": 0,
      "Further Tax": "0",
      "SRO Schedule No": "327(I)/2008",
      "FED Payable": "0",
      "Discount": "0",
      "Sale Type": " Services ",
      "SRO Item Serial No": "",
      "Seller Telephone/Mobile": "+923315088140",
      "Seller Email": "info@auto-accounting.com",
      "Seller STRN": "3277876278938",
      "Invoice Month": "October-25",
      "Delivery Region": "CAPITAL TERRITORY",
      "Due Date": "2025-11-05",
      "Customer Telephone/Mobile": "+923315088140",
      "Customer Email": "info@jasb-associates.com",
      "Customer STRN": "3277876164720"
    }
  ]
}