Create Request (Advanced)

Introduction

This API is the first step in using the GST Prism product.

This API is responsible for generating a single OTP for the client which would later be used for establishing a session for fetching GSTR data and creating analytics reports. OTP will be sent to the registered number on the GST portal. This API can also be used to submit the username and password if the end customer has opted for that authentication mechanism.

The Create Request Advanced version is an upgrade to the standard version of GST Prism report.

Signzy has incorporated due diligence checks within the GST Prism report to enhance merchant due diligence, especially for working capital and invoice discounting loans. This will enable the underwriters to perform a higher level of checks and reduce fraud.

The GST Prism API supports fetching up to 3 years of data. For longer durations, contact your sales representative for a customization. You will require an authorization token to use this API. This authorization token will be generated by Signzy for you and will be used in each API call. Please contact [email protected] or your sales representative for this.

cURL

curl --location --globoff 'https://api-preproduction.signzy.app/api/v3/gstr-analytics/create-request-advanced' \
--header 'Authorization: <Access-Token>' \
--header 'Content-Type: application/json' \
--data '{
    "gstin": "29ABCDE1234F1Z5",
    "username": "signzy8e_1",
    "fromDate": "062022",
    "toDate": "082022",
    "pdfUrl": true,
    "entityDetails": true,
    "authType": "otp",
    "callbackUrl": "https://client-specific.callback.url"
}'

Endpoints

https://api-preproduction.signzy.app/api/v3/gstr-analytics/create-request-advanced

Request Headers

Key	Value
Authorization	shared by Signzy
Content-type	application/json

Request Body

{
    "gstin": "12ABCDE3456X7YZ",
    "username": "abcde3456x_7",
    "fromDate": "022020",
    "toDate": "012023",
    "entityDetails": true,
    "pdfUrl": false,
    "callbackUrl": "https://client-specific.callback.url",
    "authType" : "OTP",
    "password" : "testt",
    "relatedPartyTransactions": [ "12ABCDE345543", "Signzy" ]
}

Input Mapping

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
gstin	GSTIN of the business/customer for which the analytics report/raw data is to be generated/fetched	String	COMPULSORY
username	Username of the entity on GST portal for which the authorization is being done	String	COMPULSORY
fromDate	Starting date (MMYYYY format) from which the analytics report is to be generated	String	COMPULSORY
toDate	Ending date (MMYYYY format) till which the analytics report is to be generated	String	COMPULSORY
entityDetails	Shall the report consist of entity details of the provided GSTIN?	Boolean	OPTIONAL
pdfUrl	Shall the report be generated in PDF format as well?	Boolean	OPTIONAL
callbackUrl	The URL which will be used to publish raw GST data	String	OPTIONAL
authType	The type of authentication being used to take consent. Default is OTP if not passed	string, only accepts - "OTP"/ "PASSWORD"	OPTIONAL in case of OTP. Compulsory if going with Password authentication
password	Password for the GST portal corresponding to the GSTIN and username provided	String	OPTIONAL, in case of authorization type of password, it is mandatory
relatedPartyTransactions	The GSTINS and entity Names for which we want to get the Transaction data.	Array of String	OPTIONAL

Response Data

{
    "result": {
        "requestId": "d54becdf-05d9-49b9-9af8-7c93ae2772a4",
        "message": "GST OTP generation successful."
    }
}

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
result	This parameter contains the actual output.	Object	COMPULSORY
requestId	This is a unique 36-character long alphanumeric string created during the successful generation of OTP/submission of password and to be used for subsequent GSTR APIs	String	COMPULSORY
message	It indicates whether the OTP generation step was successful or not.	String	COMPULSORY

Sample Status Codes And Messages

{
    "result": {
        "requestId": "605e824c-7008-40c6-b420-ed25d0a8991d",
        "message": "GST OTP generation successful."
    }
}

1. GST OTP generation successful.
2. OTP is already triggered for this gstin. Use the requestId and proceed with the submit otp API.
3. API Access/GSTIN Username Error.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].