Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Ç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:

  1. 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.
  2. API aracılığıyla konuma özgü envanterler paylaşın.
  3. SSA'nın izin verdiği mevcut şablonları oluşturun veya tanımlayın.
  4. 3. Adımda oluşturulan veya tanımlanan kargo şablonunu envanter eklediğiniz SKU'lara atayın. Bunu her konum için yapın.
  5. DEFAULT envanter kanalını 0 olarak ayarlayın.
  6. 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 kanala 0. Ayarlanamama DEFAULT kanala 0 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

ParametreAçıklamaZorunlu mu?
sellerIdSatıcı Müşteri Kimliği (MCID) veya Satıcı kodu gibi Satış Ortağı tanımlayıcısı.Evet
skuSatı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
issueLocaleNeden 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

AdValue
Acceptsapplication/json
Content-Typeapplication/json
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "StoreID1234567", "quantity": 10 } ] } ] }

❗️

Uyarı

Ayarlamalısın Product Type ve Path 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

AdAçıklamaZorunlu mu?
sellerIdSatıcı Müşteri Kimliği (MCID) veya Satıcı kodu gibi Satış Ortağı tanımlayıcısı.Evet
skuListeye özgü olan liste için SKU tanımlayıcısı sellerId.Evet

Sorgu parametreleri

AdAçıklamaZorunlu mu?
marketplaceIdsİstek için pazar yeri tanımlayıcılarının virgülle ayrılmış listesi.Evet
issueLocaleNeden 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

  1. Kullan GET Varsayılan konum için tek bir SKU miktarını bulma işlemi. Bu örnek şunları kullanır: ssnm001 Bir miktarı olan SKU 3 Tek bir tedarik kaynağında.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{ "sku": "ssnm001", "fulfillmentAvailability": [ { "fulfillmentChannelCode": "DEFAULT", "quantity": 3 } ] }
  1. Kullan PATCH çalıştırma ve ayarlama fulfillmentChannelCode doğru DEFAULT ve quantity doğru 0.
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": [] }
  1. Kullan getListingsItem değişiklikleri gönderme ve ayrıntıları alma işlemi fulfillmentAvailability.
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:

  1. Satıcı Merkezi hesabınıza giriş yapın.
  2. Sol üst köşede hamburger menüsünü seçin.
  3. Seçiniz Inventory ve seçin Manage All Inventory.
  4. 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

<?xml version="1.0" encoding="utf-8"?> <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

  1. İki SKU'lu bir besleme belgesi oluşturun ve ikisini de iki tedarik kaynağına atayın. Bu örnek şunları kullanır: ssnm001 ve ssnm002 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" }
  1. 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 } ] } } ] }
  1. Bir feed oluşturun.
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody); postman.setEnvironmentVariable("feedId", jsonData. feedId);
{ "feedId": "50037019429" }
  1. 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" }
  1. 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 } ] }
  1. Envanter miktarının Satıcı Merkezi'nde güncellendiğini doğrulamak için:

    1. Satıcı Merkezi hesabınıza giriş yapın.
    2. Sol üst köşede hamburger menüsünü seçin ve genişletin.
    3. Seçiniz Inventory ve seçin Manage All Inventory.
    4. SKU numarasını ve ilgili tedarik kaynaklarını kontrol edin.

Sorun giderme

Yetkilendirme hataları alırsanız, bkz. Yetkilendirme Hataları.


Bu sayfa size yardımcı oldu mu?