{"openapi":"3.0.3","info":{"title":"Cifra API","version":"1.0.0","description":"API unificada de datos públicos de Chile (indicadores, riesgo/compliance, tributario e inteligencia comercial) y facturación electrónica ante el SII. Solo fuentes públicas y oficiales; el certificado digital y los folios son siempre del cliente.","contact":{"name":"Cifra","url":"https://0.0.0.0:3000"}},"servers":[{"url":"https://0.0.0.0:3000"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RespuestaDataset":{"type":"object","properties":{"producto":{"type":"string"},"dataset":{"type":"string"},"capa":{"type":"string"},"fuente":{"type":"string"},"estado_datos":{"type":"string","enum":["live","cached","sample"]},"actualizado":{"type":"string","format":"date-time"},"count":{"type":"integer"},"data":{"type":"array","items":{"type":"object"}}}},"Emisor":{"type":"object","required":["rut","razonSocial","giro","acteco","direccion","comuna"],"properties":{"rut":{"type":"string","example":"76000000-0"},"razonSocial":{"type":"string"},"giro":{"type":"string"},"acteco":{"type":"string","example":"620200"},"direccion":{"type":"string"},"comuna":{"type":"string"}}},"Receptor":{"type":"object","required":["rut","razonSocial"],"properties":{"rut":{"type":"string","example":"77000000-1"},"razonSocial":{"type":"string"},"giro":{"type":"string"},"direccion":{"type":"string"},"comuna":{"type":"string"}}},"Item":{"type":"object","required":["nombre","cantidad","precioUnitario"],"properties":{"nombre":{"type":"string"},"cantidad":{"type":"number"},"precioUnitario":{"type":"number","description":"Precio neto, sin IVA."}}},"DteRequest":{"type":"object","required":["tipo","emisor","items"],"properties":{"tipo":{"type":"integer","enum":[33,34,39,56,61],"description":"33 factura · 34 factura exenta · 39 boleta · 56 nota de débito · 61 nota de crédito."},"folio":{"type":"integer","description":"Opcional: si se omite se toma del CAF."},"emisor":{"$ref":"#/components/schemas/Emisor"},"receptor":{"$ref":"#/components/schemas/Receptor"},"items":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/Item"}},"referencia":{"type":"object","description":"Obligatoria en notas de crédito (61) y débito (56).","properties":{"tipoDocRef":{"type":"integer"},"folioRef":{"type":"integer"},"fechaRef":{"type":"string","format":"date"},"codigo":{"type":"integer","enum":[1,2,3]},"razon":{"type":"string"}}}}},"DteRespuesta":{"type":"object","properties":{"estado":{"type":"string"},"origen_folio":{"type":"string","enum":["provisto","caf","demo"]},"tipoDte":{"type":"integer"},"folio":{"type":"integer"},"fecha":{"type":"string","format":"date"},"totales":{"type":"object","properties":{"neto":{"type":"integer"},"iva":{"type":"integer"},"total":{"type":"integer"}}},"timbre":{"type":"string","description":"PNG del timbre PDF417 en data URI."},"xml":{"type":"string"}}},"PdfBase64":{"type":"object","properties":{"estado":{"type":"string"},"nombre":{"type":"string"},"mime":{"type":"string"},"bytes":{"type":"integer"},"pdf_base64":{"type":"string"}}},"Boleta":{"type":"object","properties":{"folio":{"type":"integer","nullable":true},"fecha_emision":{"type":"string","nullable":true,"example":"07/07/2026"},"rut_contraparte":{"type":"string","nullable":true},"nombre_contraparte":{"type":"string","nullable":true},"monto_bruto":{"type":"integer","nullable":true},"retencion":{"type":"integer","nullable":true},"monto_liquido":{"type":"integer","nullable":true},"anulada":{"type":"boolean"},"fecha_anulacion":{"type":"string","nullable":true},"codigo_barras":{"type":"string","nullable":true},"codigo_comuna":{"type":"string","nullable":true},"sociedad_profesional":{"type":"boolean"}}},"BheRespuesta":{"type":"object","properties":{"fuente":{"type":"string"},"estado_datos":{"type":"string","enum":["live"]},"direccion":{"type":"string","enum":["recibidas","emitidas"]},"periodicidad":{"type":"string","enum":["anual","mensual","diario"]},"periodo":{"type":"object","properties":{"anio":{"type":"integer"},"mes":{"type":"integer"}}},"contribuyente":{"type":"object","properties":{"nombre":{"type":"string","nullable":true},"rut":{"type":"string","nullable":true},"total_boletas":{"type":"integer","nullable":true}}},"count":{"type":"integer"},"totales":{"type":"object","properties":{"boletas_vigentes":{"type":"integer"},"boletas_anuladas":{"type":"integer"},"honorarios_brutos":{"type":"integer"},"retencion":{"type":"integer"},"liquido":{"type":"integer"}}},"boletas":{"type":"array","items":{"$ref":"#/components/schemas/Boleta"}},"resumen_mensual":{"type":"array","description":"Solo en periodicidad anual: totales por mes.","items":{"type":"object","properties":{"mes":{"type":"integer"},"honorarios":{"type":"integer"},"retencion_emisor":{"type":"integer"},"retencion_receptor":{"type":"integer"},"liquido":{"type":"integer"}}}}}},"ResumenTipoDoc":{"type":"object","description":"Totales de un tipo de documento en el período, tal como los agrupa el SII.","properties":{"tipo_dte":{"type":"integer","description":"33 factura afecta, 39 boleta, 61 nota de crédito…"},"nombre":{"type":"string"},"documentos":{"type":"integer"},"monto_exento":{"type":"integer"},"monto_neto":{"type":"integer"},"monto_iva":{"type":"integer","description":"IVA recuperable. Excluye el no recuperable."},"iva_no_recuperable":{"type":"integer","description":"No forma parte del crédito fiscal."},"iva_uso_comun":{"type":"integer","description":"Se recupera en proporción al factor del período."},"monto_total":{"type":"integer"},"otros_impuestos":{"type":"integer","description":"Impuestos adicionales del documento (ILA de bebidas, tabacos, combustibles). Se informan aparte: según el giro pueden ser crédito o costo, y nunca se suman al crédito fiscal automáticamente."}}},"RcvRespuesta":{"type":"object","properties":{"periodo":{"type":"string","example":"2026-07"},"operacion":{"type":"string","enum":["compra","venta"]},"estado":{"type":"string","enum":["REGISTRO","PENDIENTE","NO_INCLUIR","RECLAMADO"]},"factor_proporcionalidad":{"type":"number"},"totales":{"type":"object","description":"Las notas de crédito (61) restan, aunque el SII las informe en positivo.","properties":{"documentos":{"type":"integer"},"neto":{"type":"integer"},"exento":{"type":"integer"},"iva":{"type":"integer"},"otros_impuestos":{"type":"integer"},"total":{"type":"integer"}}},"resumen":{"type":"array","items":{"$ref":"#/components/schemas/ResumenTipoDoc"}},"documentos":{"type":"array","description":"Solo con detalle=1. Las boletas y los comprobantes de pago no aparecen: el SII los entrega agregados porque no identifican al receptor.","items":{"type":"object","properties":{"tipo_dte":{"type":"integer","nullable":true},"folio":{"type":"integer","nullable":true},"rut_contraparte":{"type":"string","nullable":true},"razon_social":{"type":"string","nullable":true},"fecha_emision":{"type":"string","nullable":true},"monto_neto":{"type":"integer","nullable":true},"monto_iva":{"type":"integer","nullable":true},"monto_total":{"type":"integer","nullable":true}}}},"sin_datos":{"type":"boolean"}}},"IvaProyeccion":{"type":"object","properties":{"fuente":{"type":"string"},"estado_datos":{"type":"string","enum":["live"]},"periodo":{"type":"string","example":"2026-07"},"contribuyente":{"type":"object","properties":{"rut":{"type":"string"},"nombre":{"type":"string","nullable":true}}},"factor_proporcionalidad":{"type":"number","description":"Aplicable al IVA de uso común."},"resumen":{"type":"object","properties":{"ventas":{"type":"array","items":{"$ref":"#/components/schemas/ResumenTipoDoc"}},"compras":{"type":"array","items":{"$ref":"#/components/schemas/ResumenTipoDoc"}}}},"proyeccion":{"type":"object","properties":{"dias_con_datos":{"type":"integer"},"dias_del_periodo":{"type":"integer"},"parcial":{"type":"boolean","description":"El período sigue abierto: las cifras proyectadas son estimaciones."},"posicion_actual":{"type":"integer","description":"Débito − crédito − remanente. Negativo significa remanente a favor."},"a_pagar_hoy":{"type":"integer","description":"Nunca negativo."},"remanente_hoy":{"type":"integer"},"proyectado":{"type":"object","properties":{"debito":{"type":"integer"},"credito":{"type":"integer"},"a_pagar":{"type":"integer"},"remanente":{"type":"integer"}}},"confianza":{"type":"string","enum":["alta","media","baja"],"description":"Según la fracción del período observada. Con pocos días, la proyección es poco fiable."},"vence":{"type":"string","format":"date","description":"Día 20 del mes siguiente. No se modela la prórroga por fin de semana."},"dias_para_vencer":{"type":"integer"}}},"remanente":{"type":"object","properties":{"aplicado":{"type":"integer"},"origen":{"type":"string","enum":["indicado","calculado","sin_determinar"]},"periodos_revisados":{"type":"integer"},"truncada":{"type":"boolean","description":"Se alcanzó el tope de 12 períodos hacia atrás."}}},"ppm":{"type":"object","properties":{"base_imponible":{"type":"integer","description":"Ingresos brutos según el SII (código 563)."},"tasa":{"type":"number","description":"Porcentaje (código 115)."},"monto":{"type":"integer"},"es_propyme":{"type":"boolean"},"en_plazo":{"type":"boolean"}}},"retenciones":{"type":"object","description":"Retenciones de honorarios (código 151). No son impuesto de la empresa —es dinero del profesional que se entera al Fisco por él— pero salen de la misma caja. Se suma lo efectivamente retenido según el SII, no una tasa codificada: la tasa legal sube cada año y calcularla llevaría a errores silenciosos.","properties":{"boletas":{"type":"integer","description":"Boletas recibidas vigentes. Las anuladas se excluyen."},"honorarios_brutos":{"type":"integer"},"retencion":{"type":"integer"},"liquido":{"type":"integer"},"tasa_implicita":{"type":"number","nullable":true,"description":"Derivada de los montos. Informativa: sirve para detectar anomalías."},"anuladas":{"type":"integer"}}},"total_f29":{"type":"object","description":"IVA + PPM + retenciones de honorarios. Marcado como incompleto: quedan fuera los impuestos adicionales declarables y los créditos especiales, que dependen de información que el SII no expone.","properties":{"iva":{"type":"integer"},"ppm":{"type":"integer"},"retenciones":{"type":"integer"},"total":{"type":"integer"},"proyectado":{"type":"integer"},"incompleto":{"type":"boolean"},"falta":{"type":"string"}}},"otros_impuestos":{"type":"object","properties":{"compras":{"type":"integer"},"ventas":{"type":"integer"},"nota":{"type":"string"}}},"pendientes_de_acuse":{"type":"object","description":"Compras recibidas sin acuse de recibo: su IVA no entra al crédito hasta que se aceptan.","properties":{"documentos":{"type":"integer"},"neto":{"type":"integer"},"iva":{"type":"integer"},"a_pagar_si_se_registran":{"type":"integer"}}},"simulacion":{"type":"object","properties":{"compra_neta":{"type":"integer"},"credito_adicional":{"type":"integer"},"a_pagar_despues":{"type":"integer"},"ahorro":{"type":"integer"},"compra_neta_util_maxima":{"type":"integer","description":"Más allá de este monto el crédito supera al débito y el exceso solo sirve el período siguiente."},"excede_el_optimo":{"type":"boolean"}}},"proveedores":{"type":"object","properties":{"total_proveedores":{"type":"integer"},"concentracion_top3":{"type":"number","description":"% del gasto en los tres mayores."},"top":{"type":"array","items":{"type":"object","properties":{"rut":{"type":"string"},"razon_social":{"type":"string"},"documentos":{"type":"integer"},"neto":{"type":"integer"},"participacion":{"type":"number"}}}}}},"aviso":{"type":"string"}}},"IvaHistorico":{"type":"object","properties":{"meses":{"type":"integer"},"serie":{"type":"array","items":{"type":"object","properties":{"periodo":{"type":"string","example":"2026-06"},"debito":{"type":"integer"},"credito":{"type":"integer"},"remanente_inicial":{"type":"integer"},"a_pagar":{"type":"integer"},"remanente":{"type":"integer"},"ventas_neto":{"type":"integer"},"compras_neto":{"type":"integer"},"carga_efectiva":{"type":"number","nullable":true,"description":"% del neto vendido que se va en IVA."},"sin_datos":{"type":"boolean"}}}},"promedio_a_pagar":{"type":"integer","nullable":true,"description":"Excluye el período en curso, que está incompleto."}}},"F29Respuesta":{"type":"object","properties":{"periodo":{"type":"string"},"contribuyente":{"type":"object","properties":{"rut":{"type":"string"},"nombre":{"type":"string"},"direccion":{"type":"string"},"comuna":{"type":"string"},"categoria_tributaria":{"type":"integer"}}},"ppm":{"type":"object","properties":{"base_imponible":{"type":"integer"},"tasa":{"type":"number"},"monto":{"type":"integer"},"es_propyme":{"type":"boolean"},"en_plazo":{"type":"boolean"}}},"declaracion":{"type":"object","properties":{"declarado":{"type":"boolean"},"detalle":{"type":"array","items":{"type":"object"}}}},"aviso":{"type":"string"}}},"LineaF29":{"type":"object","description":"Un recuadro del formulario, con el origen del número para poder auditarlo.","properties":{"codigo":{"type":"integer","description":"Código del recuadro en el F29."},"concepto":{"type":"string"},"valor":{"type":"number"},"unidad":{"type":"string","enum":["pesos","cantidad","porcentaje"],"default":"pesos","description":"El formulario mezcla las tres en el mismo tipo de recuadro. Formatear todo como moneda muestra la tasa de PPM de 0,1% como $0."},"origen":{"type":"string","description":"De dónde salió el número."}}},"PropuestaF29":{"type":"object","properties":{"contribuyente":{"type":"object","properties":{"rut":{"type":"string"}}},"declarado":{"type":"boolean","description":"El período ya fue declarado ante el SII."},"propuesta":{"type":"object","properties":{"periodo":{"type":"string"},"debitos":{"type":"array","items":{"$ref":"#/components/schemas/LineaF29"}},"creditos":{"type":"array","items":{"$ref":"#/components/schemas/LineaF29"}},"impuesto":{"type":"array","items":{"$ref":"#/components/schemas/LineaF29"}},"otros":{"type":"array","items":{"$ref":"#/components/schemas/LineaF29"}},"total_a_pagar":{"type":"integer"},"incompleta":{"type":"boolean","description":"Siempre true: hay tramos que el SII no expone."},"no_incluye":{"type":"array","items":{"type":"string"}},"advertencia":{"type":"string"}}},"comparacion":{"type":"object","description":"Presente solo si el período ya fue declarado.","properties":{"diferencias":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"integer"},"concepto":{"type":"string"},"calculado":{"type":"number"},"declarado":{"type":"number"},"diferencia":{"type":"number"}}}},"sin_diferencias":{"type":"boolean"},"nota":{"type":"string"}}}}},"Oportunidad":{"type":"object","properties":{"codigo":{"type":"string","example":"1233600-43-LE26"},"nombre":{"type":"string"},"estado":{"type":"string"},"organismo":{"type":"string","nullable":true},"rut_comprador":{"type":"string","nullable":true,"description":"Llave del cruce con tu registro de ventas."},"region":{"type":"string","nullable":true},"comuna":{"type":"string","nullable":true},"monto_estimado":{"type":"integer","nullable":true,"description":"null cuando el organismo eligió no publicarlo."},"moneda":{"type":"string","nullable":true},"dias_para_cierre":{"type":"integer","nullable":true},"fecha_cierre":{"type":"string","nullable":true},"items":{"type":"array","items":{"type":"object"}},"url":{"type":"string"},"relacion":{"type":"string","enum":["cliente","nuevo"]},"historial":{"type":"object","nullable":true,"description":"Presente solo si el organismo ya es cliente.","properties":{"documentos":{"type":"integer"},"monto":{"type":"integer"},"ultima_venta":{"type":"string","nullable":true}}}}},"RadarRespuesta":{"type":"object","properties":{"termino":{"type":"string","nullable":true},"universo":{"type":"integer","description":"Licitaciones abiertas en total."},"coincidencias":{"type":"integer","description":"Cuántas calzan con el texto."},"analizadas":{"type":"integer","description":"Cuántas se enriquecieron con su detalle."},"clientes_conocidos":{"type":"integer"},"periodo_cruce":{"type":"string","nullable":true},"oportunidades":{"type":"array","items":{"$ref":"#/components/schemas/Oportunidad"}},"aviso_cruce":{"type":"string","description":"Presente si no se pudo cruzar con el SII."}}},"InformeLicitaciones":{"type":"object","properties":{"filtro":{"type":"object"},"universo":{"type":"integer"},"enriquecidas":{"type":"integer"},"analizadas":{"type":"integer","description":"Las que quedaron tras aplicar los filtros."},"cobertura_monto":{"type":"object","description":"Sin esto el monto total engaña: no todos los organismos lo publican.","properties":{"con_monto_publicado":{"type":"integer"},"sin_monto_publicado":{"type":"integer"},"porcentaje":{"type":"number"}}},"monto_total_publicado":{"type":"integer"},"urgencia":{"type":"object","properties":{"cierra_hoy":{"type":"integer"},"en_2_dias":{"type":"integer"},"en_7_dias":{"type":"integer"},"mas_de_7":{"type":"integer"}}},"opciones":{"type":"object","description":"Valores presentes en la muestra, para poblar filtros.","properties":{"regiones":{"type":"array","items":{"type":"string"}},"organismos":{"type":"array","items":{"type":"string"}}}},"por_organismo":{"type":"array","items":{"type":"object"}},"por_region":{"type":"array","items":{"type":"object"}}}},"BusquedasRadar":{"type":"object","properties":{"maximo":{"type":"integer","example":10},"busquedas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"nombre":{"type":"string"},"termino":{"type":"string","nullable":true},"dias_maximos":{"type":"integer","nullable":true},"solo_clientes":{"type":"boolean"},"notificar_email":{"type":"boolean"},"activa":{"type":"boolean"},"creada":{"type":"string"},"ultima_revision":{"type":"string","nullable":true},"sin_leer":{"type":"integer"}}}}}},"AlertasRadar":{"type":"object","properties":{"sin_leer":{"type":"integer"},"alertas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"busqueda_id":{"type":"integer"},"busqueda_nombre":{"type":"string"},"clase":{"type":"string","enum":["nueva","cierra_pronto","cambio_estado"]},"codigo":{"type":"string"},"nombre":{"type":"string"},"organismo":{"type":"string","nullable":true},"rut_comprador":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"monto_estimado":{"type":"integer","nullable":true},"dias_para_cierre":{"type":"integer","nullable":true},"es_cliente":{"type":"boolean"},"detalle":{"type":"string","nullable":true},"leida":{"type":"boolean"},"creada":{"type":"string"}}}}}},"SituacionTributaria":{"type":"object","properties":{"rut":{"type":"string","example":"61608204-3"},"registrado":{"type":"boolean"},"razon_social":{"type":"string","nullable":true,"description":"null si el SII lo enmascara por ser persona natural."},"es_persona_natural":{"type":"boolean"},"inicio_actividades":{"type":"boolean"},"fecha_inicio_actividades":{"type":"string","nullable":true},"primera_categoria":{"type":"boolean"},"autorizado_a_timbrar":{"type":"boolean"},"timbraje_electronico":{"type":"boolean"},"giros":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descripcion":{"type":"string"},"categoria_tributaria":{"type":"string"},"fecha_inicio":{"type":"string","nullable":true},"afecto_iva":{"type":"boolean"}}}},"observaciones":{"type":"array","items":{"type":"string"}},"puede_emitir_dte":{"type":"boolean","description":"Veredicto deducido por Cifra, no entregado por el SII."},"motivo":{"type":"string"}}},"RiesgoClientes":{"type":"object","properties":{"periodo":{"type":"string"},"total_neto":{"type":"integer"},"documentos_identificados":{"type":"integer"},"documentos_sin_receptor":{"type":"integer","description":"Boletas y comprobantes: el SII no informa comprador."},"concentracion_top1":{"type":"number","nullable":true},"concentracion_top3":{"type":"number","nullable":true},"conducta":{"type":"object","properties":{"con_acuse":{"type":"integer"},"sin_acuse":{"type":"integer"},"reclamados":{"type":"integer"},"dias_acuse_promedio":{"type":"number","nullable":true},"sin_informacion":{"type":"boolean"}}},"clientes":{"type":"array","items":{"type":"object"}},"alertas":{"type":"array","items":{"type":"object"}}}},"RiesgoProveedores":{"type":"object","properties":{"periodo":{"type":"string"},"sin_datos":{"type":"boolean","description":"No hay compras con proveedor identificado."},"proveedores":{"type":"array","items":{"type":"object","properties":{"rut":{"type":"string"},"razon_social":{"type":"string"},"documentos":{"type":"integer"},"neto":{"type":"integer"},"iva":{"type":"integer"},"participacion":{"type":"number","nullable":true,"description":"% del neto comprado en el período."},"ultima_factura":{"type":"string","nullable":true}}}},"total_proveedores":{"type":"integer"},"total_neto":{"type":"integer"},"concentracion_top3":{"type":"number","nullable":true},"boletin_disponible":{"type":"boolean","description":"Si es false, la ausencia de alertas concursales no prueba nada: el Boletín no se pudo consultar."},"aviso_boletin":{"type":"string"},"alertas":{"type":"array","items":{"type":"object","properties":{"clase":{"type":"string","enum":["concursal","concentracion","sin_movimiento","posible_duplicado"]},"severidad":{"type":"string","enum":["alta","media","informativa"]},"titulo":{"type":"string"},"detalle":{"type":"string"},"rut":{"type":"string"},"monto":{"type":"number"}}}},"aviso":{"type":"string"}}},"BoletasDiarias":{"type":"object","properties":{"periodo":{"type":"string"},"tipo_dte":{"type":"integer","enum":[39,41]},"documentos":{"type":"integer"},"monto_neto":{"type":"integer"},"monto_exento":{"type":"integer"},"monto_iva":{"type":"integer"},"monto_total":{"type":"integer"},"promedio_diario":{"type":"integer","description":"Sobre los días CON venta, no sobre el mes completo."},"mejor_dia":{"type":"object","nullable":true},"dias":{"type":"array","items":{"type":"object","properties":{"dia":{"type":"integer"},"documentos":{"type":"integer"},"monto_neto":{"type":"integer"},"monto_exento":{"type":"integer"},"monto_iva":{"type":"integer"},"monto_total":{"type":"integer"},"modificado":{"type":"boolean","description":"El contribuyente ajustó el resumen de ese día en el portal."}}}},"aviso":{"type":"string"}}},"ConciliacionRespuesta":{"type":"object","properties":{"resumen":{"type":"object","properties":{"documentos_sii":{"type":"integer"},"documentos_erp":{"type":"integer"},"coincidentes":{"type":"integer"},"faltantes_en_erp":{"type":"integer"},"sobrantes_en_erp":{"type":"integer"},"diferencias_monto":{"type":"integer"},"tasa_calce":{"type":"number","description":"% de documentos del SII que calzan exactamente."},"monto_faltante":{"type":"integer"},"monto_sobrante":{"type":"integer"},"monto_diferencias":{"type":"integer"},"exposicion_iva":{"type":"integer","description":"IVA estimado involucrado en las diferencias."}}},"discrepancias":{"type":"array","items":{"type":"object","properties":{"clase":{"type":"string","enum":["faltante_en_erp","sobrante_en_erp","diferencia_monto"]},"tipo":{"type":"integer","nullable":true},"folio":{"type":"integer","nullable":true},"rut":{"type":"string","nullable":true},"razon_social":{"type":"string","nullable":true},"fecha":{"type":"string","nullable":true},"monto_sii":{"type":"integer","nullable":true},"monto_erp":{"type":"integer","nullable":true},"diferencia":{"type":"integer","nullable":true},"motivo":{"type":"string"}}}},"mapeo":{"type":"object","description":"Columnas reconocidas en cada archivo."},"avisos":{"type":"array","items":{"type":"string"}}}},"FoliosRespuesta":{"type":"object","properties":{"total_disponibles":{"type":"integer"},"rangos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"tipo_dte":{"type":"integer"},"desde":{"type":"integer"},"hasta":{"type":"integer"},"siguiente":{"type":"integer"},"disponibles":{"type":"integer"},"usados":{"type":"integer"},"agotado":{"type":"boolean"},"anulado":{"type":"boolean"}}}}}}}},"tags":[{"name":"Catálogo"},{"name":"Indicadores"},{"name":"Riesgo / Compliance"},{"name":"Tributario"},{"name":"Inteligencia comercial"},{"name":"Facturación electrónica"},{"name":"Folios (CAF)"},{"name":"Boletas de honorarios"},{"name":"Conciliación"}],"paths":{"/api/v1":{"get":{"tags":["Catálogo"],"summary":"Lista los datasets disponibles","security":[],"responses":{"200":{"description":"Catálogo de datasets"}}}},"/api/v1/cuenta":{"get":{"tags":["Catálogo"],"summary":"Estado de la suscripción","description":"Plan asociado a la API key, límites vigentes por categoría y estado del certificado digital.","responses":{"200":{"description":"Estado de la cuenta"},"401":{"description":"Falta o es inválida la API key"}}}},"/api/v1/indicadores":{"get":{"tags":["Indicadores"],"summary":"Indicadores económicos","description":"UF, UTM, dólar, euro, IPC, TPM, IMACEC, desempleo y cobre del día. Fuente: Banco Central de Chile (vía mindicador.cl). Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/tasa-maxima-convencional":{"get":{"tags":["Indicadores"],"summary":"Tasa Máxima Convencional (CMF)","description":"Tope legal de interés para créditos en Chile por tipo de operación. Clave para financieras y bancos. Fuente: Comisión para el Mercado Financiero (CMF). Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/feriados":{"get":{"tags":["Tributario"],"summary":"Feriados legales","description":"Feriados de Chile por año, con tipo e irrenunciabilidad. Útil para plazos tributarios y de abastecimiento. Fuente: Gobierno Digital de Chile. Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/sii-actividades":{"get":{"tags":["Tributario"],"summary":"Actividades económicas SII","description":"Códigos de actividad económica del SII con categoría tributaria y afectación a IVA. Fuente: Servicio de Impuestos Internos (SII). Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/validar-rut":{"get":{"tags":["Tributario"],"summary":"Validación de RUT","description":"Valida y formatea un RUT chileno (dígito verificador, módulo 11). Sin credenciales. Fuente: Cálculo (algoritmo módulo 11). Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/comunas":{"get":{"tags":["Tributario"],"summary":"Regiones y Comunas","description":"División político-administrativa de Chile: 346 comunas en 16 regiones. Para formularios, direcciones y DTE. Fuente: SUBDERE (división político-administrativa). Plan mínimo: free.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/boletin-concursal":{"get":{"tags":["Riesgo / Compliance"],"summary":"Boletín Concursal (empresas)","description":"Procedimientos de liquidación y reorganización de EMPRESAS. Dato clave de riesgo crediticio. Fuente: Superintendencia de Insolvencia y Reemprendimiento. Plan mínimo: pro.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/diario-oficial":{"get":{"tags":["Riesgo / Compliance"],"summary":"Diario Oficial — Sociedades","description":"Constitución, modificación y disolución de sociedades. Para KYC e inteligencia comercial. Fuente: Diario Oficial de la República de Chile. Plan mínimo: pro.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/v1/licitaciones":{"get":{"tags":["Inteligencia comercial"],"summary":"Licitaciones ChileCompra","description":"Licitaciones públicas de Mercado Público por fecha, con detalle (monto, organismo, estado). Inteligencia comercial y señal de actividad para riesgo. Fuente: ChileCompra — Mercado Público. Plan mínimo: pro.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Filtro de búsqueda por texto (según dataset)."}],"responses":{"200":{"description":"Datos normalizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaDataset"}}}},"401":{"description":"Falta o es inválida la API key"},"403":{"description":"El plan no permite este dataset"},"404":{"description":"Dataset inexistente"},"429":{"description":"Se superó el límite de solicitudes"},"502":{"description":"La fuente oficial no respondió"}}}},"/api/dte/emitir":{"post":{"tags":["Facturación electrónica"],"summary":"Emitir un DTE","description":"Genera, calcula totales y timbra el documento. Si no se indica folio y hay un CAF cargado, se toma el siguiente folio disponible.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DteRequest"}}}},"responses":{"200":{"description":"Documento generado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DteRespuesta"}}}},"400":{"description":"Datos inválidos"},"401":{"description":"Falta o es inválida la API key"},"429":{"description":"Se superó el límite de emisión"}}}},"/api/dte/pdf":{"post":{"tags":["Facturación electrónica"],"summary":"Representación impresa (PDF)","description":"Devuelve el PDF del documento. Formatos: carta, 80mm y 58mm. Con cedible=true agrega la leyenda CEDIBLE y el acuse de recibo de la Ley 19.983.","requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/DteRequest"},{"type":"object","properties":{"formato":{"type":"string","enum":["carta","80mm","58mm"],"default":"carta"},"cedible":{"type":"boolean","default":false},"salida":{"type":"string","enum":["pdf","base64"],"default":"pdf"},"resolucion":{"type":"object","properties":{"numero":{"type":"integer"},"anio":{"type":"integer"}}}}}]}}}},"responses":{"200":{"description":"PDF del documento","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/PdfBase64"}}}},"400":{"description":"Datos inválidos"},"401":{"description":"Falta o es inválida la API key"},"429":{"description":"Se superó el límite"}}}},"/api/dte/folios":{"get":{"tags":["Folios (CAF)"],"summary":"Consultar folios disponibles","parameters":[{"name":"tipo","in":"query","required":false,"schema":{"type":"integer"},"description":"Filtra por tipo de DTE."}],"responses":{"200":{"description":"Rangos de folios","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoliosRespuesta"}}}},"401":{"description":"Falta o es inválida la API key"},"503":{"description":"Almacén de folios no disponible"}}},"post":{"tags":["Folios (CAF)"],"summary":"Cargar un CAF del SII","description":"El CAF contiene la llave privada del timbre: se almacena cifrado.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["caf"],"properties":{"caf":{"type":"string","description":"XML del CAF entregado por el SII."}}}}}},"responses":{"200":{"description":"CAF cargado"},"400":{"description":"CAF inválido o rango duplicado"},"401":{"description":"Falta o es inválida la API key"}}},"delete":{"tags":["Folios (CAF)"],"summary":"Anular un rango de folios","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer"},"description":"Id del rango."}],"responses":{"200":{"description":"Rango anulado"},"404":{"description":"El rango no existe o ya estaba anulado"}}}},"/api/sii/credenciales":{"get":{"tags":["Boletas de honorarios"],"summary":"Estado de la credencial del SII","description":"Devuelve solo metadatos. La clave nunca se expone.","responses":{"200":{"description":"Estado de la credencial"},"401":{"description":"API key inválida"}}},"post":{"tags":["Boletas de honorarios"],"summary":"Guardar credencial del SII","description":"RUT y Clave Tributaria del contribuyente. Se cifra con AES-256-GCM y se usa solo para consultar los documentos del propio titular.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rut","clave"],"properties":{"rut":{"type":"string","example":"12345678-9"},"clave":{"type":"string","format":"password"}}}}}},"responses":{"200":{"description":"Credencial guardada"},"400":{"description":"RUT inválido o clave muy corta"},"401":{"description":"API key inválida"}}},"delete":{"tags":["Boletas de honorarios"],"summary":"Eliminar la credencial del SII","responses":{"200":{"description":"Credencial eliminada"}}}},"/api/bhe":{"get":{"tags":["Boletas de honorarios"],"summary":"Consultar boletas de honorarios","description":"Boletas emitidas o recibidas del contribuyente, con los totales del período. Requiere credencial del SII configurada.","parameters":[{"name":"direccion","in":"query","schema":{"type":"string","enum":["recibidas","emitidas"],"default":"recibidas"}},{"name":"periodicidad","in":"query","schema":{"type":"string","enum":["anual","mensual","diario"],"default":"mensual"}},{"name":"anio","in":"query","schema":{"type":"integer","example":2026}},{"name":"mes","in":"query","schema":{"type":"integer","minimum":1,"maximum":12}},{"name":"dia","in":"query","schema":{"type":"integer","minimum":1,"maximum":31}}],"responses":{"200":{"description":"Boletas y totales","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BheRespuesta"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/bhe/pdf":{"get":{"tags":["Boletas de honorarios"],"summary":"PDF oficial de una boleta","description":"Devuelve el PDF tal como lo emite el SII. La boleta se identifica por su código de barras, que viene en cada fila de /api/bhe.","parameters":[{"name":"codigo","in":"query","required":true,"schema":{"type":"string"},"description":"Código de barras de la boleta."},{"name":"direccion","in":"query","schema":{"type":"string","enum":["recibidas","emitidas"],"default":"recibidas"}}],"responses":{"200":{"description":"PDF de la boleta","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"412":{"description":"Falta configurar la credencial del SII"},"502":{"description":"El SII no devolvió el documento"}}}},"/api/bhe/export":{"get":{"tags":["Boletas de honorarios"],"summary":"Exportar boletas a planilla","description":"Descarga las boletas del período en CSV con BOM UTF-8 y separador punto y coma, listo para abrir en Excel. En periodicidad anual exporta el resumen por mes.","parameters":[{"name":"direccion","in":"query","schema":{"type":"string","enum":["recibidas","emitidas"],"default":"recibidas"}},{"name":"periodicidad","in":"query","schema":{"type":"string","enum":["anual","mensual"],"default":"mensual"}},{"name":"anio","in":"query","schema":{"type":"integer"}},{"name":"mes","in":"query","schema":{"type":"integer","minimum":1,"maximum":12}}],"responses":{"200":{"description":"Planilla CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"412":{"description":"Falta configurar la credencial del SII"}}}},"/api/rcv":{"get":{"tags":["Compras y Ventas (RCV)"],"summary":"Registro de Compras y Ventas","description":"Totales por tipo de documento y, opcionalmente, el detalle uno a uno. Es la fuente cruda del Control de IVA y de la conciliación. Solo el estado REGISTRO alimenta el F29: PENDIENTE son documentos a la espera de acuse de recibo, cuyo IVA todavía no es crédito fiscal.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."},{"name":"operacion","in":"query","schema":{"type":"string","enum":["compra","venta"],"default":"compra"}},{"name":"estado","in":"query","schema":{"type":"string","enum":["REGISTRO","PENDIENTE","NO_INCLUIR","RECLAMADO"],"default":"REGISTRO"}},{"name":"detalle","in":"query","schema":{"type":"string","enum":["0","1"]},"description":"'1' incluye los documentos uno a uno."},{"name":"tipo","in":"query","schema":{"type":"integer","example":33},"description":"Código de documento del SII. Limita el detalle a UN tipo: una llamada al portal en vez de una por cada tipo del período. El plan gratuito recibe una vista previa de las primeras filas."}],"responses":{"200":{"description":"Registro del período","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RcvRespuesta"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/iva":{"get":{"tags":["Control de IVA"],"summary":"Proyección del IVA del período","description":"Línea de IVA del F29 (débito menos crédito menos remanente) con lo registrado en el Registro de Compras y Ventas. Si el período sigue abierto, proyecta el cierre e informa el nivel de confianza. El remanente del período anterior se reconstruye automáticamente. Incluye el PPM, los impuestos adicionales (ILA) presentes en los documentos y el crédito pendiente de acuse de recibo. NO es el F29 completo: faltan retenciones de honorarios, créditos especiales y otros impuestos.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."},{"name":"remanente","in":"query","schema":{"type":"integer","minimum":0},"description":"Remanente de crédito fiscal del período anterior. Si se omite, se calcula contra el SII."},{"name":"simular","in":"query","schema":{"type":"integer","minimum":0},"description":"Monto neto de una compra hipotética: devuelve cuánto bajaría el pago y el tope útil."},{"name":"detalle","in":"query","schema":{"type":"string","enum":["0","1"]},"description":"'1' incluye los documentos uno a uno."},{"name":"proveedores","in":"query","schema":{"type":"string","enum":["0","1"]},"description":"'1' agrupa las compras por proveedor."},{"name":"diario","in":"query","schema":{"type":"string","enum":["0","1"]},"description":"'1' incluye el desglose diario de boletas."}],"responses":{"200":{"description":"Proyección del período","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IvaProyeccion"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/iva/historico":{"get":{"tags":["Control de IVA"],"summary":"Evolución del IVA","description":"Serie de los últimos períodos con débito, crédito, lo pagado y la carga efectiva sobre las ventas netas. Los remanentes se encadenan entre períodos. El promedio excluye el período en curso porque está incompleto.","parameters":[{"name":"meses","in":"query","schema":{"type":"integer","minimum":1,"maximum":12,"default":6},"description":"Cuántos períodos hacia atrás."}],"responses":{"200":{"description":"Serie histórica","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IvaHistorico"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/iva/export":{"get":{"tags":["Control de IVA"],"summary":"Exportar el período a planilla","description":"CSV con BOM UTF-8 y separador punto y coma: determinación del IVA, crédito pendiente de acuse, resúmenes por tipo de documento y detalle documento a documento.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."},{"name":"detalle","in":"query","schema":{"type":"string","enum":["0","1"],"default":"1"},"description":"'0' omite el detalle y genera más rápido."}],"responses":{"200":{"description":"Planilla CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/f29":{"get":{"tags":["Control de IVA"],"summary":"PPM y declaración del F29","description":"Pago Provisional Mensual con la base imponible y la tasa que el SII asigna al contribuyente, más la declaración del período si ya fue presentada. Es lo que el Registro de Compras y Ventas no contiene.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."}],"responses":{"200":{"description":"PPM y declaración","content":{"application/json":{"schema":{"$ref":"#/components/schemas/F29Respuesta"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/f29/propuesta":{"get":{"tags":["Control de IVA"],"summary":"Propuesta del F29, código por código","description":"El formulario armado: cada recuadro con su código, su valor y de dónde salió. Reúne en una llamada lo que exige entrar a cuatro pantallas del SII —compras, ventas, propuesta de PPM y honorarios recibidos— con el remanente del período anterior ya encadenado. NO presenta la declaración. Si el período ya fue declarado, agrega la comparación entre lo declarado y lo registrado. Cada línea trae 'unidad' porque el formulario mezcla pesos, cantidades y porcentajes en el mismo tipo de recuadro.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."}],"responses":{"200":{"description":"Propuesta del período","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropuestaF29"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/licitaciones/radar":{"get":{"tags":["Inteligencia comercial"],"summary":"Radar de licitaciones cruzado con tus ventas","description":"Las licitaciones abiertas de Mercado Público, marcando cuáles publica un organismo al que YA le facturas. El cruce va por el RUT de la unidad compradora contra tus documentos de venta del SII. Funciona sin credencial del SII, entregando el radar sin cruce.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Texto en el nombre. Todas las palabras deben aparecer."},{"name":"dias","in":"query","schema":{"type":"integer"},"description":"Solo las que cierran dentro de N días."},{"name":"clientes","in":"query","schema":{"type":"string","enum":["0","1"]},"description":"'1' devuelve solo organismos que ya son tus clientes."},{"name":"meses","in":"query","schema":{"type":"integer","minimum":1,"maximum":12,"default":6},"description":"Meses de ventas para el cruce. El plan gratuito usa 1."}],"responses":{"200":{"description":"Oportunidades clasificadas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarRespuesta"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/licitaciones/informe":{"get":{"tags":["Inteligencia comercial"],"summary":"Informe consolidado de compras públicas","description":"Cuánto se licita, quién compra, dónde y con qué urgencia. El total viene siempre con `cobertura_monto`: buena parte de los organismos no publica monto estimado, así que la suma es un piso y no el tamaño del mercado. Con formato=csv descarga el archivo con los mismos filtros.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"dias","in":"query","schema":{"type":"integer"}},{"name":"region","in":"query","schema":{"type":"string"},"description":"Coincidencia parcial sobre la región del comprador."},{"name":"organismo","in":"query","schema":{"type":"string"},"description":"Coincidencia parcial sobre el nombre del organismo."},{"name":"monto_min","in":"query","schema":{"type":"integer"}},{"name":"con_monto","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"muestra","in":"query","schema":{"type":"integer","minimum":10,"maximum":120,"default":60}},{"name":"formato","in":"query","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Informe consolidado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformeLicitaciones"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/radar/busquedas":{"get":{"tags":["Inteligencia comercial"],"summary":"Búsquedas guardadas del radar","description":"Lo que el sistema vigila por ti. Máximo 10 por cuenta.","responses":{"200":{"description":"Tus búsquedas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusquedasRadar"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}},"post":{"tags":["Inteligencia comercial"],"summary":"Guardar una búsqueda","description":"Cada mañana se revisan las licitaciones abiertas contra esta búsqueda y se generan alertas. Requiere un plan de pago: es trabajo recurrente que se hace aunque no entres.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nombre"],"properties":{"nombre":{"type":"string","example":"Alimentos en la Araucanía"},"termino":{"type":"string","nullable":true,"example":"alimentos"},"dias_maximos":{"type":"integer","nullable":true,"example":7},"solo_clientes":{"type":"boolean","default":false},"notificar_email":{"type":"boolean","default":true}}}}}},"responses":{"201":{"description":"Búsqueda creada"},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"403":{"description":"Requiere plan de pago"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/radar/alertas":{"get":{"tags":["Inteligencia comercial"],"summary":"Bandeja de alertas","description":"Tres clases: 'nueva', 'cierra_pronto' y 'cambio_estado'. El orden no es cronológico: primero lo no leído, luego lo de organismos que ya son clientes, luego lo que cierra antes — el orden en que conviene atenderlas.","parameters":[{"name":"sin_leer","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"limite","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Alertas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertasRadar"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}},"patch":{"tags":["Inteligencia comercial"],"summary":"Marcar alertas como leídas","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"integer"}},"todas":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Cuántas se marcaron"},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/situacion-tributaria":{"get":{"tags":["Cumplimiento tributario"],"summary":"¿Este RUT puede emitir facturas?","description":"Si el RUT existe, tiene inicio de actividades, está autorizado a timbrar documentos y con qué giros opera. Devuelve además 'puede_emitir_dte', un veredicto que el SII no entrega y que Cifra deduce de los campos oficiales. No requiere la credencial del SII del cliente: el organismo publica esta consulta sin autenticación. Para personas naturales el SII enmascara el nombre y la respuesta lo informa sin exponerlo.","parameters":[{"name":"rut","in":"query","required":true,"schema":{"type":"string","example":"76543210-9"},"description":"RUT con dígito verificador. Varios separados por coma (máx. 25, requiere plan)."}],"responses":{"200":{"description":"Situación del contribuyente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SituacionTributaria"}}}},"400":{"description":"RUT inválido o rechazado por el SII"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/riesgo-clientes":{"get":{"tags":["Control de IVA"],"summary":"Cartera de clientes: concentración y conducta","description":"De quién dependen tus ventas y cuánto tardan tus clientes en acusar recibo. El acuse NO es el pago: es el reconocimiento del documento en el registro del receptor. Pasados 8 días el SII lo acepta por silencio. Las boletas no identifican comprador y no forman cartera.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."}],"responses":{"200":{"description":"Cartera del período","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiesgoClientes"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/riesgo-proveedores":{"get":{"tags":["Control de IVA"],"summary":"Salud de la cartera de proveedores","description":"Cruza el Registro de Compras con el Boletín Concursal y revisa la concentración del gasto. Ninguna de las dos fuentes puede hacerlo por separado: un ERP sabe a quién le compras pero no tiene los datos de riesgo, y un buró de riesgo tiene los datos pero no sabe a quién le compras. Detecta también documentos del mismo proveedor por el mismo monto. Las alertas son señales para revisar, no conclusiones.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."}],"responses":{"200":{"description":"Proveedores y alertas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiesgoProveedores"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/boletas-diarias":{"get":{"tags":["Control de IVA"],"summary":"Boletas electrónicas día por día","description":"Desglose diario de boletas: documentos, neto, IVA y total por jornada, con el mejor día y el promedio sobre los días con venta. El SII no entrega la boleta individual porque no identifica al receptor: esta es la granularidad máxima disponible.","parameters":[{"name":"periodo","in":"query","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-07"},"description":"Período tributario AAAA-MM. Por defecto, el mes en curso."},{"name":"tipo","in":"query","schema":{"type":"integer","enum":[39,41],"default":39},"description":"39 boleta electrónica, 41 boleta exenta."}],"responses":{"200":{"description":"Desglose diario","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoletasDiarias"}}}},"400":{"description":"Parámetros inválidos"},"401":{"description":"API key inválida, o el SII rechazó la credencial"},"412":{"description":"Falta configurar la credencial del SII"},"429":{"description":"Se superó el límite de consultas al SII"},"502":{"description":"El portal del SII no respondió o cambió su estructura"}}}},"/api/conciliacion":{"post":{"tags":["Conciliación"],"summary":"Conciliar SII contra ERP","description":"Compara dos planillas CSV y devuelve faltantes, sobrantes y diferencias de monto, con la exposición de IVA involucrada. Las planillas no se almacenan.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sii","erp"],"properties":{"sii":{"type":"string","description":"CSV del registro del SII (máx. 6 MB)."},"erp":{"type":"string","description":"CSV del export del ERP (máx. 6 MB)."}}}}}},"responses":{"200":{"description":"Resultado de la conciliación","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConciliacionRespuesta"}}}},"400":{"description":"Archivo inválido o sin filas de datos"},"401":{"description":"API key inválida"},"429":{"description":"Se superó el límite de solicitudes"}}}}}}