Tabellenbeschreibung
Das Datenmodell von PHX ERP und seine Schnittstelle: GraphQL-Admin-API, Entitäten, Schema-Abfrage und Zugang mit API-Benutzer.
PHX ERP speichert alle Daten in einer PostgreSQL-Datenbank mit rund 280 Tabellen. Nach außen stehen die Daten über die GraphQL-Admin-API bereit, die auch die Oberfläche selbst nutzt. Wer Auswertungen, Reports oder Schnittstellen baut, arbeitet mit diesen Entitäten.
Schnittstelle
Die Admin-API ist unter dem Pfad /admin-api beziehungsweise /backend-api/admin-api der Installation erreichbar. Sie bietet Abfragen (zum Beispiel getAddresses, getProducts, getDocuments) und Änderungen (zum Beispiel saveDocument, transferDocument). Das vollständige Schema mit allen Typen und Feldern lässt sich per Introspektion abrufen und in GraphQL-Werkzeugen anzeigen.
Zugang
Anmeldung mit Benutzer und Passwort über die Abfrage login; das Token aus der Antwort wird als Bearer im Authorization-Header mitgeschickt. Für Schnittstellen eignet sich ein API-Benutzer mit dauerhaftem Token, siehe API Key erstellen und verwenden.
Wichtige Entitäten
| Entität | Inhalt |
|---|---|
| address, postal_address, contact, debitor_creditor_instance | Adressen, Anschriften, Kontakte, Debitor- und Kreditorkonten |
| product, product_group, unit, price_list, price_list_entry, discount_group | Artikel, Gruppen, Einheiten, Preise, Rabatte |
| document, document_line_item, document_definition, document_definition_transfer_option | Belege, Positionen, Belegarten, Übergaberegeln |
| storage_place, stock_transaction, stock_inventory | Lagerplätze, Lagerbuchungen, Inventuren |
| payment, open_item_accounting, payment_run, bank, bank_account | Zahlungen, offene Posten, Zahlungsläufe, Banken |
| tenant, user, role, employee, number_range | Mandant, Benutzer, Rollen, Mitarbeiter, Nummernkreise |
Für Reports und Dashboards wird direkt die Datenbank gelesen, siehe Reporte.
Erläuterung
Alle Tabellen tragen eine Mandantenkennung und ein Löschkennzeichen; gelöschte Datensätze bleiben markiert erhalten. Das Schema kann sich mit Updates ändern; prüfen Sie eigene Abfragen nach jedem Update.
Quelle: Systemstand Demo, Oktober 2026.