Çok Konumlu Envanter Entegrasyon Rehberi
Müşterilere konum düzeyinde veriler sağlamak için çoklu konum envanterini API'ler ve işlemlerle entegre edin.
Satıcılar, Amazon'a verileri ve gönderim yetenekleri için konum düzeyinde veriler sağlamak için çoklu konum envanterini kullanabilir. Satıcının gönderilen konum verileriyle eşleştirilen bu konum düzeyindeki veriler, müşterilerin incelemesi için kesin bilgiler oluşturur. Çok konumlu envanter, satıcıların hızını ve güvenilirliğini artırır ve hizmet maliyetini düşürür, teklifleri müşteriler için daha çekici hale getirir, MFN satışlarını artırır ve satıcı karını artırır. Bu kılavuz, Satış Ortaklarına, çok konumlu envanteri başarılı bir şekilde entegre etmek için zorunlu olan API'ler ve işlemler hakkında tavsiyelerde bulunur.
Çok konumlu envanter şu anda aşağıdakileri yapan satıcılar için mevcut değildir:
- FBA envanterini kullan
- Envanterlerini Seller Central ile yönetin
Ön koşullar
Satıcı hesabınızın çoklu konumlu envanteri kullanmak için gerekli izinlere sahip olması gerekir. Hesabınızda çoklu konum envanter izinleri yoksa, erişim talebinde bulunabilirsiniz Çok Konumlu Envanter Kayıt Formu. Hesabınızın 15 iş günü içinde hazır olduğuna dair onay alacaksınız.
Gerekli izinleri aldıktan sonra Amazon, varsayılan konumunuzu tedarik kaynağı olarak ekler. Ek konumlar oluşturmak için bir şablon kullandıysanız ve Kargo Ayarları Otomasyonu (SSA) buna izin verdiyse, bu konumlar tedarik kaynakları olarak da eklenir.
Satıcı hesabı kurulumunu tamamlamak için:
- Tedarik Kaynakları API'si veya Satıcı Merkezi kullanıcı arabirimi aracılığıyla yeni tedarik kaynakları oluşturun veya mevcut tedarik kaynaklarını güncelleyin.
- API aracılığıyla konuma özgü envanterler paylaşın.
- SSA'nın izin verdiği mevcut şablonları oluşturun veya tanımlayın.
- 3. Adımda oluşturulan veya tanımlanan kargo şablonunu envanter eklediğiniz SKU'lara atayın. Bunu her konum için yapın.
DEFAULT
envanter kanalını0
olarak ayarlayın.- Profilinize Satış Ortağı Analizleri rolü ekleyin.
Çok konumlu envanter entegrasyonu için zorunlu API'ler
Satış Ortakları entegre etmelidir Tedarik Kaynakları API'si, Listeler Öğeleri API'si, ve Beslemeler API'si çok konumlu envanteri kullanmak.
Seller Central'da SSA tarafından izin verilen çok konumlu envanter gönderim şablonları oluşturun
SSA tarafından izin verilen çok konumlu envanter kargo şablonlarının nasıl oluşturulacağını öğrenmek için bkz. Kargo Ayarları Otomasyonu.
Tedarik Kaynakları API'sini entegre edin
Çok konumlu envanter programının Tedarik Kaynakları API'si ile nasıl kullanılacağını öğrenmek için bkz. Tedarik Kaynakları API Kullanım Örneği Kılavuzu.
Listeler Öğeleri API'sini entegre edin
Satıcılar, bir tedarik kaynağında bulunan envanter sayısını değiştirmek için Listeleme Öğeleri API'sini kullanabilir. Listeleme Öğeleri API'si kabul eder PATCH
Mevcut bir liste için bir veya daha fazla bireysel özniteliği güncelleme ve silme işlemleri, örneğin price
ve quantity
.
Dikkat
Ayarlamalısınız
DEFAULT
kanala0
. AyarlanamamaDEFAULT
kanala0
listelenen iki teklifle sonuçlanır: bir çok konumlu envanter teklifi ve bir çok konumlu olmayan envanter teklifi. Bu sorun teklifin satın alınabilirliğini etkilemez, ancak çok konumlu olmayan envanter teklifi yanlış envanter ve gönderim zaman çizelgeleri gösterebilir.
Envanterinizi güncellemek için çok konumlu envanteri kullanın
Kullan PATCH
uç nokta ile işlem /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale}
, ardından aşağıdaki parametreleri iletin:
Yol parametreleri
Parametre | Açıklama | Zorunlu mu? |
---|---|---|
sellerId | Satıcı Müşteri Kimliği (MCID) veya Satıcı kodu gibi Satış Ortağı tanımlayıcısı. | Evet |
sku | Satıcı kimliğine özgü olan listenin SKU tanımlayıcısı. | Evet |
marketplaceIds | İstek için pazar yeri tanımlayıcılarının virgülle ayrılmış listesi. | Evet |
issueLocale | Neden metni yerelleştirmesi için bir yerel ayar. Sağlanmadığında, ilk pazaryerinin varsayılan dil kodu kullanılır. Örnekler: en_US , fr_CA , fr_FR . Belirtilen yerel ayarda yerelleştirme mevcut olmadığında yerelleştirilmiş mesajlar varsayılan olarak en_US ayarını kullanır. | Hayır |
Başlık parametreleri
Ad | Value |
---|---|
Accepts | application/json |
Content-Type | application/json |
{
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "StoreID1234567",
"quantity": 10
}
]
}
]
}
Uyarı
Ayarlamalısın
Product Type
vePath
aşağıdaki gibi:
Product Type
+PRODUCT
.Path
+/attributes/fulfillment_availability
.Bu değerlerin ayarlanmaması şunlara neden olabilir:
Bir hata veya uyarı yanıtı
Göz ardı edilebilecek veya Amazon sisteminin amaçlanan kısmına ulaşamayabilecek veriler. Bu, ilgili liste güncellemelerini ve envanter kullanılabilirliğini etkileyebilir
Verilerinizin varsayılan ayarlara göre geçersiz kılınması veya pazara özgü işlemlerle ilgili sorunlar gibi beklenmedik API davranışı
{
"sku": "SKUID1234567",
"status": "ACCEPTED",
"submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
"issues": []
}
{
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "ISPU01",
"quantity": 10
},
{
"fulfillment_channel_code": "ISPU02",
"quantity": 10
}
]
}
]
}
{
"header": {
"sellerId": "{merchantId}",
"version": "2.0",
"issueLocale": "en_US"
},
"messages": [
{
"messageId": 1,
"sku": "My-SKU-01",
"operationType": "PATCH",
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "ISPU01",
"quantity": 10
},
{
"fulfillment_channel_code": "ISPU02",
"quantity": 10
}
]
}
]
},
{
"messageId": 2,
"sku": "My-SKU-02",
"operationType": "PATCH",
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "ISPU01",
"quantity": 10
},
{
"fulfillment_channel_code": "ISPU02",
"quantity": 10
}
]
}
]
}
]
}
Envanterinizi görüntülemek için Listeleme Öğeleri API'sini kullanın
Satıcılar, tedarik kaynağında bulunan envanter sayısını görüntülemek için Listeleme Öğeleri API'sini kullanabilir. Arayın getListingsItem
bir liste öğesi hakkında ayrıntıları döndürme işlemi.
Kullan GET
uç nokta ile işlem /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale} &includedData=issues,attributes,summaries,offers,fulfillmentAvailability
ve aşağıdaki parametreleri iletin:
Yol parametreleri
Ad | Açıklama | Zorunlu mu? |
---|---|---|
sellerId | Satıcı Müşteri Kimliği (MCID) veya Satıcı kodu gibi Satış Ortağı tanımlayıcısı. | Evet |
sku | Listeye özgü olan liste için SKU tanımlayıcısı sellerId . | Evet |
Sorgu parametreleri
Ad | Açıklama | Zorunlu mu? |
---|---|---|
marketplaceIds | İstek için pazar yeri tanımlayıcılarının virgülle ayrılmış listesi. | Evet |
issueLocale | Neden metni yerelleştirmesi için bir yerel ayar. Sağlanmadığında, ilk pazaryerinin varsayılan dil kodu kullanılır. Örnekler: en_US , fr_CA , fr_FR . Belirtilen yerel ayarda yerelleştirme mevcut olmadığında yerelleştirilmiş mesajlar varsayılan olarak en_US ayarını kullanır. | İsteğe bağlı |
includedData | İstek için pazar yeri tanımlayıcılarının virgülle ayrılmış listesi. Tür: dizi (csv) | Hayır |
Başarılı bir yanıt şunları içerir: Fulfillment Availability
Tedarik Kaynağı Kimliğini döndüren array özniteliği (fulfillmentChannelCode
) ve kalan envanter sayısı (quantity
).
Tek tek SKU'lar için envanter atama
- Kullan
GET
Varsayılan konum için tek bir SKU miktarını bulma işlemi. Bu örnek şunları kullanır:ssnm001
Bir miktarı olan SKU3
Tek bir tedarik kaynağında.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{
"sku": "ssnm001",
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 3
}
]
}
- Kullan
PATCH
çalıştırma ve ayarlamafulfillmentChannelCode
doğruDEFAULT
vequantity
doğru0
.
PATCH: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 10
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 5
},
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 0
}
]
}
]
}
{
"sku": "ssnm001",
"status": "ACCEPTED",
"submissionId": "680b16163093417da2edfd77a7edc38f",
"issues": []
}
- Kullan
getListingsItem
değişiklikleri gönderme ve ayrıntıları alma işlemifulfillmentAvailability
.
GET:
{{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{
"sku": "ssnm001",
"fulfilmentAvailability": [
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 9
},
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 10
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 5
}
]
}
Yanıt, SKU'nun olduğunu doğrular ssnm001
ve bu envanter iki tedarik kaynağından birleştirilmiştir, Store A ve Store B.
Satıcı Merkezi'nde miktarın güncellendiğini doğrulayın:
- Satıcı Merkezi hesabınıza giriş yapın.
- Sol üst köşede hamburger menüsünü seçin.
- Seçiniz Inventory ve seçin Manage All Inventory.
- SKU numarasını ve ilgili tedarik kaynaklarını kontrol edin.
Satış ortakları tarafından Sipariş Gönderim feed'i aracılığıyla kullanılan tedarik kaynağı kimliğini alın
Sipariş Gönderme akışı Amazon'u alıcıdan ücret almaya, satıcı hesabına kredi vermeye ve alıcıya siparişin gönderildiğini bildirmeye yönlendirir.
Bu feed, bir satış ortağı tarafından kullanılan tedarik kaynağı kimliğini sağlar. Bunu almak için, Sipariş Gönderim feed'ini kullanmanız gerekir XML şeması.
Sipariş Gönderme akışı aracılığıyla birden fazla siparişi onaylayın
Bir siparişi veya sipariş grubunu kullanarak onaylamak için POST_ORDER_FULFILLMENT_DATA
besleme türü, eklemelisiniz CarrierCode
, ShippingMethod
, ve ShipperTrackingNumber
XML şeması içinde. Entegre edebilirsiniz POST_ORDER_FULFILLMENT_DATA
satıcı tarafından gönderilen siparişleri onaylamak için besleme türü.
XML örneği
<AmazonEnvelope
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.01</DocumentVersion>
<MerchantIdentifier>MerchantID</MerchantIdentifier>
</Header>
<MessageType>OrderFulfillment</MessageType>
<Message>
<MessageID>1</MessageID>
<OrderFulfillment>
<AmazonOrderID>7XX-XXXXXXX-XXXXXXX</AmazonOrderID>
<FulfillmentDate>2023-01-01T01:01:01+00:00</FulfillmentDate>
<FulfillmentData>
<CarrierCode>USPS</CarrierCode>
<ShippingMethod>USPS First Class Mail</ShippingMethod>
<ShipperTrackingNumber>1234567891011121314</ShipperTrackingNumber>
</FulfillmentData>
</OrderFulfillment>
</Message>
</AmazonEnvelope>
Satıcı Merkezi kullanıcı arayüzüne düzenli olarak yeni taşıyıcılar eklenir. Eğer CarrierCode
Kullanmak istediğiniz taşıyıcının değeri ile eşlenmemiş amzn-base XSD
dosya, kullan CarrierCode
değeri Other
ve taşıyıcı adını girin CarrierName
alan. Bu yöntemi kullanırsanız, Amazon'un paket gönderim güncellemelerini takip edemeyeceğini unutmayın.
XML'i gerekli bilgilerle oluşturduktan sonra, kullanabilirsiniz POST_ORDER_FULFILLMENT_DATA
Amazon'dan alıcıya siparişin gönderildiğini bildirmesini isteyen yem türü.
Toplu güncellemeler yapın
Feeds API'si toplu güncellemeler yapabilir. Her biri birden fazla gönderim güncelleştirmesi içeren iki SKU'lu örnek bir feed için bkz. Listeler Beslemeleri API'si.
Birden çok SKU için envanter atayın
- İki SKU'lu bir besleme belgesi oluşturun ve ikisini de iki tedarik kaynağına atayın. Bu örnek şunları kullanır:
ssnm001
vessnm002
SKU'lar.
POST: {{baseUrl}}/feeds/2021-06-30/documents
{
"contentType": "application/json; charset=UTF-8"
}
{
"feedDocumentId": "amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd489c9a.T20RL98XXLBHV9",
"url": "https://tortuga-prod-na.s3-external-1.amazonaws.com/&2FNinetyDays/amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd48f9c9a.T20RL98XXLBHV9?X"
}
- Tüm SKU'lar için tek bir JSON yükleyin ve her tedarik kaynağının envanter düzeyini ayarlayın.
PUT: {{FeedUrl}}
{
"header": {
"sellerId": "A1PP0FEH11RW77",
"version": "2.0"
},
"messages": [
{
"messageId": 1,
"sku": "ssnm002",
"operationType": "PATCH",
"patches": {
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 10
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 7
},
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 0
}
]
}
},
{
"messageId": 2,
"sku": "ssnm001",
"operationType": "PATCH",
"patches": {
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 5
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 8
},
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 0
}
]
}
}
]
}
- Bir feed oluşturun.
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody);
postman.setEnvironmentVariable("feedId", jsonData. feedId);
{
"feedId": "50037019429"
}
GET
besleme belgesi.
GET: {{baseUrl}}/feeds/2021-06-30/feeds/:feedId
{
"createdTime": "2023-03-12T21:23:02+00:00",
"processingStatus": "DONE ",
"marketplaceIds": ["ATVPDKIKX0DER"],
"feedId": "50037019429",
"feedType": "JSON_LISTINGS_FEED",
"createdTime": "2023-03-12T21:23:02+00:00",
"processingStartTime": "2023-03-12T21:23:02+00:00",
"resultFeedDocumentId": "amzn1.tortuga.4.na.55£45d82-9068-4386-bbdd-9d0b7330c2e1.T3HAQ94M1R94U6"
}
- Her iki SKU için de miktarları doğrulayın.
GET:
{{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{
"sku": "ssnm001",
"fulfillmentAvailability": [
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 15
},
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 10
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 5
}
]
}
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm002?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{
"sku": "ssnm002",
"fulfillmentAvailability": [
{
"fulfillmentchannelCode": "DEFAULT",
"quantity": 17
},
{
"fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3",
"quantity": 10
},
{
"fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0",
"quantity": 7
}
]
}
-
Envanter miktarının Satıcı Merkezi'nde güncellendiğini doğrulamak için:
- Satıcı Merkezi hesabınıza giriş yapın.
- Sol üst köşede hamburger menüsünü seçin ve genişletin.
- Seçiniz Inventory ve seçin Manage All Inventory.
- SKU numarasını ve ilgili tedarik kaynaklarını kontrol edin.
Sorun giderme
Yetkilendirme hataları alırsanız, bkz. Yetkilendirme Hataları.
Updated 27 days ago