Renew PCSID
Last updated
Was this helpful?
Last updated
Was this helpful?
Renews PCSID for an existing Device ID.
POST
x-cleartax-auth-token
String
Cannot be empty.
vat
String
Cannot be empty
Mandatory. VAT or Group VAT of the entity.
There are no path parameters for this API.
There are no query parameters for this API.
DeviceId
String
Cannot be empty.
Mandatory. The Device ID of the EGS Unit.
Otp
String
Should be a valid OTP.
Mandatory. The one time password generated by the user on the ZATCA portal. OTP once generated is valid only for 1 hour.
200
For a successful PCSID renewal.
400
For any kind of validation issues.
401
If the user is not authenticated for the operation.
403
If the user is not authorized for the operation.
Status
String
Enum:
GENERATED
FAILED
Mandatory. The status of PCSID Renewal.
GENERATED: On successful renewal.
FAILED: On validation issues.
DeviceId
String
MaxLength: 36
Mandatory. UUID. An identifier to exclusively identify the device getting onboarded. On successful Device ID generation, the field value will contain a UUID. On failure, the field will not be present in the response.
ErrorList
Array
NA
Success - HTTP Status Code - 200
Error - HTTP Status Code - 400
The DeviceId
for which the PCSID is intended to be renewed, should already have an existing PCSID.
This API needs to be authenticated with a valid user authentication token. If the auth token is not present or is invalid, the API will return HTTP Status Code 401.
If the auth token is valid, but the user does not have the authorization to generate device ID, then the API will return HTTP Status Code 403. The user, whose auth token is used, should have an Admin role for the particular VAT used in the request.
Mandatory. .
Optional. Validation Errors. An array of . In case there are no errors, this will be an empty Array ([]).