> ## 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.

# File GSTR-3B

> File GSTR-3B by passing the GSTR-3B Details response after offsetting liabilities for the authenticated taxpayer.

#### Request body schema

<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-3b/file-v6.0.xlsx" arrow="true" horizontal />


## OpenAPI

````yaml api-reference/gst/compliance/openapi.json POST /gst/compliance/tax-payer/gstrs/gstr-3b/{year}/{month}/file
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-3b/{year}/{month}/file:
    post:
      tags:
        - Taxpayer
        - Returns
        - File GSTR-3B
      summary: File GSTR-3B
      description: Authenticated tax payer can upload GSTR-3B json to GST portal
      operationId: fileGstr3b
      parameters:
        - name: year
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: month
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: pan
          in: query
          description: PAN of the authorized signatory
          required: true
          schema:
            type: string
            example: '{{pan}}'
        - name: otp
          in: query
          description: Generated EVC OTP
          required: true
          schema:
            type: string
            example: '575757'
        - 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/FileGstr3bRequest'
            examples:
              200 Success:
                value:
                  tx_pmt:
                    net_tax_pay:
                      - sgst:
                          intr: 0
                          tx: 4841
                          fee: 0
                        liab_ldg_id: 0
                        tran_desc: Other than Reverse Charge
                        cgst:
                          intr: 0
                          tx: 4841
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 259471
                          fee: 0
                        trans_typ: 30002
                      - sgst:
                          intr: 0
                          tx: 9000
                          fee: 0
                        liab_ldg_id: 0
                        tran_desc: Reverse charge and supplies made u/s 9(5)
                        cgst:
                          intr: 0
                          tx: 9000
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30003
                    adjnegliab: []
                    pdnls: []
                    pdcash:
                      - liab_ldg_id: 757163094
                        spd: 0
                        c_intrpd: 0
                        i_lfeepd: 0
                        cspd: 0
                        s_intrpd: 0
                        trans_typ: 30002
                        i_intrpd: 0
                        s_lfeepd: 0
                        cpd: 0
                        c_lfeepd: 0
                        cs_intrpd: 0
                        cs_lfeepd: 0
                        ipd: 44357
                      - liab_ldg_id: 757163095
                        spd: 9000
                        c_intrpd: 0
                        i_lfeepd: 0
                        cspd: 0
                        s_intrpd: 0
                        trans_typ: 30003
                        i_intrpd: 0
                        s_lfeepd: 0
                        cpd: 9000
                        c_lfeepd: 0
                        cs_intrpd: 0
                        cs_lfeepd: 0
                        ipd: 0
                    pditc:
                      s_pds: 4841
                      liab_ldg_id: 757163094
                      c_pdi: 0
                      cs_pdcs: 0
                      s_pdi: 0
                      i_pdi: 182450
                      c_pdc: 4841
                      i_pdc: 16332
                      i_pds: 16332
                      trans_typ: 30002
                    tx_py:
                      - sgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        liab_ldg_id: 757163094
                        tran_desc: Other than Reverse Charge
                        cgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30002
                      - sgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        liab_ldg_id: 757163095
                        tran_desc: Reverse charge and supplies made u/s 9(5)
                        cgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30003
                  eco_dtls:
                    eco_reg_sup:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    eco_sup:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                  sup_details:
                    osup_zero:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_nil_exmp:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_nongst:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_det:
                      samt: 4841.23
                      csamt: 0
                      txval: 1495299.69
                      camt: 4841.23
                      iamt: 259471.16
                    isup_rev:
                      samt: 9000
                      csamt: 0
                      txval: 100000
                      camt: 9000
                      iamt: 0
                  intr_ltfee:
                    ltfee_details:
                      samt: 0
                      csamt: 0
                      camt: 0
                      iamt: 0
                    intr_details:
                      samt: 0
                      csamt: 0
                      camt: 0
                      iamt: 0
                  inter_sup:
                    unreg_details:
                      - pos: '27'
                        txval: 846.61
                        iamt: 152.39
                      - pos: '07'
                        txval: 1693.22
                        iamt: 304.78
                      - pos: '29'
                        txval: 149013.05
                        iamt: 26822.27
                    comp_details:
                      - pos: '33'
                        txval: 1157.31
                        iamt: 208.32
                    uin_details: []
                  itc_elg:
                    itc_avl:
                      - samt: 0
                        csamt: 0
                        ty: IMPG
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: IMPS
                        camt: 0
                        iamt: 0
                      - samt: 9000
                        csamt: 0
                        ty: ISRC
                        camt: 9000
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: ISD
                        camt: 0
                        iamt: 0
                      - samt: 12173
                        csamt: 0
                        ty: OTH
                        camt: 12173
                        iamt: 182450
                    itc_net:
                      samt: 21173
                      csamt: 0
                      camt: 21173
                      iamt: 182450
                    itc_rev:
                      - samt: 0
                        csamt: 0
                        ty: RUL
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: OTH
                        camt: 0
                        iamt: 0
                    itc_inelg:
                      - samt: 0
                        csamt: 0
                        ty: RUL
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: OTH
                        camt: 0
                        iamt: 0
                summary: 200 Success
              200 You cannot file Nil return:
                value: {}
                summary: 200 You cannot file Nil return
              Request Example:
                value:
                  tx_pmt:
                    net_tax_pay:
                      - sgst:
                          intr: 0
                          tx: 4841
                          fee: 0
                        liab_ldg_id: 0
                        tran_desc: Other than Reverse Charge
                        cgst:
                          intr: 0
                          tx: 4841
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 259471
                          fee: 0
                        trans_typ: 30002
                      - sgst:
                          intr: 0
                          tx: 9000
                          fee: 0
                        liab_ldg_id: 0
                        tran_desc: Reverse charge and supplies made u/s 9(5)
                        cgst:
                          intr: 0
                          tx: 9000
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30003
                    adjnegliab: []
                    pdnls: []
                    pdcash:
                      - liab_ldg_id: 757163094
                        spd: 0
                        c_intrpd: 0
                        i_lfeepd: 0
                        cspd: 0
                        s_intrpd: 0
                        trans_typ: 30002
                        i_intrpd: 0
                        s_lfeepd: 0
                        cpd: 0
                        c_lfeepd: 0
                        cs_intrpd: 0
                        cs_lfeepd: 0
                        ipd: 44357
                      - liab_ldg_id: 757163095
                        spd: 9000
                        c_intrpd: 0
                        i_lfeepd: 0
                        cspd: 0
                        s_intrpd: 0
                        trans_typ: 30003
                        i_intrpd: 0
                        s_lfeepd: 0
                        cpd: 9000
                        c_lfeepd: 0
                        cs_intrpd: 0
                        cs_lfeepd: 0
                        ipd: 0
                    pditc:
                      s_pds: 4841
                      liab_ldg_id: 757163094
                      c_pdi: 0
                      cs_pdcs: 0
                      s_pdi: 0
                      i_pdi: 182450
                      c_pdc: 4841
                      i_pdc: 16332
                      i_pds: 16332
                      trans_typ: 30002
                    tx_py:
                      - sgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        liab_ldg_id: 757163094
                        tran_desc: Other than Reverse Charge
                        cgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30002
                      - sgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        liab_ldg_id: 757163095
                        tran_desc: Reverse charge and supplies made u/s 9(5)
                        cgst:
                          intr: 0
                          tx: 0
                          fee: 0
                        cess:
                          intr: 0
                          tx: 0
                          fee: 0
                        igst:
                          intr: 0
                          tx: 0
                          fee: 0
                        trans_typ: 30003
                  eco_dtls:
                    eco_reg_sup:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    eco_sup:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                  sup_details:
                    osup_zero:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_nil_exmp:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_nongst:
                      samt: 0
                      csamt: 0
                      txval: 0
                      camt: 0
                      iamt: 0
                    osup_det:
                      samt: 4841.23
                      csamt: 0
                      txval: 1495299.69
                      camt: 4841.23
                      iamt: 259471.16
                    isup_rev:
                      samt: 9000
                      csamt: 0
                      txval: 100000
                      camt: 9000
                      iamt: 0
                  intr_ltfee:
                    ltfee_details:
                      samt: 0
                      csamt: 0
                      camt: 0
                      iamt: 0
                    intr_details:
                      samt: 0
                      csamt: 0
                      camt: 0
                      iamt: 0
                  inter_sup:
                    unreg_details:
                      - pos: '27'
                        txval: 846.61
                        iamt: 152.39
                      - pos: '07'
                        txval: 1693.22
                        iamt: 304.78
                      - pos: '29'
                        txval: 149013.05
                        iamt: 26822.27
                    comp_details:
                      - pos: '33'
                        txval: 1157.31
                        iamt: 208.32
                    uin_details: []
                  itc_elg:
                    itc_avl:
                      - samt: 0
                        csamt: 0
                        ty: IMPG
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: IMPS
                        camt: 0
                        iamt: 0
                      - samt: 9000
                        csamt: 0
                        ty: ISRC
                        camt: 9000
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: ISD
                        camt: 0
                        iamt: 0
                      - samt: 12173
                        csamt: 0
                        ty: OTH
                        camt: 12173
                        iamt: 182450
                    itc_net:
                      samt: 21173
                      csamt: 0
                      camt: 21173
                      iamt: 182450
                    itc_rev:
                      - samt: 0
                        csamt: 0
                        ty: RUL
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: OTH
                        camt: 0
                        iamt: 0
                    itc_inelg:
                      - samt: 0
                        csamt: 0
                        ty: RUL
                        camt: 0
                        iamt: 0
                      - samt: 0
                        csamt: 0
                        ty: OTH
                        camt: 0
                        iamt: 0
                summary: Request Example
        required: true
      responses:
        '200':
          description: 200 Success / 200 You cannot file Nil return
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileGstr3bResponse'
              examples:
                200 Success:
                  summary: 200 Success
                  value:
                    code: 200
                    data:
                      status_cd: '1'
                      data:
                        ack_num: AB2410242527396 19/11/2024 16:23
                    timestamp: 1763446641000
                    transaction_id: 72da34f0-d6d1-4056-92e1-734fc29f0249
                200 You cannot file Nil return:
                  summary: 200 You cannot file Nil return
                  value:
                    code: 200
                    data:
                      status_cd: '0'
                      error:
                        error_cd: RT-3BAS1027
                        message: >-
                          There is a checksum mismatch or You cannot file Nil
                          return as there are already saved values in 3B. If
                          error persists quote error number RT-3BAS1027 when you
                          contact customer care for quick resolution.
                    timestamp: 1734603529000
                    transaction_id: 8df2a844-6c40-4da1-9792-334214734b85
          headers: {}
      deprecated: false
      security: []
components:
  schemas:
    FileGstr3bRequest:
      type: object
      description: Public request body for File Gstr3b.
      properties:
        tx_pmt:
          type: object
          description: The tx pmt value provided in the request.
          properties:
            net_tax_pay:
              type: array
              description: The net tax pay value provided in the request.
              items:
                type: object
                properties:
                  sgst:
                    type: object
                    description: The sgst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  liab_ldg_id:
                    type: integer
                    description: The liab ldg id value provided in the request.
                  tran_desc:
                    type: string
                    description: The tran desc value provided in the request.
                  cgst:
                    type: object
                    description: The cgst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  cess:
                    type: object
                    description: The cess value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  igst:
                    type: object
                    description: The igst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  trans_typ:
                    type: integer
                    description: The trans typ value provided in the request.
            adjnegliab:
              type: array
              description: >-
                A list that can be empty; record fields depend on the return
                section.
              items:
                type: object
                description: Adjusted tax payable details.
                properties:
                  trans_typ:
                    type: integer
                    description: Transaction type.
                  liab_ldg_id:
                    type: integer
                    description: Liability ledger identifier.
                  tran_desc:
                    type: string
                    description: Transaction description.
                  sgst:
                    type: object
                    properties:
                      intr:
                        type: number
                        description: Interest payable.
                      tx:
                        type: number
                        description: Tax payable.
                      fee:
                        type: number
                        description: Late fee payable.
                  cgst:
                    type: object
                    properties:
                      intr:
                        type: number
                        description: Interest payable.
                      tx:
                        type: number
                        description: Tax payable.
                      fee:
                        type: number
                        description: Late fee payable.
                  igst:
                    type: object
                    properties:
                      intr:
                        type: number
                        description: Interest payable.
                      tx:
                        type: number
                        description: Tax payable.
                  cess:
                    type: object
                    properties:
                      intr:
                        type: number
                        description: Interest payable.
                      tx:
                        type: number
                        description: Tax payable.
            pdnls:
              type: array
              description: >-
                A list that can be empty; record fields depend on the return
                section.
              items:
                type: object
                description: Tax paid against negative liability statement entries.
                properties:
                  liab_ldg_id:
                    type: integer
                    description: Liability ledger identifier.
                  trans_typ:
                    type: integer
                    description: Transaction type.
                  tran_desc:
                    type: string
                    description: Transaction description.
                  ipd:
                    type: number
                    description: Integrated tax paid.
                  cpd:
                    type: number
                    description: Central tax paid.
                  spd:
                    type: number
                    description: State or Union Territory tax paid.
                  cspd:
                    type: number
                    description: Cess paid.
            pdcash:
              type: array
              description: The pdcash value provided in the request.
              items:
                type: object
                properties:
                  liab_ldg_id:
                    type: integer
                    description: The liab ldg id value provided in the request.
                  spd:
                    type: integer
                    description: The spd value provided in the request.
                  c_intrpd:
                    type: integer
                    description: The c intrpd value provided in the request.
                  i_lfeepd:
                    type: integer
                    description: The i lfeepd value provided in the request.
                  cspd:
                    type: integer
                    description: The cspd value provided in the request.
                  s_intrpd:
                    type: integer
                    description: The s intrpd value provided in the request.
                  trans_typ:
                    type: integer
                    description: The trans typ value provided in the request.
                  i_intrpd:
                    type: integer
                    description: The i intrpd value provided in the request.
                  s_lfeepd:
                    type: integer
                    description: The s lfeepd value provided in the request.
                  cpd:
                    type: integer
                    description: The cpd value provided in the request.
                  c_lfeepd:
                    type: integer
                    description: The c lfeepd value provided in the request.
                  cs_intrpd:
                    type: integer
                    description: The cs intrpd value provided in the request.
                  cs_lfeepd:
                    type: integer
                    description: The cs lfeepd value provided in the request.
                  ipd:
                    type: integer
                    description: The ipd value provided in the request.
            pditc:
              type: object
              description: The pditc value provided in the request.
              properties:
                s_pds:
                  type: integer
                  description: The s pds value provided in the request.
                liab_ldg_id:
                  type: integer
                  description: The liab ldg id value provided in the request.
                c_pdi:
                  type: integer
                  description: The c pdi value provided in the request.
                cs_pdcs:
                  type: integer
                  description: The cs pdcs value provided in the request.
                s_pdi:
                  type: integer
                  description: The s pdi value provided in the request.
                i_pdi:
                  type: integer
                  description: The i pdi value provided in the request.
                c_pdc:
                  type: integer
                  description: The c pdc value provided in the request.
                i_pdc:
                  type: integer
                  description: The i pdc value provided in the request.
                i_pds:
                  type: integer
                  description: The i pds value provided in the request.
                trans_typ:
                  type: integer
                  description: The trans typ value provided in the request.
            tx_py:
              type: array
              description: The tx py value provided in the request.
              items:
                type: object
                properties:
                  sgst:
                    type: object
                    description: The sgst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  liab_ldg_id:
                    type: integer
                    description: The liab ldg id value provided in the request.
                  tran_desc:
                    type: string
                    description: The tran desc value provided in the request.
                  cgst:
                    type: object
                    description: The cgst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  cess:
                    type: object
                    description: The cess value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  igst:
                    type: object
                    description: The igst value provided in the request.
                    properties:
                      intr:
                        type: integer
                        description: The intr value provided in the request.
                      tx:
                        type: integer
                        description: The tx value provided in the request.
                      fee:
                        type: integer
                        description: The fee value provided in the request.
                  trans_typ:
                    type: integer
                    description: The trans typ value provided in the request.
        eco_dtls:
          type: object
          description: The eco dtls value provided in the request.
          properties:
            eco_reg_sup:
              type: object
              description: The eco reg sup value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: integer
                  description: The txval 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.
            eco_sup:
              type: object
              description: The eco sup value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: integer
                  description: The txval 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.
        sup_details:
          type: object
          description: The sup details value provided in the request.
          properties:
            osup_zero:
              type: object
              description: The osup zero value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: integer
                  description: The txval 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.
            osup_nil_exmp:
              type: object
              description: The osup nil exmp value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: integer
                  description: The txval 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.
            osup_nongst:
              type: object
              description: The osup nongst value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: integer
                  description: The txval 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.
            osup_det:
              type: object
              description: The osup det value provided in the request.
              properties:
                samt:
                  type: number
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt value provided in the request.
                txval:
                  type: number
                  description: The txval value provided in the request.
                camt:
                  type: number
                  description: The camt value provided in the request.
                iamt:
                  type: number
                  description: The iamt value provided in the request.
            isup_rev:
              type: object
              description: The isup rev value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt 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.
                txval:
                  type: integer
                  description: The txval value provided in the request.
        intr_ltfee:
          type: object
          description: The intr ltfee value provided in the request.
          properties:
            ltfee_details:
              type: object
              description: The ltfee details value provided in the request.
              properties:
                samt:
                  type: integer
                  description: The samt value provided in the request.
                csamt:
                  type: integer
                  description: The csamt 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.
            intr_details:
              type: object
              description: The intr details 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.
        inter_sup:
          type: object
          description: The inter sup value provided in the request.
          properties:
            unreg_details:
              type: array
              description: The unreg details value provided in the request.
              items:
                $ref: '#/components/schemas/Gstr3bInterStateSupply'
            comp_details:
              type: array
              description: The comp details value provided in the request.
              items:
                $ref: '#/components/schemas/Gstr3bInterStateSupply'
            uin_details:
              type: array
              description: >-
                A list that can be empty; record fields depend on the return
                section.
              items:
                $ref: '#/components/schemas/Gstr3bInterStateSupply'
        itc_elg:
          type: object
          description: The itc elg value provided in the request.
          properties:
            itc_avl:
              type: array
              description: The itc avl value provided in the request.
              items:
                type: object
                properties:
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  ty:
                    type: string
                    description: The ty value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
            itc_rev:
              type: array
              description: The itc rev value provided in the request.
              items:
                type: object
                properties:
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  ty:
                    type: string
                    description: The ty value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
            itc_net:
              type: object
              description: The itc net 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_inelg:
              type: array
              description: The itc inelg value provided in the request.
              items:
                type: object
                properties:
                  samt:
                    type: integer
                    description: The samt value provided in the request.
                  csamt:
                    type: integer
                    description: The csamt value provided in the request.
                  camt:
                    type: integer
                    description: The camt value provided in the request.
                  ty:
                    type: string
                    description: The ty value provided in the request.
                  iamt:
                    type: integer
                    description: The iamt value provided in the request.
    FileGstr3bResponse:
      oneOf:
        - $ref: '#/components/schemas/FileGstr3bSuccessResponse'
        - $ref: '#/components/schemas/GstnBusinessErrorResponse'
      description: >-
        A GSTN success or GSTN business-failure response. Both variants use HTTP
        200.
    Gstr3bInterStateSupply:
      type: object
      description: Inter-state supply totals for a place of supply.
      properties:
        pos:
          type: string
          description: Place-of-supply state or Union Territory code.
        txval:
          type: number
          description: Taxable value.
        iamt:
          type: number
          description: Integrated tax amount.
    FileGstr3bSuccessResponse:
      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/FileGstr3bSuccessPayload'
    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
    FileGstr3bSuccessPayload:
      type: object
      description: Successful GSTN payload for File Gstr3b.
      properties:
        ack_num:
          type: string
          description: The ack num value returned by GSTN.
          example: AB2410242527396 19/11/2024 16:23
    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.

````