Emisión de Certificados

Emisión agnóstica del proveedor (mail / viafirma / futuros). Cada solicitud puede dispararse (POST /issue), consultarse (GET /issuance) y descargarse (GET /issuance/download). El proveedor activo se resuelve por cascada de configuración.

📄️Disparar emisión del certificado (provider-agnostic)

Inicia el flujo de emisión usando el proveedor activo (mail / viafirma / futuros). El proveedor se resuelve por cascada: payload override (admin) → companies.issuance_provider → CERTIFICATE_ISSUANCE_PROVIDER → fallback 'mail'. Para Viafirma el cuerpo debe incluir 'email_certificate'.

📄️Consultar estado del trámite

Devuelve el estado normalizado del trámite de emisión. Para Viafirma incluye internal_state, remote_status, public_id y fechas relevantes. Para 'mail' devuelve el request_status actual.

📄️Metadata de descarga del P12 (sólo Viafirma)

Retorna el PIN temporal y una URL firmada (24h) para descargar el .p12 ensamblado. Disponible cuando el estado interno es ASSEMBLED o COMPLETED. El parámetro es el UUID público de la solicitud (`certificate_requests.uuid`), no su ID numérico.

📄️Descarga del P12 en Base64

Devuelve el .p12 codificado en Base64 + PIN, para integración desatendida (ERP, scripts). Sólo proveedor Viafirma en estado ASSEMBLED/COMPLETED. El parámetro es el UUID público de la solicitud (`certificate_requests.uuid`), no su ID numérico.

📄️Genera orden de renovación de un certificado

Crea una orden de pago WOMPI para renovar la vigencia del certificado por 1 año adicional (llegando a 2 años de vida comercial total). Retorna la orden creada.