Revocar un certificado Viafirma ya emitido (irreversible)
POST/certificate-request/:uuid/revoke
Solicita a Viafirma RA la revocación del certificado con el código de revocación y el motivo indicados. Solo aplica a solicitudes tramitadas con Viafirma cuyo estado sea PROCESSED (certificado emitido). Si la solicitud tiene varios trámites Viafirma, se revoca y actualiza el trámite vigente, el mismo que informa GET /certificate-request/{id}/issuance (el que tiene el certificado emitido tiene prioridad sobre reintentos o duplicados). Si Viafirma la acepta: el trámite pasa a REVOKED, la solicitud a REVOKED y se registra en el historial el motivo y el código devuelto por Viafirma (que reemplaza a revocation_code en GET /certificate-request/{id}/issuance). El revoking_code se obtiene de GET /certificate-request/{id}/issuance → dataRecords.data.revocation_code, disponible desde que se descarga el certificado de Viafirma. Es IRREVERSIBLE. Para retirar una solicitud que aún no tiene certificado use POST /certificate-request/{id}/issuance/reject.
Request
Responses
- 200
- 401
- 404
- 422
- 429
- 500
Certificado revocado.
No autenticado (token ausente, inválido o expirado).
La solicitud no existe o pertenece a otra empresa (el administrador accede a todas): mensaje Solicitud de certificado no encontrada. La solicitud existe pero no se tramitó con Viafirma (p. ej. proveedor mail): mensaje Recurso no encontrado.
Validación del cuerpo fallida (con errors: revoking_code obligatorio, texto de hasta 255 caracteres; revocation_reason obligatorio, entero en 0,1,2,3,4,5,9,10), o error de negocio sin errors: la solicitud no está en PROCESSED ('No se puede revocar un certificado que no esté en estado PROCESSED...'), o Viafirma RA rechazó la revocación (p. ej. código inválido) o no respondió. Cuando el error viene de Viafirma RA, message es uno de estos textos fijos: Error de comunicación con Viafirma RA. Intente nuevamente. (sin respuesta, error del servicio o tiempo agotado), Viafirma no admite la operación en el estado actual de la solicitud., Viafirma no encuentra la solicitud asociada. o El servicio de Viafirma rechazó la operación. Revisa los datos e intenta de nuevo. (opcionalmente seguido de Código: <errorCode>. con el código de error de Viafirma).
Límite general de 60 peticiones por minuto excedido.
Error interno.