Giriş
Amazon sisteminde oluşturmak istediğiniz ürünleri toplu olarak gönderebilmenizi 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
Toplu Ürün Oluşturma Aşamaları
Ürünler JSON formatı ile oluşturuluyorsa; işlemde tek seferde fiyat, stok adedi, görsel ve varyant bilgileri gönderilebilir.
- 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.
- İşlem sonucunda doküman ID’sini (feedDocumentId) ve doküman URL'ini (URL) daha sonraki adımlarda kullanmak üzere saklayınız.
- {"contentType": "application/json"} göndermelisiniz.
- Ürün bilgilerini içeren JSON dosyasını oluşturun.
- Örnek JSON dosyasını incelemek için tıklayınız.
- Ürün bilgilerini içeren JSON formatındaki dosyayı oluşturabilmeniz için izleyebileceğiniz aşamaları linke tıklayarak inceleyebilirsiniz.
- Oluşturduğunuz JSON formatındaki dosyayı 1. adımda aldığınız doküman URL'ine (URL) istek atarak gönderebilirsiniz.
- Content-Type:application/json göndermelisiniz.
- Dosya içeriğini raw data olarak body içerisinde göndermelisiniz.
- Toplu ürün işlem taleplerinizi Toplu Ürün İşlem Talebi metoduyla iletebilirsiniz.
- inputFeedDocumentId parametresine Amazon tarafından iletilen linkteki doküman ID’sini (feedDocumentId) eklemeniz gereklidir.
- 2.adımda oluşturduğunuz dosya XML ise feedType parametresine POST_PRODUCT_DATA , JSON ise feedType parametresine JSON_LISTINGS_FEED eklemeniz gereklidir.
- Talep ettiğiniz dokümanın hazır olma durumunu 2 şekilde kontrol edip sonuçlanan doküman ID'sini (resultFeedDocumentId) alabilirsiniz:
- Toplu Ürün İşlem Kontrolü metodunu kullanarak, işlem sonucunda bulunan processingStatus parametresinden dokümanın hazır olma durumunu kontrol edebilirsiniz.
- Notifications yöntemi ile kontrol edebilirsiniz. (Önerilen)
- 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.
- Toplu Ürün İşlem Raporu Alma metodunun sonucunda dönen doküman linkini (URL) kullanarak dokümanı indirin.
- Ü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; görsel, stok ve fiyat bilgileri ürünler başarılı şekilde açıldıktan sonra eklenebilmektedir.
Ürünü oluşturduktan sonra, Amazon üzerinde ü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.
- Ürünlere görsel eklemek için toplu ürün güncelleme sürecine göre işlem yapmalısınız.
Toplu Ürün Oluşturma Değerleri ve Açıklamaları
Requirements
Değer Açıklama feedType 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 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 için kullanmanız gereken değerdir.
Toplu Ürün Oluşturma Örnek Kodları
Aşağıda barkodun bulunmadığı ancak Amazon tarafından muafiyet onayı verilen örnekler ile barkodun tanımlı olduğu kıyafet (clothing) kategorisine ait örnekler iletilmiştir. .
{
"header": {
"sellerId": "AO0WPKWDI17JQ",
"version": "2.0",
"issueLocale": "tr_TR"
},
"messages": [
{
"messageId": 1,
"sku": "My-SKU-C",
"operationType": "UPDATE",
"productType": "SHOES",
"requirements": "LISTING_PRODUCT_ONLY",
"attributes": {
"externally_assigned_product_identifier": [
{
"type": "upc",
"value": "884802801818"
}
],
"water_resistance_level": [
{
"value": "waterproof"
}
],
"brand": [
{
"value": "Genel"
}
],
"bullet_point": [
{
"value": "Belirli oranda geri dönüştürülmüş malzemelerle üretilen, konforlu koşu ayakkabısı."
}
],
"country_of_origin": [
{
"value": "TR"
}
],
"item_name": [
{
"value": "Runner 6 Spor Ayakkabı"
}
],
"product_description": [
{
"value": "Her zaman kullanabileceğin bu koşu ayakkabısı, bazı yenilikçi teknolojilerle donatılmıştır."
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_material_regulation": [
{
"value": "not_applicable"
}
],
"purchasable_offer": [
{
"currency": "TRY",
"our_price": [
{
"schedule": [
{
"value_with_tax": "890.90"
}
]
}
]
}
],
"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"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": "50",
"lead_time_to_ship_max_days": "3"
}
],
"recommended_browse_nodes": [
{
"value": "13546675031"
}
],
"manufacturer": [
{
"value": "Adidas"
}
],
"condition_type": [
{
"value": "new_new"
}
],
"model_number": [
{
"value": "NIKE-RUNNER-6"
}
],
"model_name": [
{
"value": "Runner"
}
],
"color": [
{
"standardized_values": [
"Bronz"
],
"value": "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"
}
],
"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ı"
}
]
}
]
}
},
{
"messageId": 2,
"sku": "My-SKU-D",
"operationType": "UPDATE",
"productType": "SHOES",
"requirements": "LISTING_PRODUCT_ONLY",
"attributes": {
"externally_assigned_product_identifier": [
{
"type": "upc",
"value": "884802801819"
}
],
"water_resistance_level": [
{
"value": "waterproof"
}
],
"brand": [
{
"value": "Genel"
}
],
"bullet_point": [
{
"value": "Belirli oranda geri dönüştürülmüş malzemelerle üretilen, konforlu koşu ayakkabısı."
}
],
"country_of_origin": [
{
"value": "TR"
}
],
"item_name": [
{
"value": "Runner 7 Spor Ayakkabı"
}
],
"product_description": [
{
"value": "Her zaman kullanabileceğin bu koşu ayakkabısı, bazı yenilikçi teknolojilerle donatılmıştır."
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_material_regulation": [
{
"value": "not_applicable"
}
],
"purchasable_offer": [
{
"currency": "TRY",
"our_price": [
{
"schedule": [
{
"value_with_tax": "1890.90"
}
]
}
]
}
],
"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"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": "50",
"lead_time_to_ship_max_days": "3"
}
],
"recommended_browse_nodes": [
{
"value": "13546675031"
}
],
"manufacturer": [
{
"value": "Adidas"
}
],
"condition_type": [
{
"value": "new_new"
}
],
"model_number": [
{
"value": "NIKE-RUNNER-7"
}
],
"model_name": [
{
"value": "Runner"
}
],
"color": [
{
"standardized_values": [
"Bronz"
],
"value": "Bronz"
}
],
"target_gender": [
{
"value": "male"
}
],
"footwear_size": [
{
"age_group": "adult",
"size_system": "eu_footwear_size_system",
"gender": "men",
"size_class": "numeric",
"size": "numeric_42",
"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"
}
],
"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ı"
}
]
}
]
}
}
]
}
{
"header": {
"sellerId": "AO0WPKWDI17JQ",
"version": "2.0",
"issueLocale": "tr_TR"
},
"messages": [
{
"messageId": 1,
"sku": "My-SKU-C",
"operationType": "UPDATE",
"productType": "SHOES",
"requirements": "LISTING_PRODUCT_ONLY",
"attributes": {
"water_resistance_level": [
{
"value": "waterproof"
}
],
"brand": [
{
"value": "Genel"
}
],
"bullet_point": [
{
"value": "Belirli oranda geri dönüştürülmüş malzemelerle üretilen, konforlu koşu ayakkabısı."
}
],
"country_of_origin": [
{
"value": "TR"
}
],
"item_name": [
{
"value": "Runner 6 Spor Ayakkabı"
}
],
"product_description": [
{
"value": "Her zaman kullanabileceğin bu koşu ayakkabısı, bazı yenilikçi teknolojilerle donatılmıştır."
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_material_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_has_product_identifier_exemption": [
{
"value": true
}
],
"purchasable_offer": [
{
"currency": "TRY",
"our_price": [
{
"schedule": [
{
"value_with_tax": "890.90"
}
]
}
]
}
],
"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"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": "50",
"lead_time_to_ship_max_days": "3"
}
],
"recommended_browse_nodes": [
{
"value": "13546675031"
}
],
"manufacturer": [
{
"value": "Adidas"
}
],
"condition_type": [
{
"value": "new_new"
}
],
"model_number": [
{
"value": "NIKE-RUNNER-6"
}
],
"model_name": [
{
"value": "Runner"
}
],
"color": [
{
"standardized_values": [
"Bronz"
],
"value": "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"
}
],
"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ı"
}
]
}
]
}
},
{
"messageId": 2,
"sku": "My-SKU-D",
"operationType": "UPDATE",
"productType": "SHOES",
"requirements": "LISTING_PRODUCT_ONLY",
"attributes": {
"water_resistance_level": [
{
"value": "waterproof"
}
],
"brand": [
{
"value": "Genel"
}
],
"bullet_point": [
{
"value": "Belirli oranda geri dönüştürülmüş malzemelerle üretilen, konforlu koşu ayakkabısı."
}
],
"country_of_origin": [
{
"value": "TR"
}
],
"item_name": [
{
"value": "Runner 7 Spor Ayakkabı"
}
],
"product_description": [
{
"value": "Her zaman kullanabileceğin bu koşu ayakkabısı, bazı yenilikçi teknolojilerle donatılmıştır."
}
],
"supplier_declared_dg_hz_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_material_regulation": [
{
"value": "not_applicable"
}
],
"supplier_declared_has_product_identifier_exemption": [
{
"value": true
}
],
"purchasable_offer": [
{
"currency": "TRY",
"our_price": [
{
"schedule": [
{
"value_with_tax": "1890.90"
}
]
}
]
}
],
"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"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": "50",
"lead_time_to_ship_max_days": "3"
}
],
"recommended_browse_nodes": [
{
"value": "13546675031"
}
],
"manufacturer": [
{
"value": "Adidas"
}
],
"condition_type": [
{
"value": "new_new"
}
],
"model_number": [
{
"value": "NIKE-RUNNER-7"
}
],
"model_name": [
{
"value": "Runner"
}
],
"color": [
{
"standardized_values": [
"Bronz"
],
"value": "Bronz"
}
],
"target_gender": [
{
"value": "male"
}
],
"footwear_size": [
{
"age_group": "adult",
"size_system": "eu_footwear_size_system",
"gender": "men",
"size_class": "numeric",
"size": "numeric_42",
"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"
}
],
"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ı"
}
]
}
]
}
}
]
}