> ## 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-1 > Authenticated tax payer can save entire GSTR-1 invoices by uploading json to GST portal #### Request body schema ## OpenAPI ````yaml api-reference/gst/compliance/openapi.json POST /gst/compliance/tax-payer/gstrs/gstr-1/{year}/{month} 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-1/{year}/{month}: post: tags: - Taxpayer - Returns - File GSTR-1 summary: Save GSTR-1 description: >- Authenticated tax payer can save entire GSTR-1 invoices by uploading json to GST portal operationId: saveGstr1 parameters: - name: year in: path description: '' required: true example: '{{year}}' schema: type: string - name: month in: path description: '' required: true example: '{{month}}' schema: type: string - 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: '{{gsp_access_token}}' schema: type: string - name: x-api-version in: header description: API version required: false example: '' schema: type: string default: 1.0.0 - name: x-api-key in: header description: API key for identification required: true example: '{{api_key}}' schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SaveGstr1Request' examples: 200 Success: value: fp: '112023' gt: 3782969.01 cur_gt: 3782969.01 b2b: - ctin: 01AABCE2207R1Z5 inv: - inum: S008400 idt: 24-12-2023 val: 729248.16 pos: '06' rchrg: 'N' etin: 01AABCE5507R1C4 inv_typ: R diff_percent: 0.65 itms: - num: 1 itm_det: rt: 5 txval: 10000 iamt: 325 csamt: 500 b2ba: - ctin: 01AABCE2207R1Z5 inv: - oinum: S008400 oidt: 24-12-2023 inum: S008400 idt: 24-12-2023 val: 729248.16 pos: '06' rchrg: 'N' etin: 01AABCE5507R1C4 inv_typ: R diff_percent: 0.65 itms: - num: 1 itm_det: rt: 5 txval: 10000 iamt: 325 camt: 0 samt: 0 csamt: 500 b2cl: - pos: '05' inv: - inum: '92661' idt: 10-12-2023 val: 784586.33 etin: 27AHQPA8875L1CU diff_percent: 0.65 itms: - num: 1 itm_det: rt: 5 txval: 10000 iamt: 325 csamt: 500 b2cla: - pos: '06' inv: - oinum: '9266' oidt: 10-02-2023 diff_percent: 0.65 inum: '92661' idt: 10-12-2023 val: 784586.33 etin: 01AABCE5507R1C4 itms: - num: 1 itm_det: rt: 5 txval: 10000 iamt: 833.33 cdnr: - ctin: 01AAAAP1208Q1ZS nt: - ntty: C nt_num: '533515' nt_dt: 23-12-2023 pos: '03' rchrg: 'Y' inv_typ: DE val: 123123 diff_percent: 0.65 itms: - num: 1 itm_det: rt: 10 txval: 5225.28 iamt: 339.64 csamt: 789.52 cdnra: - ctin: 01AAAAP1208Q1ZS nt: - ntty: C ont_num: '533515' ont_dt: 23-09-2023 nt_num: '533515' nt_dt: 23-12-2023 diff_percent: 0.65 inv_typ: DE pos: '03' rchrg: 'Y' val: 123123 itms: - num: 1 itm_det: rt: 10 txval: 5225.28 iamt: 845.22 camt: 0 samt: 0 csamt: 789.52 b2cs: - sply_ty: INTER diff_percent: 0.65 rt: 5 typ: E etin: 01AABCE5507R1C4 pos: '05' txval: 110 iamt: 10 csamt: 10 - rt: 5 sply_ty: INTER diff_percent: 0.65 typ: OE txval: 100 iamt: 10 csamt: 10 pos: '05' b2csa: - omon: '122023' sply_ty: INTER diff_percent: 0.65 typ: E etin: 01AABCE5507R1C4 pos: '05' itms: - rt: 5 txval: 110 iamt: 10 camt: 0 samt: 0 csamt: 10 - rt: 12 txval: 110 iamt: 10 camt: 0 samt: 0 csamt: 10 exp: - exp_typ: WPAY inv: - inum: '81542' idt: 12-02-2023 val: 995048.36 sbpcode: ASB991 sbnum: '7896542' sbdt: 04-10-2023 itms: - txval: 10000 rt: 5 iamt: 833.33 csamt: 100 - exp_typ: WOPAY inv: - inum: '81542' idt: 12-02-2023 val: 995048.36 sbpcode: ASB981 sbnum: '7896542' sbdt: 04-10-2023 itms: - txval: 10000 rt: 0 iamt: 0 csamt: 100 expa: - exp_typ: WPAY inv: - oinum: '81542' oidt: 12-02-2023 inum: '81542' idt: 12-12-2023 val: 995048.36 sbpcode: ASB995 sbnum: '1234567' sbdt: 04-10-2023 itms: - txval: 10000 rt: 5 iamt: 833.33 csamt: 100 hsn: data: - num: 1 hsn_sc: '1010' desc: Goods Description uqc: kg qty: 2.05 txval: 10.23 iamt: 14.52 csamt: 500 rt: 0.1 nil: inv: - sply_ty: INTRB2B expt_amt: 123.45 nil_amt: 1470.85 ngsup_amt: 1258.5 - sply_ty: INTRB2C expt_amt: 123.45 nil_amt: 1470.85 ngsup_amt: 1258.5 txpd: - pos: '05' sply_ty: INTER diff_percent: 0.65 itms: - rt: 5 ad_amt: 100 iamt: 9400 csamt: 500 txpda: - omon: '122023' pos: '05' sply_ty: INTER diff_percent: 0.65 itms: - rt: 5 ad_amt: 100 iamt: 9400 csamt: 500 at: - pos: '05' sply_ty: INTER diff_percent: 0.65 itms: - rt: 5 ad_amt: 100 iamt: 9400 csamt: 500 ata: - omon: '022017' pos: '05' sply_ty: INTER diff_percent: 0.65 itms: - rt: 5 ad_amt: 100 iamt: 9400 csamt: 500 doc_issue: doc_det: - doc_num: 1 docs: - num: 1 from: '20' to: '29' totnum: 20 cancel: 3 net_issue: 17 cdnur: - typ: B2CL ntty: C nt_num: '533515' nt_dt: 23-12-2023 pos: '03' val: 64646 diff_percent: 0.65 itms: - num: 1 itm_det: rt: 10 txval: 5225.28 iamt: 339.64 csamt: 789.52 cdnura: - ont_num: '533515' ont_dt: 23-09-2023 nt_num: '533515' nt_dt: 23-12-2023 ntty: C typ: B2CL pos: '03' val: 123123 diff_percent: 0.65 itms: - num: 1 itm_det: rt: 10 txval: 5225.28 iamt: 845.22 csamt: 789.52 summary: 200 Success AUTH117 GSTR-1 is already filed: value: fp: '032024' gt: 3782969.01 cur_gt: 3782969.01 b2b: - inv: - val: 1178.82 itms: - num: 1 itm_det: csamt: 0 samt: 0 rt: 18 txval: 999 camt: 0 iamt: 179.82 flag: U irn: >- qoycq59t30ab18dcd27f569f30e41e0bd773481aec10b2259578b230f852773a updby: S irngendate: 29-03-2024 inum: '79188' cflag: 'N' inv_typ: R pos: '20' srctyp: E-Invoice idt: 12-03-2024 rchrg: 'N' chksum: >- fb69db99d0d962a30b54f12413aca5f88eeb060491c483aaaa14095f00579984 cfs: 'N' ctin: 20ABCPR9123F1YZ - inv: - val: 1103578.06 itms: - num: 1 itm_det: csamt: 0 samt: 84171.21 rt: 18 txval: 935235.64 camt: 84171.21 iamt: 0 flag: U irn: >- qoycq59t309252f10a3c145e3e7d34e55b9e9b103711e821f0c3dec9b474fea9 updby: S irngendate: 28-03-2024 inum: '79370' cflag: 'N' inv_typ: R pos: '24' srctyp: E-Invoice idt: 28-03-2024 rchrg: 'N' chksum: >- 43669ff19e74da1b4b674cae1c6438b3886579c7490fedb248092155d15d5e87 - val: 1062000 itms: - num: 1 itm_det: csamt: 0 samt: 81000 rt: 18 txval: 900000 camt: 81000 iamt: 0 flag: U irn: >- qoycq59t30b656602b367450772f4663cfab17114b1c984b59d4d6d9d5df27b9 updby: S irngendate: 28-03-2024 inum: '79373' cflag: 'N' inv_typ: R pos: '24' srctyp: E-Invoice idt: 28-03-2024 rchrg: 'N' chksum: >- b69d0c9c8fbb0571a3f94960cf8cfbdab94bad73a515e04fcbdbd9968b3c6ab4 cfs: 'N' ctin: 24ABCCS2123B1YZ - inv: - val: 1178.82 itms: - num: 1 itm_det: csamt: 0 samt: 89.91 rt: 18 txval: 999 camt: 89.91 iamt: 0 flag: U irn: >- qoycq59t3048fd73e5ebd41c390d2fc22d5049829a4a67cbcc5d8e122ce7ea1e updby: S irngendate: 29-03-2024 inum: '79122' cflag: 'N' inv_typ: R pos: '24' srctyp: E-Invoice idt: 04-03-2024 rchrg: 'N' chksum: >- a3d0f6bea39e025d5cf216ba4c30e08ef3a15588130459621db9417e5eed718c cfs: 'N' ctin: 24ABCPB0123K1YZ summary: AUTH117 GSTR-1 is already filed required: true responses: '200': description: 200 Success / AUTH117 GSTR-1 is already filed content: application/json: schema: $ref: '#/components/schemas/SaveGstr1Response' examples: 200 Success: summary: 200 Success value: code: 200 data: status_cd: '1' data: reference_id: dfb8f5a1-04c3-4f95-bb60-e13ce9b7221c timestamp: 1763446641000 transaction_id: 02b23947-f428-4deb-844d-c4e8456bb04d AUTH117 GSTR-1 is already filed: summary: AUTH117 GSTR-1 is already filed value: code: 200 data: status_cd: '0' error: error_cd: AUTH117 message: GSTR1 is already filed for current period timestamp: 1763446641000 transaction_id: 14790334-8944-48be-a2b2-0263a28ff41a headers: {} deprecated: false security: [] components: schemas: SaveGstr1Request: type: object description: Sample Payload. Clear to manually input values properties: fp: type: string description: The fp value provided in the request. gt: type: number description: The gt value provided in the request. cur_gt: type: number description: The cur gt value provided in the request. b2b: type: array description: The b2b value provided in the request. items: type: object properties: ctin: type: string description: The ctin value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. pos: type: string description: The pos value provided in the request. rchrg: type: string description: The rchrg value provided in the request. etin: type: string description: The etin value provided in the request. inv_typ: type: string description: The inv typ value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. csamt: type: integer description: The csamt value provided in the request. samt: type: number description: The samt value provided in the request. camt: type: number description: The camt value provided in the request. flag: type: string description: The flag value provided in the request. irn: type: string description: The irn value provided in the request. updby: type: string description: The updby value provided in the request. irngendate: type: string description: The irngendate value provided in the request. cflag: type: string description: The cflag value provided in the request. srctyp: type: string description: The srctyp value provided in the request. chksum: type: string description: The chksum value provided in the request. cfs: type: string description: The cfs value provided in the request. b2ba: type: array description: The b2ba value provided in the request. items: type: object properties: ctin: type: string description: The ctin value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: oinum: type: string description: The oinum value provided in the request. oidt: type: string description: The oidt value provided in the request. inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. pos: type: string description: The pos value provided in the request. rchrg: type: string description: The rchrg value provided in the request. etin: type: string description: The etin value provided in the request. inv_typ: type: string description: The inv typ value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. 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. b2cl: type: array description: The b2cl value provided in the request. items: type: object properties: pos: type: string description: The pos value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. etin: type: string description: The etin value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. 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. b2cla: type: array description: The b2cla value provided in the request. items: type: object properties: pos: type: string description: The pos value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: oinum: type: string description: The oinum value provided in the request. oidt: type: string description: The oidt value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. etin: type: string description: The etin value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: integer description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. cdnr: type: array description: The cdnr value provided in the request. items: type: object properties: ctin: type: string description: The ctin value provided in the request. nt: type: array description: The nt value provided in the request. items: type: object properties: ntty: type: string description: The ntty value provided in the request. nt_num: type: string description: The nt num value provided in the request. nt_dt: type: string description: The nt dt value provided in the request. pos: type: string description: The pos value provided in the request. rchrg: type: string description: The rchrg value provided in the request. inv_typ: type: string description: The inv typ value provided in the request. val: type: integer description: The val value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. csamt: type: number description: The csamt value provided in the request. cdnra: type: array description: The cdnra value provided in the request. items: type: object properties: ctin: type: string description: The ctin value provided in the request. nt: type: array description: The nt value provided in the request. items: type: object properties: ntty: type: string description: The ntty value provided in the request. ont_num: type: string description: The ont num value provided in the request. ont_dt: type: string description: The ont dt value provided in the request. nt_num: type: string description: The nt num value provided in the request. nt_dt: type: string description: The nt dt value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. inv_typ: type: string description: The inv typ value provided in the request. pos: type: string description: The pos value provided in the request. rchrg: type: string description: The rchrg value provided in the request. val: type: integer description: The val value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number 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: number description: The csamt value provided in the request. b2cs: type: array description: The b2cs value provided in the request. items: type: object properties: sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. rt: type: integer description: The rt value provided in the request. typ: type: string description: The typ value provided in the request. etin: type: string description: The etin value provided in the request. pos: type: string description: The pos value provided in the request. 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. b2csa: type: array description: The b2csa value provided in the request. items: type: object properties: omon: type: string description: The omon value provided in the request. sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. typ: type: string description: The typ value provided in the request. etin: type: string description: The etin value provided in the request. pos: type: string description: The pos value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: rt: type: integer description: The rt value provided in the request. 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. exp: type: array description: The exp value provided in the request. items: type: object properties: exp_typ: type: string description: The exp typ value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. sbpcode: type: string description: The sbpcode value provided in the request. sbnum: type: string description: The sbnum value provided in the request. sbdt: type: string description: The sbdt value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: txval: type: integer description: The txval 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. csamt: type: integer description: The csamt value provided in the request. expa: type: array description: The expa value provided in the request. items: type: object properties: exp_typ: type: string description: The exp typ value provided in the request. inv: type: array description: The inv value provided in the request. items: type: object properties: oinum: type: string description: The oinum value provided in the request. oidt: type: string description: The oidt value provided in the request. inum: type: string description: The inum value provided in the request. idt: type: string description: The idt value provided in the request. val: type: number description: The val value provided in the request. sbpcode: type: string description: The sbpcode value provided in the request. sbnum: type: string description: The sbnum value provided in the request. sbdt: type: string description: The sbdt value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: txval: type: integer description: The txval 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. csamt: type: integer description: The csamt value provided in the request. hsn: type: object description: The hsn value provided in the request. properties: data: type: array description: The data value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. hsn_sc: type: string description: The hsn sc value provided in the request. desc: type: string description: The desc value provided in the request. uqc: type: string description: The uqc value provided in the request. qty: type: number description: The qty value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. csamt: type: integer description: The csamt value provided in the request. rt: type: number description: The rt value provided in the request. nil: type: object description: The nil value provided in the request. properties: inv: type: array description: The inv value provided in the request. items: type: object properties: sply_ty: type: string description: The sply ty value provided in the request. expt_amt: type: number description: The expt amt value provided in the request. nil_amt: type: number description: The nil amt value provided in the request. ngsup_amt: type: number description: The ngsup amt value provided in the request. txpd: type: array description: The txpd value provided in the request. items: type: object properties: pos: type: string description: The pos value provided in the request. sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: rt: type: integer description: The rt value provided in the request. ad_amt: type: integer description: The ad amt 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. txpda: type: array description: The txpda value provided in the request. items: type: object properties: omon: type: string description: The omon value provided in the request. pos: type: string description: The pos value provided in the request. sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: rt: type: integer description: The rt value provided in the request. ad_amt: type: integer description: The ad amt 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. at: type: array description: The at value provided in the request. items: type: object properties: pos: type: string description: The pos value provided in the request. sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: rt: type: integer description: The rt value provided in the request. ad_amt: type: integer description: The ad amt 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. ata: type: array description: The ata value provided in the request. items: type: object properties: omon: type: string description: The omon value provided in the request. pos: type: string description: The pos value provided in the request. sply_ty: type: string description: The sply ty value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: rt: type: integer description: The rt value provided in the request. ad_amt: type: integer description: The ad amt 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. doc_issue: type: object description: The doc issue value provided in the request. properties: doc_det: type: array description: The doc det value provided in the request. items: type: object properties: doc_num: type: integer description: The doc num value provided in the request. docs: type: array description: The docs value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. from: type: string description: The from value provided in the request. to: type: string description: The to value provided in the request. totnum: type: integer description: The totnum value provided in the request. cancel: type: integer description: The cancel value provided in the request. net_issue: type: integer description: The net issue value provided in the request. cdnur: type: array description: The cdnur value provided in the request. items: type: object properties: typ: type: string description: The typ value provided in the request. ntty: type: string description: The ntty value provided in the request. nt_num: type: string description: The nt num value provided in the request. nt_dt: type: string description: The nt dt value provided in the request. pos: type: string description: The pos value provided in the request. val: type: integer description: The val value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. csamt: type: number description: The csamt value provided in the request. cdnura: type: array description: The cdnura value provided in the request. items: type: object properties: ont_num: type: string description: The ont num value provided in the request. ont_dt: type: string description: The ont dt value provided in the request. nt_num: type: string description: The nt num value provided in the request. nt_dt: type: string description: The nt dt value provided in the request. ntty: type: string description: The ntty value provided in the request. typ: type: string description: The typ value provided in the request. pos: type: string description: The pos value provided in the request. val: type: integer description: The val value provided in the request. diff_percent: type: number description: The diff percent value provided in the request. itms: type: array description: The itms value provided in the request. items: type: object properties: num: type: integer description: The num value provided in the request. itm_det: type: object description: The itm det value provided in the request. properties: rt: type: integer description: The rt value provided in the request. txval: type: number description: The txval value provided in the request. iamt: type: number description: The iamt value provided in the request. csamt: type: number description: The csamt value provided in the request. SaveGstr1Response: oneOf: - $ref: '#/components/schemas/SaveGstr1SuccessResponse' - $ref: '#/components/schemas/GstnBusinessErrorResponse' description: >- A GSTN success or GSTN business-failure response. Both variants use HTTP 200. SaveGstr1SuccessResponse: 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/SaveGstr1SuccessPayload' 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 SaveGstr1SuccessPayload: type: object description: Successful GSTN payload for Save Gstr1. properties: reference_id: type: string description: The reference id value returned by GSTN. example: dfb8f5a1-04c3-4f95-bb60-e13ce9b7221c 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. ````