Amazon Sipariş Çekme Sorunları Rehberi
Hızlı özet: Amazon’da siparişleriniz panelinize düşmüyorsa, bunun nedeni çoğu zaman gerçek bir teknik arıza değil; SP-API yetkilendirmesinin süresinin dolması, eksik API rolü, PII verisi için ayrı bir token gerektiren senaryolar veya sorgu parametrelerindeki tarih aralığının yanlış ayarlanmasıdır. Bu yazıda sipariş çekme sorununun en sık dört nedenini ve teşhis sırasını ele alıyoruz.
1. SP-API Yetkilendirmesi (LWA Refresh Token) Süresi Dolmuş Olabilir
Amazon entegrasyonları, Login with Amazon (LWA) üzerinden alınan bir refresh token ile çalışır. Bu token geçersiz hale geldiğinde veya yetkilendirme iptal edildiğinde, sipariş çekme isteği sessizce başarısız olabilir — panelde açık bir hata mesajı görmeyebilirsiniz, sadece yeni siparişlerin düşmediğini fark edersiniz. Bu konuyu genel hatlarıyla Amazon Entegrasyonu Nedir? yazımızda da ele almıştık; burada asıl odak, bu sessiz kesintiyi nasıl teşhis edeceğinizdir. Çözüm, entegrasyon panelinizden Amazon yetkilendirmesini iptal edip yeniden bağlamak ve yeni bir refresh token oluşturmaktır.
2. Eksik API Rolü veya Yetki Kapsamı
Amazon Geliştirici Profili üzerinden başvurduğunuz uygulamanın belirli API rollerine (örneğin sipariş verisi rolüne) erişimi olması gerekir. Rol eksikse veya kısıtlı bir role erişim talebiniz onaylanmamışsa, sipariş uç noktasına yapılan istekler yetkisiz erişim hatası döner. Bu durumda geliştirici profilinizden ilgili rolü tekrar talep etmeniz ve rol eklendikten sonra uygulamanızı yeniden yetkilendirerek geçerli bir refresh token oluşturmanız gerekir.
3. PII Verisi İçin Ayrı Token (RDT) Gerekliliği
Alıcı adı, teslimat adresi gibi kişisel veriler (PII) standart erişim token’ı ile değil, Restricted Data Token (RDT) ile çekilir. Sipariş listesi genel olarak geliyor ama alıcı bilgileri eksik veya boş görünüyorsa, sorun genellikle burada gizlidir: sistem önce normal access token ile Tokens API üzerinden bir RDT talep etmeli, ardından sipariş detayını bu RDT ile çekmelidir. Bu iki aşamalı akış atlanırsa, PII alanları sessizce boş döner.
4. Tarih Aralığı Parametresi Sorunu
Sipariş çekme isteği başarılı (200 durum kodu) dönebilir ama sonuç listesi boş olabilir — bu bir hata değil, sorgu parametrelerinizin o tarih aralığında sipariş olmadığını gösterdiği anlamına gelir. En sık yapılan hata, sorgunun “oluşturulma tarihi” yerine “güncellenme tarihi” aralığına göre filtrelenmesi veya zaman diliminin (UTC/yerel saat) yanlış hesaplanmasıdır. Boş bir sonuç aldığınızda önce API’nin hata döndürüp döndürmediğini, sonra sorgu parametrelerini kontrol etmek, gereksiz yere yetkilendirme sorunuyla uğraşmanızı önler.
5. Sipariş Durumu Filtresi Yanlış Ayarlanmış Olabilir
Sipariş çekme isteğine uygulanan durum filtreleri (örneğin yalnızca “Unshipped” siparişleri getirme) bazı siparişlerin listeden dışarıda kalmasına neden olabilir. Bir siparişin panelde göründüğü halde entegrasyonunuza düşmediğini fark ederseniz, filtre parametrelerinin o siparişin durumunu kapsayıp kapsamadığını kontrol etmek gerekir.
Teşhis Sırası: Hangi Kontrolü Önce Yapmalısınız?
Önce API isteğinin bir hata kodu döndürüp döndürmediğine bakın; hata yoksa sorun muhtemelen tarih aralığı veya filtre parametrelerindedir. Hata “unauthorized” ise önce refresh token’ın geçerliliğini, ardından geliştirici profilinizdeki rol izinlerini kontrol edin. Alıcı bilgisi eksikse RDT akışının doğru çalışıp çalışmadığını doğrulayın. Bu sıralama, sorunun kaynağını tahmin etmek yerine birkaç dakika içinde daraltmanızı sağlar.
Pixa ile Amazon Sipariş Akışını Kesintisiz Tutmak
Pixa Lab’ın Amazon entegrasyonu, SP-API yetkilendirmesini düzenli olarak izler ve token süresi dolmadan önce yenileme sürecini yönetir; bu sayede sipariş akışının “sessizce” durması riskini ortadan kaldırır. Sipariş senkronizasyonu altyapımız her sipariş çekme işlemini log kaydına düşürür, böylece bir sorun yaşandığında bunun yetkilendirme mi, filtre mi yoksa tarih aralığı mı kaynaklı olduğunu geriye dönük olarak görebilirsiniz.
Sık Sorulan Sorular
Siparişlerim neden hiç hata almadan çekilmiyor?
API isteği başarılı dönüp sonuç listesi boş geliyorsa, bu genellikle bir hata değil, tarih aralığı veya durum filtresi parametrelerinizin o siparişleri kapsamadığı anlamına gelir.
Refresh token ne sıklıkla yenilenmeli?
Amazon’un belirlediği süreye göre periyodik yenileme gerekir; entegrasyon yazılımınızın bu süreci otomatik yönetip yönetmediğini kontrol etmeniz önerilir.
Alıcı adı ve adresi neden bazı siparişlerde eksik geliyor?
Bu tür kişisel veriler standart access token ile değil, ayrıca talep edilen bir Restricted Data Token (RDT) ile çekilir; bu ek adım atlanırsa PII alanları boş döner.
Yetkisiz erişim hatası aldığımda ilk ne kontrol etmeliyim?
Önce refresh token’ın geçerli olup olmadığını, ardından geliştirici profilinizde ilgili API rolüne erişiminiz olup olmadığını kontrol edin.
Panelde gördüğüm bir sipariş neden entegrasyonuma düşmüyor?
Sipariş çekme isteğinize uygulanan durum filtresi o siparişin durumunu kapsamıyor olabilir; filtre parametrelerini gözden geçirmeniz gerekir.
