1. Types of state
A request has status attributes that allow monitoring the progress of the process in the application.
CREATED: the request has been created and associated with an RA, but the content of the request has not yet been validated. In the state, the data may also be inconsistent; the system will not throw an error. The content of the request can be edited at any time to make it valid.
ENROLLREADY: The certificates are ready to be issued. The request reaches this stage if it has been approved and signed by an RAO, who is part of the RA in charge of the request.
ISSUED: The certificate is issued through the user’s self-service page on the platform. First, the user must set a PIN code or password for the secure element.
Certificate States:
ACTIVE
SUSPENDED
REVOKED
RENOVATED: The certificate is renewed through the user’s self-service page on the platform.
CANCELED: The request is canceled, and the digital certificate cannot be issued.
For more information about the states, you can visit the following page.
https://ra-uanataca-docs.redoc.ly/#section/Glossary
2. WEBHOOK NOTIFICATIONS
2.1. Flow States of a Paperless Request
Request created
{"event_type": "REQUEST_CREATED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "CREATED", ...}, "certificates": []}
a. Request canceled
{"event_type": "REQUEST_CANCELED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "CANCELLED", ...}, "certificates": []}
b. Request approved
{"event_type": "REQUEST_APPROVED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "ENROLLREADY", ...}, "certificates": []}
c. Request in Issued State (Certificate Issued)
{"event_type": "REQUEST_ENROLLED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "ISSUED"}, "certificates": [{"status": "VALID", "serial_number": "XXXXXXXXXXXXXXX", "valid_from": "YYYYMMDD HH:MM:SS", "valid_to": "YYYYMMDD HH:MM:SS"}]}
d. Certificate suspended
{"event_type": "CERTIFICATE_SUSPENDED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "ISSUED"}, "certificates": [{"status": "SUSPENDED", "serial_number": "XXXXXXXXXXXXXXX", "valid_from": "YYYYMMDD HH:MM:SS", "valid_to": "YYYYMMDD HH:MM:SS"}]}
e. Certificate reactivated
{"event_type": "CERTIFICATE_ACTIVATED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "ISSUED"}, "certificates": [{"status": "VALID", "serial_number": "XXXXXXXXXXXXXXX", "valid_from": "YYYYMMDD HH:MM:SS", "valid_to": "YYYYMMDD HH:MM:SS"}]}
f. Certificate revoked
{"event_type": "CERTIFICATE_REVOKED", "sent_at": "YYYYMMDDHHMMSS", "request": {"status": "ISSUED"}, "certificates": [{"status": "REVOKED", "serial_number": "XXXXXXXXXXXXXXX", "valid_from": "YYYYMMDD HH:MM:SS", "valid_to": "YYYYMMDD HH:MM:SS"}]}