Uso de IA · Contabilidad

    @Tool(name = "consultar_poliza",
          description = "Devuelve una póliza contable por su identificador UUID: periodo, tipo, fecha, estatus y movimientos (cargos y abonos por cuenta).")
    public String consultarPoliza(
            @ToolParam(description = "Identificador UUID de la póliza", required = true) String polizaId) {
        RegistroHerramientasUsadas.registrar("consultar_poliza");
        String cuerpo = gateway.get()
                .uri(constructor -> constructor.path(RUTA_BASE + "/polizas/{id}")
                        .build(UUID.fromString(polizaId.trim())))
                .retrieve()
                .body(String.class);
        return FiltroDatosSensibles.redactar(cuerpo).texto();
    }

    @Tool(name = "sugerir_poliza",
          description = "Propone una póliza contable a partir de la descripción de una operación. No la registra. "
                  + "Devuelve el identificador de la acción y un código de confirmación de una sola vez; "
                  + "la póliza solo se registra cuando se confirma con confirmar_accion usando ese código.")
    public String sugerirPoliza(
            @ToolParam(description = "Descripción de la operación contable, con montos y moneda", required = true) String descripcion) {
        RegistroHerramientasUsadas.registrar("sugerir_poliza");
        AccionPendiente accion = servicio.get().preparar(usuarioActual(), descripcion);
        return "Acción " + accion.id() + " preparada, vence " + accion.expiraUtc() + ". "
                + accion.resumen() + ". Código de confirmación: " + codigos.generar(accion.id(), accion.usuario())
                + ". Nada se ha registrado todavía.";
    }

    static final String RUTA_BASE = "/contabilidad-ms/v1";