Partner-API · RobotSpec v0.2

Ihre Modelle und Preise, maschinenlesbar

Statt PDF-Preislisten und Vertriebsgesprächen: Liefern Sie Ihre aktuellen Modelle, Raten und Verfügbarkeiten direkt aus Ihrem System — im offenen RobotSpec-Format. Einmal angebunden, sind Katalog, Preisradar und Bedarfsanalyse immer aktuell.

Endpunkte

POST /api/v1/robotspec/listings — Listing(s) einreichen (einzeln oder Array, max. 50)

GET /api/v1/robotspec/schema — das JSON Schema (Draft 2020-12)

Auth: Header X-Api-Key — Ihren Partner-Key erhalten Sie beim Onboarding über das Kontaktformular. Antworten: 202 (in Kuratierung), 422 (Validierungsfehler mit Feldpfaden), 401 (Key ungültig). Verfügbarkeitsangaben brauchen seit v0.2 einen status und den Zeitstempel asOf.

Was RobotSpec anders macht

Preise netto in Cent + expliziter USt.-Satz

priceCents: 119000 = 1.190,00 € netto, vatRate: 19. Keine Rundungsfehler, kein Brutto-Netto-Raten.

Serviceumfang ist Pflicht

Jedes Angebot braucht serviceScope.level (Full/Partial/None) — „Leasing ab X €" ohne Service-Abgrenzung ist kein gültiges RobotSpec-Angebot. Genau diese Lücke macht Marktpreise heute unvergleichbar.

Ehrliche Leistungsdaten

Theoretische und praktische Flächenleistung sind getrennte Felder — theoretische Werte erscheinen bei uns nie als praktische.

Compliance eingebaut

CE-Kennzeichnung, Rechtsgrundlage (MRL/MVO), Normen wie EN IEC 63327 und ein DSGVO-Sensorik-Profil gehören zum Listing — die Basis unserer Kuratierung.

Kuratierung statt Auto-Publish

Gültige Einreichungen (HTTP 202) durchlaufen Compliance- und Preisplausibilitäts-Prüfung, bevor sie im Katalog und Preisradar erscheinen.

Beispiel

curl -X POST https://lotmark.onlypxl.com/api/v1/robotspec/listings \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <ihr-partner-key>" \
  -d '{
    "schemaVersion": "0.2",
    "listingId": "ihr-system-id-4711",
    "robotClass": "ScrubberDryer",
    "make": "Gausium",
    "model": "Scrubber 50 Pro",
    "condition": "New",
    "compliance": { "ceMarking": true },
    "offers": [{
      "offerType": "RaaS",
      "priceCents": 119000,
      "currency": "EUR",
      "vatRate": 19,
      "billingPeriod": "Month",
      "minTermMonths": 24,
      "serviceScope": { "level": "Full", "maintenance": true,
        "repairs": true, "replacementDevice": true },
      "availability": { "status": "LeadTime", "leadTimeDays": 14,
        "asOf": "2026-08-11T12:00:00Z" }
    }],
    "supplier": { "name": "Ihre Firma GmbH", "countryCode": "DE" }
  }'

Auch reine Produkt-Datenblätter (ohne offers) sind gültig — so liefern Hersteller Spezifikationen, während Händler die Angebote beisteuern. Vollständige Beispiele und das kanonische Schema: github.com/cnolti/robotspec.

Partner-Key anfragen

Kurz Portfolio und Servicegebiet nennen — wir melden uns mit Key und Onboarding. Das Listing ist in der Startphase kostenlos.

Als Anbieter starten