105 lines
4.7 KiB
Plaintext
105 lines
4.7 KiB
Plaintext
Einrichtung des Admin-Bereichs
|
|
|
|
1. Datenbank und Benutzer anlegen und anschließend tat_schema.sql importieren.
|
|
2. Die Platzhalter in inc/db.inc.php ersetzen oder besser eine geschützte Konfiguration außerhalb des Webroots verwenden.
|
|
3. Einen Admin-Benutzer mit einem sicheren Passwort anlegen. Beispiel für einen Hash:
|
|
|
|
php -r 'echo password_hash("HIER_EIN_LANGES_EINMALIGES_PASSWORT", PASSWORD_DEFAULT), PHP_EOL;'
|
|
|
|
INSERT INTO admin_users (username, password_hash)
|
|
VALUES ('admin', 'HIER_DEN_HASH_EINSETZEN');
|
|
|
|
4. Danach ist der Bereich unter /tat/admin.php erreichbar.
|
|
|
|
Die Anwendung verwendet PDO mit echten Prepared Statements, CSRF-Schutz,
|
|
Session-Härtung und getrennte CSS-/JavaScript-Dateien.
|
|
|
|
ISBN-Eingabe und CSV-Import
|
|
|
|
Im Webformular werden Print- und eBook-ISBN als gültige ISBN-13 mit
|
|
Bindestrichen erwartet, zum Beispiel 978-3-16-148410-0. Beim CSV-Import
|
|
werden Bindestriche und andere Trennzeichen vor dem Abgleich entfernt.
|
|
Eine CSV-ISBN ohne Bindestriche wird daher gegen die formatierte ISBN in
|
|
TAT erkannt. Bei einem nicht gefundenen Treffer wird die betreffende Zeile
|
|
übersprungen. Alle übersprungenen Zeilen und Gründe werden gesammelt und
|
|
unterhalb des Uploads zusammengefasst angezeigt; gültige Zeilen können
|
|
weiterhin übernommen werden. Bereits gespeicherte eBook-Abrechnungen
|
|
können über die ausdrücklich bestätigungspflichtige Funktion „Gesamte
|
|
eBook-Abrechnung zurücksetzen“ gelöscht und anschließend neu importiert
|
|
werden. Print-Abrechnungen und Stammdaten bleiben dabei unverändert.
|
|
|
|
CSV-Import für die Abrechnung
|
|
|
|
Auf der Seite /tat/billing.php kann eine JTL-Verkaufs-CSV hochgeladen werden.
|
|
Die Datei muss mindestens diese Spalten enthalten:
|
|
|
|
Kundengruppe;ISBN;Menge
|
|
Großhandel;9781234567890;25
|
|
Buchhandel;9781234567890;12
|
|
Endkunden;9781234567890;8
|
|
|
|
Erlaubte Spaltennamen:
|
|
- Kundengruppe: Kundengruppe, Kundengruppen oder Gruppe
|
|
- Buchkennung: ISBN, ISBN/EAN, EAN oder ISBN Print
|
|
- Verkaufsmenge: Menge, Anzahl, Verkaufsmenge oder Quantity
|
|
|
|
Unterstützte CSV-Trennzeichen sind Semikolon, Komma und Tabulator. Die Print-ISBN
|
|
wird mit der in TAT hinterlegten Print-ISBN verglichen. Es werden nur Bücher mit
|
|
Print-ISBN verarbeitet; eBook-only-Bücher bleiben ausgeschlossen.
|
|
|
|
Die Kundengruppen werden wie folgt den Abrechnungswegen zugeordnet:
|
|
- Großhandel, Grosshandel oder Buchgrosshandel -> Großhandel
|
|
- Buchhandel -> Buchhandel
|
|
- Endkunden, Direktkunden, Direkt oder Privatkunden -> Direkt
|
|
|
|
Mehrere Zeilen für dieselbe ISBN und Kundengruppe werden addiert. Nach dem Upload
|
|
zeigt TAT eine Vorschau. Erst nach der Bestätigung und Auswahl der gewünschten
|
|
Bücher werden die Mengen gespeichert. Die bisher gespeicherten Mengen der
|
|
bestätigten Bücher werden dabei ersetzt; nicht ausgewählte Bücher bleiben unverändert.
|
|
Die maximale Dateigröße beträgt 5 MB.
|
|
|
|
CSV-Struktur für die eBook-Abrechnung
|
|
|
|
Für eBooks wird eine separate CSV-Datei verwendet. Der Verkaufsweg wird
|
|
beibehalten, beeinflusst die Berechnung aber nicht. Es gibt keine Zuordnung zu
|
|
Großhandel, Buchhandel oder Direktverkauf.
|
|
|
|
Verbindliche Spaltenstruktur:
|
|
|
|
Verkaufsdatum;Verkaufsweg;ISBN;Titel;Erlös
|
|
2026-01-05;Amazon Kindle;9781234567890;Buchtitel A;17,97
|
|
2026-01-06;Apple Books;9781234567890;Buchtitel A;11,98
|
|
2026-01-08;Tolino;9781234567890;Buchtitel A;5,99
|
|
2026-01-10;Amazon Kindle;9789876543210;Buchtitel B;23,96
|
|
|
|
Pflichtspalten:
|
|
- Verkaufsdatum: Verkaufs- oder Abrechnungsdatum des Distributors; daraus wird der Abrechnungsmonat abgeleitet
|
|
- Verkaufsweg: Der vom Distributor gelieferte Verkaufsweg, zum Beispiel Amazon Kindle, Apple Books oder Tolino
|
|
- ISBN: Abgleich mit der in TAT hinterlegten eBook-ISBN
|
|
- Titel: Bezeichnung des eBooks zur Kontrolle
|
|
- Erlös: Der vom Distributor gemeldete Erlös dieser Zeile in Euro
|
|
|
|
Die CSV enthält keine Spalte für Abrechnungszeitraum, Transaktionsnummer,
|
|
Menge, Währung oder Korrektur. Der Abrechnungszeitraum wird aus dem
|
|
Verkaufsdatum abgeleitet. Der Erlös ist der vollständige Betrag der jeweiligen
|
|
Zeile. Stornos oder Korrekturen werden als negativer Erlös übertragen.
|
|
|
|
Der Erlös wird unverändert übernommen. TAT zieht keine Druckkosten,
|
|
Vertriebskosten oder sonstige Abzüge ab. Die Berechnung lautet:
|
|
|
|
Autorenanteil = Erlös x Autorenmarge / 100
|
|
|
|
Beispiel:
|
|
|
|
Erlös: 17,97 EUR
|
|
Autorenmarge: 50 Prozent
|
|
Autorenanteil: 8,985 EUR, angezeigt als 8,99 EUR
|
|
|
|
Mehrere Zeilen werden nach eBook, Verkaufsdatum und Verkaufsweg
|
|
zusammengefasst. Der Verkaufsweg bleibt dabei in der Auswertung erhalten und
|
|
wird nicht in eine Print-Vertriebskategorie umgewandelt.
|
|
|
|
Die Datei wird als UTF-8-CSV mit Semikolon als Trennzeichen und Dezimalkomma
|
|
bereitgestellt. Die ISBN ist der eindeutige Buchschlüssel; der Titel dient nur
|
|
der Kontrolle.
|