> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Save GSTR-9

> Save the GSTR-9 with the required data across tables including outward supplies, input tax credits (ITC), and tax payments for the financial year with the GST department.

#### Request body schema

<Card title="View request body schema" icon="code" href="https://raw.githubusercontent.com/in-co-sandbox/in-co-sandbox-docs/refs/heads/main/data/gst/schema/request/taxpayer/gstr-9/save.json" arrow="true" horizontal />

<Card title="View request body schema" icon="file-spreadsheet" href="https://raw.githubusercontent.com/in-co-sandbox/in-co-sandbox-docs/refs/heads/main/data/gst/schema/workbook/taxpayer/gstr-9/save-v1.3.xlsx" arrow="true" horizontal />


## OpenAPI

````yaml api-reference/gst/compliance/openapi.json POST /gst/compliance/tax-payer/gstrs/gstr-9/save
openapi: 3.0.1
info:
  title: compliance
  description: >-
    **GST Compliance API** enables businesses to automate compliance
    requirements like [Taxpayer
    verification](https://developer.sandbox.co.in/reference/search-gstin-api),
    [GSTR
    Filing](https://developer.sandbox.co.in/reference/gst-taxpayer-authentication),
    [Generating
    E-Invoices](https://developer.sandbox.co.in/reference/e-invoice-authentication-api),
    and [E-Way
    Bills](https://developer.sandbox.co.in/reference/e-way-bill-authentication-api).We
    provide these APIs from GSTN-authorised GST Suvidha Providers, handling the
    encryption-decryption and signing so you don't have to handle the
    complexities.
  version: 1.0.0
servers:
  - url: https://api.sandbox.co.in
  - url: https://test-api.sandbox.co.in
security: []
tags:
  - name: Public
  - name: Taxpayer
  - name: Taxpayer Auth
  - name: Returns
  - name: GSTR-1 Documents
  - name: File GSTR-1
  - name: GSTR-2A Documents
  - name: GSTR-2B Document
  - name: File GSTR-3B
  - name: GSTR-4
  - name: File GSTR-9
  - name: Invoice Management System
  - name: GSTR-1A Documents
  - name: File GSTR-1A
  - name: Ledgers
  - name: e-Invoice
  - name: Sales e-Invoices for return period
  - name: Purchase e-Invoices for return period
  - name: Front Office Notices
  - name: Front Office
  - name: AATO
  - name: e-Invoice1
  - name: Authentication
  - name: e-Invoice12
  - name: E-Way Bill
  - name: E-Way Bill1
  - name: Authentication1
  - name: Consignor
  - name: Consolidated E-Way Bill
  - name: Multi-Vehicle Movement
  - name: Consignee
  - name: Transporter
  - name: Consolidated E-Way Bill1
  - name: Multi-vehicle Movement
  - name: Common
paths:
  /gst/compliance/tax-payer/gstrs/gstr-9/save:
    post:
      tags:
        - Taxpayer
        - Returns
        - File GSTR-9
      summary: Save GSTR-9
      operationId: saveGstr9
      parameters:
        - name: financial_year
          in: query
          description: Financial year. E.g., FY 2023-24
          required: true
          schema:
            type: string
            example: '{{financial_year}}'
        - name: authorization
          in: header
          description: >-
            GST taxpayer access token. For token-generation steps, refer to the
            [Generate Taxpayer
            Session](/recipes/gst/authentication/generate_tax_payer_session)
            recipe, then pass the token in the authorization header.
          required: true
          example: ''
          schema:
            type: string
        - name: x-api-key
          in: header
          description: API key for identification
          required: true
          example: ''
          schema:
            type: string
        - name: x-api-version
          in: header
          description: API version
          required: false
          example: ''
          schema:
            type: string
            default: 1.0.0
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveGstr9Request'
            examples:
              GSTR-1/GSTR-3B not filed:
                value:
                  fp: '032024'
                  table4:
                    b2c:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    b2b:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    exp:
                      txval: 1000
                      iamt: 20
                      csamt: 20
                    sez:
                      txval: 1000
                      iamt: 20
                      csamt: 20
                    deemed:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    at:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rchrg:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    cr_nt:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    dr_nt:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    amd_pos:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    amd_neg:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                  table5:
                    zero_rtd:
                      txval: 1000
                    sez:
                      txval: 1000
                    rchrg:
                      txval: 1000
                    exmt:
                      txval: 1000
                    nil:
                      txval: 1000
                    non_gst:
                      txval: 1000
                    cr_nt:
                      txval: 1000
                    dr_nt:
                      txval: 1000
                    amd_pos:
                      txval: 1000
                    amd_neg:
                      txval: 1000
                  table6:
                    supp_non_rchrg:
                      - itc_typ: ip
                        iamt: 20
                        camt: 20
                        samt: 20
                        csamt: 20
                    supp_rchrg_unreg:
                      - itc_typ: ip
                        iamt: 20
                        camt: 20
                        samt: 20
                        csamt: 20
                    supp_rchrg_reg:
                      - itc_typ: ip
                        iamt: 20
                        camt: 20
                        samt: 20
                        csamt: 20
                    iog:
                      - itc_typ: ip
                        iamt: 20
                        csamt: 20
                    ios:
                      iamt: 20
                      csamt: 20
                    isd:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    itc_clmd:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    tran1:
                      camt: 20
                      samt: 20
                    tran2:
                      camt: 20
                      samt: 20
                    other:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                  table7:
                    rule37:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rule39:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rule42:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rule43:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    sec17:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    revsl_tran1:
                      camt: 20
                      samt: 20
                    revsl_tran2:
                      camt: 20
                      samt: 20
                    other:
                      - desc: other1
                        iamt: 20
                        camt: 20
                        samt: 20
                        csamt: 20
                  table8:
                    itc_inwd_supp:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    itc_nt_availd:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    itc_nt_eleg:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    iog_taxpaid:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                  table9:
                    iamt:
                      txpyble: 1000
                    camt:
                      txpyble: 1000
                    samt:
                      txpyble: 1000
                    csamt:
                      txpyble: 1000
                    intr:
                      txpyble: 1000
                    fee:
                      txpyble: 1000
                    pen:
                      txpyble: 1000
                    other:
                      txpyble: 1000
                  table10:
                    itc_availd:
                      csamt: 20
                      samt: 20
                      camt: 20
                      iamt: 20
                    itc_rvsl:
                      csamt: 20
                      samt: 20
                      camt: 20
                      iamt: 20
                    dbn_amd:
                      csamt: 20
                      samt: 20
                      txval: 1000
                      camt: 20
                      iamt: 20
                    cdn_amd:
                      csamt: 20
                      samt: 20
                      txval: 1000
                      camt: 20
                      iamt: 20
                  table14:
                    iamt:
                      txpyble: 1000
                      txpaid: 1000
                    camt:
                      txpyble: 1000
                      txpaid: 1000
                    samt:
                      txpyble: 1000
                      txpaid: 1000
                    csamt:
                      txpyble: 1000
                      txpaid: 1000
                    intr:
                      txpyble: 1000
                      txpaid: 1000
                  table15:
                    rfd_clmd:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rfd_sanc:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rfd_rejt:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    rfd_pend:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    tax_dmnd:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                      intr: 20
                      fee: 20
                      pen: 20
                    tax_paid:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                      intr: 20
                      fee: 20
                      pen: 20
                    dmnd_pend:
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                      intr: 20
                      fee: 20
                      pen: 20
                  table16:
                    comp_supp:
                      txval: 1000
                    deemed_supp:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                    not_returned:
                      txval: 1000
                      iamt: 20
                      camt: 20
                      samt: 20
                      csamt: 20
                  table17:
                    items:
                      - hsn_sc: '99'
                        txval: 10000
                        isconcesstional: 'N'
                        rt: 5
                        iamt: 0
                        camt: 250
                        samt: 250
                        csamt: 0
                      - hsn_sc: '995411'
                        txval: 10000
                        isconcesstional: 'N'
                        rt: 5
                        iamt: 0
                        camt: 250
                        samt: 250
                        csamt: 0
                      - hsn_sc: '4502'
                        uqc: BDL
                        qty: 1
                        txval: 10000
                        isconcesstional: 'N'
                        rt: 5
                        iamt: 0
                        camt: 250
                        samt: 250
                        csamt: 500
                  table18:
                    items:
                      - hsn_sc: '1203'
                        uqc: BAL
                        qty: 1
                        txval: 10000
                        isconcesstional: 'N'
                        rt: 5
                        iamt: 0
                        camt: 250
                        samt: 250
                        csamt: 0
                      - hsn_sc: '999900'
                        txval: 10000
                        isconcesstional: 'N'
                        rt: 5
                        iamt: 0
                        camt: 250
                        samt: 250
                        csamt: 0
                summary: GSTR-1/GSTR-3B not filed
              200 Success:
                value:
                  table4:
                    b2c:
                      csamt: 0
                      samt: 33512.24
                      txval: 32048951.84
                      camt: 33512.24
                      iamt: 5701789.17
                    b2b:
                      csamt: 0
                      samt: 222404.68
                      txval: 2754408.56
                      camt: 222404.68
                      iamt: 50984.24
                    cr_nt:
                      csamt: 0
                      samt: 8.76
                      txval: 426388.99
                      camt: 8.76
                      iamt: 76732.5
                  fp: '032024'
                  table9:
                    samt:
                      txpyble: 255908
                    fee:
                      txpyble: 50
                    camt:
                      txpyble: 255908
                    iamt:
                      txpyble: 5711375
                  table6:
                    supp_non_rchrg:
                      - itc_typ: cg
                        iamt: 16745.52
                        camt: 782.55
                        samt: 782.55
                        csamt: 0
                      - itc_typ: is
                        iamt: 810052.26
                        camt: 169159.01
                        samt: 169159.01
                        csamt: 0
                  table17:
                    items:
                      - hsn_sc: '998232'
                        txval: 34376971.41
                        isconcesstional: 'N'
                        rt: 18
                        iamt: 5676040.91
                        camt: 255908.16
                        samt: 255908.16
                        csamt: 0
                summary: 200 Success
        required: true
      responses:
        '200':
          description: GSTR-1/GSTR-3B not filed / 200 Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveGstr9Response'
              examples:
                GSTR-1/GSTR-3B not filed:
                  summary: GSTR-1/GSTR-3B not filed
                  value:
                    code: 200
                    data:
                      status_cd: '0'
                      error:
                        error_cd: RT-9AS-1008
                        message: >-
                          To file your annual return, filing of all applicable
                          returns/statements (GSTR-1 and GSTR-3B) are mandatory.
                          File your pending applicable return(s)/ statement(s)
                          and try again.
                    timestamp: 1763446641000
                    transaction_id: 2b3e8972-1486-48fd-ad85-4181d568633b
                200 Success:
                  summary: 200 Success
                  value:
                    code: 200
                    data:
                      status_cd: '1'
                      data:
                        reference_id: 3f0b7b96-2c56-4e34-a025-03c3577a8468
                    timestamp: 1734691818000
                    transaction_id: fab4bf0e-0e9a-44d2-8373-2f5e85e63edf
          headers: {}
      deprecated: false
      security: []
components:
  schemas:
    SaveGstr9Request:
      type: object
      description: Public request body for Save Gstr9.
      properties:
        fp:
          type: string
          description: The fp value provided in the request.
        table4:
          type: object
          description: The table4 value provided in the request.
          properties:
            b2c:
              type: object
              description: The b2c value provided in the request.
              properties:
                txval:
                  type: number
                  description: The txval value provided in the request.
                iamt:
                  type: number
                  description: The iamt value provided in the request.
                camt:
                  type: number
                  description: The camt value provided in the request.
                samt:
                  type: number
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            b2b:
              type: object
              description: The b2b value provided in the request.
              properties:
                txval:
                  type: number
                  description: The txval value provided in the request.
                iamt:
                  type: number
                  description: The iamt value provided in the request.
                camt:
                  type: number
                  description: The camt value provided in the request.
                samt:
                  type: number
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            exp:
              type: object
              description: The exp value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            sez:
              type: object
              description: The sez value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            deemed:
              type: object
              description: The deemed value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            at:
              type: object
              description: The at value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rchrg:
              type: object
              description: The rchrg value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            cr_nt:
              type: object
              description: The cr nt value provided in the request.
              properties:
                txval:
                  type: number
                  description: The txval value provided in the request.
                iamt:
                  type: number
                  description: The iamt value provided in the request.
                camt:
                  type: number
                  description: The camt value provided in the request.
                samt:
                  type: number
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            dr_nt:
              type: object
              description: The dr nt value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            amd_pos:
              type: object
              description: The amd pos value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            amd_neg:
              type: object
              description: The amd neg value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
        table5:
          type: object
          description: The table5 value provided in the request.
          properties:
            zero_rtd:
              type: object
              description: The zero rtd value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            sez:
              type: object
              description: The sez value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            rchrg:
              type: object
              description: The rchrg value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            exmt:
              type: object
              description: The exmt value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            nil:
              type: object
              description: The nil value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            non_gst:
              type: object
              description: The non gst value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            cr_nt:
              type: object
              description: The cr nt value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            dr_nt:
              type: object
              description: The dr nt value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            amd_pos:
              type: object
              description: The amd pos value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            amd_neg:
              type: object
              description: The amd neg value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
        table6:
          type: object
          description: The table6 value provided in the request.
          properties:
            supp_non_rchrg:
              type: array
              description: The supp non rchrg value provided in the request.
              items:
                type: object
                properties:
                  itc_typ:
                    type: string
                    description: The itc typ value provided in the request.
                  iamt:
                    type: number
                    description: The iamt value provided in the request.
                  camt:
                    type: number
                    description: The camt value provided in the request.
                  samt:
                    type: number
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
            supp_rchrg_unreg:
              type: array
              description: The supp rchrg unreg value provided in the request.
              items:
                type: object
                properties:
                  itc_typ:
                    type: string
                    description: The itc typ value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
            supp_rchrg_reg:
              type: array
              description: The supp rchrg reg value provided in the request.
              items:
                type: object
                properties:
                  itc_typ:
                    type: string
                    description: The itc typ value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
            iog:
              type: array
              description: The iog value provided in the request.
              items:
                type: object
                properties:
                  itc_typ:
                    type: string
                    description: The itc typ value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
            ios:
              type: object
              description: The ios value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            isd:
              type: object
              description: The isd value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            itc_clmd:
              type: object
              description: The itc clmd value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            tran1:
              type: object
              description: The tran1 value provided in the request.
              properties:
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
            tran2:
              type: object
              description: The tran2 value provided in the request.
              properties:
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
            other:
              type: object
              description: The other value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
        table7:
          type: object
          description: The table7 value provided in the request.
          properties:
            rule37:
              type: object
              description: The rule37 value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rule39:
              type: object
              description: The rule39 value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rule42:
              type: object
              description: The rule42 value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rule43:
              type: object
              description: The rule43 value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            sec17:
              type: object
              description: The sec17 value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            revsl_tran1:
              type: object
              description: The revsl tran1 value provided in the request.
              properties:
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
            revsl_tran2:
              type: object
              description: The revsl tran2 value provided in the request.
              properties:
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
            other:
              type: array
              description: The other value provided in the request.
              items:
                type: object
                properties:
                  desc:
                    type: string
                    description: The desc value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
        table8:
          type: object
          description: The table8 value provided in the request.
          properties:
            itc_inwd_supp:
              type: object
              description: The itc inwd supp value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            itc_nt_availd:
              type: object
              description: The itc nt availd value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            itc_nt_eleg:
              type: object
              description: The itc nt eleg value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            iog_taxpaid:
              type: object
              description: The iog taxpaid value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
        table9:
          type: object
          description: The table9 value provided in the request.
          properties:
            iamt:
              type: object
              description: The iamt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            camt:
              type: object
              description: The camt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            samt:
              type: object
              description: The samt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            csamt:
              type: object
              description: The csamt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            intr:
              type: object
              description: The intr value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            fee:
              type: object
              description: The fee value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            pen:
              type: object
              description: The pen value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
            other:
              type: object
              description: The other value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
        table10:
          type: object
          description: The table10 value provided in the request.
          properties:
            itc_availd:
              type: object
              description: The itc availd value provided in the request.
              properties:
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
            itc_rvsl:
              type: object
              description: The itc rvsl value provided in the request.
              properties:
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
            dbn_amd:
              type: object
              description: The dbn amd value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            cdn_amd:
              type: object
              description: The cdn amd value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
        table14:
          type: object
          description: The table14 value provided in the request.
          properties:
            iamt:
              type: object
              description: The iamt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
                txpaid:
                  type: integer
                  description: The txpaid value provided in the request.
            camt:
              type: object
              description: The camt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
                txpaid:
                  type: integer
                  description: The txpaid value provided in the request.
            samt:
              type: object
              description: The samt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
                txpaid:
                  type: integer
                  description: The txpaid value provided in the request.
            csamt:
              type: object
              description: The csamt value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
                txpaid:
                  type: integer
                  description: The txpaid value provided in the request.
            intr:
              type: object
              description: The intr value provided in the request.
              properties:
                txpyble:
                  type: integer
                  description: The txpyble value provided in the request.
                txpaid:
                  type: integer
                  description: The txpaid value provided in the request.
        table15:
          type: object
          description: The table15 value provided in the request.
          properties:
            rfd_clmd:
              type: object
              description: The rfd clmd value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rfd_sanc:
              type: object
              description: The rfd sanc value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rfd_rejt:
              type: object
              description: The rfd rejt value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            rfd_pend:
              type: object
              description: The rfd pend value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            tax_dmnd:
              type: object
              description: The tax dmnd value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                intr:
                  type: integer
                  description: The intr value provided in the request.
                fee:
                  type: integer
                  description: The fee value provided in the request.
                pen:
                  type: integer
                  description: The pen value provided in the request.
            tax_paid:
              type: object
              description: The tax paid value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                intr:
                  type: integer
                  description: The intr value provided in the request.
                fee:
                  type: integer
                  description: The fee value provided in the request.
                pen:
                  type: integer
                  description: The pen value provided in the request.
            dmnd_pend:
              type: object
              description: The dmnd pend value provided in the request.
              properties:
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                intr:
                  type: integer
                  description: The intr value provided in the request.
                fee:
                  type: integer
                  description: The fee value provided in the request.
                pen:
                  type: integer
                  description: The pen value provided in the request.
        table16:
          type: object
          description: The table16 value provided in the request.
          properties:
            comp_supp:
              type: object
              description: The comp supp value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
            deemed_supp:
              type: object
              description: The deemed supp value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
            not_returned:
              type: object
              description: The not returned value provided in the request.
              properties:
                txval:
                  type: integer
                  description: The txval value provided in the request.
                iamt:
                  type: integer
                  description: The iamt value provided in the request.
                camt:
                  type: integer
                  description: The camt value provided in the request.
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
        table17:
          type: object
          description: The table17 value provided in the request.
          properties:
            items:
              type: array
              description: The items value provided in the request.
              items:
                type: object
                properties:
                  hsn_sc:
                    type: string
                    description: The hsn sc value provided in the request.
                  txval:
                    type: number
                    description: The txval value provided in the request.
                  isconcesstional:
                    type: string
                    description: The isconcesstional value provided in the request.
                  rt:
                    type: integer
                    description: The rt value provided in the request.
                  iamt:
                    type: number
                    description: The iamt value provided in the request.
                  camt:
                    type: number
                    description: The camt value provided in the request.
                  samt:
                    type: number
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
                  uqc:
                    type: string
                    description: The uqc value provided in the request.
                  qty:
                    type: integer
                    description: The qty value provided in the request.
        table18:
          type: object
          description: The table18 value provided in the request.
          properties:
            items:
              type: array
              description: The items value provided in the request.
              items:
                type: object
                properties:
                  hsn_sc:
                    type: string
                    description: The hsn sc value provided in the request.
                  uqc:
                    type: string
                    description: The uqc value provided in the request.
                  qty:
                    type: integer
                    description: The qty value provided in the request.
                  txval:
                    type: integer
                    description: The txval value provided in the request.
                  isconcesstional:
                    type: string
                    description: The isconcesstional value provided in the request.
                  rt:
                    type: integer
                    description: The rt value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
    SaveGstr9Response:
      oneOf:
        - $ref: '#/components/schemas/SaveGstr9SuccessResponse'
        - $ref: '#/components/schemas/GstnBusinessErrorResponse'
      description: >-
        A GSTN success or GSTN business-failure response. Both variants use HTTP
        200.
    SaveGstr9SuccessResponse:
      allOf:
        - $ref: '#/components/schemas/TaxpayerResponseMetadata'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              description: The GSTN success wrapper.
              required:
                - status_cd
                - data
              properties:
                status_cd:
                  type: string
                  enum:
                    - '1'
                  description: GSTN success status.
                  example: '1'
                data:
                  $ref: '#/components/schemas/SaveGstr9SuccessPayload'
    GstnBusinessErrorResponse:
      type: object
      description: HTTP 200 response containing a GSTN business failure.
      required:
        - code
        - timestamp
        - transaction_id
        - data
      properties:
        code:
          type: integer
          description: The HTTP status code reported in the response body.
          enum:
            - 200
          example: 200
        timestamp:
          type: integer
          format: int64
          description: The response timestamp in Unix epoch milliseconds.
          example: 1763446641000
        transaction_id:
          type: string
          description: The transaction identifier used to trace the request.
          example: 41bb8041-fb83-4654-8d75-85a19f329158
        data:
          type: object
          description: The GSTN business-failure wrapper.
          required:
            - status_cd
            - error
          properties:
            status_cd:
              type: string
              enum:
                - '0'
              description: GSTN business-failure status.
              example: '0'
            error:
              $ref: '#/components/schemas/GstnBusinessError'
    TaxpayerResponseMetadata:
      type: object
      description: Fields included in every taxpayer endpoint response.
      required:
        - code
        - timestamp
        - transaction_id
      properties:
        code:
          type: integer
          description: The HTTP status code reported in the response body.
          enum:
            - 200
          example: 200
        timestamp:
          type: integer
          format: int64
          description: The response timestamp in Unix epoch milliseconds.
          example: 1763446641000
        transaction_id:
          type: string
          description: The transaction identifier used to trace the request.
          example: 41bb8041-fb83-4654-8d75-85a19f329158
    SaveGstr9SuccessPayload:
      type: object
      description: Successful GSTN payload for Save Gstr9.
      properties:
        reference_id:
          type: string
          description: The reference id value returned by GSTN.
          example: 3f0b7b96-2c56-4e34-a025-03c3577a8468
    GstnBusinessError:
      type: object
      description: A business error returned by GSTN.
      required:
        - error_cd
        - message
      properties:
        error_cd:
          type: string
          description: The GSTN business error code.
          example: RET11416
        message:
          type: string
          description: A human-readable description of the GSTN business error.
          example: No records found.

````