{"openapi":"3.0.3","info":{"title":"API de Reputación AR","version":"0.1.0","description":"Agrega fuentes públicas argentinas (BCRA, RePET, OpenSanctions, NIC.ar, ARCA, Georef) en un informe de reputación/riesgo por **CUIT** (KYB de empresa, el foco) o **DNI/CUIT** (individuo). **POC / uso interno** — NO es un buró comercial habilitado. Toda consulta se audita."},"servers":[{"url":"http://localhost:3100","description":"Local (POC)"}],"tags":[{"name":"Empresa","description":"KYB por CUIT — foco del servicio"},{"name":"Individuo","description":"Informe genérico por DNI/CUIT + eje anti-fraude"},{"name":"Auditoría","description":"Quién consultó qué (compliance)"},{"name":"Salud","description":"Liveness"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"parameters":{"Requester":{"name":"x-requester","in":"header","required":false,"description":"Quién consulta (queda en la auditoría). El portal manda el campo 'Consultado por'.","schema":{"type":"string","maxLength":120}}},"schemas":{"DeudaEntidad":{"type":"object","properties":{"entidad":{"type":"string","nullable":true},"situacion":{"type":"number","nullable":true,"description":"1 (normal) … 5 (irrecuperable)"},"monto":{"type":"number","nullable":true},"dias_atraso":{"type":"number","nullable":true},"periodo":{"type":"string","nullable":true,"description":"YYYYMM"}}},"Aml":{"type":"object","description":"Screening de sanciones/PEP (RePET + OpenSanctions). Hit = gate crítico → revisión manual.","properties":{"hit":{"type":"boolean"},"matches":{"type":"array","items":{"type":"object"}},"nota":{"type":"string"}}},"Identidad":{"type":"object","description":"Eje anti-fraude ORTOGONAL al crédito (llaves email/teléfono/CBU). Nunca se promedia con el crédito.","properties":{"fraude_score":{"type":"number","nullable":true,"description":"0-100 (mayor = más señal de fraude)"},"riesgo_fraude":{"type":"string","nullable":true}},"additionalProperties":true},"Kyb":{"type":"object","description":"Informe KYB de empresa + score compuesto transparente.","properties":{"cuit":{"type":"string"},"tipo":{"type":"string","enum":["empresa","persona","invalido"]},"denominacion":{"type":"string","nullable":true},"reputacion_score":{"type":"number","nullable":true,"description":"0-100 (mayor = menor riesgo); null si no hay señal"},"riesgo":{"type":"string","enum":["bajo","medio","alto","critico","sin_datos"]},"flags":{"type":"array","items":{"type":"string"}},"financiero":{"type":"object","properties":{"situacion":{"type":"number","nullable":true},"deuda_total":{"type":"number","nullable":true},"dias_atraso_max":{"type":"number","nullable":true},"tendencia":{"type":"string","nullable":true,"description":"mejora | estable | empeora"},"cheques_rechazados":{"type":"number"},"le_debe_a":{"type":"array","items":{"$ref":"#/components/schemas/DeudaEntidad"}}}},"aml":{"$ref":"#/components/schemas/Aml"},"fiscal":{"type":"object","nullable":true,"properties":{"estado":{"type":"string","nullable":true},"activo":{"type":"boolean","nullable":true},"condicion":{"type":"string","nullable":true},"actividad":{"type":"string","nullable":true},"domicilio":{"type":"string","nullable":true}}},"concursos":{"type":"object","properties":{"hit":{"type":"boolean"},"casos":{"type":"array","items":{"type":"object"}},"nota":{"type":"string"}}},"presencia":{"type":"object","nullable":true,"description":"Anti-fantasma (requiere ?dominio=).","properties":{"dominio":{"type":"string","nullable":true},"antiguedad_anios":{"type":"number","nullable":true},"dominio_activo":{"type":"boolean","nullable":true},"web_viva":{"type":"boolean"},"tiene_mx":{"type":"boolean"}}},"pesos":{"type":"object","additionalProperties":{"type":"number"}},"fuentes":{"type":"object","additionalProperties":{"type":"string"}},"fetched_at":{"type":"string","format":"date-time"}}},"Reputacion":{"type":"object","description":"Informe por DNI o CUIT (individuo). Crédito + AML + eje anti-fraude + recomendación de onboarding.","properties":{"input":{"type":"string"},"tipo":{"type":"string","enum":["cuit_cuil","dni","invalido"]},"identificacion":{"type":"string","nullable":true},"cuil_formateado":{"type":"string","nullable":true},"denominacion":{"type":"string","nullable":true},"credito":{"type":"object","properties":{"situacion":{"type":"number","nullable":true},"deuda_total":{"type":"number","nullable":true},"dias_atraso_max":{"type":"number","nullable":true},"periodo":{"type":"string","nullable":true},"deudas":{"type":"array","items":{"$ref":"#/components/schemas/DeudaEntidad"}}}},"cheques_rechazados":{"type":"number"},"aml":{"$ref":"#/components/schemas/Aml"},"fiscal":{"type":"object","nullable":true,"properties":{"estado":{"type":"string","nullable":true},"condicion":{"type":"string","nullable":true},"actividad":{"type":"string","nullable":true},"domicilio":{"type":"string","nullable":true}}},"identidad":{"$ref":"#/components/schemas/Identidad"},"recomendacion_onboarding":{"type":"string","enum":["aprobar","verificar_identidad","revisar_manual","rechazar_gate"]},"motivos":{"type":"array","items":{"type":"string"}},"fuentes":{"type":"object","additionalProperties":{"type":"string"}},"fetched_at":{"type":"string","format":"date-time"}}},"AuditoriaResponse":{"type":"object","properties":{"total":{"type":"number"},"mostrando":{"type":"number"},"items":{"type":"array","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"detalle":{"type":"string"}}}}},"security":[{"apiKey":[]},{}],"paths":{"/empresa/{cuit}":{"get":{"tags":["Empresa"],"summary":"KYB de empresa por CUIT","description":"Informe consolidado + score compuesto (financiero 0.60 · presencia 0.25 · existencia 0.15). AML es gate.","parameters":[{"name":"cuit","in":"path","required":true,"schema":{"type":"string"},"example":"30703088534"},{"name":"razon_social","in":"query","required":false,"schema":{"type":"string"}},{"name":"dominio","in":"query","required":false,"description":"Habilita el sub-score de presencia (anti-fantasma).","schema":{"type":"string"},"example":"mercadolibre.com.ar"},{"$ref":"#/components/parameters/Requester"}],"responses":{"200":{"description":"Informe KYB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kyb"}}}},"401":{"description":"API key requerida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Fuente pública no disponible","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reputacion/{id}":{"get":{"tags":["Individuo"],"summary":"Informe por DNI o CUIT (individuo)","description":"Crédito (BCRA) + AML + eje anti-fraude (email/teléfono/CBU) + recomendación de onboarding (matriz crédito × fraude).","parameters":[{"name":"id","in":"path","required":true,"description":"DNI (7-8 díg) o CUIT/CUIL (11 díg).","schema":{"type":"string"},"example":"27000000001"},{"name":"nombre","in":"query","required":false,"schema":{"type":"string"}},{"name":"email","in":"query","required":false,"schema":{"type":"string","format":"email"}},{"name":"telefono","in":"query","required":false,"schema":{"type":"string"},"example":"+541122334455"},{"name":"cbu","in":"query","required":false,"description":"CBU/CVU (22 díg).","schema":{"type":"string"}},{"$ref":"#/components/parameters/Requester"}],"responses":{"200":{"description":"Informe de reputación","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reputacion"}}}},"401":{"description":"API key requerida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Fuente pública no disponible","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/auditoria":{"get":{"tags":["Auditoría"],"summary":"Buscar / exportar consultas","description":"Filtra el log de auditoría (quién/qué/cuándo/resultado). `format=csv` descarga el CSV.","parameters":[{"name":"requester","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Texto libre (input consultado, denominación).","schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","enum":["empresa","individuo"]}},{"name":"desde","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":300,"maximum":2000}},{"$ref":"#/components/parameters/Requester"}],"responses":{"200":{"description":"Listado (JSON) o archivo (CSV)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditoriaResponse"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["Salud"],"summary":"Liveness","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"}}}}}}}}}}}