Rechazar una solicitud Viafirma en curso (definitivo)
POST/certificate-request/:id/issuance/reject
Rechaza la solicitud en Viafirma RA (PUT /request/reject, API v3.4.70), la marca como CANCELLED (la solicitud queda cancelada), detiene el polling, reintegra el cupo consumido y avisa a la cuenta maestra de la empresa por correo y WhatsApp. Uso típico: se llenaron mal los datos del certificado y debe crearse una solicitud NUEVA (la misma solicitud no puede volver a emitirse). NO anula certificados emitidos (para eso está POST /certificate-request/{uuid}/revoke). Es IRREVERSIBLE. Requisitos: solicitud tramitada con Viafirma, en PROCESSING, con el trámite en SUBMITTED, POLLING o FAILED_RECOVERABLE (sin certificado emitido) y en un estado remoto que Viafirma admita rechazar; can_reject en GET /certificate-request/{id}/issuance lo anticipa, pero la decisión final es de Viafirma. Si el trámite nunca llegó a Viafirma (sin cod_request) o Viafirma ya no lo encuentra, se cancela solo localmente. Si la solicitud tiene varios trámites Viafirma, se evalúa y rechaza el trámite vigente, el mismo que informa GET /certificate-request/{id}/issuance (prioridad: con certificado emitido > con KYC completado > en curso > fallido > cancelado > sin estado; a igual prioridad, el más reciente). Un administrador (users.is_admin) puede rechazar cualquier solicitud; los demás usuarios, solo las de su empresa (las ajenas responden 404).
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
- 500
- 502
Solicitud rechazada.
No autenticado (token ausente, inválido o expirado).
La empresa del usuario está inactiva ('Acceso no autorizado. La empresa se encuentra inactiva.').
Solicitud inexistente o de otra empresa ('No se encontró un trámite Viafirma para la solicitud {id}.'), o usuario no administrador sin empresa asociada ('No se encontró la empresa asociada al usuario.').
La solicitud no está en PROCESSING; el trámite no tiene estado, ya finalizó (COMPLETED, REVOKED, FAILED, EXPIRED o CANCELLED) o ya tiene certificado emitido (READY_TO_DOWNLOAD, DOWNLOADED, ASSEMBLED: corresponde revocar); Viafirma no admite el rechazo en su estado actual (debe gestionarlo un operador RA vía soporte); o la solicitud se está actualizando en ese momento (reintentar en unos segundos).
Validación del motivo fallida (con errors; el único campo validado es reason), o la solicitud no se tramita con Viafirma ('El rechazo solo aplica a solicitudes tramitadas con Viafirma.', sin errors).
Límite general de 60 peticiones por minuto excedido.
Error interno, incluido el caso en que Viafirma ya rechazó la solicitud pero no pudo actualizarse localmente ('La solicitud se rechazó en Viafirma pero no se pudo actualizar localmente.'); el polling la cerrará después.
Error de comunicación con Viafirma RA o respuesta de error no prevista ('Error de comunicación con Viafirma RA. Intente nuevamente.'). No se modificó nada localmente.