Estándar abierto · Software libre
Open Brand Exchange es un estándar abierto que define cómo obtienen los distribuidores las fotos de producto y los datos de artículos de una marca: en un portal en el navegador, como zip u hoja de cálculo, o directamente en su propio software a través de una API. Cómo llega el contenido a tu portal lo decides tú.
{
"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
}Cómo funciona
Tu contenido está en tu propio portal. Los compradores buscan y descargan archivos en el navegador; su software lee el mismo contenido a través de la API.
01 Portal
Los compradores inician sesión, pegan los EAN de su pedido y descargan justo lo que necesitan: una foto, un artículo o un zip con toda una selección.
02 API
El software del distribuidor descarga todo una vez y después solo los cambios, también lo que retiras. Cada imagen llega con sus derechos de uso, su fecha de embargo y su origen de IA.
{
"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 Tus sistemas
El estándar define cómo obtienen el contenido los distribuidores. Cómo llega tu contenido al portal lo eliges tú: una importación nocturna desde una dirección web, SFTP o S3, una carpeta de exportación o la herramienta de línea de comandos obx.
$ 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# .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: exportPara quién es
Se acabó enviar archivos de un lado a otro. Los distribuidores recogen lo que necesitan y tú decides quién recibe qué.
Todas las marcas en un formato coherente, en tu navegador o directamente en tu software.
Alojamiento
Tres ediciones del mismo portal. Superan las mismas pruebas de conformidad y hablan la misma API, así que puedes pasar de una a otra.
Gobernanza
Open Brand Exchange debe pertenecer a las marcas, los distribuidores y los fabricantes de software que lo usan, no a una sola empresa.
Versión 0.1, escrita en OpenAPI 3.1 y JSON Schema bajo CC-BY-4.0. Cualquiera puede implementarla, también con fines comerciales.
61 comprobaciones automáticas en cuatro perfiles. Todas las implementaciones se prueban de la misma forma.
El SDK, la herramienta obx y la interfaz web son Apache-2.0. Las tres ediciones del portal son AGPL-3.0, así que las mejoras siguen siendo abiertas.
Los derechos de autor, el nombre y el dominio pasarán a la Open Brand Exchange Foundation (en constitución) en cuanto esté inscrita.
Comunica las vulnerabilidades en privado a [email protected]. La seguridad es uno de los cuatro perfiles de conformidad.
Este sitio web no usa cookies ni rastreadores y no carga nada de otros servidores.
Desarrolladores
Tres contratos OpenAPI, JSON Schemas, una marca de prueba ficticia y pruebas de conformidad. El Go SDK y la herramienta obx están listos para usar, y sirve cualquier cliente HTTP.
$ curl https://brands.kestrel.example/.well-known/obx{
"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"]
}Preguntas frecuentes
El estándar y el software son gratuitos. Si lo alojas tú, solo pagas el alojamiento. Un proveedor fija sus propios precios, que encontrarás en su sitio web.
No para lo básico. Un portal se instala con un clic, y una importación programada desde una dirección web, un servidor SFTP o un bucket no requiere código. Un desarrollador ayuda si quieres conectar directamente tu PIM o ERP.
No. Cada marca gestiona su propio portal, en su propio dominio si quiere. No hay ninguna plataforma central que guarde tu contenido.
Tú. Los distribuidores solicitan acceso y tú apruebas o rechazas cada solicitud. También eliges qué marcas ve cada distribuidor y si se pueden descargar los originales.
Pon en marcha tu propio portal, o cuéntanos cuáles son tus sistemas y tus distribuidores y ayúdanos a dar forma a la primera versión.
Deja que un proveedor lo gestione o alójalo tú mismo gratis con un clic o un comando. Opciones de alojamiento
Un archivo CSV y fotos con un nombre fijo. Tu PIM, tu ERP o una simple carpeta los entrega cada noche, sin trabajo manual. Automatización
Los distribuidores inician sesión, pegan su lista de EAN y descargan. Su software obtiene el mismo contenido a través de la API estándar. Para distribuidores