GST Data Reader

API Details

Method: POST

Endpoint: /gst-recon/read

Base URL: https://uatapi.wowpe.in/api/api/api-module

Authentication

Include the following headers in your request.

Header	Type	Description
`X-Client-Id`	String	Client ID provided by WowPe.
`X-Client-Secret`	String	Client secret provided by WowPe.

Request Parameters

Content-Type: multipart/form-data

Parameter	Type	Mandatory	Description
`files`	File	Yes	Invoice document(s) to process. Repeat this field for multiple files.

Sample Request

curl --request POST 'https://uatapi.wowpe.in/api/api/api-module/gst-recon/read' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  --form '[email protected]'

Sample Response

{
  "reviewRequired": true,
  "files": [
    {
      "fileName": "invoice.pdf",
      "success": true,
      "rows": [
        {
          "sourceFile": "invoice.pdf",
          "sourcePages": "1",
          "beneficiaryName": "",
          "uniqueRefNo": "0007",
          "gstin": "29BBBBBO0O00B1Z5",
          "taxableValue": 1000.0,
          "cgst": 90.0,
          "sgst": 90.0,
          "igst": 0.0,
          "gstAmount": 180.0,
          "reviewed": false,
          "warnings": [
            "BeneficiaryName not found; review source."
          ]
        }
      ]
    }
  ]
}

Note: This is a representative UAT response. Not every field is guaranteed to appear in every response.

Response Parameters

Parameter	Type	Description
`reviewRequired`	Boolean	Indicates whether the extracted data requires review.
`files`	Array	Contains processing results for uploaded files.
`fileName`	String	Name of the uploaded file.
`success`	Boolean	Indicates the observed file-processing result.
`rows`	Array	Contains extracted invoice records.
`sourceFile`	String	Source document name, where returned.
`sourcePages`	String	Source page information, where returned.
`beneficiaryName`	String	Extracted supplier or beneficiary name.
`uniqueRefNo`	String	Invoice or reference number.
`gstin`	String	Extracted GST identification number.
`taxableValue`	Number / Null	Extracted taxable amount.
`cgst`	Number / Null	Central GST amount.
`sgst`	Number / Null	State GST amount.
`igst`	Number / Null	Integrated GST amount.
`gstAmount`	Number / Null	Reported GST amount.
`reviewed`	Boolean	Review status of the record.
`warnings`	Array	Warnings associated with the extracted record.

Important Notes

The API's captured UAT responses may contain missing fields, warnings or conflicting document information.
Verify supplier identity, GSTIN, invoice reference, document date and tax amounts against the original invoice.
Preserve missing values as unknown. Do not automatically replace them with zero.
Multiple invoices or supporting pages may not always be grouped correctly.
An all-page OCR fix has been tested locally, but its deployment to UAT has not been confirmed.

What's Next

Review the extracted invoice data and resolve any missing or incorrect values before using the records for reconciliation.