Materialkatalog

Worum es geht

Der Materialkatalog ist die Seite, auf der du dein ganzes Material anlegst und pflegst: jedes nicht essbare Material mit seinen Kosten pro Einheit, seiner Verbrauchseinheit, seinem Lieferanten und, wenn du willst, deinen eigenen Feldern. Der Katalog gehört zu deinem Konto (du legst ihn selbst an; anders als bei den Zutaten gibt es keine globale Datenbank) und ist die Quelle, aus der die Rezepte schöpfen, wenn du Material hinzufügst.

Alles liegt auf einer einzigen Seite: Es gibt keine Unterseiten (/supplies/catalog, /supplies/categories …). Alles (Suche, Filter, Anlegen, Bearbeiten, eigene Felder und Import/Export) erledigst du hier über Fenster.

Zugang

• URL: https://app.areacacao.com/supplies
• So kommst du hin: Seitenleiste → REZEPTUREN → Verpackung & Material.
• Verfügbarkeit: für alle angemeldeten Nutzer (ohne Einschränkung nach Tarif).
• Das alte /insumos leitet hierher weiter.

Bereiche der Seite

Kopfzeile

Oben findest du den Link Zurück zum Dashboard und den Titel Verpackung & Material, mit einer Unterzeile, die die tatsächliche Anzahl deiner Materialien zeigt („N Materialien in deinem Katalog“) oder, wenn du noch keines hast, „Verpackungen, Etiketten, Versandmaterial und nicht essbares Verbrauchsmaterial“.

Rechts gibt es vier Schaltflächen:

• Neues Material: öffnet das Formular, um ein Material mit allen Angaben anzulegen. Siehe Material anlegen.
• Kategorien verwalten: öffnet das Fenster zum Umbenennen, Löschen oder Hinzufügen von Materialkategorien. Siehe Materialkategorien.
• Eigene Felder: öffnet die Verwaltung, in der du eigene Felder für dein Material festlegst (Werkstoff, Charge, Zertifizierung …). Siehe Eigene Felder.
• Importieren / Exportieren: öffnet das Fenster, um deinen Katalog als CSV auszugeben oder einzulesen. Siehe Importieren und exportieren.

Filterleiste

Über der Tabelle liegt eine Leiste mit vier Bedienelementen:

• Suchfeld mit dem Platzhalter „Nach Name, Code oder Lieferant suchen …“. Es sucht nach Name (auch dem englischen Namen), interner Artikelnummer (SKU), Artikelnummer des Lieferanten, Lieferant, Beschreibung und Notizen.
• Kategorieauswahl mit der Standardoption Alle Kategorien (sie lädt deine verwalteten Kategorien).
• Lieferantenauswahl mit der Standardoption Alle Lieferanten.
• Nur mit Bestandsführung: Kontrollkästchen, das die Liste auf Material mit aktivierter Bestandsführung beschränkt.

Sobald du einen Filter änderst, springt die Liste zurück auf Seite 1.

Ergebnistabelle

Jede Zeile zeigt diese Spalten:

Klicke auf eine beliebige Zeile, um die Materialdetails zu öffnen.

Seitenaufteilung

Die Liste zeigt 50 Materialien pro Seite. Gibt es mehr als eine Seite, erscheint unten eine Fußzeile mit dem sichtbaren Bereich („X–Y von GESAMT“) und den Pfeilen Vorherige Seite / Nächste Seite.

Material anlegen

Klicke auf Neues Material, um das Formular zu öffnen, mit dem Untertitel „Nicht essbare Materialien, die pro verkaufsfähiger Produkteinheit umgelegt werden.“ Es ist in Abschnitte gegliedert:

• Stammdaten: Name (Pflichtfeld), optional Name (Englisch), Kategorie (siehe Kategorien), Beschreibung, Lieferant, Artikelnummer des Lieferanten und Interne Artikelnummer (SKU).
• Einheiten und Einkauf: das Modell mit zwei Einheiten:
  • Verbrauchseinheit: die Einheit, die du im Rezept verwendest (z. B. Stück, Bogen, Meter).
  • Einkaufseinheit: wie du es kaufst (z. B. Karton à 500).
  • Verbrauchseinheiten pro Einkaufseinheit: der Faktor (z. B. ein Karton mit 500 Pralinenkapseln → 500). Damit werden die Kosten pro Verbrauchseinheit berechnet.
• Kosten: Kosten pro Verbrauchseinheit und die Zwischensumme in der Kalkulation (unter welcher Position diese Kosten zusammengefasst werden: Verpackung & Material, Zutaten oder Gemeinkosten; standardmäßig Verpackung & Material).
• Bestand (optional): Bestand für dieses Material führen aktiviert die laufende Bestandsführung im Lager, mit einer Warnung bei niedrigem Bestand.
• Weitere Angaben: Bild-URL, Notizen und die eigenen Felder, die du festgelegt hast.

Klicke auf Material anlegen, um es zu speichern (oder beim Bearbeiten auf Änderungen speichern).

Eigene Felder

Wie bei den Zutaten kannst du dein Material um eigene Felder deines Kontos erweitern (Werkstoff, Charge, Zertifizierung …). Klicke in der Kopfzeile auf Eigene Felder, um die Verwaltung zu öffnen:

• Die Liste N Felder definiert mit jedem Feld (Bezeichnung, Schlüssel, Typ, Pflichtfeld) und Aktionen zum Bearbeiten und Löschen.
• Neues Feld öffnet einen Editor mit Bezeichnung (Pflicht), dem internen Schlüssel in snake_case (wird automatisch erzeugt und lässt sich später nicht ändern), Typ (Text, Zahl, Datum, Liste oder Ja / Nein), Optionen (nur für Liste), Hilfetext und dem Kontrollkästchen Pflichtfeld.

Wenn du ein Feld löschst, bleiben die bei deinem Material bereits erfassten Werte erhalten. Die Werte jedes Felds trägst du im jeweiligen Material ein, im Abschnitt Weitere Angaben des Formulars.

Importieren und exportieren

Klicke auf Importieren / Exportieren, um das Fenster zu öffnen (Untertitel „Lege viele Materialien auf einmal an oder lade deinen Katalog herunter.“), mit zwei Tabs:

Importieren

• Vorlage herunterladen gibt dir vorlage-material.csv mit den richtigen Spalten und zwei Beispielzeilen (eine Pralinenkapsel und eine Pralinenschachtel) in der Sprache der App.
• Den Inhalt lieferst du, indem du eine CSV-Datei hineinziehst, über Datei auswählen oder indem du ihn direkt einfügst („… oder füge den Inhalt direkt ein“).
• Der aufklappbare Bereich So bereitest du die CSV-Datei vor erinnert an die wichtigsten Regeln:
  • name ist die einzige Pflichtspalte.
  • purchaseUnit, trackingUnit und purchaseToTrackingFactor bilden das Modell mit zwei Einheiten (du kaufst „Karton à 500“ und verbrauchst „Stück“).
  • costPerUnit sind die Kosten pro Verbrauchseinheit, in der Währung deines Kontos.
  • costBucket akzeptiert insumos, ingredientes oder overhead.
  • Neue Kategorien werden automatisch als verwaltete Kategorien angelegt.
• Die Auswahl Modus legt fest, wie importiert wird:

Vor dem Bestätigen kannst du dir eine Vorschau ansehen: Sie zeigt eine Zusammenfassung wie „N Zeilen – X anlegen, Y aktualisieren, Z überspringen, W Fehler“. Klicke auf Importieren, um sie anzuwenden.

Exportieren

Lädt deinen ganzen Katalog als CSV herunter (material.csv), eine Zeile pro Material mit allen Spalten. Spalten für eigene Felder werden mit dem Präfix cf_ ergänzt; das Feld allergens gilt nicht für Material.

Kostenverlauf

Jedes Mal, wenn sich die Kosten eines Materials ändern, erfasst AreaCacao das. Wenn du die Materialdetails öffnest (Klick auf eine Zeile), siehst du neben den allgemeinen Angaben und den Einheiten einen Abschnitt Kostenverlauf mit Datum, den Kosten Vorher, den Kosten Nachher und einer Notiz zu jeder Änderung. Gibt es noch keine Änderungen, steht dort „Noch keine Kostenänderungen erfasst.“

Zustände der Seite

• Wird geladen: zeigt ein Tabellengerüst.
• Leerer Katalog: „Noch keine Materialien“ + „Füge Verpackungen, Etiketten, Pralinenkapseln, Schachteln oder anderes nicht essbares Material hinzu, um es in die Kosten deiner Rezepte einzurechnen.“ mit einer Schaltfläche Neues Material.
• Keine Ergebnisse mit Filtern: „Keine Materialien mit diesen Filtern.“
• Ladefehler: rotes Banner mit „Die Materialien konnten nicht geladen werden“.

Verfügbarkeit nach Tarif

In allen Tarifen verfügbar.

Nächste Schritte