# API-Referenz Belege (App-Kennung belege) > 46 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz. Quelle: https://support.unitedsynergy.com/api/referenz/belege/ ## Datenobjekte Die Standard-Aktionen je Datenobjekt: list (suchen und blättern), get (einen Datensatz lesen), create, update und delete. Nicht jedes Objekt bietet alle fünf an. ### Belege: `belege.beleg.*` #### belege.beleg.list Liste/Suche: Belege - Art: Lesen - Rechte: Beleg lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"belege.beleg.list","input":{}}` #### belege.beleg.get Detail: Belege - Art: Lesen - Rechte: Beleg lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"belege.beleg.get","input":{"id":""}}` #### belege.beleg.create Anlegen: Belege - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Beleg verwalten - Datenklassen: C (vertraulich) - Eingabe: - `belegtypCode` (string, Pflicht): z.B. angebot, auftrag, rechnung, lieferschein - `datum` (string) - `statusCode` (string) - `organisationId` (string) - `personId` (string) - `betreff` (string) - `liefertermin` (string) - `gueltigBis` (string) - `frist` (number) - `zahlungsbedingungCode` (string) - `lieferbedingungCode` (string) - `waehrung` (string) - `ustFrei` (boolean) - `ustId` (string) - `kopftext` (string) - `fusstext` (string) - `eroeffnungstext` (string) - `bemerkungen` (string) - `internerVermerk` (string) - `rabatt` (number) - `rabattProzent` (number) - Beispiel: `{"name":"belege.beleg.create","input":{"belegtypCode":""}}` #### belege.beleg.update Ändern: Belege - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Beleg verwalten - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `belegtypCode` (string): z.B. angebot, auftrag, rechnung, lieferschein - `datum` (string) - `statusCode` (string) - `organisationId` (string) - `personId` (string) - `betreff` (string) - `liefertermin` (string) - `gueltigBis` (string) - `frist` (number) - `zahlungsbedingungCode` (string) - `lieferbedingungCode` (string) - `waehrung` (string) - `ustFrei` (boolean) - `ustId` (string) - `kopftext` (string) - `fusstext` (string) - `eroeffnungstext` (string) - `bemerkungen` (string) - `internerVermerk` (string) - `rabatt` (number) - `rabattProzent` (number) - Beispiel: `{"name":"belege.beleg.update","input":{"id":""}}` #### belege.beleg.delete Löschen: Belege - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Beleg verwalten - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"belege.beleg.delete","input":{"id":""}}` ### Belegpositionen: `belege.position.*` #### belege.position.list Liste/Suche: Belegpositionen - Art: Lesen - Rechte: Beleg lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"belege.position.list","input":{}}` #### belege.position.create Anlegen: Belegpositionen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Beleg verwalten - Datenklassen: C (vertraulich) - Eingabe: - `belegId` (string, Pflicht) - `position` (number) - `zeilentyp` (string): AB=Artikel, TX=Text, SP=Summe - `produktId` (string) - `produkt` (string) - `produktnummer` (string) - `menge` (number) - `einzelpreis` (number) - `rabatt` (number) - `rabattProzent` (number) - `steuersatz` (number) - `steuersatzCode` (string) - `mengeneinheit` (string) - `beschreibung` (string) - `positionstext` (string) - Beispiel: `{"name":"belege.position.create","input":{"belegId":""}}` #### belege.position.update Ändern: Belegpositionen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Beleg verwalten - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `belegId` (string) - `position` (number) - `zeilentyp` (string): AB=Artikel, TX=Text, SP=Summe - `produktId` (string) - `produkt` (string) - `produktnummer` (string) - `menge` (number) - `einzelpreis` (number) - `rabatt` (number) - `rabattProzent` (number) - `steuersatz` (number) - `steuersatzCode` (string) - `mengeneinheit` (string) - `beschreibung` (string) - `positionstext` (string) - Beispiel: `{"name":"belege.position.update","input":{"id":""}}` ## Wertelisten Auswahllisten der App wie Status, Arten oder Kategorien. Du pflegst sie mit denselben fünf Aktionen. Die Werte (code) nutzt du in den Feldern der Datenobjekte. ### Belegtypen: `belege.belegtyp.*` #### belege.belegtyp.list Liste/Suche: Katalog „Belegtypen" (belege) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `onlyAktiv` (boolean): Nur aktive Einträge - Beispiel: `{"name":"belege.belegtyp.list","input":{}}` #### belege.belegtyp.get Detail: Katalog „Belegtypen" (belege) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"belege.belegtyp.get","input":{"id":""}}` #### belege.belegtyp.create Anlegen: Katalog „Belegtypen" (belege) - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `label` (string, Pflicht): Anzeige-Text - `code` (string): Optional, sonst aus label abgeleitet. Immutable - `color` (string): Tailwind-Paar, z.B. "bg-blue-100 text-blue-700" - `icon` (string): Lucide-Icon-Name - `beschreibung` (string) - Beispiel: `{"name":"belege.belegtyp.create","input":{"label":"