GSTR-1 CDNRA

21522152

About

  • Get all amended credit/debit notes for the authenticated taxpayer (gstin) for the particular year and month.
  • The result can be further filtered by adding from date and action_required. The action_required filter is used for filter invoices where the taxpayer has some pending actions.

Endpoint

HTTP MethodResourceDescription
Get/gsp/tax-payer/{gstin}/gstrs/gstr-1/cdnra/{year}/{month}?action_required={}action_required{}&from={}from{}Takes in gstin, year and month and returns all credit or debit notes.

API EndpointAPI Endpoint

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regimeAAAAA0000A
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01

Query Parameters

ParamTypeDescriptionExample
action_requiredstringStatus filter for filtering the invoices. Possible values: Y or N. Status filter for filtering the invoices. Use filter value Y to fetches the invoices where taxpayer need to take action. Already accepted or uploaded invoices can be fetched by using filter value N.Y
fromstringFrom Date (DD/MM/YYYY)21/11/2020

Once the values are added, Your curl will look something like this

curl --request GET \
     --url https://api.sandbox.co.in/gsp/tax-payer/AAAAA0000A/gstrs/gstr-1/cdnra/2020/01?action_required=Y&from=22-06-2020 \
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxxx' \
     --header 'x-api-key: xxxxxxxxx' \
     --header 'x-api-version: 1.0'

Response

  • cdnra Invoices
ParamTypeDescriptionExample
ctinstringCounter party GSTIN20GRRHF2562D3A3
List{inv}Credit Debit Note detailsRefer to the Table below
  • Credit Debit Note details
ParamTypeDescriptionExample
flagstringInvoice StatusN - No Action
updbystringUploaded byR - Receiver
S - Supplier
chksumstringInvoice Check sum valueAflJufPlFStqKBZ
idtstringSupplier Invoice Date03-02-2016
valnumSupplier Invoice Value10000.00
posstring Place of Supply (statecode)04
ont_numstringOriginal Credit/debit note numberNT100001
ont_dtstringOriginal Credit/Debit Note date (DD-MM-YYYY)02-03-2016
rchrgstringReverse ChargeY- Yes
N - No
inv_typstringInvoice type"R- Regular B2B Invoices, DE – Deemed Exports, SEWP – SEZ Exports with payment,
SEWOP – SEZ exports without payment
CBW - Custom Bonded Warehouse"
cflagstringCounter Party FlagA-Accepted ,R-Rejected,N-No action ,U-Uploaded, P-Pending, DF-Deferred, FR-Forward
opdnumOriginal Period
(YYYY-MM)
2016-12
nttystringCredit/debit note typeC/D
nt_numstringCredit note/debit noteNT100001
nt_dtstringCredit Note/Debit Note
(DD-MM-YYYY)
02-03-2016
p_gststringPre GST Regime Dr./ Cr. NotesY/N
d_flagstringdelink flagY
diff_percentnumDifferential percentage.65 (65%)
list {itms}ItemRefer to the table below
  • Items
ParamTypeDescriptionExample
numnumSerial no2
itm_detItem DetailsRefer to the table below
  • Item Details
ParamTypeDescriptionExample
rtnumRate of Invoice5
txvalnumTaxable value of Goods or Service as per invoice10000.00
iamtnumIGST Amount as per invoice650.00
camtnumCGST Amount as per invoice650.00
samtnumSGST Amount as per invoice650.00
csamtnumCess Amount as per invoice650.00