# API-Referenz Produkte (App-Kennung produkte)

> 42 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "<tool>", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz.

Quelle: https://support.unitedsynergy.com/api/referenz/produkte/

## 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.

### Artikel (Produkte): `produkte.artikel.*`

#### produkte.artikel.list

Liste/Suche: Artikel (Produkte)

- Art: Lesen
- Rechte: Artikel lesen
- Datenklassen: B (intern)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"produkte.artikel.list","input":{}}`

#### produkte.artikel.get

Detail: Artikel (Produkte)

- Art: Lesen
- Rechte: Artikel lesen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.artikel.get","input":{"id":"<id>"}}`

#### produkte.artikel.create

Anlegen: Artikel (Produkte)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `bezeichnung` (string, Pflicht)
  - `nummer` (string)
  - `ean` (string)
  - `herstellerArtikelnummer` (string)
  - `warengruppe` (string)
  - `statusCode` (string)
  - `beschreibung` (string)
  - `steuersatz` (number)
  - `bestand` (number)
  - `mindestbestand` (number)
  - `sollbestand` (number)
  - `lagerartikel` (boolean)
  - `planbar` (boolean)
  - `shopAktiv` (boolean)
  - `gesperrt` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.artikel.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### produkte.artikel.update

Ändern: Artikel (Produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `bezeichnung` (string)
  - `nummer` (string)
  - `ean` (string)
  - `herstellerArtikelnummer` (string)
  - `warengruppe` (string)
  - `statusCode` (string)
  - `beschreibung` (string)
  - `steuersatz` (number)
  - `bestand` (number)
  - `mindestbestand` (number)
  - `sollbestand` (number)
  - `lagerartikel` (boolean)
  - `planbar` (boolean)
  - `shopAktiv` (boolean)
  - `gesperrt` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.artikel.update","input":{"id":"<id>"}}`

#### produkte.artikel.delete

Löschen: Artikel (Produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.artikel.delete","input":{"id":"<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.

### Artikel-Status: `produkte.status.*`

#### produkte.status.list

Liste/Suche: Katalog „Artikel-Status" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.status.list","input":{}}`

#### produkte.status.get

Detail: Katalog „Artikel-Status" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.status.get","input":{"id":"<id>"}}`

#### produkte.status.create

Anlegen: Katalog „Artikel-Status" (produkte)

- 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":"produkte.status.create","input":{"label":"<label>"}}`

#### produkte.status.update

Ändern: Katalog „Artikel-Status" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.status.update","input":{"id":"<id>"}}`

#### produkte.status.delete

Löschen: Katalog „Artikel-Status" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.status.delete","input":{"id":"<id>"}}`

### Buchungscodes: `produkte.buchungscode.*`

#### produkte.buchungscode.list

Liste/Suche: Katalog „Buchungscodes" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.buchungscode.list","input":{}}`

#### produkte.buchungscode.get

Detail: Katalog „Buchungscodes" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.buchungscode.get","input":{"id":"<id>"}}`

#### produkte.buchungscode.create

Anlegen: Katalog „Buchungscodes" (produkte)

- 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":"produkte.buchungscode.create","input":{"label":"<label>"}}`

#### produkte.buchungscode.update

Ändern: Katalog „Buchungscodes" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.buchungscode.update","input":{"id":"<id>"}}`

#### produkte.buchungscode.delete

Löschen: Katalog „Buchungscodes" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.buchungscode.delete","input":{"id":"<id>"}}`

### Lagertypen: `produkte.lagertyp.*`

#### produkte.lagertyp.list

Liste/Suche: Katalog „Lagertypen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.lagertyp.list","input":{}}`

#### produkte.lagertyp.get

Detail: Katalog „Lagertypen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.lagertyp.get","input":{"id":"<id>"}}`

#### produkte.lagertyp.create

Anlegen: Katalog „Lagertypen" (produkte)

- 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":"produkte.lagertyp.create","input":{"label":"<label>"}}`

#### produkte.lagertyp.update

Ändern: Katalog „Lagertypen" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.lagertyp.update","input":{"id":"<id>"}}`

#### produkte.lagertyp.delete

Löschen: Katalog „Lagertypen" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.lagertyp.delete","input":{"id":"<id>"}}`

### Mengeneinheiten: `produkte.mengeneinheit.*`

#### produkte.mengeneinheit.list

Liste/Suche: Katalog „Mengeneinheiten" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.mengeneinheit.list","input":{}}`

#### produkte.mengeneinheit.get

Detail: Katalog „Mengeneinheiten" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.mengeneinheit.get","input":{"id":"<id>"}}`

#### produkte.mengeneinheit.create

Anlegen: Katalog „Mengeneinheiten" (produkte)

- 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":"produkte.mengeneinheit.create","input":{"label":"<label>"}}`

#### produkte.mengeneinheit.update

Ändern: Katalog „Mengeneinheiten" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.mengeneinheit.update","input":{"id":"<id>"}}`

#### produkte.mengeneinheit.delete

Löschen: Katalog „Mengeneinheiten" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.mengeneinheit.delete","input":{"id":"<id>"}}`

### Preistypen: `produkte.preistyp.*`

#### produkte.preistyp.list

Liste/Suche: Katalog „Preistypen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.preistyp.list","input":{}}`

#### produkte.preistyp.get

Detail: Katalog „Preistypen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.preistyp.get","input":{"id":"<id>"}}`

#### produkte.preistyp.create

Anlegen: Katalog „Preistypen" (produkte)

- 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":"produkte.preistyp.create","input":{"label":"<label>"}}`

#### produkte.preistyp.update

Ändern: Katalog „Preistypen" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.preistyp.update","input":{"id":"<id>"}}`

#### produkte.preistyp.delete

Löschen: Katalog „Preistypen" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.preistyp.delete","input":{"id":"<id>"}}`

### Prüfarten: `ressource.pruefart.*`

#### ressource.pruefart.list

Liste/Suche: Katalog „Prüfarten" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"ressource.pruefart.list","input":{}}`

#### ressource.pruefart.get

Detail: Katalog „Prüfarten" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.pruefart.get","input":{"id":"<id>"}}`

#### ressource.pruefart.create

Anlegen: Katalog „Prüfarten" (produkte)

- 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":"ressource.pruefart.create","input":{"label":"<label>"}}`

#### ressource.pruefart.update

Ändern: Katalog „Prüfarten" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"ressource.pruefart.update","input":{"id":"<id>"}}`

#### ressource.pruefart.delete

Löschen: Katalog „Prüfarten" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.pruefart.delete","input":{"id":"<id>"}}`

### Warengruppen: `produkte.warengruppe.*`

#### produkte.warengruppe.list

Liste/Suche: Katalog „Warengruppen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"produkte.warengruppe.list","input":{}}`

#### produkte.warengruppe.get

Detail: Katalog „Warengruppen" (produkte)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.warengruppe.get","input":{"id":"<id>"}}`

#### produkte.warengruppe.create

Anlegen: Katalog „Warengruppen" (produkte)

- 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":"produkte.warengruppe.create","input":{"label":"<label>"}}`

#### produkte.warengruppe.update

Ändern: Katalog „Warengruppen" (produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.warengruppe.update","input":{"id":"<id>"}}`

#### produkte.warengruppe.delete

Löschen: Katalog „Warengruppen" (produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.warengruppe.delete","input":{"id":"<id>"}}`

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### produkte.artikel.freigabe_list

Listet die Ziel-Mandanten, fuer die ein Artikel freigegeben ist (Cross-Tenant-Sichtbarkeit).

- Art: Lesen
- Rechte: Artikel lesen
- Datenklassen: B (intern)
- Datenschutz: Liest nur die Mandanten-Freigabe-Liste eines Artikels (Beziehungs-Metadaten, keine personenbezogenen Daten).
- Eingabe:
  - `artikelId` (string, Pflicht): Artikel-ID (produkte_artikel.id)
- Beispiel: `{"name":"produkte.artikel.freigabe_list","input":{"artikelId":"<artikelId>"}}`

#### produkte.artikel.freigabe_set

Setzt die Ziel-Mandanten, fuer die ein Artikel freigegeben ist (Replace; nur an AKTIVE Kooperations-Partner).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel ändern
- Datenklassen: B (intern)
- Datenschutz: Macht einen Artikel-Datensatz fuer fremde Mandanten sichtbar. Nur an aktive Kooperations-Partner, mit vertraglicher Grundlage.
- Eingabe:
  - `artikelId` (string, Pflicht): Artikel-ID (produkte_artikel.id)
  - `zielTenantIds` (string[]): Ziel-Tenant-IDs (aktive Kooperations-Partner). Leer = alle Freigaben entfernen
- Beispiel: `{"name":"produkte.artikel.freigabe_set","input":{"artikelId":"<artikelId>"}}`