Vol. 1 · Issue 01
Velo/Stack
April 2026 · Innsbruck

VeloConnect-Protokoll

VeloConnect ist ein XML-over-HTTP-Protokoll für den Datenaustausch zwischen Fahrrad-Lieferanten und Warenwirtschaftssystemen.

Transport

XML-POST (bevorzugt), URL/GET (Fallback). Kein reines SOAP/WSDL. Basis: OASIS UBL 1.0 (Universal Business Language).

Authentifizierung

Jeder Request enthält: BuyersID, Credential, SellersID, TransactionID, IsTest. Status-Codes: 200 (Erfolg), 411 (Auth fehlgeschlagen), 415 (unbekannte SellersID).

Operationen

Operation Beschreibung Seit
TextSearch Artikelsuche nach Stichwort VC 1.1
GetItemDetails Einzelnen Artikel abfragen VC 1.1
GetItemDetailsList Mehrere Artikel abfragen (Batch) VC 1.1
GetClassificationScheme Warengruppen/BIDEX-Struktur VC 1.1
CreateOrder Bestellung auslösen VC 1.1
GetProfile Profil des Gegenübers abfragen VC 1.1
Offer Angebot/Bestätigung VC 1.3
DeliveryNote Lieferschein VC 1.3
InvoiceInformation Rechnungsinformation VC 1.3

ERP-Proprietäre Requests

GetVariantList, GetVariantAttributes, GetItemAttribute – TriData-spezifische Erweiterungen für Varianten-Abfrage und GrFa-Nachladen.

BIDEX BikeData V1.6

3-Stufen-Hierarchie: Catalog → Model → Variant. Eindeutigkeitsregel: Model + Size + Color + Variant. Enthält: Hersteller, Rahmen, Bremsen, Schaltung, Laufrad, Gewicht, Farbe, EAN.

Versions-Status

Version Anwendungsfall Status
1.0 Transaction (Rollback, GetStatus) 🟡 teilweise
1.1 Core TextSearch, GetItemDetails, Order ✅ aktiv
1.1 Profile GetProfile ✅ aktiv
1.3 Offer, DeliveryNote, Invoice ✅ aktiv
1.4 Stock B2B/B2C ❌ offen
1.5 BIDEX URL-Referenz auf BIDEX-XML ✅ aktiv
1.6 Sales Data (Händler→Hersteller) ❌ offen