Versie 0.1. Versie 0.1 is uit. De specificatie en de software zijn vrij te gebruiken.

Voor retailers

De beelden en artikeldata van elk merk, op één vaste manier

Merken die Open Brand Exchange gebruiken, leveren hun beelden en artikeldata op één vaste manier, of je nu met de hand downloadt of software gebruikt.

Naar de merkenlijst Een API-sleutel voor je software
Een artikel in de beeldbank: beelden per kleur, de keuze tussen origineel, web en vierkant, en de EAN van elke maat.

Beeldbank

Wat een merkportaal je geeft

Elk merk draait een eigen portaal, met zijn eigen naam erop: bijvoorbeeld "Kestrel · Beeldbank".

  • Toegang aanvragen

    Vraag toegang aan op het portaal van het merk. Het merk keurt goed en je krijgt een uitnodiging per e-mail.

  • Zoeken en filteren

    Op merk, seizoen, collectie, producttype of kleur. Elk artikel met al zijn beelden en data.

  • Je EAN-lijst plakken

    Plak de EAN's uit je kassasysteem en zie meteen welke artikelen er zijn en welke nog ontbreken.

  • Downloaden zoals jij wilt

    Eén foto, één artikel, je selectie of alles binnen een filter als zip. Origineel (als het merk dat toestaat), web of vierkant.

  • Artikeldata als spreadsheet

    EAN per maat, kleur, materiaal, wasvoorschrift en omschrijving, klaar voor je eigen systeem.

  • Wat mag

    Gebruiksrechten, embargodatum en of een beeld met AI is gemaakt, staan bij elk beeld.

Een retailer plakt zes EAN's in de beeldbank: vijf worden gevonden, één staat niet in de catalogus.

Artikeldata

Wat op het waslabel staat, gaat mee met elk artikel.

Samenstelling per onderdeel, wasvoorschriften in de volgorde van het label en het land van herkomst horen bij elk artikel, naast de EAN van elke maat. Je webshop toont ze als tekst of als wassymbolen in je eigen stijl. De velden volgen de Europese regels voor textieletikettering en de ISO 3758-wascodes, zodat ze later ook een digitaal productpaspoort kunnen vullen.

  • Samenstelling per onderdeel (buitenstof, voering, vulling, zool) met percentages
  • Wasvoorschriften als standaardcodes, in de volgorde van het label
  • Land van herkomst en de EAN van elke maat en kleur
Voorbeeld uit het testmerk

Kestrel Trail · Trailrunning short KT-2001 · Zwart

Samenstelling
Buitenstof: 100% gerecycled polyesterVoering: 88% polyamide, 12% elastaan
Wasvoorschrift
  1. Machinewas op 30 °C wash_30
  2. Niet bleken do_not_bleach
  3. Niet in de droogtrommel do_not_tumble_dry
  4. Niet strijken do_not_iron
  5. Niet chemisch reinigen do_not_dry_clean
Gemaakt in
Vietnam
Maten en EAN
Maat S: 02000200101017Maat M: 02000200101024Maat L: 02000200101031
Hetzelfde artikel in de 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" } }
  ]
}

Voor je software

Een API-sleutel voor je software

Haalt je PIM, kassasysteem of webshopsoftware zelf beelden op? Vraag dan een API-sleutel voor je software aan. Die haalt eerst alles op en daarna alleen nog de wijzigingen, ook wat het merk intrekt. Beelden worden op EAN aan je artikelen gekoppeld.

Voor je ontwikkelaar: zo ziet het eruit.

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

  • Welke software ermee werkt

    Open Brand Exchange is een open standaard: elke software kan hem ondersteunen. Photopilot bouwt hem in zijn software voor retailers, en andere leveranciers kunnen hetzelfde doen. Je hebt geen bepaalde software nodig: een browser is genoeg. Specificatie voor ontwikkelaars.

  • Een merk vinden

    Merken die zich laten vermelden, staan in de merkenlijst. Geeft een merk je gewoon het adres van zijn portaal, dan werkt dat ook. Naar de merkenlijst.

Staat je merk er niet op? Stuur ze dit

De snelste manier om een merk mee te krijgen, is dat winkels erom vragen. Kopieer deze mail, vul de haakjes in en stuur hem naar je contactpersoon of vertegenwoordiger bij het merk.

Meer materiaal, zoals de brochure voor retailers, staat bij de downloads. Downloads.