Mit dem Umsatz-Feed holen Sie Ihre Umsätze aus CATAMA direkt in Excel. Die Daten aktualisieren sich beim Öffnen der Datei oder in festen Abständen von selbst. Ihre eigene Excel-Vorlage übernimmt die Werte per Formel oder Pivot-Tabelle, sodass Aufbau und Gestaltung erhalten bleiben.

So funktioniert es

1. CATAMA stellt Ihre Umsätze unter einer geschützten Adresse (Feed-URL) als Tabelle bereit, je Rechnung und Gutschrift eine Zeile.
2. Excel ruft diese Adresse über Power Query ab („Daten → Aus dem Web“).
3. Bei jeder Aktualisierung lädt Excel den aktuellen Stand neu. Ihre Formeln und Auswertungen rechnen automatisch mit.

Voraussetzung: CATAMA ab Version 26.45.69 und Microsoft Excel mit Power Query (Microsoft 365 oder Excel 2016 und neuer unter Windows). Excel für Mac unterstützt Webabfragen nur eingeschränkt.

Einrichtung in CATAMA

Die Einstellungen sehen und ändern nur Administratoren. Öffnen Sie Zahnrad → System-Einstellungen → API und klappen Sie den Bereich Umsatz-Feed für Excel auf.

1. Status auf „aktiviert“ stellen.
2. Optional EK und Gewinn ausgeben aktivieren. Dann enthält der Feed zusätzlich Einkaufspreis und Gewinn je Beleg. Aktivieren Sie das nur, wenn alle Empfänger der Excel-Datei diese Zahlen sehen dürfen.
3. Einstellungen speichern.
4. Die Feed-URL für Excel kopieren. Sie sieht zum Beispiel so aus:
   https://ihr-autohaus.catama-instanz.de/api/reports/revenue-feed.csv?token=IHR-FEED-TOKEN

Zeitraum und Filiale wählen

Ohne weitere Angabe liefert der Feed den Zeitraum vom 1. Januar des Vorjahres bis heute. Andere Zeiträume und einzelne Filialen hängen Sie an die Feed-URL an:

Beispiel: https://ihr-autohaus.catama-instanz.de/api/reports/revenue-feed.csv?token=IHR-FEED-TOKEN&start=01.01.2026&branch=2

Einrichtung in Excel

1. Öffnen Sie Ihre Excel-Datei und legen Sie ein neues Tabellenblatt für die Rohdaten an, zum Beispiel „CATAMA-Daten“.
2. Wählen Sie Daten → Aus dem Web, fügen Sie die Feed-URL ein und bestätigen Sie mit OK.
3. Fragt Excel nach der Anmeldung, wählen Sie Anonym und klicken Sie auf Verbinden. Der Zugangsschlüssel steckt bereits in der Adresse.
4. Klicken Sie in der Vorschau auf Daten transformieren. Prüfen Sie, dass die Spalten getrennt angezeigt werden und die erste Zeile als Überschrift dient.
5. Stellen Sie die Zahlenspalten (z. B. turnover, net_total) auf Dezimalzahl um: Rechtsklick auf die Spalte → Typ ändern → Mit Gebietsschema… → Datentyp „Dezimalzahl“, Gebietsschema „Englisch (USA)“. CATAMA liefert Zahlen mit Dezimalpunkt. Ohne diesen Schritt liest ein deutsches Excel 1234.50 falsch.
6. Klicken Sie auf Schließen & laden. Die Daten erscheinen als Tabelle im Rohdaten-Blatt.
7. Verweisen Sie in Ihrer Vorlage per Formel (z. B. SUMMEWENNS) oder Pivot-Tabelle auf diese Tabelle.

Für Fortgeschrittene: fertige Abfrage

Statt der Schritte 4 und 5 können Sie die Abfrage auch im Power-Query-Editor unter Start → Erweiterter Editor einfügen. Ersetzen Sie die Adresse durch Ihre Feed-URL:

let
    Quelle = Csv.Document(Web.Contents("https://ihr-autohaus.catama-instanz.de/api/reports/revenue-feed.csv?token=IHR-FEED-TOKEN"), [Delimiter=";", Encoding=65001, QuoteStyle=QuoteStyle.Csv]),
    Kopfzeile = Table.PromoteHeaders(Quelle, [PromoteAllScalars=true]),
    Typen = Table.TransformColumnTypes(Kopfzeile, {
        {"document_date", type date}, {"branch_id", Int64.Type}, {"status", Int64.Type},
        {"net_total", type number}, {"turnover", type number}, {"transit_items", type number},
        {"article_net", type number}, {"labor_net", type number}, {"vehicle_net", type number},
        {"package_net", type number}, {"misc_net", type number}
    }, "en-US")
in
    Typen

Haben Sie EK und Gewinn ausgeben aktiviert, ergänzen Sie die Liste um {"purchase_total", type number}, {"profit", type number}.

Automatisch aktualisieren

Öffnen Sie Daten → Abfragen und Verbindungen, klicken Sie mit der rechten Maustaste auf die Abfrage und wählen Sie Eigenschaften:

• Daten beim Öffnen der Datei aktualisieren: Beim Öffnen sind die Zahlen immer aktuell.
• Aktualisieren alle … Minuten: Aktualisiert, solange die Datei geöffnet ist. 60 Minuten reichen in der Regel aus.

Von Hand aktualisieren Sie jederzeit mit Daten → Alle aktualisieren.

Welche Daten enthalten sind

Der Umsatz entspricht der Kachel „Umsatz **“ der Umsatzauswertung in CATAMA:

• Rechnungen mit Status fakturiert, bezahlt oder überfällig, nach Belegdatum
• Gutschriften als negative Werte
• Nicht enthalten: Entwürfe, stornierte Belege, Sammelrechnungen, Abschlagsrechnungen, Angebote und Bestellungen
• Alle Beträge netto
• Kundenname und Fahrzeug so, wie sie auf dem Beleg stehen. Fahrzeugfelder bleiben leer, wenn am Beleg kein Fahrzeug verknüpft ist.

Die Spaltennamen bleiben bei Updates gleich, damit Ihre Abfrage weiter funktioniert.

Sicherheit

• Wer die Feed-URL oder eine Excel-Datei mit dieser Abfrage besitzt, kann Ihre Umsätze abrufen. Geben Sie die Datei nur an berechtigte Personen weiter.
• Der Feed enthält Kundennamen und Fahrzeugdaten, also personenbezogene Daten. Behandeln Sie die Excel-Datei wie andere Kundendaten und speichern Sie sie nur an geschützten Orten.
• Nach einer Weitergabe oder einem Mitarbeiterwechsel klicken Sie in den Einstellungen auf Neuen Feed-Token erzeugen. Die alte Adresse funktioniert dann sofort nicht mehr. Tragen Sie die neue Adresse in Excel unter Daten → Abfragen und Verbindungen → Bearbeiten → Quelle ein.
• Der Feed kann nur lesen. Über ihn lassen sich keine Daten in CATAMA ändern.
• Ist der Status auf „deaktiviert“, liefert die Adresse keine Daten mehr.

Häufige Fragen

Excel zeigt „nicht gefunden“ oder einen Fehler 404.
Der Feed ist deaktiviert oder der Token in der Adresse stimmt nicht mehr, zum Beispiel nach dem Erzeugen eines neuen Tokens. Kopieren Sie die aktuelle Feed-URL erneut aus den Einstellungen.

Excel meldet einen Fehler zum Zeitraum.
Der Zeitraum ist länger als 24 Monate, das Enddatum liegt vor dem Startdatum, oder ein Datum ist nicht lesbar. Verwenden Sie das Format TT.MM.JJJJ.

Alle Werte stehen in einer Spalte.
Stellen Sie in Power Query das Trennzeichen auf Semikolon um oder verwenden Sie die fertige Abfrage oben.

Die Beträge sind tausendfach zu hoch oder werden als Text angezeigt.
Die Zahlenspalten wurden ohne Gebietsschema umgewandelt. Wandeln Sie sie wie in Schritt 5 mit „Englisch (USA)“ um.

Die Summe weicht von meiner Auswertung in CATAMA ab.
Vergleichen Sie mit der Umsatzauswertung, gleichem Zeitraum und gleicher Filiale, Status „fakturiert, bezahlt, überfällig“ und eingeschlossenen Gutschriften. Das Dashboard und der DATEV-Export rechnen teils mit anderen Abgrenzungen.