Versión 0.1. La versión 0.1 ya está publicada. La especificación y el software son de uso libre.

Para distribuidores

Las imágenes y los datos de artículo de cada marca, siempre de la misma forma

Las marcas que usan Open Brand Exchange entregan sus imágenes y datos de artículos de una única manera, tanto si descargas a mano como si usas software.

Ir al directorio Una clave API para tu software
Un artículo en el portal de la marca: imágenes por color, descarga en original, web o cuadrada, y el EAN de cada talla.

Portal para distribuidores

Qué te ofrece el portal de una marca

Cada marca gestiona su propio portal, con su propio nombre: por ejemplo «Kestrel · Portal para distribuidores».

  • Solicitar acceso

    Solicita acceso en el portal de la marca. La marca lo aprueba y recibes una invitación por correo.

  • Buscar y filtrar

    Por marca, temporada, colección, tipo de producto o color. Cada artículo con todas sus imágenes y datos.

  • Pegar tu lista de EAN

    Pega los EAN de tu TPV y mira al momento qué artículos están y cuáles faltan todavía.

  • Descargar como quieras

    Una foto, un artículo, tu selección o todo un filtro en zip. Original (si la marca lo permite), web o cuadrado.

  • Datos de artículo en hoja de cálculo

    EAN por talla, color, material, cuidados y descripción, listos para tu propio sistema.

  • Qué está permitido

    Los derechos de uso, la fecha de embargo y si una imagen se hizo con IA aparecen con cada imagen.

Un distribuidor pega seis EAN en el portal de la marca: encuentra cinco y uno no está en el catálogo.

Datos de artículo

Lo que pone en la etiqueta viene con cada artículo.

La composición por partes, las instrucciones de cuidado en el orden de la etiqueta y el país de origen forman parte de cada artículo, junto al EAN de cada talla. Tu tienda los muestra como texto o como símbolos de cuidado, con su propio estilo. Los campos siguen las normas de la UE sobre etiquetado textil y los códigos de cuidado de la ISO 3758, así que más adelante también pueden servir para un pasaporte digital de producto.

  • Composición por partes (tejido exterior, forro, relleno, suela) con porcentajes
  • Instrucciones de cuidado como códigos estándar, en el orden de la etiqueta
  • País de origen y el EAN de cada talla y color
Ejemplo de la marca de prueba

Kestrel Trail · Pantalón corto de trail running KT-2001 · Negro

Composición
Tejido exterior: 100% poliéster recicladoForro: 88% poliamida, 12% elastano
Cuidados
  1. Lavar a máquina a 30 °C wash_30
  2. No usar lejía do_not_bleach
  3. No usar secadora do_not_tumble_dry
  4. No planchar do_not_iron
  5. No limpiar en seco do_not_dry_clean
Fabricado en
Vietnam
Tallas y EAN
Talla S: 02000200101017Talla M: 02000200101024Talla L: 02000200101031
El mismo artículo en la 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" } }
  ]
}

Para tu software

Una clave API para tu software

¿Tu PIM, TPV o tienda online obtiene las imágenes por sí solo? Entonces solicita una clave API para tu software. Primero lo obtiene todo y después solo los cambios, también lo que la marca retira. Las imágenes se asocian a tus artículos por EAN.

Para tu desarrollador: así es como se ve.

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

  • Qué software funciona con él

    Open Brand Exchange es un estándar abierto: cualquier software puede admitirlo. Photopilot lo está incorporando a su software para distribuidores, y otros proveedores pueden hacer lo mismo. No necesitas ningún software concreto: basta con un navegador. Especificación para desarrolladores.

  • Encontrar una marca

    Las marcas que eligen aparecer están en el directorio. Si una marca simplemente te da la dirección de su portal, también funciona. Ir al directorio.

¿Tu marca no está? Envíale esto

La forma más rápida de que una marca se sume es que las tiendas lo pidan. Copia este correo, rellena los corchetes y envíalo a tu contacto o comercial en la marca.

Más material, como el folleto para distribuidores, está en la página de descargas. Descargas.