Möchten Sie, dass wir Ihre Daten von Amazon automatisch importieren? Hier können Sie die
Zeitintervalle einstellen. Die Rechnungen werden dann automatisch für Sie erstellt.
Berichtstypen
Bitte definieren Sie, welche Berichte wir für Sie abfragen sollen. Bitte wählen Sie nur solche
Reports aus, die auch in Ihrem Amazon-Account verfügbar sind, weil es ansonsten zu unnötigen
Verzögerungen bei der Bearbeitung Ihrer Berichte kommen kann.
Beachten Sie, dass wir von Amazon die Bestelldaten des Eigenversandes (MFN) direkt nach dem
Zahlungseingang abrufen können, während Bestellungen, die durch Amazon verschickt werden
(FBA) erst nach der Versandmarkierung der Bestellung abrufbar sind. Diese
Versandmarkierung können Sie bislang im Sellercentral nicht einsehen.
Ab sofort können Sie Dokumente zu Amazon hochladen, auch wenn Sie nicht den Amazon
Umsatzsteuer-Berechnungsservice nutzen.
Einstellungen zu Amazon Umsatzsteuer-Berechnungsservice (VCS)
Wenn Amazon Ihre Rechnungen erstellt, weil Sie den Amazon Umsatzsteuer-Berechnungsservice
(VCS) verwenden, geben Sie bitte das Datum an, ab dem easybill Connect nur noch Lieferscheine
und Duplikate, jedoch keine Rechnungen mehr erstellen soll.
Dokument-Upload Einstellungen für den Amazon Umsatzsteuer-Berechnungsservice VCS
Hier können Sie das Datum festlegen, ab dem Amazon VCS (Umsatzsteuer-Berechnungsservice) mit
eigener Rechnungserstellung verwendet werden soll. Dieses Datum muss der Aktivierung in Ihren
Amazon Einstellungen entsprechen. Ab diesem Zeitpunkt werden über andere Amazon Berichte keine
Rechnungen mehr erstellt. Tagsüber werden mehrfach die Daten zu den Bestellungen abgerufen,
Rechnungen erstellt und anschließend zu Amazon übermittelt.
Eine Anleitung zur Anbindung Ihres Amazon-Kontos finden Sie in unserem
Hilfe-Center.
Sie bekommen bei Amazon jeweils eine Marktplatz-ID pro Plattform (amazon.de, amazon.fr, amazon.it, …) angezeigt.
Sofern Sie ein europäisches Verkäuferkonto besitzen, ist es ausreichend nur eine der europäischen
Marktplatz-IDs hier zu hinterlegen, da wir über diese auch die Bestellungen der anderen Plattformen erhalten.
Sie können hier den Import Ihrer Daten von Amazon aktivieren. Amazon stellt uns dafür eine Schnittstelle zur Verfügung, die die automatisierte Datenübermittlung ermöglicht.
Dazu gehört eine maximale Aufbewahrungsdauer der Daten und eine Pflicht, die Daten auf nicht autorisierte Änderungen hin zu überwachen. Wir kommen diesen Pflichten nach, weil andernfalls die Schnittstelle nicht zur Verfügung gestellt werden könnte.
Mit dem Verbinden über diese Schnittstelle erklären Sie sich damit einverstanden.
Sie können die Texte auf dem Rechnungsdokument frei einstellen.
Außerdem können Sie auswählen, welches Datenfeld als Artikelnummer angezeigt werden soll.
Praxisbeispiele und Code-Vorlagen – entdecken Sie konkrete Lösungen für Ihren Einsatz.
{% if customer.lang == 'de' %} Vielen Dank für Ihre Bestellung
Hier können Sie festlegen, ob die Amazon E-Mailadresse des Kunden an Ihren Versanddienstleister weitergegeben werden soll (sofern dies von Ihrem Versanddienstleister z.B. DHL unterstützt wird). Bitte beachten Sie, dass Sie die Daten nur nach Absprache mit Amazon übermitteln dürfen.
Hier können Sie festlegen, ob der automatische E-Mailversand für alle Bestellungen aktiviert sein soll, oder nur für FBA-Bestellungen, die von Amazon verschickt werden. In bestimmten Fällen kann es Sinn machen, dass Sie nur Rechnungen für FBA-Bestellungen per E-Mail verschicken, und solche Rechnungen, die Sie selbst verschicken, nicht vorab per E-Mail versenden.
Die Einstellungen für die Berechnung der Mehrwertsteuer bei Versand von Ausländischen Amazon-Lagern finden sie zukünftig unter "Einstellungen" → "Allgemeines" → "Steuerliches".
Wichtig: Die Filterprüfung kann während des Imports mehrfach aufgerufen werden. Das Filtern basierend auf Artikeleigenschaften (SKU, Artikelname, etc.) kann zu unerwarteten Ergebnissen führen, da die Bestellung schrittweise aufgebaut wird und sich der Zustand zwischen den Prüfungen ändern kann.
Im folgenden Beispiel wird die Bestellung übersprungen falls die Kundennotiz einen bestimmten Text enthält:
{% if customer_note contains "eBay User ID" %} skip {% endif %}
Der von Ihnen definierte Ausdruck ergibt bei Ihrer letzten Bestellung:
"false"
Würde der Import in diesem Fall übersprungen werden?
Hier legen Sie den MwSt.-Satz fest, der bei der Rechnungserstellung zugrunde gelegt werden
soll, wenn aus der Import-Quelle nichts anderes hervorgeht (z. B. bei Amazon).
Versandland (Standard)
Für die Berechnung der Mehrwertsteuer ist das Versandland sehr wichtig. Fehlt diese
Information zur Bestellung, verwenden wir das hier ausgewählte Land.
Nutzung von ausländischen Warenlagern (z. B. Amazon PAN-EU)
One-Stop-Shop
Legen Sie das Datum fest, an dem die Geringfügigkeitsschwelle für Fernverkäufe der EU
überschritten wurde. Ab diesem Datum wird stets die Mehrwertsteuer des Ziellands
ausgewiesen, welche über den One-Stop-Shop gemeldet werden kann.
Testaufgabe
Coaching-Testszenario
HerkunftAmazon Coaching
VersandtypAmazon FBA
VCS seit01.06.2026 versehentlich
PAN-EU / CEENein DE only
OSSNicht registriert kein OSS
SteuersatzNur 19 % kein 7 %
Importzeiten08:00 und 17:00 Uhr
Benjamin
Einrichtungsassistent
Benjamin nutzt KI und kann Fehler machen. Wichtige Angaben bitte prüfen.
?
?
Klicken Sie auf ein anderes Element für die nächste Erklärung – Esc beendet den Erklär-Modus.
Selektor-Inspektor
Echte DOM-Adressen aus connect-mapping.js. Badge anklicken = Selektor kopieren.
Adresse + Erklärtext Adresse, Text fehlt Selektor findet nichts ungeprüft (gegen echtes Connect) Navigations-Route
✏ Erklärtext-Modus – klick ein markiertes Feld zum Bearbeiten · Esc beendet
Erklärtext bearbeiten
—
Live-Vorschau (Erklär-Modus)
?Titel
—
So erscheint der Text live beim Klick auf das Feld.
★
easybill Connect · Amazon-Demo
Interaktiver Prototyp der Amazon-Einstellungen – zum Ausprobieren & für die Übergabe
Das hier ist eine originalgetreu nachgebaute easybill-Connect-Oberfläche für die Amazon-Anbindung – also der Bildschirm, auf dem man einstellt, wie easybill die Bestellungen und Rechnungen von Amazon verarbeitet. Sie dient zum Ausprobieren, Vorführen und Abstimmen, bevor das Ganze in die echte Software eingebaut wird.
✅ Hier kann nichts schiefgehen: Es besteht keine Verbindung zu Amazon oder zu echten Daten. Nichts wird gesendet, nichts gespeichert, nichts abgerechnet. Klick dich ruhig durch alles – ein einfaches Neuladen der Seite setzt wieder auf Anfang.
Was du ausprobieren kannst
🧭
Geführte Tour
Klick unten auf „Tour mit Benjamin" (oder das Rechnungsmonster als Begleiter). Du wirst dann Schritt für Schritt durch die wichtigsten Einstellungen geführt – mit Erklärung an jeder Station. Ideal für den ersten Überblick.
❓
Erklär-Modus
Einschalten und dann auf irgendein Feld, Häkchen oder Button klicken. Es erscheint ein kleines Sprechblasen-Fenster, das in einfachen Worten erklärt, wofür dieses Feld da ist. Mit Esc wieder aus.
💬
Chat-Butler „Benjamin"
Der blaue Knopf unten rechts öffnet einen Chat-Assistenten. Du kannst ihm Fragen in normalem Deutsch stellen („Was bedeutet FBA?") – er antwortet und kann Einstellungen erklären oder vorschlagen.
🖱️
Bereiche durchklicken
Links in der Navigation wechselst du zwischen den Themen: Automatischer Import, Rechnungstexte, Artikel, Versand, VCS & Upload und mehr. Stell ruhig alles um und schau, was passiert.
📝
Texte bearbeiten
Über die Leiste unten lässt sich der Modus „Texte bearbeiten" einschalten: Alle erklärbaren Felder der Seite werden markiert, ein Klick öffnet einen kleinen Editor für den Erklärtext – mit Sofort-Vorschau.
🔄
Jederzeit zurücksetzen
Verstellt? Kein Problem. Ein Druck auf Neu laden im Browser stellt den Ausgangszustand wieder her. Es gibt keinen „Falsch"-Knopf – alles ist zum Erkunden gedacht.
So legst du am besten los
Starte mit der Geführten Tour – sie gibt dir in 1–2 Minuten den roten Faden.
Schalte danach den Erklär-Modus ein und klick die Felder an, die dich interessieren.
Hast du eine konkrete Frage? Frag den Chat-Butler unten rechts.
Die Demo ist ein frameworkfreier Single-File-Mock (index.html, Vanilla JS/CSS) plus einige schlanke PHP-Endpunkte für Persistenz. Leitprinzip: jede fachliche Information existiert genau einmal und speist von dort mehrere Verbraucher – kein Selektor, kein Erklärtext wird doppelt gepflegt.
Kernarchitektur
🗺️ Single Source of Truth
connect-mapping.js hält pro Feld einen Eintrag: echte DOM-address, page, type, explainSel sowie title+text. Drei Verbraucher leiten sich daraus ab: Erklär-Modus (explainSel→Text), Butler (id+el zum Setzen) und Selektor-Inspektor (address).
📝 Texte als Daten (Modell C)
Erklärtexte sind aus dem Code gelöst und liegen in erklaer-texte.json. Pflege auf zwei Wegen: tabellarisch im Admin-Panel (Tab „Erklärtexte") und kontextuell im In-Place-Editor („Texte bearbeiten"). Format ist Markdown (**fett**, *kursiv*, `code`), gerendert über einen injektionssicheren Mini-Parser.
🔀 Override-Kaskade
Beim Anzeigen gewinnt der jeweils speziellere Wert: connect-mapping.js (Fallback) ‹ erklaer-texte.json (Server) ‹ LocalStorage-Entwurf (Live-Vorschau). So sieht man Änderungen sofort, auch ohne Server – verbunden bleibt alles über den stabilen Key (= Mapping-id).
🔍 Selektor-Inspektor
Legt die echten DOM-Adressen als Badges über die Felder. Farbe = Abdeckungsstatus: 🟢 Text vorhanden · 🟡 Text fehlt · 🔴 Selektor findet nichts · 🟣 noch nicht gegen echtes Connect-HTML verifiziert. Stand: 37/39 Selektoren verifiziert.
🤖 Chat-Butler
Anthropic Claude (Haiku) über butler_anthropic.php, SSE-Streaming. Wissensbasis wissen.json, gepflegt im Admin-Panel (kb_admin.php). Drei Modi: Erklären (nur Auskunft), Ausführen (setzt Felder mit Bestätigung), Einrichten (geführter Ablauf).
🔐 Persistenz & Auth
PHP-Endpunkte schreiben atomar (temp-Datei + rename) und legen .bak-Backups an. Speichern ist passwortgeschützt – serverseitig gegen ai_config.php geprüft, das Passwort verlässt nie den Server. Ohne PHP (z. B. file://) greift automatisch der LocalStorage-Fallback.
Dateien auf einen Blick
index.htmlMock-Oberfläche + gesamte Client-Logik
connect-mapping.jszentrale Feld-Registry (Single Source of Truth)
Hauptaufwand: die address-Selektoren an die echten Connect-IDs hängen (Rails/React). Texte und Struktur sind getrennt, der Key bleibt stabil – ein späterer Wechsel der Pflege-Methode (Code → JSON → DB) ist dadurch günstig.
📦 Phasen
Phase 1 (integrierbar): Erklär-Modus, Tour, Selektor-Inspektor, Erklärtext-Pflege. Phase 2 (zurückgestellt): Chat-Butler – offen sind DSGVO-Klärung, serverseitige Action-Whitelist und Rate-Limiting.
Noch tiefer: Button „Für Entwickler" (Integrations-Übersicht mit Repo-Baum & nötigen API-Hooks) und „Selektoren" (Live-Abdeckung direkt auf der Seite).
Gespeichert
Technische Architektur
easybill Connect Demo
Diese Demo ist eine vollständig eigenständige Single-Page-Anwendung, die ohne externe Abhängigkeiten oder Frameworks auskommt. Alle Funktionen sind in einer einzigen HTML-Datei implementiert.
🏗️ Aufbau & Technologie
Frontend: Reines HTML5, CSS3 und Vanilla JavaScript – kein React, Vue oder ähnliches. Die gesamte Logik läuft clientseitig im Browser.
HTML: Semantische Struktur mit klar definierten Bereichen (Sidebar, Main, Overlays)
CSS: Modernes Design mit CSS Custom Properties (CSS Variables), Flexbox und Transitions
JavaScript: Event-gesteuerte Architektur ohne externe Bibliotheken
Kernkomponenten
Die Anwendung besteht aus mehreren unabhängigen Modulen:
Login-System: Demo-Authentifizierung mit SessionStorage (Passwort: easybill2026)
Ja, ich weiß – Passwort im Klartext im Code 😬 Aber hey, ist ja nur 'ne Demo! In der echten easybill Connect Anwendung gibt's natürlich OAuth 2.0 mit PKCE, bcrypt-gehashte Passwörter (min. 12 Zeichen, Sonderzeichen, Zahlen), Multi-Faktor-Authentifizierung, Rate-Limiting, Session-Tokens mit HTTP-only Cookies, CSRF-Protection und regelmäßige Security-Audits. Also alles nach BSI-Standard. Versprochen! 🔐
Seitennavigation: Dynamisches Umschalten zwischen verschiedenen Einstellungsseiten
Geführte Tour: Animierter Walkthrough mit Spotlight-Effekt und Step-by-Step-Erklärungen
Chat-Butler: KI-ähnlicher Assistent mit vordefiniertem Szenario, der Einstellungen automatisch vornimmt
Erklär-Modus: Interaktives Hilfe-System mit Kontext-Popups für jedes UI-Element
Erklärtext-Editor: Redaktioneller Editor (Admin → Tab „Erklärtexte") mit Markdown-Formatierung und Live-Vorschau; Persistierung über PHP-Backend oder LocalStorage als Fallback
Datenpersistenz
Hybrid-Ansatz: Server-first mit LocalStorage-Fallback für maximale Flexibilität
Die Erklärtexte werden zunächst über texte_admin.php auf dem Server gespeichert (erklaer-texte.json). Schlägt dies fehl (z. B. bei lokaler Nutzung via file://), wechselt der Editor automatisch zu LocalStorage – die Vorschau funktioniert dann trotzdem.
Design-Prinzipien
Progressive Enhancement: Kernfunktionalität ohne JavaScript, erweiterte Features mit JS
Responsive Design: Optimiert für Desktop, mit mobilen Breakpoints
Accessibility: ARIA-Labels, Tastaturnavigation und semantisches HTML
Performance: Keine externen Requests außer Google Fonts – alles inline
Backend (Optional)
texte_admin.php ist ein minimalistisches PHP-Script, das:
GET-Requests beantwortet mit allen Erklärtexten aus erklaer-texte.json
POST-Requests (passwortgeschützt) verarbeitet und die Texte gebündelt speichert
vor dem Schreiben ein Backup (.bak) anlegt und atomar via temp-Datei schreibt
Deployment
Die Demo kann auf drei Arten bereitgestellt werden:
Vollversion (empfohlen): HTML + PHP auf einem Webserver mit PHP-Unterstützung
Statisch: Nur HTML auf CDN/Static-Hosting – Erklärtext-Editor nutzt LocalStorage
Lokal: Direkt als Datei öffnen – alle Features außer serverseitigem Speichern verfügbar
Besonderheiten
Zero Dependencies: Kein npm, keine Build-Tools, kein Bundler
Self-Contained: Eine Datei, kopieren & fertig
Graceful Degradation: Funktioniert auch ohne Server
Developer-Friendly: Klarer, kommentierter Code ohne Minification
onNavigate(page) — Seite wechseln; page = String aus tour-schritte.json, z. B. "auto-import", "vcs-upload"
onAction(aktion) — optional; Demo-Aktionen wie "import_aktivieren" oder "vcs_modus_setzen:vcs-connect" ausführen oder ignorieren
CSS-Variable--blue muss im Host definiert sein (Primärfarbe)
Selektoren in tour-schritte.json und erklaer-texte.json auf echte Connect-IDs anpassen — das ist der Hauptaufwand
Alle Erklär- und Zuordnungsdaten liegen an einer Stelle: connect-mapping.js (Single Source of Truth). Pro Feld ein Eintrag mit echter DOM-Adresse (address), Seite, Typ sowie title + text. Daraus speisen sich Erklär-Modus, Butler und der Selektor-Inspektor – kein Selektor wird doppelt gepflegt.
Wie die Texte künftig redaktionell gepflegt werden, ist eine bewusste Entwickler-Entscheidung. Drei Modelle, alle mit demselben Schlüssel (der name-/href-Adresse) als Verbindung – ein späterer Wechsel ist daher günstig:
Modell
Wo / wie gepflegt
Wer pflegt
Integrationsaufwand
A · Registry im Code
title/text direkt im Eintrag in connect-mapping.js bzw. erklaer-texte.json
Entwickler
am geringsten (Ist-Zustand)
B · Separate JSON
Texte ausgelagert in erklaer-texte.json; Struktur (Selektor/Seite/Typ) bleibt im Code, das Mapping lädt die Texte per Key
jede:r mit JSON-Zugriff, ohne JS-Kenntnisse
gering–mittel
C · Admin-Panel
Editor-Seite analog Chatbutler-KB (kb_admin.php + wissen.json): Titel/Text je Feld bearbeiten, gespeichert als JSON/DB
Fachredaktion, ganz ohne Code
höher (UI + Speicher-Endpoint)
Empfehlung zur Konsistenz: Da für den Chatbutler bereits ein Admin-Panel mit JSON-Wissensbasis existiert, liegt Modell C nahe – muss aber nicht. Wichtig nur: die Texte bleiben Daten (keine fest in Templates eingebauten Strings) und werden über die stabile name-/href-Adresse zugeordnet. Den Selektor-Inspektor (Button „Selektoren") als laufende Abdeckungs-Kontrolle nutzen: 🟢 Adresse + Text · 🟡 Text fehlt · 🔴 Selektor findet nichts.
Der Butler (Anthropic Claude Haiku, SSE-Streaming) kann Fragen beantworten und im Ausführ-Modus Einstellungen setzen. Voraussetzungen vor Integration: KI-Modellwahl, DSGVO-Klärung, serverseitiger Action-Whitelist, Rate Limiting. Details: butler/README.md
📄integration-uebersicht.md← Reihenfolge, FAQ, Abhängigkeiten für Ruby-Devs
Benjamin
Schritt 1 von 12
Willkommen!
Ich zeige dir die wichtigsten Einstellungen.
Hallo!
BenjaminDein Einrichtungs-Guide
Geschafft!
BenjaminDein Einrichtungs-Guide
Wissensdatenbank pflegen
Grundlage für den KI-Butler (Claude)
Admin-Login
Bitte Passwort eingeben, um die Wissensdatenbank zu bearbeiten.
Wissens-Einträge
Diese Fragen stellt der Butler bei der geführten Einrichtung. Sie dienen als Grundlage für die KI-Antworten.
🌳 Neu – Ablauf-Editor: Den geführten Einrichtungs-Ablauf als verzweigten Baum (mit Bedingungen & Drag&Drop, inkl. Amazon-Verbindungs-Check) bearbeitest du im separaten Editor.Ablauf-Editor öffnen ↗
Fragen & Einrichtungs-Logik
Die Texte des Erklär-Modus – gepflegt als Daten in erklaer-texte.json (Modell C). Jeder Eintrag hängt über seine stabile DOM-Adresse am echten Feld. Formatierung mit **fett**, *kursiv* und `code` (Markdown). Rechts die Live-Vorschau im echten Popup-Look.
Live-Vorschau (Erklär-Modus)
?Titel
Wähle links einen Eintrag und tippe – hier siehst du, wie das Popup im Erklär-Modus aussieht.
So erscheint der Text live beim Klick auf das Element.
Legt fest, wie Benjamin im Chat antwortet. Die Auswahl gilt für alle User – erst nach »Speichern« wirksam.
Lege fest, welche KI-Modelle Benjamin nutzen darf und ob Endnutzer im Chat selbst wählen können. Änderungen werden erst nach »Speichern« wirksam.
Auswählbare Modelle
Pro Zeile ein Modell. Standard markiert das Modell, das Benjamin verwendet, solange der Nutzer nichts anderes wählt. Bei Replicate ist die Modell-ID Pflicht (z. B. meta/llama-4-maverick-instruct).
Der Replicate-Token wird serverseitig in ai_config.php gepflegt (nicht hier).
Feedback, das Kollegen direkt im Chat hinterlassen haben – zum Gesamtchat oder zu einzelnen Antworten. Mit Kopieren bekommst du Kommentar + Chatverlauf als Text, den du direkt weitergeben kannst.
