MoUSe-Unterstützung zur UBC-Druckabrechnung

Grundsätzliches

• Für den halbjährlichen Kostenausgleich zwischen UBC <--> URZ gilt folgende Formel:

  Kosten für das aus dem URZ übernommene Verbrauchmaterial (lt. Entnahme-Protokoll des Papierlagers)
  minus Betrag, der vom URZ via MoUSe bereits eingenommen wurde (s. unten)
  plus Kosten für Druckaufträge durch UBC-Mitarbeiter auf Druckern im URZ

  Diese Werte können vom Finanzsachbearbeiter mit Standardabfragen aus https://mouse.hrz.tu-chemnitz.de/restrict_select/finanzen/frage.php3 ermittelnt werden

• Die UBC gibt Druckkosten an Ihre Nutzer weiter.
• Bei UBC-Nutzern, die auch URZ-Nutzer sind (Anmeldung am UBC-Arbeitsplatz mit URZ-NKZ) werden Druckkosten über MoUSe abgerechnet und beglichen. Das URZ fordert die entstandenen Kosten direkt vom Nutzer ein und setzt die Summe dieser Beträge vom Betrag ab, den die UBC dem URZ übermitteln muss. Für die UBC entsteht kein Verwaltungsaufwand. Das betrifft Kosten für alle Druckaufträge in der UBC, die von URZ-Nutzern (ausser UBC-Mitarbeiter selbst) erteilt wurden.
• Bei UBC-Nutzern, die keine URZ-Nutzer sind (Anmeldung am UBC-Arbeitsplatz mit UBC-Benutzerkartennummer (besteht drei bis 7 Ziffern)), werden Druckkosten über das Gebührenkonto des Lokalsystems (z.Z. SIAS) abgerechnet und beglichen. In einer speziellen MoUSe-Tabelle wird lediglich Protokoll geführt.

Technische Realisierung

• Auf dem Printserver werden die Kosten eines Druckjobs ermittelt.
  Für URZ-Nutzer (Uni-Angehörige) können dabei andere Seitenpreise gelten, als für Fremdnutzer.
• Bzgl. des zur Abrechnung zu benutzenden Kontos (MoUSe oder Lokalsystem) wird auf dem Printserver grundsätzlich keine Unterscheidung getroffen.
• alle Beträge sind als Gleitkommazahlen (bzw. in Zeichenketten wie Gleitkommazahlen) anzugeben
  

  diese Angabe	entspricht
  1	1 Euro
  1.25	1 Euro, 25 Cent
  2.1	2 Euro, 10 Cent

  
  
  Bild 1: prinzipieller Datenfluss

Abbuchung

• Abbuchungen erfolgen mit dem Kommando konto_buchung (steht in /usr/local/bin) bzw. der zugrundeliegenden C-Funktion konto_buchen:

  konto_buchung nkz | sonderkonto | ubc-benutzerkartennummer betrag [bemerkung] [ drucker] ["force | check"]

  Wird die C-Funktion konto_buchen genutzt, erfolgt die Datenbereitstellung in der Struktur Buchung (s. /home/urzdb/urzdb/tools/liburzdb/finanzen.h).

  In dieser Struktur werden auch die Ergebnisse bereitgestellt.

  • Buchung.error = 0 --> OK
  • Buchung.buchnr --> Buchungsnummer
  • Buchung.stand_alt --> Kontenstand vor der Buchung
  • Buchung.stand_neu --> Kontenstand nach der Buchung
  • Buchung.error = 1 --> Konto (NKZ, Sonderkonto, UBC-Benutzerkartennummer) nicht gefunden
  • Buchung.error = 2 --> Kontostand erlaubt keine weitere Abbuchung (nur wenn keine "force-Buchung" gefordert ist)

  Auf dem Printserver wird zunächst

  • mit konto_buchung ... check geprüft, ob prinzipiell gedruckt werden darf
  • danach werden mit konto_buchung ... force die entstandenen Druckkosten abgebucht. Die Druckkosten werden auf dem Printserver ermittelt.

  Rückgabewerte des Kommandos konto_buchung:

  • wenn alles OK, wird in stdout wird die Buchungsnummer bereitgestellt (bei Option 'check' 1)
  • bei Fehler, wird in stdout die Buchungsnummer 0 und in stderr ein fehlertext bereitgestellt

• Wenn im Argument nkz | sonderkonto | ubc-benutzerkartennummer ausschließlich Ziffern angegeben sind, erfolgt auf dem MoUSe-Server eine Weiterleitung ans Lokalsystem der UBC.

  Die Erkennung geschieht in interface/gateway/konto-rw.php3. Von dort wird das externe Tool ubc_buchung gestartet. Es steht unter /home/urzdb/urzdb/tools/bin und führt folgendes aus:

  exec 9<>/dev/tcp/cache.bibliothek.tu-chemnitz.de/6001 /* Filedeskriptor 9 zum Lesen/Schreiben einer TCP-Verbindung */
  printf "%s\n%s\n%s\n%s\n%s\n%s\n" 8 "$ausweis_nr" "$betrag" "D" "$drucker $bemerkung" " " >&9
  read REPLY <&9
  echo $REPLY

  Die 8 nach dem Fromatstring des printf-Kommandos (FID) steht für die Serverfunktion "Buchen" (Force). Bei "Check-Buchungen" wird stattdessen die FID 14 übermittelt.

  $REPLY liefert eine Zeile in stdout
  diese besteht aus (Trennzeichen ist das Leerzeichen):

  • 1 UBC-Katkey (entspricht der Buchungsnummer)
  • 0 Fehlertext bei Fehlern

  Jede versuchte UBC-Buchung wird der Tabelle ubc_kontenbewegung angefügt.

Stornierung

• Stornierungen von Buchungen, die im Lokalsystem der Bibliothek vorgenommen wurden, sind nicht möglich!
• Stornierungen erfolgen mit dem Kommando konto_storno bzw. der zugrundeliegenden C-Funktion konto_storno:

  konto_storno nkz | sonderkonto | ubc-benutzerkartennummer beuchungsnummer [bemerkung]

  Wird die C-Funktion konto_storno genutzt, erfolgt die Datenbereitstellung in der Struktur Buchung (s. /home/urzdb/urzdb/tools/liburzdb/finanzen.h).

  In dieser Struktur werden auch die Ergebnisse bereitgestellt.

  • Buchung.error = 0 --> OK
  • Buchung.stand_alt --> Kontenstand vor der Stornierung
  • Buchung.stand_neu --> Kontenstand nach der Stornierung
  • Buchung.error = 1 --> Konto (NKZ, Sonderkonto, UBC-Benutzerkartennummer) nicht gefunden
  • Buchung.error = 4 --> buchungsnummer kann nicht storniert werden (gibt es nicht oder ist bereits storniert)

  Rückgabewerte des Kommandos konto_storno:

  • wenn alles OK, wird in stdout eine 1 bereitgestellt
  • bei Fehler, wird in stdout eine 0 und in stderr ein fehlertext bereitgestellt

Jede UBC-Stornierung wird der Tabelle ubc_kontenbewegung festgehalten.

Konto-Abfragen

• Die Abfragen von Kontenständen von Konten des Lokalsystems der Bibliothek ist nicht möglich!
• Stornierungen erfolgen mit dem Kommando konto_storno
• Kontenstandsabfragen erfolgen mit dem Kommando konto_abfrage bzw. der zugrundeliegenden C-Funktion konto_stand:

  konto_abfrage nkz | sonderkonto | ubc-benutzerkartennummer

  Wird die C-Funktion konto_stand genutzt, erfolgt die Datenbereitstellung in der Struktur Buchung (s. /home/urzdb/urzdb/tools/liburzdb/finanzen.h).

  In dieser Struktur werden auch die Ergebnisse bereitgestellt.

  • Buchung.error = 0 --> OK
  • Buchung.stand_alt --> Kontenstand
  • Buchung.error = 1 --> Konto (NKZ, Sonderkonto, UBC-Benutzerkartennummer) nicht gefunden

  Rückgabewerte des Kommandos konto_abfrage:

  • wenn alles OK, wird in stdout eine 0 und der aktuelle Kontenstand bereitgestellt
  • bei Fehler, wird in stdout eine 1 sowie der Kontostand 0.00 und in stderr ein fehlertext bereitgestellt

Zur Homepage des URZ Ronald Schmidt, Dietmar Grunewald Januar 2002, letzte Änderung:  29.01.2002