Artikelverwaltung

Die Artikelverwaltung innerhalb des Auftragsmoduls ermöglicht das Verwalten von Standardartikeln, die in Aufträgen als Positionen verwendet werden. Die Verwaltung erfolgt über den StandardArticleController in der Laravel-API.

Konzept

Standardartikel sind vordefinierte Leistungen oder Produkte, die wiederkehrend in Aufträgen verwendet werden. Sie bilden einen Artikelstamm, aus dem beim Erstellen von Auftragspositionen ausgewählt werden kann.

Listenansicht

Spalte	Beschreibung
Artikelnummer	Eindeutige Kennung des Artikels
Bezeichnung	Name des Artikels
Beschreibung	Kurzbeschreibung
Einheit	Mengeneinheit (Stück, Stunde, Pauschale)
Preis	Standardpreis
Kategorie	Zugeordnete Artikelkategorie

CRUD-Operationen

Artikel anlegen

POST /api/v2/standard-articles

Feld	Pflicht	Beschreibung
Artikelnummer	Ja	Eindeutige Kennung
Bezeichnung	Ja	Name des Artikels
Beschreibung	Nein	Detaillierte Beschreibung
Einheit	Ja	Mengeneinheit
Preis	Nein	Standardpreis (netto)
MwSt.-Satz	Ja	Mehrwertsteuersatz in Prozent
Kategorie	Nein	Zuordnung zu einer Artikelkategorie

Artikel bearbeiten

PUT /api/v2/standard-articles/{id}

Artikel löschen

DELETE /api/v2/standard-articles/{id}

Achtung

Das Löschen eines Standardartikels hat keinen Einfluss auf bestehende Auftragspositionen, die diesen Artikel verwenden. Die Positionen behalten ihre Daten bei.

Verknüpfung mit Kalibrierstandards

Standardartikel können mit Kalibrierstandards verknüpft werden. Dies ist nützlich, wenn ein Artikel eine bestimmte Kalibrierdienstleistung repräsentiert und der zugehörige Messstandard dokumentiert werden soll.

PUT /api/v2/standard-articles/{id}
Body: { "calibration_standard_id": 15 }

Kalibrierstandards

Die Verknüpfung mit einem Kalibrierstandard ermöglicht die automatische Zuordnung des verwendeten Prüfmittels bei der Auftragsabwicklung.

Verwendung in Aufträgen

Beim Hinzufügen einer Position zu einem Auftrag kann aus dem Artikelstamm ausgewählt werden:

1. Im Auftragsformular den Button „Position hinzufügen" klicken
2. Artikel über die Suchfunktion finden (Autocomplete)
3. Menge eingeben
4. Preis wird aus dem Artikelstamm übernommen (kann individuell angepasst werden)

Preisgestaltung

Der im Standardartikel hinterlegte Preis dient als Vorschlagswert. Er kann beim Einfügen in einen Auftrag individuell angepasst werden. Preisänderungen am Standardartikel wirken sich nicht auf bestehende Auftragspositionen aus.

Tipp

Für kundenspezifische Preise verwenden Sie die Preisgruppen (siehe Preisgruppen). So können Sie unterschiedliche Preise pro Kundengruppe hinterlegen.

Berechtigungen

Die Verwaltung von Standardartikeln erfordert die Berechtigung article_manage. Das Verwenden von Artikeln in Aufträgen erfordert booking_manage.