Consultar el estado de emisión de la solicitud
GET/certificate-request/:id/issuance
Devuelve el estado normalizado de la emisión. El proveedor NO se toma de la configuración actual de la empresa sino de cómo se tramitó la solicitud: si existe un trámite en viafirma_certificate_requests responde el proveedor viafirma; si no, mail. Viafirma: si la solicitud tiene varios trámites (p. ej. un reintento o un duplicado), se informa el trámite vigente, elegido por prioridad: con certificado emitido (COMPLETED o REVOKED, P7B descargado o certificado generado en Viafirma) > con verificación de identidad (KYC) completada > en curso > fallido (FAILED, FAILED_RECOVERABLE, EXPIRED) > cancelado > sin estado; a igual prioridad, el más reciente. dataRecords.resource_id y dataRecords.external_id son los de ese trámite. dataRecords.data es IssuanceViafirmaData (internal_state, remote_status, KYC, notas públicas, can_reject, revocation_code, etc.); dataRecords.status = submitted (SUBMITTED), processing (trámite sin estado interno, DRAFT, CSR_GENERATED, POLLING, DOWNLOADED, FAILED_RECOVERABLE), ready (READY_TO_DOWNLOAD, ASSEMBLED, COMPLETED) o failed (REVOKED, FAILED, EXPIRED, CANCELLED). Mail: dataRecords.data = {"request_status": "..."}; dataRecords.status = ready (PROCESSED), failed (REJECTED) o processing (cualquier otro estado). Siempre responde 200 cuando la solicitud existe.
Request
Responses
- 200
- 401
- 404
- 429
- 500
Estado de la emisión.
No autenticado (token ausente, inválido o expirado).
La solicitud no existe o pertenece a otra empresa; el administrador accede a todas ('La solicitud de certificado {id} no existe.'; provider=null).
Límite general de 60 peticiones por minuto excedido.
Error interno. Hay dos formas de cuerpo: (a) error de la aplicación al consultar el estado: {success:false, message} con message 'Error interno del servidor. {detalle}' (un fallo de base de datos se reemplaza por un texto genérico sin SQL ni datos); (b) error no controlado, p. ej. cuando {id} no es un número entero (como el UUID de la solicitud) o falla la base de datos al buscar la solicitud: lo responde el manejador de errores general con {"message": "Server Error"}, sin success, en producción; si la petición no envía Accept: application/json, la respuesta puede ser una página HTML.