Dispute Document

Dispute Simple Document API is used to Dispute the Simple Document using the given request payload. This api provides Simple Document dispute feature for buyer

Route

/invx/apis/{iridessa-version}/orgs/{org-id}/simple

- active 'iridessa-version': v1
- method: PATCH

URL Parameters

Name	Description	Type
iridessa-version	version of the API for example, v1	string
org-id	theodore organisation id	string
doc-id	document id	string

Headers

All headers are mentioned in common headers

Request

Please refer the following request body for reference-

Sample request body

{
  "docId":"2e63f8bc-b89a-43e1-bb7d-f2dde82f97f6",
  "comments":"test Dispute",
  "action":"dpt"
}

Response

Successful response will have the response in “data” attribute as a json.

200

Sample response body

{
  "status": "1",
  "data": {
    "id": "307d40e3-cf2f-4c35-a6e0-6d250d89d9a6",
    "docNumber": "F3CA3D31547F04C6",
    "docType": "100",
    "docDate": "24/01/2023",
    "sellerGstin": "27AAAPI3182M002",
    "sellerPAN": "AAAPI3182M",
    "buyerGstin": "27ACBPN2353E1ZX",
    "buyerPAN": "ACBPN2353E",
    "irdDocType": "SMP",
    "amount": 100.00,
    "acceptanceComments": null,
    "denialComments": null,
    "disputeComments": "test dispute",
    "status": "230",
    "createdByUserId": "3e193e19-0d70-4938-9698-287f8bd947fb",
    "createdOn": 1674561085766,
    "lastUpdatedByUserId": "2a2e6f94-6b87-4e74-9692-483ffc127b04",
    "lastUpdated": 1674561085854,
    "annotations": []
  },
  "error": null,
  "info": null
}

400 BAD REQUEST

Sample Response Body

{
  "error": {
    "message": "err-incorrect-update-action",
    "type": "ClientError",
    "args": {
      "message": "action dpt on state 260.kotlin"
    }
  }
}

Note

status field in document is the state of the Document generated. Different Document states are as bellow -

• 100 -> DRAFT
• 120 -> REGISTRATIONFAILED
• 200 -> CREATED
• 210 -> ACCEPTED
• 220 -> DENIED
• 230 -> DISPUTED
• 240 -> CANCELLED
• 250 -> FROZEN
• 260 -> DELETE

---

Last update: April 7, 2023