Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
installationshandbuch:billing [23.02.2023 14:05] – gelöscht - Externe Bearbeitung (Unknown date) 127.0.0.1installationshandbuch:billing [20.03.2024 11:34] (aktuell) – richard.neubert
Zeile 1: Zeile 1:
 +<WRAP hide>{{tag>red:initial}}</WRAP>
 +<WRAP>{{tag>func:Installation func:Inbetriebnahme}}</WRAP>
 +<WRAP 850px>
  
 +====== Billing-Service installieren und benutzen ======
 +
 +Mit dem UCware Server haben Sie die Möglichkeit, Verbindungen ins öffentliche Telefonnetz für Abrechnungszwecke zu dokumentieren.
 +
 +Die Funktion ist an das Debian-Paket ''ucware-services-billing'' gebunden, das Sie bei Bedarf nachinstallieren können.
 +
 +Sobald der zugehörige Service läuft, schreibt er die folgenden Verbindungsdaten in die Tabelle ''services_billing'' der lokalen Datenbank:
 +
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''uniqueid'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>eindeutige Kennung des Anrufs</wrap>
 +</WRAP>
 +</WRAP>
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''extension'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>Durchwahl des Anrufurhebers</wrap>
 +</WRAP>
 +</WRAP>
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''originator'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>Durchwahl, die den Anruf ins öffentliche Telefonnetz transferiert\\ hat (z. B. durch Weiterleitung des ursprünglichen Anrufs)</wrap>
 +</WRAP>
 +</WRAP>
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''dialedNumber'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>externe Zielnummer</wrap>
 +</WRAP>
 +</WRAP>
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''timestamp'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>Zeitstempel des Anrufs</wrap>
 +</WRAP>
 +</WRAP>
 +<WRAP group>
 +<WRAP column 180px>
 +  * ''duration'':
 +</WRAP>
 +<WRAP column 500px>
 +<wrap lo>Dauer des Anrufs</wrap>
 +</WRAP>
 +</WRAP>
 +
 +<WRAP tip>**Hinweis:**\\ Der Service erfasst nur Anrufe mit externer Zielnummer.</WRAP>
 +
 +Über die UCwareAPI lassen sich die dokumentierten Verbindungen abrufen, als **bezahlt** kennzeichnen und löschen.
 +
 +
 +===== Installation =====
 +
 +Um das erforderliche Paket für den Billing-Service bereitzustellen, gehen Sie wie folgt vor:
 +
 +  - Greifen Sie per SSH auf den UCware Server zu.
 +  - Lesen Sie die Paketquellen neu ein: <code bash>sudo apt update</code>
 +  - Installieren Sie das Paket **ucware-services-billing**: <code bash>sudo apt install ucware-services-billing</code>
 +  - Überprüfen Sie, ob der Dienst **ucware-services-billing.service** läuft: <code bash>ucware-health</code> {{:installation:terminal_health_billing.png?850direct|}}
 +
 +
 +===== Benutzung =====
 +
 +==== API-Zugriff ====
 +
 +Die UCwareAPI bietet vier Methoden, um auf die gespeicherten Daten des Billing-Services zuzugreifen.
 +
 +<WRAP tip>**Hinweis:**\\ Details zur Benutzung der einzelnen Methoden finden Sie in der API-Dokumentation: <code>https://[HOSTNAME_UCWARE]/apidoc/classes/api-admin-Billing.html</code></WRAP>
 +
 +Zur Abrechnung ausgehender Verbindungen empfiehlt sich der folgende Workflow:
 +
 +  - Unbezahlter Verbindungen mit ''getAllUnbilled'' abrufen.
 +  - Verbindungsdaten in der gewünschten Drittanwendung weiterverarbeiten.
 +  - Bezahlte Verbindungen mit ''markCallsRetrieved'' kennzeichnen.
 +  - Bezahlte Verbindungen mit ''prune'' aus der Datenbasis löschen.
 +
 +Darüber hinaus können Sie mit ''purge'' bei Bedarf **alle** aufgezeichneten Verbindungsdaten löschen.
 +
 +
 +==== Einzelne Gespräche als "privat" markieren ====
 +
 +Benutzer, für die nur bestimmte Verbindungen abgerechnet werden sollen, können diese per vorgewähltem [[geraetehandbuch:tasten_codes#Privatgespräch|Tasten-Code]] (Standard: <key>✱</key> <key>7</key> <key>✱</key>) als **privat** markieren.
 +
 +Voraussetzung ist, dass die gewünschten Benutzer die [[adhandbuch:benutzer_gruppen:gruppen:allg|Berechtigung]] ''private_call'' über den Host ausüben.
 +
 +
 +</WRAP>