API Reference

Varyantlı Ürün Oluşturma

Giriş

Amazon katalog sisteminde mevcut olmayan ürünleri varyantlarıyla oluşturabilmenizi sağlayan metottur.

Servis kullanım detaylarını Ana Ürün Oluşturma ve Ana Ürüne Varyant Oluşturma bölümlerinden inceleyebilirsiniz.

Varyantlı Ürün Oluştrma Süreci

Varyantlı Ürün Oluştrma Süreci

İstek Limiti

❗️

Bu servise saniyede en fazla 5 istek gönderebilirsiniz.

Varyantlı Ürün Oluşturma Aşamaları

Katalogda mevcut olmayan bir ürünü varyantlarıyla açabilmeniz için;

  1. Ana ürün bilgilerini göndererek Ana Ürün Oluşturma metoduyla ana ürün eklemeniz gereklidir.
  2. Eklediğiniz ana ürünün stok kodunu ve varyant bilgilerini göndererek Ana Ürüne Varyant Oluşturma metoduyla ana ürüne varyant ekleyebilirsiniz.
  3. Açtığınız ürünün durumunu 2 şekilde kontrol edebilirsiniz:
    1. Ürün Detayı metodunu kullanarak, işlem sonucunda bulunan issues parametresinden eklediğiniz ürünün durumunu kontrol edebilirsiniz.
    2. Notifications yöntemi ile kontrol edebilirsiniz. (Önerilen)

Ana Ürün Nasıl Oluşturulur?

  1. Ana ürünü oluştururken, ürün bilgilerine ek olarak ana ürünü temsil eden parentage_level, child_parent_sku_relationship, variation_theme özelliklerini eklemeniz gereklidir.
    1. Parentage Level: Ana ürünü belirlemek için parentage_level parametresine parent değerini eklemeniz gereklidir.
    2. Child Parent Sku Relationship: Ana ürünün varyantlı olacağını belirtmek için child_relationship_type parametresine variation değerini eklemeniz gereklidir.
    3. Variation Theme: SIZE, SIZE/COLOR veya COLOR değerlerini gönderebilirsiniz. Ürünlerin varyant temaları değişkenlik gösterebilmektedir. Ürün türlerine göre varyant temalarına ürün türü özelliklerini listeleyerek erişebilirsiniz.
  2. Ana ürün için, açacağınız varyanta ait ürünün genel özelliklerini eklemeniz gereklidir.
    1. Stok ve fiyat bilgisi ana ürüne eklenmemelidir. Stok-fiyat bilgilerini yalnızca ürüne varyant eklerken gönderebilirsiniz.

📘

Ana ürün özellik ekleme örnek kullanım:
"parentage_level": [
            {
                "value": "parent"
            }
        ],
        "child_parent_sku_relationship": [
            {
                "child_relationship_type": "variation"
            }
        ],
        "variation_theme": [
            {
                "name": "SIZE/COLOR"
            }
        ]

{
    "productType": "SHOES",
    "requirements": "LISTING",
    "attributes": {
        "parentage_level": [
            {
                "value": "parent"
            }
        ],
        "child_parent_sku_relationship": [
            {
                "child_relationship_type": "variation"
            }
        ],
        "variation_theme": [
            {
                "name": "SIZE/COLOR"
            }
        ],
        "main_product_image_locator": [
            {
                "media_location": "https://m.media-amazon.com/images/I/519BZQVaptS._AC_SY695_.jpg"
            }
        ],
        "supplier_declared_has_product_identifier_exemption": [
            {
                "value": true
            }
        ],
        "other_product_image_locator_1": [
            {
                "media_location": "https://m.media-amazon.com/images/I/51L6svfpKQS._AC_SY695_.jpg"
            }
        ],
        "other_product_image_locator_2": [
            {
                "media_location": "https://m.media-amazon.com/images/I/51Y1UROoQHS._AC_SY695_.jpg"
            }
        ],
        "generic_keyword": [
            {
                "value": "Koşu Ayakkabısı"
            }
        ],
        "lifestyle": [
            {
                "value": "Günlük"
            }
        ],
        "style": [
            {
                "value": "Spor"
            }
        ],
        "age_range_description": [
            {
                "value": "Genç Yetişkin"
            }
        ],
        "pattern_type": [
            {
                "value": "Siyah Beyaz Damalı"
            }
        ],
        "strap_type": [
            {
                "value": "Ayak Bileği Kayışı"
            }
        ],
        "inner": [
            {
                "material": [
                    {
                        "value": "Polyester"
                    }
                ]
            }
        ],
        "height_map": [
            {
                "value": "Orta"
            }
        ],
        "water_resistance_level": [
            {
                "value": "waterproof"
            }
        ],
        "fulfillment_availability": [
            {
                "fulfillment_channel_code": "DEFAULT",
                "quantity": "9999",
                "lead_time_to_ship_max_days": "5"
            }
        ],
        "item_name": [
            {
                "value": "Nika Runner XS Spor Ayakkabısı"
            }
        ],
        "brand": [
            {
                "value": "Genel"
            }
        ],
        "bullet_point": [
            {
                "value": "Kısa açıklama notları."
            }
        ],
        "country_of_origin": [
            {
                "value": "TR"
            }
        ],
        "product_description": [
            {
                "value": "Ürün açıklaması"
            }
        ],
        "recommended_browse_nodes": [
            {
                "value": "13808745031"
            }
        ],
        "supplier_declared_dg_hz_regulation": [
            {
                "value": "not_applicable"
            }
        ],
        "supplier_declared_material_regulation": [
            {
                "value": "not_applicable"
            }
        ],
        "manufacturer": [
            {
                "value": "Amazon"
            }
        ],
        "condition_type": [
            {
                "value": "new_new"
            }
        ],
        "model_number": [
            {
                "value": "AMZN-SHOES-1"
            }
        ],
        "model_name": [
            {
                "value": "Runner"
            }
        ],
        "color": [
            {
                "standardized_values": [
                    "Bronz"
                ]
            }
        ],
        "target_gender": [
            {
                "value": "male"
            }
        ],
        "footwear_size": [
            {
                "age_group": "adult",
                "size_system": "eu_footwear_size_system",
                "gender": "men",
                "size_class": "numeric",
                "size": "numeric_41",
                "width": "medium"
            }
        ],
        "sole_material": [
            {
                "value": "Kauçuk"
            }
        ],
        "toe_style": [
            {
                "value": "Yuvarlak Burun"
            }
        ],
        "leather_type": [
            {
                "value": "Süet"
            }
        ],
        "seasons": [
            {
                "value": "Yaz Kış"
            }
        ],
        "shoe_type": [
            {
                "value": "athletic_shoe"
            }
        ],
        "item_weight": [
            {
                "unit": "grams",
                "value": "300"
            }
        ],
        "externally_assigned_product_identifier": [
            {
                "type": "ean",
                "value": "7094026756778"
            }
        ],
        "department": [
            {
                "value": "Erkek"
            }
        ],
        "outer": [
            {
                "material": [
                    {
                        "value": "Süet"
                    }
                ]
            }
        ],
        "heel": [
            {
                "height": [
                    {
                        "decimal_value": "2.5",
                        "unit": "centimeters"
                    }
                ],
                "type": [
                    {
                        "value": "Düz"
                    }
                ]
            }
        ],
        "item_type_name": [
            {
                "value": "Spor Ayakkabı"
            }
        ],
        "closure": [
            {
                "type": [
                    {
                        "value": "Bağcıklı"
                    }
                ]
            }
        ],
        "shaft": [
            {
                "height": [
                    {
                        "value": "Diz Hizası"
                    }
                ]
            }
        ]
    }
}

Varyant Bilgisi Nasıl Eklenir?

  1. Ana ürüne varyant eklemeden önce varyant stok kodunu (sku) belirlemeniz gereklidir. Ayrıca varyant bilgilerini temsil eden parentage_level, child_parent_sku_relationship, variation_theme özelliklerini eklemeniz gereklidir.
  2. Parentage Level: Ürünün varyantlı olduğunu belirtmek için parentage_level parametresine child değerini eklemeniz gereklidir.
  3. Child Parent Sku Relationship: Ana ürünün stok kodunu parent_sku parametresine eklemelisiniz. Ürünün varyantlı olacağını belirtmek için child_relationship_type parametresine variation değerini eklemeniz gereklidir.
  4. Variation Theme: SIZE, SIZE/COLOR veya COLOR değerlerini gönderebilirsiniz. Ürünlerin varyant temaları değişkenlik gösterebilmektedir. Ürün türlerine göre varyant temalarına ürün türü özelliklerini listeleyerek erişebilirsiniz.
  5. Varyantlara ait diğer tüm özellik bilgilerini** Attributes parametresi ile ekleyebilirsiniz.

📘

Varyant ekleme örnek kullanım:
	"parentage_level": [
            {
                "value": "child"
            }
				],
	"child_parent_sku_relationship": [
            {
                "child_relationship_type": "variation",
                "parent_sku": {{stockCode}}
            }
        ],
	"variation_theme": [
            {
                "name": "SIZE/COLOR"
            }
        ],
	"color": [
            {
                "standardized_values": ["Red"],
                "value": "Red"
            }
        ],
	"footwear_size": [
            {
                "age_group": "adult",
                "size_system": "eu_footwear_size_system",
                "gender": "men",
                "size_class": "numeric",
                "size": "numeric_42",
                "width": "medium"
            }
				]

{
    "productType": "SHOES",
    "requirements": "LISTING_PRODUCT_ONLY",
    "attributes": {
        "purchasable_offer": [
            {
                "currency": "TRY",
                "our_price": [
                    {
                        "schedule": [
                            {
                                "value_with_tax": "1999"
                            }
                        ]
                    }
                ]
            }
        ],
        "fulfillment_availability": [
            {
                "fulfillment_channel_code": "DEFAULT",
                "quantity": "9999",
                "lead_time_to_ship_max_days": "5"
            }
        ],
        "supplier_declared_has_product_identifier_exemption":[  
            {  
                "value": true  
            }  
        ],
        "parentage_level": [
            {
                "value": "child"
            }
        ],
        "child_parent_sku_relationship": [
            {
                "child_relationship_type": "variation",
                "parent_sku": "NK1234"
            }
        ],
        "variation_theme": [
            {
                "name": "SIZE/COLOR"
            }
        ],
        "color": [
            {
                "standardized_values": ["Red"],
                "value": "Red"
            }
        ],
        "footwear_size": [
            {
                "age_group": "adult",
                "size_system": "eu_footwear_size_system",
                "gender": "men",
                "size_class": "numeric",
                "size": "numeric_42",
                "width": "medium"
            }
        ],
        "main_product_image_locator": [
            {
                "media_location": "https://amazon-seller-central-tr.s3.eu-central-1.amazonaws.com/shoe-1.jpg"
            }
        ],
        "other_product_image_locator_1": [
            {
                "media_location": "https://amazon-seller-central-tr.s3.eu-central-1.amazonaws.com/shoe-2.jpg"
            }
        ],
        "other_product_image_locator_2": [
            {
                "media_location": "https://amazon-seller-central-tr.s3.eu-central-1.amazonaws.com/shoe-3.jpg"
            }
        ],
        "generic_keyword": [
            {
                "value": "Koşu Ayakkabısı"
            }
        ],
        "lifestyle": [
            {
                "value": "Günlük"
            }
        ],
        "style": [
            {
                "value": "Spor"
            }
        ],
        "age_range_description": [
            {
                "value": "Genç Yetişkin"
            }
        ],
        "pattern_type": [
            {
                "value": "Siyah Beyaz Damalı"
            }
        ],
        "strap_type": [
            {
                "value": "Ayak Bileği Kayışı"
            }
        ],
        "inner": [
            {
                "material": [
                    {
                        "value": "Polyester"
                    }
                ]
            }
        ],
        "height_map": [
            {
                "value": "Orta"
            }
        ],
        "water_resistance_level": [
            {
                "value": "waterproof"
            }
        ],
        "item_name": [
            {
                "value": "Nika Runner XS Spor Ayakkabı Kırmızı"
            }
        ],
        "brand": [
            {
                "value": "Genel"
            }
        ],
        "bullet_point": [
            {
                "value": "Kısa açıklama notları."
            }
        ],
        "country_of_origin": [
            {
                "value": "TR"
            }
        ],
        "product_description": [
            {
                "value": "Ürün açıklaması"
            }
        ],
        "recommended_browse_nodes": [
            {
                "value": "13808745031"
            }
        ],
        "supplier_declared_dg_hz_regulation": [
            {
                "value": "not_applicable"
            }
        ],
        "supplier_declared_material_regulation": [
            {
                "value": "not_applicable"
            }
        ],
        "manufacturer": [
            {
                "value": "Amazon"
            }
        ],
        "condition_type": [
            {
                "value": "new_new"
            }
        ],
        "model_number": [
            {
                "value": "AMZN-SHOES-1"
            }
        ],
        "model_name": [
            {
                "value": "Runner"
            }
        ],
        "target_gender": [
            {
                "value": "male"
            }
        ],
        "sole_material": [
            {
                "value": "Kauçuk"
            }
        ],
        "toe_style": [
            {
                "value": "Yuvarlak Burun"
            }
        ],
        "leather_type": [
            {
                "value": "Süet"
            }
        ],
        "seasons": [
            {
                "value": "Yaz Kış"
            }
        ],
        "shoe_type": [
            {
                "value": "athletic_shoe"
            }
        ],
        "item_weight": [
            {
                "unit": "grams",
                "value": "300"
            }
        ],
        "department": [
            {
                "value": "Erkek"
            }
        ],
        "outer": [
            {
                "material": [
                    {
                        "value": "Süet"
                    }
                ]
            }
        ],
        "heel": [
            {
                "height": [
                    {
                        "decimal_value": "2.5",
                        "unit": "centimeters"
                    }
                ],
                "type": [
                    {
                        "value": "Düz"
                    }
                ]
            }
        ],
        "item_type_name": [
            {
                "value": "Spor Ayakkabı"
            }
        ],
        "closure": [
            {
                "type": [
                    {
                        "value": "Bağcıklı"
                    }
                ]
            }
        ],
        "shaft": [
            {
                "height": [
                    {
                        "value": "Diz Hizası"
                    }
                ]
            }
        ]
    }
}

Ana Ürüne veya Varyanta Kategori Özellik Bilgisi Nasıl Eklenir?

  1. Amazon kategori listesine, rapor tipi olarak GET_XML_BROWSE_TREE_DATA bilgisini gönderip Rapor Oluşturma Metodu üzerinden erişebilirsiniz. Alternatif olarak excel dosyasını indirebilirsiniz.
  2. Ürünün kategori bilgisini, attributes alanında recommended_browse_nodes parametresine eklemeniz gerekmektedir.

📘

Attributes Parametrelerinden Kategori Bilgisi için Örnek Kullanım:
"attributes": {
    "recommended_browse_nodes": [
      {
        "value": "13546675031"
      }
    ]
}

Dikkat Edilmesi Gerekenler

❗️

Ana ürün eklenirken stok-fiyat bilgisi gönderilmemelidir. Stok-fiyat bilgisi, ana ürüne varyant eklenirken attributes parametresi ile gönderilmelidir.

❗️

Varyant eklemesi yaparken, stok-fiyat bilgilerini ayrı ayrı veya birlikte gönderebilirsiniz.

❗️

Stok bilgilerini Attributes parametresi ile aşağıdaki gibi gönderebilirsiniz:
"fulfillment_availability": [
            {
                "fulfillment_channel_code": "DEFAULT",
                "quantity": "9999"
            }
        ]

❗️

Fiyat bilgilerini attributes parametresi ile aşağıdaki gibi gönderebilirsiniz:
"purchasable_offer": [
            {
                "currency": "TRY",
                "our_price": [
                    {
                        "schedule": [
                            {
                                "value_with_tax": 1999
                            }
                        ]
                    }
                ]
            }
        ]

❗️

Ürünün varyant temasını almak için LISTING parametresiyle Ürün Türü Özellik Listelemeye istek göndermeniz gereklidir. Konu hakkında Ürün Türü Özellik Listeleme metodunu inceleyebilirsiniz.

❗️

Barkod muafiyetiniz varsa Attributes bölümüne aşağıdaki özelliği eklemelisiniz.
"supplier_declared_has_product_identifier_exemption":[  
            {  
                "value": true  
            }  
        ]

❗️

Barkod muafiyetiniz bulunmuyorsa externally_assigned_product_identifier parametresini ekleyerek barkod bilgisini gönderebilirsiniz.
"externally_assigned_product_identifier": [  
            {  
                "type": "ean",  
                "value": "7094026756778"  
            }  
        ]

❗️

Ürünün kategori bilgisini recommended_browse_nodes parametresi ile eklemeniz gerekmektedir.

Amazon kategori listesine, rapor tipini GET_XML_BROWSE_TREE_DATA bilgisini girerek Rapor Oluşturma Metodu üzerinden erişebilirsiniz. Alternatif olarak excel dosyasını indirebilirsiniz.

Örnek kullanım:

"attributes": {
    "recommended_browse_nodes": [
      {
        "value": "13546675031"
      }
    ]
}

❗️

Varyantlı ürün oluşturmada eklenen ürün resim linkleri aşağıdaki şartlardan herhangi birine yüklenmelidir.
  1. Public Amazon S3 bucket
  2. Public Amazon Cloudfront
  3. Private Amazon S3 Bucket (s3://bucket-name/object-name.jpg)

Önemli Notlar

📘

Ana ürüne eklenen resim, Amazon kataloğunda gösterilecek ilk resmi temsil eder.

📘

 Varyantlı ürünlerin isimlerini, varyant bilgilerine göre değiştirebilirsiniz.

📘

Ürün oluşturma talebi sonrası, ürününüzün durumunu Amazon tarafından sonuçalndığı(hatalı,başarılı) zaman kontrol etmek için Notifications yöntemini kullanmanızı öneririz.

Notifications metodu ile ürün oluşturulduğu zaman Amazon sistemi sizlere bilgi iletir. Bu sayede tekrarlı sorgulamaların önüne geçmiş olursunuz.