​

CSV-Upload

Verwende CSV Upload, um POS-Verkaufsdaten aus einer CSV-Datei zu importieren und in Bestandsbewegungen umzuwandeln. CSV Upload ist nützlich, wenn du keine direkte POS-Integration verwendest oder wenn Verkaufsdaten aus einem anderen System als Exportdatei bereitgestellt werden. Der CSV-Upload kann:

• Verkaufsdaten aus einer CSV-Datei lesen
• POS-Artikelcodes aus ausgewählten Spalten extrahieren
• Mengen aus einer Mengenspalte lesen
• Daten aus einer Datumsspalte lesen
• POS-Codes mit POS-Zuordnungen abgleichen
• Rezeptzuordnungen in Zutaten aufschlüsseln
• Bestands-Ledger-Einträge erstellen

​

So funktioniert es

Mathership liest die hochgeladene CSV-Datei Zeile für Zeile. Für jede Zeile wendet Mathership die konfigurierten CSV-Regeln an und extrahiert verkaufte POS-Artikel. Der grundlegende Ablauf ist:

1. CSV-Integration erstellen
2. CSV-Regeln konfigurieren
3. POS-Zuordnungen erstellen
4. CSV-Datei hochladen
5. Mathership liest die Datei
6. Verkaufte POS-Artikel werden mit Zuordnungen abgeglichen
7. Zutatenabbuchungen werden im Bestands-Ledger erstellt

​

Bevor du beginnst

Stelle sicher, dass du bereits Folgendes hast:

• Ein Unternehmen in Mathership
• In Mathership erstellte Zutaten
• Erstellte Rezepte, wenn du POS-Artikel Rezepten zuordnen möchtest
• Erstellte Lagereinheiten
• Konfigurierte POS-Zuordnungen
• Eine CSV-Datei mit Verkaufsdaten

​

CSV-Integration erstellen

CSV Upload verwendet eine POS-Integration mit dem Integrationstyp CSV. So erstellst du sie:

1. Gehe zu Manage → Integrations
2. Wähle CSV Upload
3. Erstelle eine neue CSV-Integration
4. Konfiguriere die Regeln für das Datenschema
5. Speichere die Integration

Die Integration speichert die Regeln, die Mathership mitteilen, wie die CSV-Datei gelesen werden soll.

​

CSV-Regeln

CSV-Regeln legen fest, welche Spalten Mathership aus der hochgeladenen Datei lesen soll. Der unterstützte Regeltyp ist: Eine Regel kann Folgendes verwenden:

​

Beispiel-CSV-Datei

Eine einfache CSV-Datei könnte so aussehen: In diesem Beispiel:

• pos_code ist die Quellspalte
• qty ist die Mengenspalte
• date ist die Datumsspalte

​

Beispielregel

Beispielhafte Regelkonfiguration: Mit dieser Regel liest Mathership jeden POS-Code aus der Spalte pos_code.

​

Mehrere POS-Codes in einer Zelle

Wenn eine CSV-Zelle mehrere POS-Codes enthält, verwende ein Trennzeichen. Beispiel-CSV: Beispielregel: Mathership teilt den Wert auf und verarbeitet beide POS-Codes.

​

Umgang mit Mengen

Wenn eine Mengenspalte konfiguriert ist, verwendet Mathership den Wert aus dieser Spalte. Wenn keine Mengenspalte konfiguriert ist, verwendet Mathership 1 als Standardmenge. Beispiel:

​

Umgang mit Daten

Wenn eine Datumsspalte konfiguriert ist, verwendet Mathership dieses Datum für die Bestandsbewegung. Wenn keine Datumsspalte konfiguriert ist, verwendet Mathership das aktuelle Datum und die aktuelle Uhrzeit. Das Datum sollte als ISO-ähnliches Datum oder Datum mit Uhrzeit lesbar sein, zum Beispiel:

​

POS-Zuordnungen

Erstelle POS-Zuordnungen, bevor du Verkaufsdaten hochlädst. Eine POS-Zuordnung verbindet einen POS-Artikelcode oder -namen mit einer Mathership-Zutat oder einem Mathership-Rezept. Beispiele: Ohne Zuordnungen kann Mathership POS-Verkäufe nicht in Bestandsabbuchungen umwandeln.

​

Zutat-Zuordnung

Verwende eine Zutat-Zuordnung, wenn ein POS-Artikel eine einzelne Zutat direkt abbuchen soll. Beispiel:

​

Rezeptzuordnung

Verwende eine Rezeptzuordnung, wenn ein POS-Artikel aus mehreren Zutaten besteht. Beispiel: Wenn die CSV-Datei BURGER_CLASSIC enthält, schlüsselt Mathership das Rezept auf und bucht alle Rezeptzutaten ab.

​

CSV-Datei hochladen

So lädst du eine Datei hoch:

1. Öffne Manage → Integrations
2. Öffne die CSV-Integration
3. Wähle die CSV-Datei aus
4. Starte den Upload
5. Prüfe das Ergebnis

Die hochgeladene Datei muss eine CSV-Datei mit Kopfzeilen sein. Mathership liest die Spaltennamen aus der ersten Zeile.

​

Was während des Uploads passiert

Wenn eine CSV-Datei hochgeladen wird, führt Mathership Folgendes aus:

1. CSV-Datei lesen
2. Konfigurierte Regeln auf jede Zeile anwenden
3. POS-Codes, Mengen und Daten extrahieren
4. POS-Codes mit POS-Zuordnungen abgleichen
5. Rezeptzuordnungen in Zutaten aufschlüsseln
6. Zutatenmengen berechnen
7. Bestands-Ledger-Einträge erstellen
8. Letzte Ausführungszeit der Integration aktualisieren
9. Verarbeitungszusammenfassung zurückgeben

​

Upload-Ergebnis

Ein erfolgreicher Upload gibt eine Zusammenfassung der erstellten Bestandsabbuchungen zurück. Das Ergebnis kann Folgendes enthalten:

• Zutatenname
• Abgebuchte Menge
• Lagereinheit
• Datum der Bestandsbewegung

Beispielergebnis:

​

Bestands-Ledger-Einträge

CSV-Uploads erstellen Bestands-Ledger-Einträge mit dem Transaktionstyp ISSUE. Das bedeutet, dass die hochgeladenen Verkäufe den Bestand reduzieren. Jeder erstellte Eintrag enthält:

• Unternehmen
• Zutat
• Lagereinheit
• Transaktionstyp
• Menge
• Stückkosten
• Wert
• Datum

Siehe Inventory Ledger für Details.

​

Auswahl der Lagereinheit

Bei CSV-Uploads bestimmt Mathership die Lagereinheit über die Logik der zugeordneten Zutat oder des zugeordneten Rezepts. Das System versucht, eine Lagereinheit aus folgenden Quellen zu ermitteln:

1. Ausgabelager der Rezeptzeile
2. Bevorzugtes Ausgabelager der Zutat
3. Standard-Ausgabelager des Rezepts
4. Eine Lagereinheit mit verfügbarem Bestand
5. Erste verfügbare Lagereinheit als Fallback

Für korrekte Bestandsabbuchungen solltest du die Lagereinstellungen für Zutaten und Rezepte konfigurieren.

​

Typischer Einrichtungsablauf

Verwende diese Reihenfolge für eine saubere CSV-Einrichtung:

1. Lagereinheiten erstellen
2. Zutaten erstellen
3. Bei Bedarf Rezepte erstellen
4. CSV-Integration erstellen
5. CSV-Regeln konfigurieren
6. POS-Zuordnungen erstellen
7. Kleine Test-CSV hochladen
8. Bestands-Ledger prüfen
9. Vollständige CSV-Datei hochladen

​

Zuerst mit einer kleinen Datei testen

Bevor du einen großen Export hochlädst, teste mit einer kleinen CSV-Datei. Verwende nur wenige Zeilen, zum Beispiel: Prüfe nach dem Upload, ob:

• Der Upload erfolgreich abgeschlossen wurde
• Die richtigen Zutaten abgebucht wurden
• Die Mengen korrekt sind
• Die richtigen Lagereinheiten verwendet wurden
• Die Ledger-Einträge das richtige Datum haben

​

Häufige Fehler

​

Datei nicht bereitgestellt

Dies passiert, wenn keine CSV-Datei angehängt wurde. Lade eine CSV-Datei hoch und versuche es erneut.

​

CSV-Integration nicht gefunden

Dies passiert, wenn die ausgewählte Integration nicht existiert oder keine CSV-Integration ist. Prüfe, ob:

• Die Integration existiert
• Die Integration zum ausgewählten Unternehmen gehört
• Der Integrationstyp CSV ist

​

Verarbeitungsfehler

Dies passiert, wenn Mathership während der Verarbeitung Probleme findet. Häufige Ursachen sind:

• POS-Code hat keine Zuordnung
• Rezept hat einen Zyklus
• Lagereinheit kann nicht ermittelt werden
• Zutat existiert nicht mehr
• Rezeptzeile ist unvollständig

Korrigiere die Zuordnungen oder die Rezepteinrichtung und lade die Datei erneut hoch.

​

Nicht zugeordneter POS-Code

Das bedeutet, dass die CSV-Datei einen POS-Code enthält, der keine POS-Zuordnung hat. Beispiel:

​

Falsche Menge

Prüfe:

• Die Mengenspalte in der CSV
• Die konfigurierte Mengen-Quellspalte
• Die Menge in der POS-Zuordnung
• Die Mengen der Rezeptzeilen
• Die Basiseinheit der Zutat

​

Falsches Datum

Prüfe:

• Die Datumsspalte in der CSV
• Die konfigurierte Datums-Quellspalte
• Ob das Datumsformat korrekt gelesen werden kann

Wenn das Datum nicht gelesen werden kann, verwendet Mathership möglicherweise das aktuelle Datum und die aktuelle Uhrzeit.

​

Best Practices

• Verwende nach Möglichkeit stabile POS-Codes statt Produktnamen
• Halte CSV-Kopfzeilen konsistent
• Vermeide Änderungen an Spaltennamen nach der Einrichtung
• Teste zuerst mit einer kleinen Datei
• Ordne zuerst POS-Artikel mit hohem Verkaufsvolumen zu
• Verwende Rezepte für vorbereitete Gerichte
• Verwende direkte Zutat-Zuordnungen für einfache Artikel
• Prüfe den Bestands-Ledger nach jedem ersten Upload
• Bewahre eine Kopie hochgeladener CSV-Dateien zur Nachvollziehbarkeit auf

​

Beispiel für eine CSV-Einrichtung

Beispielhafte CSV-Kopfzeilen: Beispielregel: Beispielzuordnungen:

​

Verwandte Seiten