Für Händler & Garagen
Feed-Anbindung für Händler & Garagen
Wir nehmen Fahrzeug-Exporte in gängigen Formaten entgegen – JSON-Vollabzug, mobile.de-kompatibles CSV und HTTPS-Push. Die Anbindung läuft über deinen Export bzw. dein Softwarehaus: kostet nichts, kündigt nichts, ersetzt nichts.
Unser Gratis-Versprechen
«Die Feed-Anbindung ist gratis. Wir verrechnen Händlern und Garagen nie eine Schnittstellen- oder Publikationsgebühr.» Bezahlt werden – wenn überhaupt – nur Zusatz-Werkzeuge, nie die Anbindung oder die Publikation selbst.
Einrichtung in der Regel an einem Arbeitstag.
Unterstützte Formate
Fahrzeug-JSON (Vollabzug)
Kanonisches Vehicle JSON v1.1 mit vollständigem Bestand; Bilder als lokale Dateinamen oder geprüfte öffentliche HTTPS-URLs.
Händlerfahrzeuge werden nur mit eindeutigem CHF-Brutto-Endpreis automatisch veröffentlicht.
Anlieferung: SFTP oder HTTPS Push · data/*.json
mobile.de-kompatibles CSV
DACH-kompatibler Kernadapter für positionsfestes mobile.de-CSV; kein vollständiger Extended-CSV-Vertrag. Bilder nur über dokumentierte lokale Bild-IDs.
EUR oder ein nicht eindeutig bestätigter Brutto-Endpreis bleibt als Entwurf offline und wird im Laufbericht erklärt.
Anlieferung: SFTP oder HTTPS Push · data/*.csv
REST Push (HTTPS)
Für Softwarehäuser, die Fahrzeuge direkt übermitteln wollen.
POST /api/feeds/{ulid}/push
Authorization: Bearer … · Content-Type application/json / text/csv · max. 50 MB
Antwort 202: {accepted, status, run_id, file}; Token im Feed-Cockpit rotierbar.
Push-Fehlercodes
| Code | Bedeutung |
|---|---|
| 401 | Bearer-Token fehlt oder ungültig / unbekannter Feed-Zugang. |
| 403 | Feed-Zugang ist nicht aktiv (z. B. pending oder gesperrt). |
| 409 | Für diesen Feed läuft bereits eine Verarbeitung; die Datei wurde sicher quarantänisiert. |
| 413 | Datei zu gross (über dem konfigurierten MB-Limit). |
| 422 | Leerer Inhalt, ZIP oder kein JSON/CSV. |
| 429 | Rate-Limit erreicht (Schutz vor Missbrauch sowie Zugangslimit). |
Status-Mapping
| Feed state | Inserat-Status |
|---|---|
| active | published (wenn Qualitäts-Guards ok), sonst draft |
| reserved | reserved nur aus einem bereits veröffentlichten Inserat; ein neuer Entwurf bleibt offline |
| sold | sold nur aus einem bereits öffentlichen Inserat; ein neuer Entwurf bleibt offline |
| inactive | expired (offline, nie gelöscht) |
Preis, MwSt. & Reservierung
- Endpreis (PBV): Für die Veröffentlichung als Händler brauchen wir einen eindeutigen CHF-Brutto-Endpreis. EUR oder ein nicht eindeutig als Brutto belegter Preis bleibt als Entwurf sichtbar und wird im Cockpit rapportiert.
- MwSt. (mobile.de-CSV): Nach offizieller Regel ist «mwst=0» zusammen mit gesetztem «mwstsatz» ein Nettopreis – jede andere Kombination gilt als Brutto. Nur der eindeutige Brutto-Fall wird als Endpreis veröffentlicht.
- Reserviert (mobile.de-CSV, Feld 94/CQ): Wert «1» setzt ein bereits veröffentlichtes Inserat auf «reserviert». Neue oder unvollständige Fahrzeuge bleiben Entwurf. Wir schliessen dabei nie automatisch offene Anfragen.
- Modell & Variante: Ein kombiniertes Modellfeld («Golf 1.5 TSI Life») trennen wir konservativ in Modell und Variante.
Gängige Exportformate (u. a. mobile.de-CSV) nehmen wir entgegen – unabhängig davon, aus welchem System sie kommen. Beim Mapping helfen wir; eine offizielle Listung in den Hubs ist in Abstimmung:
So funktioniert es
-
1
Kostenloses Professional-Konto erstellen und im Profil unter «Feed-Anbindung» den Zugang beantragen (DMS/Software, Format, technischer Kontakt).
-
2
Wir schalten den Zugang frei – der technische Kontakt erhält die Verzeichnis-Angaben, Push-URL und separat die SFTP-Zugangsdaten.
-
3
Angaben ans DMS- bzw. Softwarehaus weitergeben oder den Export selbst einrichten. Sync-Status und Fehler siehst du im Cockpit unter Feed & Sync.
Technische Eckdaten
- Transport
- SFTP (abgeschottetes Verzeichnis) und HTTPS Push mit Bearer-Token.
- Verzeichnis-Layout
data/*.{json,csv}und lokale Bilder unter images/. Verarbeitete, abgewiesene und ersetzte Rohdateien werden nach 14 Tagen automatisch gelöscht.- Rhythmus
- Import alle 10 Minuten; Push stösst einen Sofort-Sync an. Fehlende Fahrzeuge nach Karenz von zwei Läufen offline — nie gelöscht.
- Grenzen
- Maximal 50 MB pro Datei, 5’000 Fahrzeuge, 20 Bilder und 20 Ausstattungsmerkmale pro Fahrzeug; maximal 15 MB pro Bild.
- Rückmeldung
- Import-Protokoll mit Zählern und Fehlerliste im Feed-&-Sync-Cockpit; bei Komplettausfall informieren wir den technischen Kontakt per E-Mail.
- Qualität & Schutz
- Jedes Fahrzeug durchläuft dieselben Qualitäts- und Sicherheitsprüfungen wie manuell erfasste Inserate (Text- und Bild-Prüfung, Moderation). Ein Fahrzeug geht erst online, wenn der Bild-Scan abgeschlossen ist.
- Authentifizierung & Limits
- Push per Bearer-Token (SHA-256 gespeichert, im Cockpit rotierbar). Rate-Limit pro Zugang, JSON-Grössenbudget und ein Speicherbudget je Zugang schützen vor Überlast.
- Test ohne Risiko (Dry-Run)
- Im Cockpit lässt sich eine kleine Datei als Dry-Run prüfen – ohne Inserate oder Läufe zu schreiben. So siehst du Mapping und Fehler vor der produktiven Anlieferung.
Fragen zur Anbindung?
Am einfachsten über die Feed-Anbindung im Profil – wir antworten werktags innert 24 Stunden.