Markalar

Marka authority'si mağazadaki products.brand değerlerinden türetilir.

Endpointler

GET/brandsMarka listesi

Brands API ne işe yarar?

Mağazada kullanılan marka değerlerini okumak için kullanılır. Brand listesi ayrı bir merkezi brand tablosundan değil mağazadaki products.brand değerlerinden türetilir.

Bu nedenle brand authority ürün kataloğudur.

Gerekli scope

GET /brands için products:read scope gerekir.

Önemli mimari fark

Brand response'u ayrı bir brand ID contract'ı sunmaz. Marka adı ve o markayı kullanan ürün sayısı üzerinden türetilmiş bir liste döner.

Entegrasyonunuz brand için var olmayan numeric brand_id varsayımı yapmamalıdır.

Response alanları

AlanAçıklama
nameproducts.brand içerisinden türetilen marka adı
product_countBu marka değerini kullanan ürün sayısı

Meta authority

Response metadata içerisinde count ve authority bilgisi bulunabilir. authority değeri products.brand olarak brand listesinin hangi kaynaktan üretildiğini açıklar.

ERP tarafında nasıl kullanmalıyım?

BYNovax brand listesini ERP'deki marka sözlüğüyle eşleştirebilirsiniz. Ancak bunu ayrı BYNovax brand ID eşlemesi olarak tasarlamayın.

Ürün gönderirken brand alanını string değer olarak değerlendirin.

Örnek senaryo

GET /brands

Response:
Nike     → 42 ürün
Adidas   → 31 ürün

ERP:
"Nike" string değeri ürün brand alanıyla eşleşir.
Numeric BYNovax brand_id beklenmez.

Çalıştığını nasıl doğrularım?

  • GET /brands 200 dönüyor.
  • Her item name ve product_count içeriyor.
  • Entegrasyon ayrı brand ID varsaymıyor.
  • Brand değerleri product catalog ile tutarlı işleniyor.