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 XML veya JSON formatında 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. XML ile işlem yapıyorsanız, body içerisine {"contentType": "application/xml"}; JSON ile ürün oluşturuyorsanız {"contentType": "application/xml"} göndermelisiniz.
2. ASIN (Ürünün Amazon Katalog Numarası) bilgilerini içeren XML veya JSON dosyasını oluşturun.
   1. Örnek XML dosyasını incelemek için tıklayınız.
   2. Örnek JSON dosyasını incelemek için tıklayınız.
3. Oluşturduğunuz XML veya JSON formatındaki dosyayı 1. adımda aldığınız doküman URL'ine (URL) istek atarak gönderebilirsiniz.
   1. XML ile işlem yapıyorsanız, header içerisine Content-Type:application/xml; JSON ile ürün oluşturuyorsanız Content-Type:application/json göndermelisiniz.
   2. XML veya 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 XML ise feedType parametresine POST_PRODUCT_DATA , JSON ise 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 kataloğunda mevcut olan ürünün satışa açılabilmesi için;

• Ürünlere stok bilgilerini eklemek için toplu stok güncelleme sürecine göre işlem yapmalısınız.
• Ürünlere fiyat bilgilerini eklemek için toplu fiyat güncelleme sürecine göre işlem yapmalısınız.

📘

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.
POST_PRODUCT_DATA	Toplu ürün oluşturma dosyanız XML formatındaysa kullanmanız gereken değerdirToplu ürün oluşturma dosyanız XML formatındaysa kullanmanız gereken değerdir. İşlem sonucunda ürüne bir ASIN (Ürünün Amazon Katalog Numarası) tanımlanır. Kategorilere tanımlı XML verileri hakkında detaylı bilgi için destek taleplerinizi https://sellercentral.amazon.com.tr/gp/mws/contactus.html linkine tıklayarak oluşturabilirsiniz.

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.

📘

JSON örneğinde XML'den farklı olarak ürün fiyatı ve stok adet bilgilerini güncelleyecek şekilde oluşturulmuştur.

📘

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

XML

<?xml version="1.0"?>
<AmazonEnvelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Header>
    <DocumentVersion>1.00</DocumentVersion>
    <MerchantIdentifier>AO0WPKWDI17JQ</MerchantIdentifier>
  </Header>
  <MessageType>Product</MessageType>
  <EffectiveDate>2023-03-19T14:00:00+03:00</EffectiveDate>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Product>
      <SKU>YNG-MOP-1</SKU>
      <StandardProductID>
        <Type>ASIN</Type>
        <Value>B0819DV2ZH</Value>
      </StandardProductID>
      <Condition>
        <ConditionType>New</ConditionType>
      </Condition>
    </Product>
  </Message>
  <Message>
    <MessageID>2</MessageID>
    <OperationType>Update</OperationType>
    <Product>
      <SKU>YNG-MOP-2</SKU>
      <StandardProductID>
        <Type>ASIN</Type>
        <Value>B09BPZKV9F</Value>
      </StandardProductID>
      <Condition>
        <ConditionType>New</ConditionType>
      </Condition>
    </Product>
  </Message>
</AmazonEnvelope>

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"
                    }
                ]
            }
        }
    ]
}