{"openapi":"3.0.3","info":{"title":"Nubex Certificados API","version":"1.0.0","description":"API privada por casa de software. Camerfirma está simulado: la API registra solicitudes y permite descargar archivos cargados por un administrador, sin emisión automática. Documentación y credenciales disponibles para administradores."},"servers":[{"url":"https://nubexcertificados.lovable.app"}],"security":[{"BearerAuth":[],"HouseCode":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"},"HouseCode":{"type":"apiKey","in":"header","name":"X-Software-House-Code"}},"schemas":{"Request":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"reference":{"type":"string"},"cert_type":{"type":"string"},"holder_name":{"type":"string"},"holder_document":{"type":"string"},"holder_email":{"type":"string"},"holder_phone":{"type":"string"},"company_nit":{"type":"string"},"company_name":{"type":"string"},"status":{"type":"string","enum":["recibida","enviada","en_validacion","emitida","entregada","rechazada","error","revocada"]},"operation":{"type":"string","enum":["emision","renovacion","revocatoria"]},"parent_request_id":{"type":"string","format":"uuid","nullable":true},"revocation_reason":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"provider_connection":{"type":"string","enum":["simulated"]}}}}},"paths":{"/api/public/v1/solicitudes":{"post":{"operationId":"createRequest","summary":"Registrar solicitud con cuatro documentos","description":"Máximo 25 MB total, 20 MB por archivo. PDF/JPG/PNG. Referencia única por casa de software; un duplicado devuelve 409. No admite URLs de documentos ni callback_url; el webhook se configura por empresa.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["reference","cert_type","holder_name","holder_document","holder_email","holder_phone","company_nit","company_name","camara_comercio","rut","cedula_frontal","cedula_trasera"],"properties":{"reference":{"type":"string","example":"ERP-2026-00891"},"cert_type":{"type":"string","example":"representacion_legal","enum":["representacion_legal","persona_natural","persona_juridica"]},"holder_name":{"type":"string","example":"Carlos Alberto Gómez Restrepo"},"holder_document":{"type":"string","example":"79845123"},"holder_email":{"type":"string","example":"titular@example.com"},"holder_phone":{"type":"string","example":"+573105551234"},"company_nit":{"type":"string","example":"900123456-1"},"company_name":{"type":"string","example":"Empresa de ejemplo S.A.S."},"camara_comercio":{"type":"string","format":"binary"},"rut":{"type":"string","format":"binary"},"cedula_frontal":{"type":"string","format":"binary"},"cedula_trasera":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Operación completada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"get":{"operationId":"listRequests","summary":"Consultar solicitudes de la empresa","parameters":[{"name":"reference","in":"query","schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Operación completada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Request"}},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}":{"get":{"operationId":"getRequest","summary":"Consultar estado y disponibilidad del certificado","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operación completada","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Request"},{"type":"object","properties":{"certificate":{"type":"object","properties":{"available":{"type":"boolean"},"download_url":{"type":"string","nullable":true}}}}}]}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}/documentos":{"get":{"operationId":"listDocuments","summary":"Consultar archivos recibidos por categoría","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operación completada","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"documents":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"size":{"type":"integer","nullable":true}}}}}}}}}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}/certificado":{"get":{"operationId":"downloadCertificate","summary":"Descargar P12/PFX privado","description":"Solo emitida o entregada. Descargar no cambia automáticamente el estado a entregada.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Binario del certificado","content":{"application/x-pkcs12":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}/clave":{"get":{"operationId":"getPassword","summary":"Consultar contraseña con permiso explícito","description":"Solo con credencial autorizada para contraseñas, certificado guardado y estado emitida o entregada. No se cachea ni se incluye en listados o webhooks.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operación completada","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"password":{"type":"string"}}}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}/renovacion":{"post":{"operationId":"renewCertificate","summary":"Solicitar renovación","description":"Solo certificados emitidos o entregados. Reutiliza RUT y cédula de la solicitud original; exige Cámara de comercio nueva.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["reference","camara_comercio"],"properties":{"reference":{"type":"string"},"camara_comercio":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Operación completada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/solicitudes/{id}/revocatoria":{"post":{"operationId":"revokeCertificate","summary":"Solicitar revocatoria","description":"Queda pendiente de aprobación administrativa. Al aprobarse, la solicitud original pasa a revocada.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reference","reason"],"properties":{"reference":{"type":"string"},"reason":{"type":"string","minLength":10,"maxLength":500}}}}}},"responses":{"201":{"description":"Operación completada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/certificados/ultimo":{"get":{"operationId":"lastCertificate","summary":"Copia del último certificado vigente del titular","parameters":[{"name":"holder_document","in":"query","required":true,"schema":{"type":"string"}},{"name":"company_nit","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Binario del certificado; X-Request-Id indica la solicitud","content":{"application/x-pkcs12":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/public/v1/estado-cuenta":{"get":{"operationId":"accountSummary","summary":"Estado de cuenta en cantidades","parameters":[{"name":"desde","in":"query","schema":{"type":"string","format":"date"}},{"name":"hasta","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Operación completada","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"by_operation":{"type":"object","additionalProperties":{"type":"integer"}},"by_status":{"type":"object","additionalProperties":{"type":"integer"}},"active_certificates":{"type":"integer"},"pending":{"type":"integer"}}}}}},"400":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"403":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"500":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Error de autenticación, validación, autorización o disponibilidad","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}