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

Norma aberta · Software livre

O conteúdo dos seus produtos, pronto para todos os revendedores.

O Open Brand Exchange é uma norma aberta para a forma como os revendedores obtêm as fotografias e os dados de artigo de uma marca: num portal no navegador, em zip ou folha de cálculo, ou diretamente no seu próprio software através de uma única API. A forma como o conteúdo chega ao seu portal fica ao seu critério.

Comece como marca Sou revendedor
Aberta
norma, CC-BY-4.0
3
edições do portal
61
testes de conformidade
25
idiomas
0 €
em licenças
O portal da marca fictícia Kestrel, tal como um revendedor o vê: oito artigos com filtros por marca, tipo de produto e cor.
GET/obx/v1/changesO que o software de um revendedor recebe
{
  "phase": "live",
  "changes": [
    { "seq": 1042, "op": "delete",
      "type": "asset",
      "external_id": "KO-1001_NVY_2" },
    { "seq": 1043, "op": "upsert",
      "type": "variant",
      "external_id": "2000100101025",
      "data": { "size": "M", … } }
  ],
  "has_more": false
}

Como funciona

Uma só fonte. Os revendedores vão buscar o que precisam.

O seu conteúdo está no seu próprio portal. Os compradores pesquisam e transferem ficheiros no navegador; o software deles lê o mesmo conteúdo através da API.

  1. Os seus sistemas

    • PIM
    • ERP
    • DAM
    • Pasta de exportação

  2. Colocar o conteúdo

    • Importação agendada
    • Ferramenta obx
    • GitHub Action
    • API de envio

  3. O seu portal

    brands.yourbrand.com
    • Catálogo e imagens
    • Acesso por revendedor
    • Estatísticas de utilização

  4. Os seus revendedores

    Compradores, no navegador

    • Pesquisa e lista de EAN
    • Transferências em zip e CSV

    O software deles, através da API

    • Loja online e PIM
    • POS e ferramentas de conteúdo
Como o conteúdo segue dos sistemas de uma marca, através do seu próprio portal, até aos seus revendedores.

01 Portal

Um portal para os compradores dos seus revendedores.

Os compradores iniciam sessão no seu portal, colam os EAN da encomenda e transferem exatamente o que precisam: uma fotografia, um artigo ou um zip de uma seleção inteira.

  • Pesquisa e filtros por marca, estação, tipo de produto e cor
  • Cole uma lista de EAN e veja de imediato o que existe e o que falta
  • Original, web (2000 px) ou quadrada, mais os dados dos artigos numa folha de cálculo
  • O seu nome, logótipo e domínio: «Kestrel · Portal de revendedores»
Veja-o pelos olhos de um revendedor
Um revendedor cola seis EAN no portal da marca: cinco são encontrados e um não consta do catálogo.

02 API

Uma API, igual para todas as marcas.

O software do revendedor obtém tudo uma vez e depois apenas o que mudou, incluindo o que retirar. Cada imagem chega com os direitos de utilização, a data de embargo e a origem de IA.

  • Primeiro uma cópia completa, depois só as alterações
  • Pesquisa por EAN, associada ao artigo e ao tamanho certos
  • Versões web, quadrada e miniatura; originais se o permitir
  • Um fabricante de software integra-a uma vez e funciona com todas as marcas
Leia a referência da API
GET/obx/v1/changesAsset
{
  "seq": 1051, "type": "asset", "op": "upsert",
  "external_id": "KO-1003_RST_3",
  "data": {
    "role": "model",
    "color_code": "RST",
    "rights": {
      "license": "retailer-use",
      "channels": ["webshop", "marketplace", "social"],
      "embargo_until": null
    },
    "provenance": { "ai_generated": true, "source": "generated" },
    "renditions": {
      "web":    { "width": 1200, "height": 1500 },
      "square": { "width": 1500, "height": 1500 },
      "thumb":  { "width": 480,  "height": 600 }
    }
  }
}

03 Os seus sistemas

Continue a trabalhar como trabalha hoje.

A norma trata da forma como os revendedores vão buscar o conteúdo. Como o seu conteúdo chega ao portal é uma escolha sua: uma importação noturna a partir de um endereço web, SFTP ou S3, uma pasta de exportação ou a ferramenta de linha de comandos obx.

  • Importação noturna a partir de um endereço web, SFTP ou S3, sem código
  • A ferramenta obx para Windows, macOS e Linux envia só o que mudou
  • Receitas para cron, GitHub Actions, n8n, Make e Zapier
  • Um único formato CSV e uma única regra de nomes para as fotografias
Veja as receitas de automatização
Terminal
$ obx push ./export
Publishing to brands.kestrel.example (Kestrel, Kestrel Trail)
images: 27 checked, 3 uploaded (4.2 MB) in 3s
Done: rows: 40, images: 27 → new: 2 · updated: 3 · unchanged: 35
publish.ymlGitHub Action
# .github/workflows/publish.yml
on:
  push:
    paths: ["export/**"]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: openbrandexchange/obx-go/push-action@v0
        with:
          url: ${{ secrets.OBX_URL }}
          token: ${{ secrets.OBX_TOKEN }}
          folder: export

Para quem é

Para marcas e para revendedores.

Para marcas

Acabou o envio de ficheiros. Os revendedores vão buscar o que precisam e é a sua marca que decide quem recebe o quê.

  • O seu próprio portal, no seu próprio domínio
  • Aprova cada revendedor e decide o que ele vê
  • Veja quem transfere o quê, por revendedor
  • Aloje-o gratuitamente ou escolha um fornecedor e saia quando quiser
Saiba mais para marcas

Para revendedores

Todas as marcas num formato coerente, no seu navegador ou diretamente no seu software.

  • Cole a sua lista de EAN e receba as imagens certas para cada tamanho
  • Transfira zips e dados de artigos, prontos para a sua loja
  • Uma só ligação para todas as marcas da norma
  • Direitos de utilização e datas de embargo em cada imagem
Saiba mais para revendedores

Alojamento

Onde quiser. Paga só o alojamento.

Três edições do mesmo portal. Passam nos mesmos testes de conformidade e falam a mesma API, por isso pode mudar de uma para outra.

  • A mais fácil

    Com um fornecedor

    Funciona em
    Uma empresa de alojamento ou agência gere-o por si
    Precisa de
    Nada técnico
    Instalação
    Configuram-no consigo
    Custo
    Os preços do próprio fornecedor
    Ver fornecedores
  • Um clique

    Portal para Cloudflare

    Funciona em
    Cloudflare Workers, com D1 e R2
    Precisa de
    Uma conta Cloudflare
    Instalação
    Um clique e depois o assistente
    Custo
    Plano Workers Paid, cerca de 5 dólares por mês
    Instalar no Cloudflare
  • Contentores

    Portal para Google Cloud e Docker

    Funciona em
    Google Cloud Run ou qualquer servidor com Docker
    Precisa de
    Uma conta Google Cloud ou um servidor Docker
    Instalação
    Um script ou um comando Docker
    Custo
    Paga o que usa no Cloud Run, ou o seu servidor
    Instalar com Docker
  • Sem comandos

    Portal para alojamento web

    Funciona em
    Alojamento web comum com PHP e uma base de dados
    Precisa de
    Um programa de FTP
    Instalação
    Envie um zip e siga o instalador
    Custo
    O alojamento que já paga
    Instalar em alojamento web

Governação

Uma norma aberta, não uma plataforma.

O Open Brand Exchange deve pertencer às marcas, revendedores e fabricantes de software que o usam, não a uma única empresa.

  • Especificação aberta

    Versão 0.1, escrita em OpenAPI 3.1 e JSON Schema sob CC-BY-4.0. Qualquer pessoa a pode implementar, também para fins comerciais.

  • Testes de conformidade

    61 verificações automáticas em quatro perfis. Todas as implementações são testadas da mesma forma.

  • Licenças de código aberto

    O SDK, a ferramenta obx e a interface web são Apache-2.0. As três edições do portal são AGPL-3.0, para que as melhorias continuem abertas.

  • Uma fundação em constituição

    Os direitos de autor, o nome e o domínio passam para a Open Brand Exchange Foundation (em constituição) assim que esta estiver registada.

  • Segurança

    Comunique vulnerabilidades em privado para [email protected]. A segurança é um dos quatro perfis de conformidade.

  • Privacidade primeiro

    Este site não define cookies, não usa rastreadores e não carrega nada de outros servidores.

Saiba como é governado

Programadores

Uma especificação sobre a qual construir.

Três contratos OpenAPI, JSON Schemas, uma marca de teste fictícia e testes de conformidade. O Go SDK e a ferramenta obx estão prontos a usar, e qualquer cliente HTTP funciona.

Terminal
$ curl https://brands.kestrel.example/.well-known/obx
200 OK · application/json
{
  "obx_version": "0.1",
  "publisher": { "name": "Kestrel Outfitters" },
  "api_base": "https://brands.kestrel.example/obx/v1",
  "portal_url": "https://brands.kestrel.example/",
  "capabilities": ["changes", "products", "by_gtin",
                   "renditions", "exports", "webhooks"]
}

Perguntas frequentes

O que as marcas perguntam primeiro

Todas as perguntas
Quanto custa?

A norma e o software são gratuitos. Se alojar por conta própria, paga apenas o alojamento. Um fornecedor tem os seus próprios preços, que encontra no site dele.

Precisamos de um programador?

Não para o essencial. Um portal instala-se com um clique, e uma importação agendada a partir de um endereço web, servidor SFTP ou bucket não exige código. Um programador ajuda se quiser ligar diretamente o PIM ou ERP.

É mais uma plataforma a que temos de aderir?

Não. Cada marca gere o seu próprio portal, no seu domínio se quiser. Não há nenhuma plataforma central que guarde o seu conteúdo.

Quem decide que revendedor tem acesso?

Você. Os revendedores pedem acesso e aprova ou recusa cada pedido. Escolhe também que marcas cada revendedor vê e se os originais podem ser transferidos.

Deixe os seus revendedores irem buscá-lo sozinhos.

Crie o seu próprio portal, ou fale-nos dos seus sistemas e revendedores e ajude a moldar a primeira versão.

Comece como marca Envie-nos um e-mail

  1. Crie o seu portal

    Deixe um fornecedor geri-lo, ou aloje-o gratuitamente com um clique ou um comando. Opções de alojamento

  2. Publique automaticamente

    Um ficheiro CSV e fotografias com um nome fixo. O seu PIM, ERP ou uma simples pasta entrega-os todas as noites, sem trabalho manual. Automatização

  3. Os revendedores tratam do resto

    Os revendedores iniciam sessão, colam a lista de EAN e transferem. O software deles obtém o mesmo conteúdo através da API padrão. Para revendedores