Version 0.1. Version 0.1 ist erschienen. Spezifikation und Software sind frei nutzbar.

Für Händler

Bilder und Artikeldaten jeder Marke, auf eine einheitliche Weise

Marken, die Open Brand Exchange nutzen, liefern ihre Bilder und Artikeldaten auf eine einheitliche Weise, egal ob Sie von Hand herunterladen oder Software nutzen.

Zum Markenverzeichnis Ein API-Schlüssel für Ihre Software
Ein Artikel im Markenportal: Bilder pro Farbe, die Wahl zwischen Original, Web und quadratisch sowie die EAN jeder Größe.

Händlerportal

Was Ihnen ein Markenportal bietet

Jede Marke betreibt ihr eigenes Portal mit ihrem eigenen Namen, zum Beispiel „Kestrel · Händlerportal“.

  • Zugang beantragen

    Beantragen Sie Zugang im Portal der Marke. Die Marke genehmigt, und Sie erhalten eine Einladung per E-Mail.

  • Suchen und filtern

    Nach Marke, Saison, Kollektion, Produkttyp oder Farbe. Jeder Artikel mit allen Bildern und Daten.

  • EAN-Liste einfügen

    Fügen Sie die EANs aus Ihrem Kassensystem ein und sehen Sie sofort, welche Artikel da sind und welche noch fehlen.

  • Herunterladen, wie Sie wollen

    Ein Foto, einen Artikel, Ihre Auswahl oder alles in einem Filter als ZIP. Original (wenn die Marke es erlaubt), Web oder quadratisch.

  • Artikeldaten als Tabelle

    EAN pro Größe, Farbe, Material, Pflegehinweise und Beschreibung, bereit für Ihr eigenes System.

  • Was erlaubt ist

    Nutzungsrechte, Sperrfrist und ob ein Bild mit KI erstellt wurde, stehen bei jedem Bild.

Ein Händler fügt sechs EANs in das Markenportal ein: Fünf werden gefunden, eine fehlt im Katalog.

Artikeldaten

Die Angaben vom Pflegeetikett gehören zu jedem Artikel.

Die Zusammensetzung pro Teil, die Pflegehinweise in der Reihenfolge des Etiketts und das Herkunftsland gehören zu jedem Artikel, neben der EAN jeder Größe. Ihr Shop zeigt sie als Text oder als Pflegesymbole im eigenen Stil. Die Felder folgen den EU-Regeln zur Textilkennzeichnung und den Pflegecodes nach ISO 3758, sodass sie später auch einen digitalen Produktpass füllen können.

  • Zusammensetzung pro Teil (Oberstoff, Futter, Füllung, Sohle) mit Prozentangaben
  • Pflegehinweise als Standardcodes, in der Reihenfolge des Etiketts
  • Herkunftsland und die EAN jeder Größe und Farbe
Beispiel der Testmarke

Kestrel Trail · Trail-Laufshorts KT-2001 · Schwarz

Zusammensetzung
Oberstoff: 100% recyceltes PolyesterFutter: 88% Polyamid, 12% Elasthan
Pflege
  1. Maschinenwäsche 30 °C wash_30
  2. Nicht bleichen do_not_bleach
  3. Nicht im Trockner trocknen do_not_tumble_dry
  4. Nicht bügeln do_not_iron
  5. Nicht chemisch reinigen do_not_dry_clean
Hergestellt in
Vietnam
Größen und EAN
Größe S: 02000200101017Größe M: 02000200101024Größe L: 02000200101031
Derselbe Artikel in der API
{
  "style_number": "KT-2001",
  "materials": [
    { "part": "outer", "fibers": [{ "fiber": "recycled_polyester", "percentage": 100 }] },
    { "part": "lining", "fibers": [{ "fiber": "polyamide", "percentage": 88 }, { "fiber": "elastane", "percentage": 12 }] }
  ],
  "care": [
    { "code": "wash_30", "text": null },
    { "code": "do_not_bleach", "text": null },
    { "code": "do_not_tumble_dry", "text": null },
    { "code": "do_not_iron", "text": null },
    { "code": "do_not_dry_clean", "text": null }
  ],
  "country_of_origin": "VN",
  "variants": [
    { "size": "S", "gtin": "02000200101017", "color": { "code": "BLK" } },
    { "size": "M", "gtin": "02000200101024", "color": { "code": "BLK" } },
    { "size": "L", "gtin": "02000200101031", "color": { "code": "BLK" } }
  ]
}

Für Ihre Software

Ein API-Schlüssel für Ihre Software

Holt Ihr PIM, Kassensystem oder Ihre Shopsoftware Bilder selbst ab? Dann beantragen Sie einen API-Schlüssel für Ihre Software. Sie holt zuerst alles und danach nur noch die Änderungen, auch das, was die Marke zurückzieht. Bilder werden per EAN Ihren Artikeln zugeordnet.

Für Ihren Entwickler: So sieht es aus.

HOST=https://brands.kestrel.example
curl -s $HOST/.well-known/obx                       # what does this brand offer?
TOKEN=$(curl -s -u "$CLIENT_ID:$CLIENT_SECRET" -d grant_type=client_credentials \
  $HOST/obx/v1/oauth/token | jq -r .access_token)
curl -s -H "Authorization: Bearer $TOKEN" "$HOST/obx/v1/changes?limit=500"   # everything, then only changes
curl -s -H "Authorization: Bearer $TOKEN" -X POST -H 'Content-Type: application/json' \
  -d '{"gtins":["2000100101025"]}' "$HOST/obx/v1/products:by-gtin"
# or let the obx tool keep a copy in a folder, only fetching what changed:
OBX_CLIENT_ID=$CLIENT_ID OBX_CLIENT_SECRET=$CLIENT_SECRET obx pull $HOST --out ./kestrel

  • Welche Software damit funktioniert

    Open Brand Exchange ist ein offener Standard: Jede Software kann ihn unterstützen. Photopilot baut ihn in seine Software für Händler ein, und andere Anbieter können das ebenso tun. Sie brauchen keine bestimmte Software: Ein Browser genügt. Spezifikation für Entwickler.

  • Eine Marke finden

    Marken, die gelistet werden möchten, stehen im Markenverzeichnis. Wenn Ihnen eine Marke einfach die Adresse ihres Portals gibt, funktioniert das auch. Zum Markenverzeichnis.

Ihre Marke ist noch nicht dabei? Schicken Sie ihr das

Am schnellsten kommt eine Marke an Bord, wenn Geschäfte danach fragen. Kopieren Sie diese E-Mail, füllen Sie die Klammern aus und senden Sie sie an Ihren Ansprechpartner oder Vertreter bei der Marke.

Weiteres Material, etwa die Broschüre für Händler, finden Sie bei den Downloads. Downloads.