Sık karşılaşılan sorunlar ve en iyi uygulamalar
Bu bölümde, geliştiricilerin MCF bağlayıcı entegrasyonları oluştururken sık karşılaştıkları sorun örneklerine değinecek ve bu sorunları atlatmaya yardımcı olabilecek en iyi uygulamalardan birkaçını açıklayacağız.
Sipariş durum güncellemelerini alma
Yaygın sorun: Geliştiriciler bazen tüm sipariş durumu güncellemelerinin bildirimlerini okumakta zorlanıyor.
En iyi uygulama: Sipariş durum güncellemelerini almak için aşağıdaki iki yöntemden birini kullanın:
1. API'yi çağırın: Siparişte bir son duruma [Tamamlandı, Kısmen Tamamlandı, İptal Edildi, Satılamaz] ulaşılana kadar sipariş durumu güncellemeleri için düzenli aralıklarla getOrder API'sini çağırın. Takip detayları İşleniyor, Tamamlandı ve Kısmen Tamamlandı durumlarında mevcut olduğu zaman yanıtta paylaşılır.
2. Bildirimlere abone olun: Bildirimlere abone olun ve FULFILLMENT_ORDER_STATUS olayını dinleyin. Sipariş durumunda her değişiklik olduğunda veya takip numarası oluşturulduğunda bir SQS sırasından okunması gereken bir bildirim gönderilir.
API çağırma, bir çekme mekanizmasıdır ve geliştiriciler API'leri çağırma sıklığının farkında olmayabilir. Burada önerdiğimiz uygulama, bildirimleri okumak ve yalnızca sipariş tamamlandıktan sonra sipariş detaylarının tamamı için getOrder API'sini çağırmaktır.
Bu yaklaşımı izleyerek neler yapabilirsiniz?
• API'leri sık sık çağırmak için gereken bant genişliğini azaltın.
• Erken takip detayları hakkında farkındalık kazanın.
• API çağrıları gecikmeyle gelebileceğinden gerçek zamanlı bildirimler alın.
• Varsa takip numaralarındaki güncellemelerin bildirimlerini alın.
En iyi uygulama: Sipariş durum güncellemelerini almak için aşağıdaki iki yöntemden birini kullanın:
1. API'yi çağırın: Siparişte bir son duruma [Tamamlandı, Kısmen Tamamlandı, İptal Edildi, Satılamaz] ulaşılana kadar sipariş durumu güncellemeleri için düzenli aralıklarla getOrder API'sini çağırın. Takip detayları İşleniyor, Tamamlandı ve Kısmen Tamamlandı durumlarında mevcut olduğu zaman yanıtta paylaşılır.
2. Bildirimlere abone olun: Bildirimlere abone olun ve FULFILLMENT_ORDER_STATUS olayını dinleyin. Sipariş durumunda her değişiklik olduğunda veya takip numarası oluşturulduğunda bir SQS sırasından okunması gereken bir bildirim gönderilir.
API çağırma, bir çekme mekanizmasıdır ve geliştiriciler API'leri çağırma sıklığının farkında olmayabilir. Burada önerdiğimiz uygulama, bildirimleri okumak ve yalnızca sipariş tamamlandıktan sonra sipariş detaylarının tamamı için getOrder API'sini çağırmaktır.
Bu yaklaşımı izleyerek neler yapabilirsiniz?
• API'leri sık sık çağırmak için gereken bant genişliğini azaltın.
• Erken takip detayları hakkında farkındalık kazanın.
• API çağrıları gecikmeyle gelebileceğinden gerçek zamanlı bildirimler alın.
• Varsa takip numaralarındaki güncellemelerin bildirimlerini alın.
Envanter senkronizasyonu
Yaygın sorun: Geliştiriciler, envanter mesajındaki envanter değerini yanlış okuduğundan veya envanteri düzgün bir şekilde senkronize etmeyi bilmediğinden aşırı satış ve stokların tükenmesi veya envanter fazlasıyla karşılaşılabiliyor.
En iyi uygulama: Amazon envanteriyle gerçek zamanlı senkronizasyon sağlayan ve tüm envanter değişikliklerini yansıtan FBA_INVENTORY_AVAILABILITY_CHANGES bildirimine abone olmanızı öneririz. Geliştiriciler, bildirimleri kaçırmamak için envanter seviyelerinin baştan uca anlık görüntüsünü sağlayan getInventorySummaries API'sini günde bir kez çağırmalıdır.
getInventorySummaries API'sini günde birden fazla çağırmak, API çağrıları arasında verilerin eskimesine neden olabilir ve önerilmez.
Yalnızca API kullanan geliştiriciler için şunları öneririz:
• Verilen ve iptal edilen siparişlere göre kendi dahili envanter kaydınızı tutun. Sonrasında, günde bir veya iki kez yapabileceğiniz envanter senkronizasyonu sırasında bu kaydın üzerine yazabilirsiniz.
• Envanter senkronizasyon işleri arasında aşırı satışı önlemek için belirli emniyet stok ayarlarıyla da çalışın.
Yalnızca eldeki envanterle (Amazon lojistik merkezlerinde bulunan) ilgileniyorsanız geliştiriciler yanıtta inventorySummaries.Fulfillable operasyonunu takip etmelidir.
Aktarılan/gelen ürünlerin muhasebesiyle ilgilenen geliştiriciler şu toplama işlemini yapmalıdır: [inventoryDetails.Fulfillable + inventoryDetails.inboundWorkingQuantity+inventoryDetails.inboundShippedQuantity+inventoryDetails.inboundReceivingQuantity].
Not: Aktarılan/gelen envanterin tahmini varış tarihi eldeki envanterden daha uzun olabilir.
En iyi uygulama: Amazon envanteriyle gerçek zamanlı senkronizasyon sağlayan ve tüm envanter değişikliklerini yansıtan FBA_INVENTORY_AVAILABILITY_CHANGES bildirimine abone olmanızı öneririz. Geliştiriciler, bildirimleri kaçırmamak için envanter seviyelerinin baştan uca anlık görüntüsünü sağlayan getInventorySummaries API'sini günde bir kez çağırmalıdır.
getInventorySummaries API'sini günde birden fazla çağırmak, API çağrıları arasında verilerin eskimesine neden olabilir ve önerilmez.
Yalnızca API kullanan geliştiriciler için şunları öneririz:
• Verilen ve iptal edilen siparişlere göre kendi dahili envanter kaydınızı tutun. Sonrasında, günde bir veya iki kez yapabileceğiniz envanter senkronizasyonu sırasında bu kaydın üzerine yazabilirsiniz.
• Envanter senkronizasyon işleri arasında aşırı satışı önlemek için belirli emniyet stok ayarlarıyla da çalışın.
Yalnızca eldeki envanterle (Amazon lojistik merkezlerinde bulunan) ilgileniyorsanız geliştiriciler yanıtta inventorySummaries.Fulfillable operasyonunu takip etmelidir.
Aktarılan/gelen ürünlerin muhasebesiyle ilgilenen geliştiriciler şu toplama işlemini yapmalıdır: [inventoryDetails.Fulfillable + inventoryDetails.inboundWorkingQuantity+inventoryDetails.inboundShippedQuantity+inventoryDetails.inboundReceivingQuantity].
Not: Aktarılan/gelen envanterin tahmini varış tarihi eldeki envanterden daha uzun olabilir.
Erken takip bilgilerine erişme
Yaygın sorun: Takip numaraları artık sipariş Nakliye Tamamlandı durumuna geçmeden de kullanılabilir.
En iyi uygulama: getOrder API'sini çağıran geliştiriciler, takip detaylarının yalnızca Tamamlandı veya Kısmen Tamamlandı durumlarındaki siparişler için kullanılabileceğini varsaymamalıdır. Takip detayları artık İşleniyor durumundaki siparişlerde de kullanılabilir.
Sipariş bildirimlerini dinleyen geliştiriciler için İşleniyor sipariş durumuyla taşıyıcı firma, paket numarası ve takip numarasının belirtildiği erken takip detaylarını içeren bir bildirim açık bir şekilde yayınlanır.
getOrder API'sini çağıran geliştiriciler, çoğu zaman takip detaylarını kullandıktan sonra siparişlerini Gönderildi olarak işaretler ancak bir lojistik merkezinde değişiklik olduğunda takip detayları da her zaman güncellenebilir. Siparişleri Gönderildi olarak işaretlerseniz hiçbir güncellemeden haberdar olmaz ve geçersiz takip detayları alırsınız.
Erken takip detayları ve varsa takip detayı güncellemeleri için olay gönderen FULFILLMENT_ORDER_STATUS bildirimlerini okuduğunuzdan emin olun. Bu yaklaşımla satıcılar siparişlerde her zaman doğru takip detaylarını alabilir.
En iyi uygulama: getOrder API'sini çağıran geliştiriciler, takip detaylarının yalnızca Tamamlandı veya Kısmen Tamamlandı durumlarındaki siparişler için kullanılabileceğini varsaymamalıdır. Takip detayları artık İşleniyor durumundaki siparişlerde de kullanılabilir.
Sipariş bildirimlerini dinleyen geliştiriciler için İşleniyor sipariş durumuyla taşıyıcı firma, paket numarası ve takip numarasının belirtildiği erken takip detaylarını içeren bir bildirim açık bir şekilde yayınlanır.
getOrder API'sini çağıran geliştiriciler, çoğu zaman takip detaylarını kullandıktan sonra siparişlerini Gönderildi olarak işaretler ancak bir lojistik merkezinde değişiklik olduğunda takip detayları da her zaman güncellenebilir. Siparişleri Gönderildi olarak işaretlerseniz hiçbir güncellemeden haberdar olmaz ve geçersiz takip detayları alırsınız.
Erken takip detayları ve varsa takip detayı güncellemeleri için olay gönderen FULFILLMENT_ORDER_STATUS bildirimlerini okuduğunuzdan emin olun. Bu yaklaşımla satıcılar siparişlerde her zaman doğru takip detaylarını alabilir.
Markasız paketleme (Boş Kutu) ve Amazon Lojistik'i engelleme özelliklerini kullanma
Yaygın sorun: Geliştiriciler, markasız paketlemeyi nasıl yapılandıracaklarını ve Amazon Lojistik özelliklerini nasıl engelleyeceklerini bilmiyor.
En iyi uygulama: MCF, ABD bölgesi içinde çoğu siparişi markasız paketleme ile teslim eder ancak bazı satıcılar tüm siparişlerin markasız paketleme ile teslim edilmesini talep edebilir.
Markasız paketler (Boş Kutu veya BB):
1. Markasız paketleri Yalnızca Boş Kutu (BB) SKU'lar olarak seçmek için SKU düzeyinde işaretleyin. Boş Kutu için uygun olan ürünlerinizi getFeatureInventory API'sini çağırarak görüntüleyebilirsiniz.
2. Yalnızca BB SKU'lar için hem markasız paketleri (Boş Kutu veya BB) hem de normal envanteri takip ettiğinizden emin olun.
3. Geçiş düğmesini satış kanalı düzeyinde ayarlayın ve gereken satış kanallarının BB envanterine her zaman baktığından emin olun. BB siparişleri oluşturun ve BB envanterini bu satış kanallarına iletin.
4. Sipariş çalışma düzeyinde, ürünlerin yalnızca markasız paketlerde teslimatını sağlamak için PREVIEW Order ve CREATE Order operasyonlarını Blank_Box=Required özellik kısıtlamasıyla çağırın.
Amazon Lojistik'i engelleme (AMZL Engelle veya BAMZL):
Seller Central ve Tedarik zinciri portalları, %5'lik ek ücretle bir satıcı hesabının pazaryeri düzeyinde tüm siparişler için açılabilen bir AMZL Engelle ayarı sunar. Belirli siparişlerde AMZL Engelle kullanması gereken geliştiriciler aşağıdaki yapılandırma adımlarını uygulayabilir:
1. Gerekli satış kanallarındaki siparişlerin Amazon Lojistik tarafından teslim edilmesini önlemek için geçiş düğmesini satış kanalı düzeyine getirin. Bu kanallar için BAMZL talimatları oluşturun.
2. Sipariş çalışma düzeyinde, ürünleri Amazon Lojistik'ten başka bir taşıyıcı firmanın gönderdiğinden emin olmak için PREVIEW Order ve CREATE Order operasyonunu Block_AMZL=Required özellik kısıtlamasıyla çağırın.
En iyi uygulama: MCF, ABD bölgesi içinde çoğu siparişi markasız paketleme ile teslim eder ancak bazı satıcılar tüm siparişlerin markasız paketleme ile teslim edilmesini talep edebilir.
Markasız paketler (Boş Kutu veya BB):
1. Markasız paketleri Yalnızca Boş Kutu (BB) SKU'lar olarak seçmek için SKU düzeyinde işaretleyin. Boş Kutu için uygun olan ürünlerinizi getFeatureInventory API'sini çağırarak görüntüleyebilirsiniz.
2. Yalnızca BB SKU'lar için hem markasız paketleri (Boş Kutu veya BB) hem de normal envanteri takip ettiğinizden emin olun.
3. Geçiş düğmesini satış kanalı düzeyinde ayarlayın ve gereken satış kanallarının BB envanterine her zaman baktığından emin olun. BB siparişleri oluşturun ve BB envanterini bu satış kanallarına iletin.
4. Sipariş çalışma düzeyinde, ürünlerin yalnızca markasız paketlerde teslimatını sağlamak için PREVIEW Order ve CREATE Order operasyonlarını Blank_Box=Required özellik kısıtlamasıyla çağırın.
Amazon Lojistik'i engelleme (AMZL Engelle veya BAMZL):
Seller Central ve Tedarik zinciri portalları, %5'lik ek ücretle bir satıcı hesabının pazaryeri düzeyinde tüm siparişler için açılabilen bir AMZL Engelle ayarı sunar. Belirli siparişlerde AMZL Engelle kullanması gereken geliştiriciler aşağıdaki yapılandırma adımlarını uygulayabilir:
1. Gerekli satış kanallarındaki siparişlerin Amazon Lojistik tarafından teslim edilmesini önlemek için geçiş düğmesini satış kanalı düzeyine getirin. Bu kanallar için BAMZL talimatları oluşturun.
2. Sipariş çalışma düzeyinde, ürünleri Amazon Lojistik'ten başka bir taşıyıcı firmanın gönderdiğinden emin olmak için PREVIEW Order ve CREATE Order operasyonunu Block_AMZL=Required özellik kısıtlamasıyla çağırın.
Yetkilendirme akışını herkese açık bir uygulamada test etme
Yaygın sorun: Geliştiriciler, uygulamalarını Seller Central'da yayınlamadan veya listelemeden önce satıcı kimlik doğrulama akışlarını nasıl test edeceklerini bilmiyor.
En iyi uygulama: Geliştiriciler, uygulamalarını yayınlamak zorunda kalmadan bir test satıcı hesabının kimlik doğrulama akışını doğrulayabilir. Hem Seller Central hem de web mağazası kimlik doğrulama akışı için Seller Central onay URL'sine "version=beta" ekleyerek kimlik doğrulama akışınızı test edin. Not: Beta modunda yalnızca doğrulama amacıyla kullanıldığı için en fazla 25 satıcı uygulamayı yetkilendirebilir.
Örneğin:
https://sellercentral.amazon.com/apps/authorize/consent?application_id=appidexample&state=stateexample&version=beta
En iyi uygulama: Geliştiriciler, uygulamalarını yayınlamak zorunda kalmadan bir test satıcı hesabının kimlik doğrulama akışını doğrulayabilir. Hem Seller Central hem de web mağazası kimlik doğrulama akışı için Seller Central onay URL'sine "version=beta" ekleyerek kimlik doğrulama akışınızı test edin. Not: Beta modunda yalnızca doğrulama amacıyla kullanıldığı için en fazla 25 satıcı uygulamayı yetkilendirebilir.
Örneğin:
https://sellercentral.amazon.com/apps/authorize/consent?application_id=appidexample&state=stateexample&version=beta
MCF geliştiricileri için önemli raporları alma
Yaygın sorun: Geliştiriciler, Raporlar API'mizi kullanarak alabilecekleri raporlardan haberdar değil.
En iyi uygulama: MCF geliştiricilerine yönelik önemli raporları almak için aşağıdaki çağrı bilgilerini kullanın.
MCF geliştiricileri için önemli raporlar:
• Liste kaydı raporları: Bir satıcı hesabının ürün liste kaydı verilerini almak için kullanılır.
GET_FLAT_FILE_OPEN_LISTINGS_DATA ve GET_MERCHANT_LISTINGS_ALL_DATA
• Envanter raporları: Amazon lojistik merkezlerindeki envanter hareketlerini takip etmek için kullanılır.
GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA ve GET_LEDGER_SUMMARY_VIEW_DATA
• Siparişler/Satış raporları: Amazon tarafından gönderilen tüm siparişleri ve nakliye verilerini almak için kullanılır.
GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL ve GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL
En iyi uygulama: MCF geliştiricilerine yönelik önemli raporları almak için aşağıdaki çağrı bilgilerini kullanın.
MCF geliştiricileri için önemli raporlar:
• Liste kaydı raporları: Bir satıcı hesabının ürün liste kaydı verilerini almak için kullanılır.
GET_FLAT_FILE_OPEN_LISTINGS_DATA ve GET_MERCHANT_LISTINGS_ALL_DATA
• Envanter raporları: Amazon lojistik merkezlerindeki envanter hareketlerini takip etmek için kullanılır.
GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA ve GET_LEDGER_SUMMARY_VIEW_DATA
• Siparişler/Satış raporları: Amazon tarafından gönderilen tüm siparişleri ve nakliye verilerini almak için kullanılır.
GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL, GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL ve GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL
Korumalı alan erişimi için kimlik bilgilerini tutma
Yaygın sorun: Geliştiriciler, Dinamik Korumalı Alan ortamı ve Üretim ortamı için farklı uygulama kimlik bilgileri istiyor.
Hem özel hem de herkese açık uygulamalar için erişim yalnızca Dinamik Korumalı Alan ortamı için sınırlandırılabilir. Ancak Üretim onaylı tüm uygulamalar, hem Üretim hem de Korumalı Alan uç noktalarına erişebilir ve bu erişimi kısıtlamanın bir yolu yoktur.
En iyi uygulama: Geliştiriciler, bu sorunu çözmek için Korumalı Alan ve Üretim ortamlarında TASLAK durumunda farklı özel uygulamalar oluşturabilir ve iki ayrı istemci kimlik bilgisi için ürünleri yalnızca Üretim ortamında listeleyebilir.
Hem özel hem de herkese açık uygulamalar için erişim yalnızca Dinamik Korumalı Alan ortamı için sınırlandırılabilir. Ancak Üretim onaylı tüm uygulamalar, hem Üretim hem de Korumalı Alan uç noktalarına erişebilir ve bu erişimi kısıtlamanın bir yolu yoktur.
En iyi uygulama: Geliştiriciler, bu sorunu çözmek için Korumalı Alan ve Üretim ortamlarında TASLAK durumunda farklı özel uygulamalar oluşturabilir ve iki ayrı istemci kimlik bilgisi için ürünleri yalnızca Üretim ortamında listeleyebilir.
