Aus CSV oder Excel importieren

Der Importweg ohne KI und ohne Credits: Du lädst eine Tabelle hoch, ordnest die Spalten zu, und AreaCacao legt deine Rezepte auf einmal an oder aktualisiert sie.

Worum es geht

Aus CSV oder Excel importieren macht aus einer Tabelle Rezepte in AreaCacao. Du bereitest die Datei vor, du entscheidest, was jede Spalte bedeutet, und der Import legt die Rezepte an (oder aktualisiert sie). Beim Lesen der Datei ist keine KI beteiligt, und es werden keine Credits verbraucht.

Pfad: https://app.areacacao.com/import-recipe, Tab Neu hochladen.
So kommst du hin: Seitenleiste → REZEPTUREN → Rezepte importieren → Tab Neu hochladen. Die Karte liegt unter der Fläche zum Hochladen von Fotos/PDFs.
Verfügbarkeit: standardmäßig in allen Tarifen aktiv.

Was der Unterschied zum Import eines Fotos oder PDFs ist

	CSV / Excel	Foto oder PDF
Lesen der Datei	Deterministisch: deine Spalten, deine Zuordnung	Die KI deutet das Bild
Credits	0	ca. 15 pro Bild, ca. 25 pro PDF
Nutzungslimit	Kein Nutzungslimit (wohl aber eine technische Grenze für die Häufigkeit, siehe unten)	Begrenzt durch dein Credit-Guthaben
Mehrere Rezepte pro Datei	Ja, so viele, wie in die Tabelle passen	Eines pro Datei; enthält die Datei mehrere, wählst du, welches importiert wird
Wer entscheidet, was jede Angabe bedeutet	Du, im Schritt der Zuordnung	Die KI, und du korrigierst danach

Die KI kann nur an einer Stelle mitwirken, und die ist optional und deine Wahl: beim Ergänzen der Zutaten, die es in deinem Katalog nicht gibt (siehe weiter unten den Abschnitt Zutaten, die nicht zum Katalog passen).

Die Karte und ihre zwei Schaltflächen

Die Karte heißt „CSV oder Excel (ohne Credits)“, und ihr Text lautet: „Importiere deine Rezepte aus einer Tabelle. Verbraucht keine Credits und hat kein Nutzungslimit. Importiere ein oder mehrere Rezepte auf einmal.“

Sie hat zwei Schaltflächen und einen aufklappbaren Bereich:

CSV/Excel importieren: öffnet den Assistenten.
Vorlage herunterladen: lädt die Datei direkt herunter, ohne Umweg über den Server.
Kurzanleitung: So bereitest du deine Datei vor: ein aufklappbarer Bereich mit den Regeln zum Ausfüllen, der Liste der gültigen Werte für filling_type und den Werten für recipe_type.

Wenn die Karte bei dir nicht erscheint, ist die Funktion in der Infrastruktur abgeschaltet (Schalter RECIPE_IMPORT_CSV_ENABLED). Standardmäßig ist sie eingeschaltet: Sie wird nur abgeschaltet, wenn der Wert ausdrücklich false ist.

Die Vorlage

Die Schaltfläche Vorlage herunterladen legt rezeptvorlage-areacacao.csv auf deinem Rechner ab. Es ist eine CSV-Datei mit UTF-8-BOM (damit Excel Umlaute und Akzente richtig anzeigt) und enthält die kanonische Kopfzeile plus drei Beispielrezepte, ausgewählt, um die drei Muster zu zeigen, die der Import versteht:

Maracuja-Ganache: einfache Füllung: Fünf Zeilen teilen sich denselben recipe_name, und die letzte enthält die Arbeitsschritte. Vier Zutaten sind über ingredient_code verknüpft und eine (das Maracujamark) nur über den Namen.
Klassische Kakao-Trüffelpraline: Füllung mit Schichten: Die Spalte part trennt „Innenteil“ von „Überzug“.
Tafel Zartbitter 70 %: Schokoladenrezept: verwendet chocolate_type und cocoa_percent und lässt filling_type leer.

Die Vorlage kommt in der Sprache der Oberfläche: Mit der App auf Deutsch heißt die Datei rezeptvorlage-areacacao.csv, und die Namen von Rezepten, Zutaten, Abschnitten und Arbeitsschritten sind auf Deutsch; die Spaltenköpfe und die Bezeichner (ganache_bombon, negro …) sind immer dieselben. Die Beispielkosten gelten pro Kilo (cost_unit = kg) und in Euro (EUR).

Du musst die Vorlage nicht verwenden: Du kannst auch deine eigene Tabelle mit eigenen Spaltenköpfen importieren und im Schritt der Zuordnung angeben, was jede Spalte ist.

Spalten

Die Vorlage enthält 17 Spalten, in dieser Reihenfolge:

recipe_name, recipe_type, chocolate_type, filling_type, cocoa_percent, part, ingredient_code, ingredient_name, quantity, unit, weight_g, cost_per_unit, cost_unit, cost_currency, is_supply, supply_code, steps

Im Assistenten kannst du 18 Felder zuordnen: die 17 der Vorlage plus recipe_id (Rezept-ID), das es als Ziel der Zuordnung gibt, auch wenn es nicht in der Vorlage steht.

Feld	Bezeichnung im Assistenten	Wozu es dient
`recipe_name`	Rezeptname	Einziges Pflichtfeld. Fasst die Zeilen zusammen: Mehrere Zeilen mit demselben Namen bilden ein Rezept.
`recipe_id`	Rezept-ID	Aktualisiert ein bestehendes Rezept, statt ein neues anzulegen.
`recipe_type`	Rezepttyp	Akzeptierte Werte: `chocolate`, `filling`, `relleno`. Jeder andere Wert (oder ein leeres Feld) wird als `generic` behandelt.
`chocolate_type`	Schokoladensorte	Nur für Schokoladenrezepte.
`filling_type`	Füllungstyp	Der technische Typ der Füllung; ermöglicht die Prüfung anhand von Zielbereichen.
`cocoa_percent`	Kakaoanteil (%)	Kakaoanteil des Rezepts in Prozent.
`part`	Teil / Abschnitt	Trennt Schichten oder Abschnitte innerhalb desselben Rezepts.
`ingredient_code`	Zutatencode	Verknüpft die Zeile mit einem bestimmten Datenblatt deines Katalogs.
`ingredient_name`	Zutatenname	Dient zur Suche nach Namen, wenn es keinen Code gibt.
`quantity`	Menge	Menge der Zutat.
`unit`	Einheit	Einheit der Menge.
`weight_g`	Gewicht (g)	Gewicht in Gramm. Bleibt es leer, wird versucht, es aus Menge + Einheit umzurechnen.
`cost_per_unit`	Kosten pro Einheit	Stückkosten der Zeile.
`cost_unit`	Kosteneinheit	Einheit, auf die sich die Kosten beziehen (zum Beispiel `kg`). Ordnest du die Kosten zu, aber nicht diese Spalte, werden die Kosten in der Einheit jeder Zeile gelesen (eine Zeile in `g` gilt als Kosten pro Gramm), und die Vorschau weist dich darauf hin.
`cost_currency`	Währung	Währung der Kosten.
`is_supply`	Ist Verbrauchsmaterial	Kennzeichnet die Zeile als Material (nicht essbar).
`supply_code`	Materialcode	Verknüpft die Zeile über den Code mit einem Material aus deinem Katalog.
`steps`	Arbeitsschritte / Zubereitung	Alle Arbeitsschritte in einer einzigen Zelle, getrennt durch einen senkrechten Strich.

Wie die Zeilen zusammengefasst werden

Die Zeilen werden nach dem normalisierten recipe_name zusammengefasst: kleingeschrieben, ohne Akzente und mit zusammengezogenen Leerzeichen im Inneren. „Haselnuss-Praliné“ und „haselnuss-praline“ landen also im selben Rezept.

Regeln zum Ausfüllen, die der Import anwendet

Eine Zutat pro Zeile. Schreib nicht die ganze Zutatenliste in eine Zelle: Der Import kann sie nicht auftrennen.
Arbeitsschritte mit |. Es reicht, steps in einer beliebigen Zeile des Rezepts auszufüllen.
Schichten mit part. Derselbe recipe_name in allen Zeilen und der Name der Schicht in part. Hat das Rezept nur eine Schicht, lass part leer.
filling_type mit dem genauen Bezeichner, kleingeschrieben und mit Unterstrichen. ganache allein ist kein gültiger Wert; die klassische Pralinenganache ist ganache_bombon. Die vollständige Liste steht im aufklappbaren Bereich Kurzanleitung auf der Seite selbst.

Der Assistent, Schritt für Schritt

Der Assistent heißt „Rezepte aus CSV importieren“ und hat fünf Ansichten.

Hochladen. Zieh die Datei auf die Fläche „Zieh deine Datei hierher“ oder klicke, um sie auszuwählen. Akzeptiert werden .csv und .xlsx, und nur eine Datei pro Import (die Auswahl lässt nicht mehrere zu).

Zuordnen. Eine Tabelle mit drei Spalten (Spalte der Datei, Beispiel und Feld in AreaCacao), in der du das Ziel jedes Spaltenkopfs wählst. Der Assistent ist schon mit seiner eigenen Erkennung vorausgefüllt, die Synonyme auf Spanisch, Englisch, Französisch und Portugiesisch erkennt, ohne Groß- und Kleinschreibung oder Akzente zu unterscheiden (Nombre de la receta, recipe name, recette, receita … landen alle bei recipe_name).

Spalten, die du nicht brauchst, lässt du auf Überspringen. Dasselbe Feld in AreaCacao kann nicht zwei Spalten zugeordnet werden: Wählst du es in einer, wird es in der anderen entfernt.

Hast du den Rezeptnamen nicht zugeordnet, lässt dich der Assistent nicht weiter und zeigt: „Gib mindestens an, welche Spalte den Rezeptnamen enthält, um fortzufahren.“

Optionen. Du wählst, was mit den Zutaten passiert, die wir nicht finden. Siehe nächster Abschnitt.

Vorschau. Der Server berechnet, was passieren würde, ohne etwas zu schreiben: „Das werden wir tun. Noch ist nichts gespeichert.“ Du siehst die Zählungen Neu anzulegende Rezepte, Zu aktualisierende Rezepte, Rezepte gesamt, Verknüpfte Zutaten, Neu anzulegende Zutaten, Ausstehende Zutaten und Nicht gefundenes Material, dazu eine Liste Gefundene Fehler nach Zeilennummer. Hast du die Kosten pro Einheit ohne die Spalte cost_unit zugeordnet, erklärt dir ein Hinweis, wie diese Kosten gelesen werden.

Importieren. Du klickst auf Importieren, und die Arbeit läuft im Hintergrund weiter. Die Seite fragt den Status alle 2,5 Sekunden ab und zeigt währenddessen „Deine Rezepte werden importiert …“ mit der Schaltfläche Schließen (läuft im Hintergrund weiter). Am Ende zeigt sie „Import abgeschlossen“ mit der Zusammenfassung „N angelegt · N aktualisiert · N mit Fehlern.“, einer Schaltfläche Meine Rezepte und, wenn nur ein Rezept angelegt wurde, Rezept ansehen, das es im Editor mit dem Prüfbereich öffnet.

Zutaten, die nicht zum Katalog passen

Der Import löst jede Zeile so auf: Gibt es einen ingredient_code, sucht er genau dieses Datenblatt; sonst sucht er nach Namen in deinem Katalog. Passt der Name zu mehreren Datenblättern, bleibt die Zeile offen, mit einer kurzen Liste von Kandidaten, aus der du im Rezept wählst; wurde das Datenblatt abgeleitet, indem eine Marke oder ein Prozentwert aus dem Namen entfernt wurde, wird die Zeile zur Kontrolle markiert. Findet er gar nichts, wendet er die Option an, die du im Schritt Optionen gewählt hast:

Fehlende Zutaten als ausstehend anlegen (ohne Kosten): „Zutaten, die wir nicht finden, werden als ausstehend markiert hinzugefügt, ohne Nährwerte und Kosten. Du kannst sie später ergänzen. Verbraucht keine Credits.“ Das ist die Standardoption.
Fehlende Zutaten mit KI ergänzen – 5 Credits pro Zutat: „Für jede Zutat, die wir nicht finden, schätzt die KI Makronährstoffe, Allergene und Kostendaten. Pro neuer Zutat werden 5 Credits berechnet.“

Der KI-Modus ist die einzige Möglichkeit, bei diesem Weg Credits zu verbrauchen, und sie werden pro neuer Zutat berechnet, nicht pro Rezept oder pro Datei. Der Modus „ausstehend“ rührt deine Credits nie an.

Material

Zeilen, die mit is_supply oder mit supply_code gekennzeichnet sind, werden als Material behandelt. Sie werden nur über den Code mit deinem Materialkatalog verknüpft. Gibt es den Code nicht, wird die Zeile trotzdem importiert, aber zur Prüfung markiert, und die Zählung Nicht gefundenes Material in der Vorschau warnt dich vorher. Der Import legt nie neues Material an, auch nicht im KI-Modus, der nur für Zutaten gilt.

Anlegen oder aktualisieren

Ohne recipe_id → es wird immer ein neues Rezept angelegt.
Mit recipe_id → gibt es diese ID und gehört sie dir, wird das Rezept aktualisiert. Gibt es sie nicht oder gehört sie dir nicht, wird ein neues Rezept angelegt.
Wird ein Rezept angelegt, dessen Namen es in deinem Katalog schon gibt, unterscheidet AreaCacao den Namen automatisch, statt ihn blind zu doppeln. Das gilt nur beim Anlegen, nie beim Aktualisieren.
Ein Rezept, das fehlschlägt, bricht den Stapel nicht ab: Es wird mit seinem Fehler markiert, und der Import macht mit dem nächsten weiter.

Grenzen

Grenze	Wert
Formate	`.csv` und `.xlsx`
Dateien pro Import	1
Maximale Dateigröße	20 MB
Maximale Zahl an Datenzeilen	20.000 (ohne Kopfzeile)
Gelesene Blätter einer `.xlsx`-Datei	Nur das erste
Gleichzeitige Importe	1 pro Nutzer
Häufigkeit	20 Upload-/Analysevorgänge alle 10 Minuten pro Nutzer

Startest du einen Import, während ein anderer noch in der Warteschlange steht oder verarbeitet wird, lehnt der Server ihn ab: Du musst warten, bis der vorherige fertig ist.

Was der Import NICHT macht

Er liest deine Datei nicht mit KI. Die Zuordnung der Spalten machst du, und das Einlesen ist deterministisch.
Er erscheint nicht im Tab Verlauf. Dieser Tab listet die Foto- und PDF-Importe. Auch wenn der Assistent sagt „Du kannst dieses Fenster schließen; der Import läuft weiter, und du findest ihn im Verlauf.“, werden Importe aus Tabellen heute auf keiner Seite aufgelistet: Ihren Status siehst du nur im Fenster des Assistenten, solange es offen ist. Schließt du es, läuft der Import weiter, aber um das Ergebnis zu prüfen, musst du in Meine Rezepte nachsehen.
Er lässt sich nicht abbrechen. Sobald du auf Importieren klickst, gibt es keine Schaltfläche zum Abbrechen; der Assistent lässt dich nur das Fenster schließen.
Er legt kein neues Material an.
Er liest nicht mehr als ein Blatt einer Excel-Arbeitsmappe.
Er importiert nicht über einen Link zu Google Sheets oder eine URL: Du musst die Datei hochladen. Für den Import von einer Webseite gibt es einen eigenen Weg, siehe Rezept per URL importieren.
Er prüft den filling_type nicht für dich. Schreibst du einen Bezeichner, den es nicht gibt, wird das Rezept ohne technische Prüfung der Füllung importiert.