Versão 0.1. A versão 0.1 foi publicada. A especificação e o software são de utilização livre.

Para revendedores

As imagens e os dados de artigo de cada marca, sempre da mesma forma

As marcas que usam o Open Brand Exchange entregam imagens e dados de artigos de uma única forma, quer transfira à mão quer use software.

Ir para o diretório Uma chave de API para o seu software
Um artigo no portal da marca: imagens por cor, transferência em original, web ou quadrada, e o EAN de cada tamanho.

Portal de revendedores

O que o portal de uma marca lhe oferece

Cada marca gere o seu próprio portal, com o seu nome: por exemplo «Kestrel · Portal de revendedores».

  • Pedir acesso

    Peça acesso no portal da marca. A marca aprova e recebe um convite por e-mail.

  • Pesquisar e filtrar

    Por marca, estação, coleção, tipo de produto ou cor. Cada artigo com todas as imagens e dados.

  • Colar a sua lista de EAN

    Cole os EAN do seu POS e veja logo que artigos existem e quais ainda faltam.

  • Transferir como quiser

    Uma fotografia, um artigo, a sua seleção ou tudo num filtro em zip. Original (se a marca permitir), web ou quadrado.

  • Dados dos artigos em folha de cálculo

    EAN por tamanho, cor, material, cuidados e descrição, prontos para o seu sistema.

  • O que é permitido

    Os direitos de utilização, a data de embargo e se uma imagem foi feita com IA aparecem em cada imagem.

Um revendedor cola seis EAN no portal da marca: cinco são encontrados e um não consta do catálogo.

Dados de artigo

O que está na etiqueta de conservação acompanha cada artigo.

A composição por parte, as instruções de conservação pela ordem da etiqueta e o país de origem fazem parte de cada artigo, ao lado do EAN de cada tamanho. A sua loja mostra-os como texto ou como símbolos de conservação, no seu próprio estilo. Os campos seguem as regras da UE sobre etiquetagem têxtil e os códigos de conservação da ISO 3758, por isso mais tarde também podem alimentar um passaporte digital do produto.

  • Composição por parte (exterior, forro, enchimento, sola) com percentagens
  • Instruções de conservação em códigos normalizados, pela ordem da etiqueta
  • País de origem e o EAN de cada tamanho e cor
Exemplo da marca de teste

Kestrel Trail · Calções de trail running KT-2001 · Preto

Composição
Exterior: 100% poliéster recicladoForro: 88% poliamida, 12% elastano
Conservação
  1. Lavar na máquina a 30 °C wash_30
  2. Não usar lixívia do_not_bleach
  3. Não secar na máquina do_not_tumble_dry
  4. Não passar a ferro do_not_iron
  5. Não limpar a seco do_not_dry_clean
Fabricado em
Vietnã
Tamanhos e EAN
Tamanho S: 02000200101017Tamanho M: 02000200101024Tamanho L: 02000200101031
O mesmo artigo na 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 o seu software

Uma chave de API para o seu software

O seu PIM, POS ou loja online obtém as imagens sozinho? Então peça uma chave API para o seu software. Primeiro obtém tudo e depois só as alterações, incluindo o que a marca retira. As imagens são associadas aos seus artigos por EAN.

Para o seu programador: é assim que funciona.

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

  • Que software funciona com ele

    O Open Brand Exchange é uma norma aberta: qualquer software a pode suportar. A Photopilot está a integrá-la no seu software para revendedores, e outros fornecedores podem fazer o mesmo. Não precisa de nenhum software em particular: basta um navegador. Especificação para programadores.

  • Encontrar uma marca

    As marcas que escolhem constar estão no diretório. Se uma marca simplesmente lhe der o endereço do portal, também funciona. Ir para o diretório.

A sua marca não está lá? Envie-lhe isto

A forma mais rápida de trazer uma marca é as lojas pedirem. Copie este e-mail, preencha os parênteses retos e envie-o ao seu contacto ou comercial na marca.

Mais material, como a brochura para revendedores, está na página de transferências. Transferências.