Ürünler & Katalog API
Ana ürün kataloğunuzu ve varyantlarınızı yönetin, barkod/SKU bazlı pazaryeri eşleşmelerini sorgulayın ve kanallar arası stok/fiyat uyumsuzluklarını tespit edin.
Katalog Yapısı & Kanal Eşleşme Mimarisi
Armonika'da her ürün bir model_code altında gruplanan bir veya daha fazla satılabilir varyanttan (beden, renk vb.) oluşur. Varyantlar bağlı pazaryerlerindeki ilanlarla şu öncelik sırasıyla eşleştirilir:
- 1. Barcode (GTIN / EAN): Önce tekil barkod eşleşmesi aranır.
- 2. SKU (Stok Kodu): Barkod eşleşmezse satıcı stok koduna (SKU) bakılır.
- 3. Manual (Elle Eşleştirme): Panel üzerinden elle bağlanan varyantlar otomatik senkronlarda korunur.
/v1/productsÜrün Kataloğunu Listele
Mağaza kataloğundaki ana ürünleri, varyant özetlerini, toplam stoklarını ve kanal eşleşme sayılarını imleçli olarak döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| status | Query | 'active' | 'draft' | 'archived' | Opsiyonel | Ürün yayın durumu filtresi. |
| q | Query | string | Opsiyonel | Ürün başlığı, model kodu, SKU veya barkod araması. |
| brand | Query | string | Opsiyonel | Marka adına göre filtrele. |
| cursor | Query | string | Opsiyonel | Sonraki sayfa için pagination.next_cursor değeri. |
| limit | Query | integer (1–100) | Vars: 50 | Sayfa boyutu. |
/v1/products/v1/products/{product_id}Tekil Ürün ve Varyant Detaylarını Getir
Ürünün açıklaması, görselleri, tüm varyantları (beden/renk seçenekleri, barkod, SKU, stok, liste/satış fiyatı) ve bağlı pazaryeri eşleşmelerini döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| product_id | Path | string | Zorunlu | Armonika tekil ürün kimliği (örn. prd_01JA9M2K4P6R8T0V2X4Z). |
/v1/products/{product_id}/v1/productsYeni Ürün Oluştur
Mağaza kataloğuna varyantlarıyla birlikte yeni bir ürün ekler. Barkod veya SKU mevcut kanal ürünleriyle eşleşiyorsa otomatik kanal eşleştirmesi tetiklenir.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| title | Body (JSON) | string | Zorunlu | Ürün başlığı (2–250 karakter). |
| model_code | Body (JSON) | string | Zorunlu | Ana model / grup kodu (varyantları gruplamak için kullanılır). |
| brand | Body (JSON) | string | Zorunlu | Marka adı. |
| vat_rate | Body (JSON) | 0 | 1 | 10 | 20 | Vars: 20 | KDV oranı (%). |
| variants | Body (JSON) | VariantInput[] | Zorunlu | En az 1 varyant içeren dizi: { sku, barcode, stock, list_price, sale_price, options }. |
Olası Hata Kodları
| HTTP | Hata Kodu | Açıklama & Çözüm |
|---|---|---|
| 409 | DUPLICATE_SKU_OR_BARCODE | Gönderilen SKU veya barkod mağaza kataloğunda başka bir varyantta zaten kayıtlı. |
/v1/products/v1/products/{product_id}Ürün Bilgilerini Güncelle
Ürünün başlık, açıklama, marka, KDV oranı, görsel listesi veya yayın durumunu kısmi olarak günceller. (Yüksek hacimli stok/fiyat güncellemeleri için /v1/inventory/bulk ve /v1/prices/bulk uçlarını kullanın.)
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| product_id | Path | string | Zorunlu | Güncellenecek ürün kimliği. |
| title | Body (JSON) | string | Opsiyonel | Yeni ürün başlığı. |
| description_html | Body (JSON) | string | Opsiyonel | Ürün açıklaması (temiz HTML). |
| status | Body (JSON) | 'active' | 'draft' | 'archived' | Opsiyonel | Yayın durumu. |
/v1/products/{product_id}/v1/products/mappingsBarkod / SKU Kanal Eşleşmelerini Listele
Ana katalog varyantlarının bağlı pazaryerlerindeki (Trendyol, Hepsiburada, Boyner, Beymen) karşılıklarını ve eşleşme yöntemini (barcode, sku veya manual) döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| channel | Query | string | Opsiyonel | Pazaryeri filtresi: trendyol, hepsiburada, boyner, beymen. |
| state | Query | 'matched' | 'unmatched' | Opsiyonel | Yalnızca eşleşmiş veya henüz eşleşmemiş kayıtları filtreler. |
| barcode | Query | string | Opsiyonel | Belirli bir barkodu sorgula. |
/v1/products/mappings/v1/products/discrepanciesKanallar Arası Stok ve Fiyat Farklarını Getir
Ana stok/fiyat kaynağı ile pazaryerlerindeki canlı ilanlar arasında oluşan stok adedi veya satış fiyatı uyumsuzluklarını listeler.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| channel | Query | string | Opsiyonel | Kanal filtresi (örn. trendyol, hepsiburada). |
| type | Query | 'stock' | 'price' | Opsiyonel | Yalnızca stok veya yalnızca fiyat farklarını getirir. |
/v1/products/discrepancies
