Giriş
Amazon sisteminde varyantlı 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
Varyantlı Toplu Ürün Oluşturma Aşamaları
JSON formatında tek seferde ana ürün ve varyantlar gönderilebildiği için bu formatla yapılan varyantlı ürün oluşturma işlemlerinde varyant bağlama yapılması gerekmemektedir.
- Varyantlı toplu ürün oluşturmak için, toplu ürün ve varyant oluşturma maddelerini uygulayınız.
- Toplu ürün işlemleri aşamalarından, 2. maddede bulunan JSON dosyası varyantlı toplu oluşturacağınız ürünlerin bilgilerini içermelidir.
- Varyantlı toplu ürün oluşturmak için gerekli olan JSON dosya örneği için tıklayınız.
- Ana ürüne varyantları bağlamak için toplu ürünlere varyant bağlama maddelerini ayrıca uygulayınız.
Toplu Ürün ve Varyant Oluşturma Aşamaları
- Varyantlı 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 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.
- JSON formatındaki 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 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.
Varyantlı 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. 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.
Varyantlı Toplu Ürün Oluşturma Örnek Kodları
JSON ile varyantlı ürün eklenme süreci tek json dosyası içerisinde varyant ve ana ürün bilgilerini geçecek yapabilirsiniz.
{
"header": {
"sellerId": "AO0WPKWDI17JQ",
"version": "2.0"
},
"messages": [
{
"messageId": 1,
"sku": "OB3001198-1",
"operationType": "UPDATE",
"productType": "HAT",
"requirements": "LISTING",
"attributes": {
"child_parent_sku_relationship": [
{
"parent_sku": "OB3001198",
"marketplace_id": "A33AVAJ2PDY3EV",
"child_relationship_type": "variation"
}
],
"parentage_level": [
{
"value": "child",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"item_name": [
{
"value": "Thinking Out Loud Patch Black Flexfit - 4REAL",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"product_description": [
{
"value": "Thinking Out Loud Patch Black Flexfit",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"brand": [
{
"value": "Hatstore",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"externally_assigned_product_identifier": [
{
"value": "07333179233812",
"marketplace_id": "A33AVAJ2PDY3EV",
"type": "gtin"
}
],
"skip_offer": [
{
"value": false,
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"fulfillment_availability": [
{
"fulfillment_channel_code": "DEFAULT",
"quantity": 3049
}
],
"condition_type": [
{
"value": "new_new",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"purchasable_offer": [
{
"currency": "TRY",
"discounted_price": [
{
"schedule": [
{
"value_with_tax": 24.99,
"start_at": "2018-01-01",
"end_at": "2018-01-02"
}
]
}
],
"our_price": [
{
"schedule": [
{
"value_with_tax": 26.99
}
]
}
],
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"country_of_origin": [
{
"value": "BD",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"batteries_required": [
{
"value": false,
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"other_product_image_locator_1": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/21a57956b7655ebaf041f234864fc4a77db62416405da0706c720b5a46041b9b/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_offer_image_locator_1": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/21a57956b7655ebaf041f234864fc4a77db62416405da0706c720b5a46041b9b/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_product_image_locator_2": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/34101217b399745b1a161aa3c25bbf048ccd2ac3ef0f8f34322ffe4c10c5c391/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_offer_image_locator_2": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/34101217b399745b1a161aa3c25bbf048ccd2ac3ef0f8f34322ffe4c10c5c391/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_product_image_locator_3": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/feda1ae80ce12491ad5ad86b0b2ae2ee537aecf10d3943bbc3cdd725bc13ba54/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_offer_image_locator_3": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/feda1ae80ce12491ad5ad86b0b2ae2ee537aecf10d3943bbc3cdd725bc13ba54/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_product_image_locator_4": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/e71ed6f179ff447dd7f8358e1da986d5be66703c4977000533595af089371d12/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_offer_image_locator_4": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/e71ed6f179ff447dd7f8358e1da986d5be66703c4977000533595af089371d12/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_product_image_locator_5": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/848bc089d45e59217cce0017911d2c5b3ea8dc1e31185e8047a2cdcd13a78adc/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"other_offer_image_locator_5": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/848bc089d45e59217cce0017911d2c5b3ea8dc1e31185e8047a2cdcd13a78adc/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"main_product_image_locator": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/aebed63929eaf2a283e7ceecc86aa0be4c7bc6d89a4e41d0ef5d97611f4266f6/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"main_offer_image_locator": [
{
"media_location": "https://s3-us-west-2.amazonaws.com/images.crescodata.com/aebed63929eaf2a283e7ceecc86aa0be4c7bc6d89a4e41d0ef5d97611f4266f6/20230211/d751713988987e9331980363e24189ce.jpg",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"weave_type": [
{
"language_tag": "tr_TR",
"value": "Plain",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"variation_theme": [
{
"language_tag": "tr_TR",
"name": "SIZE",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"target_gender": [
{
"language_tag": "tr_TR",
"value": "unisex",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"supplier_declared_material_regulation": [
{
"language_tag": "tr_TR",
"value": "not_applicable",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"style": [
{
"language_tag": "tr_TR",
"value": "Streetwear",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"special_size_type": [
{
"language_tag": "tr_TR",
"value": "Standard",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"recommended_browse_nodes": [
{
"language_tag": "tr_TR",
"value": "1981066031",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"outer": [
{
"material": [
{
"language_tag": "tr_TR",
"value": "Synthetik"
}
],
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"model_name": [
{
"language_tag": "tr_TR",
"value": "Thinking Out Loud Patch Black Flexfit",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"manufacturer": [
{
"language_tag": "tr_TR",
"value": "Hatstore",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"item_type_name": [
{
"language_tag": "tr_TR",
"value": "Baseballkappe",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"headwear_size": [
{
"language_tag": "tr_TR",
"size_system": "as3",
"marketplace_id": "A33AVAJ2PDY3EV",
"size_class": "alpha",
"size": "s"
}
],
"fabric_type": [
{
"language_tag": "tr_TR",
"value": "63% Polyester, 34% Cotton, 3% Elastane",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"department": [
{
"language_tag": "tr_TR",
"value": "Unisex",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"color": [
{
"language_tag": "tr_TR",
"standardized_values": [
"Schwarz"
],
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"closure": [
{
"type": [
{
"language_tag": "tr_TR",
"value": "Schnalle"
}
],
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"care_instructions": [
{
"language_tag": "tr_TR",
"value": "Nur Handwäsche",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"age_range_description": [
{
"language_tag": "tr_TR",
"value": "Erwachsener",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"supplier_declared_dg_hz_regulation": [
{
"language_tag": "tr_TR",
"value": "not_applicable",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"item_weight": [
{
"language_tag": "tr_TR",
"value": 100,
"marketplace_id": "A33AVAJ2PDY3EV",
"unit": "grams"
}
],
"ghs": [
{
"classification": [
{
"language_tag": "tr_TR",
"class": "amzn_specific_no_label_with_warning"
}
],
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"bullet_point": [
{
"language_tag": "tr_TR",
"value": "closed",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"batteries_included": [
{
"language_tag": "tr_TR",
"value": false,
"marketplace_id": "A33AVAJ2PDY3EV"
}
]
}
},
{
"messageId": 2,
"sku": "OB3001198",
"operationType": "UPDATE",
"productType": "HAT",
"requirements": "LISTING",
"attributes": {
"child_parent_sku_relationship": [
{
"marketplace_id": "A33AVAJ2PDY3EV",
"child_relationship_type": "variation"
}
],
"parentage_level": [
{
"value": "parent",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"item_name": [
{
"value": "Thinking Out Loud Patch Black Flexfit - 4REAL",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"product_description": [
{
"value": "Thinking Out Loud Patch Black Flexfit",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"brand": [
{
"value": "Hatstore",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"country_of_origin": [
{
"value": "BD",
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"batteries_required": [
{
"value": false,
"marketplace_id": "A33AVAJ2PDY3EV",
"language_tag": "tr_TR"
}
],
"variation_theme": [
{
"language_tag": "tr_TR",
"name": "SIZE",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"supplier_declared_material_regulation": [
{
"language_tag": "tr_TR",
"value": "not_applicable",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"recommended_browse_nodes": [
{
"language_tag": "tr_TR",
"value": "1981066031",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"fabric_type": [
{
"language_tag": "tr_TR",
"value": "63% Polyester, 34% Cotton, 3% Elastane",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"supplier_declared_dg_hz_regulation": [
{
"language_tag": "tr_TR",
"value": "not_applicable",
"marketplace_id": "A33AVAJ2PDY3EV"
}
],
"bullet_point": [
{
"language_tag": "tr_TR",
"value": "closed",
"marketplace_id": "A33AVAJ2PDY3EV"
}
]
}
}
]
}