Katalogdan Toplu Ürün Oluşturma

Giriş

Amazon sisteminde mevcut olan katalog ürünlerinin bilgileri ile ürünlerinizi toplu olarak oluşturabilmenizi sağlayan metottur.

İstek Limitleri

❗️

Servis	Limit
Toplu Ürün Doküman Linki Oluşturma Metodu	1 dakikada 30 defa
Toplu Ürün İşlem Talebi Metodu	2 dakikada 1 defa
Toplu Ürün İşlem Kontrolü Metodu	1 dakikada 120 defa
Toplu Ürün İşlem Raporu Alma Metodu	1 dakikada 1 defa

Katalogdan Toplu Ürün Oluşturma Aşamaları

1. Katalogdan toplu ürün oluşturmak için öncelikle yükleyeceğiniz dokümanın Amazon linkini almanız gereklidir. Amazon tarafından iletilen linki Toplu Ürün Doküman Linki Oluşturma metodu ile alabilirsiniz.
   1. İşlem sonucunda doküman ID’sini (feedDocumentId) ve doküman URL'ini (URL) daha sonraki adımlarda kullanmak üzere saklayınız.
   2. {"contentType": "application/xml"} göndermelisiniz.
2. ASIN (Ürünün Amazon Katalog Numarası) bilgilerini içeren dosya oluşturun.
   1. Örnek JSON dosyasını incelemek için tıklayınız.
3. Oluşturduğunuz JSON formatındaki dosyayı 1. adımda aldığınız doküman URL'ine (URL) istek atarak gönderebilirsiniz.
   1. Content-Type:application/json göndermelisiniz.
   2. JSON formatındaki dosya içeriğini raw data olarak body içerisinde göndermelisiniz.
4. Toplu ürün işlem taleplerinizi Toplu Ürün İşlem Talebi metoduyla iletebilirsiniz.
   1. inputFeedDocumentId parametresine Amazon tarafından iletilen linkteki doküman ID’sini (feedDocumentId) eklemeniz gereklidir.
   2. 2.adımda oluşturduğunuz dosya feedType parametresine JSON_LISTINGS_FEED eklemeniz gereklidir.
5. Talep ettiğiniz dokümanın hazır olma durumunu 2 şekilde kontrol edip sonuçlanan doküman ID'sini (resultFeedDocumentId) alabilirsiniz:
   1. Toplu Ürün İşlem Kontrolü metodunu kullanarak, işlem sonucunda bulunan processingStatus parametresinden dokümanın hazır olma durumunu kontrol edebilirsiniz.
   2. Notifications yöntemi ile kontrol edebilirsiniz. (Önerilen)
6. Dokümanı indirmek için, sonuçlanan doküman ID’sini (resultFeedDocumentId) belirterek Toplu Ürün İşlem Raporu Alma metodunu kullanmanız gereklidir. İşlem sonucunda dönen doküman linkini (URL) bir sonraki adımda kullanmak üzere saklayınız.
7. Toplu Ürün İşlem Raporu Alma metodunun sonucunda dönen doküman linkini (URL) kullanarak dokümanı indirin.
8. Ürünlerin durumunu dokümandan kontrol edebilirsiniz. Oluşturulan ürünlerde hata oluşursa, hatanın detaylı bilgisi doküman içerisinde yer alacaktır.

❗️

Ürünlerin; stok ve fiyat bilgileri ürünler başarılı şekilde açıldıktan sonra eklenebilmektedir. Ürünler ASIN ile açıldığı için Amazon kataloğunda mevcut olan ürünün görselleri otomatik yansıyacaktır.

📘

Amazon Türkiye için yalnızca sıfır ürünü açabilirsiniz. Ürün durumunu aşağıdaki gibi gönderebilirsiniz.

Text

<Condition>
        <ConditionType>New</ConditionType>
      </Condition>

Katalogdan Toplu Ürün Oluşturma Değerleri ve Açıklamaları

🚧

Requirements

Değer	Açıklama
feedType	Katalogdan toplu ürün oluşturma yönteminin formatını belirten parametredir. Aşağıdaki tablodan toplu ürün oluşturma yöntemleri için kullanılabilecek formatları inceleyebilirsiniz.
marketplaceIds	Amazon satış ortağı mağaza ID'sini temsil eder. ID listesine https://docs.developer.amazonservices.com/en_UK/dev_guide/DG_Endpoints.html buradan erişebilirsiniz. Toplu ürün oluşturma işlemlerinde birden fazla mağaza ID'si gönderilebilmektedir. TR: A33AVAJ2PDY3EV
inputFeedDocumentId	Katalogdan toplu ürün doküman linki oluşturma metoduyla yapılan işlem sonucunda dönen Amazon'un ilettiği doküman id'si.

🚧

feedType Değerleri

Değer	Açıklama
JSON_LISTINGS_FEED	Toplu ürün oluşturma dosyanız JSON formatındaysa kullanmanız gereken değerdir.

Katalogdan Toplu Ürün Oluşturma Örnek Kodları

Amazon kataloğunda bulunan bir ürünü eklemek için ASIN kodunu bilmeniz gereklidir. Aşağıda bulunan XML ve JSON örnekleri 2 adet Amazon üzerinde bulunan ayakkabıyı mağazanıza ekler.

📘

Marka izni gereken bir ASIN kodlu ürünü ekliyorsanız, Amazon tarafında marka iznini almanız gereklidir.

JSON

{
    "header": {
        "sellerId": "AO0WPKWDI17JQ",
        "version": "2.0",
        "issueLocale": "tr_TR"
    },
    "messages": [
        {
            "messageId": 1,
            "sku": "My-SKU-A",
            "operationType": "UPDATE",
            "productType": "SHOES",
            "requirements": "LISTING_OFFER_ONLY",
            "attributes": {
                "merchant_suggested_asin": [
                    {
                        "value": "B01MU2H7J5"
                    }
                ],
                "purchasable_offer": [
                    {
                        "currency": "TRY",
                        "our_price": [
                            {
                                "schedule": [
                                    {
                                        "value_with_tax": "890.90"
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "condition_type": [
                    {
                        "value": "new_new"
                    }
                ],
                "fulfillment_availability": [
                    {
                        "fulfillment_channel_code": "DEFAULT",
                        "quantity": "50",
                        "lead_time_to_ship_max_days": "3"
                    }
                ]
            }
        },
        {
            "messageId": 2,
            "sku": "My-SKU-B",
            "operationType": "UPDATE",
            "productType": "SHOES",
            "requirements": "LISTING_OFFER_ONLY",
            "attributes": {
                "merchant_suggested_asin": [
                    {
                        "value": "B0B82NSCQG"
                    }
                ],
                "purchasable_offer": [
                    {
                        "currency": "TRY",
                        "our_price": [
                            {
                                "schedule": [
                                    {
                                        "value_with_tax": "890.90"
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "condition_type": [
                    {
                        "value": "new_new"
                    }
                ],
                "fulfillment_availability": [
                    {
                        "fulfillment_channel_code": "DEFAULT",
                        "quantity": "50",
                        "lead_time_to_ship_max_days": "3"
                    }
                ]
            }
        }
    ]
}