Händler-Einbettung Kunden-Info (Deutsch)

haendler-einbettung-kunde.md

Händler-Einbettung (Dealer Embed) – Kunden-Info

Was ist das?

Mit der neuen Händler-Einbettung können Sie den Türkonfigurator als iframe in Ihre Website einbetten – und dabei erkennen, welcher Händler den Konfigurator nutzt.

Vorteile für Sie und Ihre Händler:

1. Händler-Erkennung – Sie sehen, welcher Händler eine Konfiguration erstellt hat
2. Händler-Rabatte – Automatische Anwendung der richtigen Rabatte pro Händler
3. Individuelle Absender-Adresse – E-Mails können im Namen des Händlers versendet werden
4. Individuelle E-Mail-Vorlagen – Jeder Händler kann seine eigene Bestätigungs-E-Mail haben
5. CORS-Sicherheit – Nur erlaubte Websites können den Konfigurator einbetten

---

Was müssen Sie tun?

1. iframe einbetten

Fügen Sie diesen Code auf Ihrer Website ein:

<iframe 
  src="https://ihre-tuerkonfigurator-url.de?embed=true&dealer_id=IHRE_HÄNDLER_ID" 
  width="100%" 
  height="800" 
  frameborder="0">
</iframe>

Ersetzen Sie IHRE_HÄNDLER_ID mit der Händler-ID (z.B. 123).

2. Datenbank-Migration (einmalig)

Führen Sie dieses SQL auf Ihrer discounts.db aus, um die neuen Tabellen anzulegen:

-- Händler-Tabelle anlegen
CREATE TABLE IF NOT EXISTS dealer (
    dealer_id TEXT PRIMARY KEY,
    name TEXT NOT NULL,
    email_recipient TEXT NULL,
    email_from_name TEXT NULL,
    confirmation_template_path TEXT NULL
);

-- Händler-Websites (CORS) anlegen
CREATE TABLE IF NOT EXISTS dealer_origin (
    origin_id INTEGER PRIMARY KEY AUTOINCREMENT,
    dealer_id TEXT NOT NULL,
    origin TEXT NOT NULL,
    FOREIGN KEY (dealer_id) REFERENCES dealer(dealer_id)
);

-- Beispiel-Händler anlegen
INSERT INTO dealer (dealer_id, name, email_recipient, email_from_name) 
VALUES ('123', 'Mein Händler', 'haendler@example.com', 'Mein Händler Türkonfigurator');

-- Website des Händlers erlauben
INSERT INTO dealer_origin (dealer_id, origin) VALUES ('123', 'https://meine-website.de');

3. Händler hinzufügen

Für jeden neuen Händler fügen Sie einen Eintrag in die dealer und dealer_origin Tabelle ein:

INSERT INTO dealer (dealer_id, name, email_recipient, email_from_name) 
VALUES ('456', 'Neuer Händler', 'neuer@haendler.de', 'Neuer Händler');

INSERT INTO dealer_origin (dealer_id, origin) VALUES ('456', 'https://neuer-haendler.de');

---

Technische Details (für Entwickler)

• Händler-ID wird per Query-Parameter übergeben (?dealer_id=123)
• Backend erwartet X-Dealer-Id Header bei API-Aufrufen
• B2C Frontend liest dealer_id aus der URL und sendet ihn automatisch mit
• Die dealer_discounts Tabelle bleibt unverändert – Rabatte werden wie bisher über serial_no zugeordnet

---

Kontakt

Bei Fragen zur Integration wenden Sie sich an Ihren technischen Ansprechpartner.