API Reference

Kolay Gönderi Etiket Alma

Giriş

Kolay Gönderi, Amazon tarafından belirlenen kargo firmaları ile gönderim yapabileceğiniz kargolama sürecidir. Kolay Gönderi etiket alma sürecini aşağıdaki aşamaları tamamlayarak yönetebilirsiniz.


📘

Kolay Gönderi etiket alma API koleksiyonu 7 ana istekten oluşur.


İstek Limitleri

❗️

ServisLimit
Etiket Doküman Linki Oluşturma Metodu1 dakikada 30 defa
Etiket İşlem Talebi Gönderme Metodu2 dakikada 1 defa
Etiket İşlem Kontrolü Metodu1 dakikada 120 defa
Etiket İşlem Doküman Alma Metodu1 dakikada 1 defa
Etiket İşlem Rapor Getirme Metodu1 dakikada 120 defa
Etiket İşlem Raporu Alma Metodu1 dakikada 1 defa

Kolay Gönderi Etiket Alma Aşamaları

  1. Kolay gönderi etiketini alabilmek için öncelikle XML formatında yükleyeceğiniz dokümanın Amazon linkini almanız gereklidir. Amazon tarafından iletilen linki Etiket Doküman Linki Oluşturma metodu ile alabilirsiniz.
    1. İşlem sonucunda doküman ID’sini (feedDocumentId) ve doküman URL'ini (URL) daha sonraki adımlarda kullanmak üzere saklayınız.
  2. Oluşturduğunuz XML formatındaki dosyayı 1. adımda aldığınız doküman URL'ine (URL) istek atarak gönderebilirsiniz. Etiket Alma Doküman Yükleme Metodu ile gönderimi sağlayabilirsiniz.
    1. XML formatındaki dosya içeriğini raw data olarak body içerisinde göndermelisiniz.
  3. feedType, etiket alma yönteminin formatını belirten parametredir. Etiket Alma işlem talebinizi feedType parametresi ile birlikte iletebilirsiniz. Etiket Alma İşlem Talebi Gönderme Metodu ile gönderimi sağlayabilirsiniz.
    1. inputFeedDocumentId parametresine Amazon tarafından iletilen linkteki doküman ID’sini (feedDocumentId) eklemeniz gereklidir. Bu değer ilk adım olan Etiket Doküman Linki Oluşturma adımında elde edilmiştir.
    2. İstek içerisinde yer alan feedType değerini gerçekleştireceğiniz operasyon çeşitliliğine göre göndermeniz gerekmektedir. Kolay Gönderi Etiket Alma süreci kapsamında bu değerin 'POST_EASYSHIP_DOCUMENTS' olarak gönderilmesi gerekmektedir.
  4. Talep ettiğiniz dokümanın hazır olma durumunu kontrol edip sonuçlanan doküman ID'sini (resultFeedDocumentId) alabilirsiniz:
    1. Etiket alma İşlem Kontrolü Metodu metodunu kullanarak, işlem sonucunda bulunan processingStatus parametresinden dokümanın hazır olma durumunu kontrol edebilirsiniz.
    2. Sonuç içerisinde bulunan processingStatus: "DONE" olduğu durumda resultFeedDocumentId bilgisini alarak bir sonraki adıma geçebilirsiniz.
  5. Dokümanı indirmek için, sonuçlanan doküman ID’sini (resultFeedDocumentId) belirterekEtiket Alma İşlem Doküman Alma Metodu metodunu kullanmanız gereklidir.
    1. İşlem sonucunda dönen doküman linkinden (URL) sıkıştırılmış veriyi alabilmek adına sonuçtaki URL'i , GET isteğiyle çağırmanız gerekmektedir. Bu URL'e istek yalnızca bir kere atılabildiği için sonuçta dönen reportId değerini daha sonra tekrar kullanmak istemeniz adına saklayınız.
  6. Oluşturulan dokümandan ilgili raporu almak için kullanılan istektir. Bir önceki adımda oluşturulan doküman URL'inden alınan DocumentReportReferenceID değeriyle reportDocumentId değerini almanızı sağlayan istektir. reportDocumentId değerini almak için Etiket Alma Rapor Getirme Metodu 'nu kullanabilirsiniz.
  7. Etiket Alma Rapor Getirme adımında alınan reportDocumentId parametresi ile birlikte; ilgili etiketin URL'ini almanızı sağlar. İlgili etiketin URL'ini almak için Etiket Alma Rapor Alma Metodu'nu kullanınız.
    1. Response'ta GZIP formatında gönderilen URL'deki veriyi işleyerek ilgili etiket'e ulaşabilirsiniz.

Amazon Kargo Etiketi Spesifikasyonları ve Uygulama Rehberi


1.Format Kısıtlamaları

• Amazon etiketleri standart olarak PDF formatında sunulmaktadır
• Alternatif formatlar için geliştiriciler self servis olarak (ZPL, PNG vb.) özel etiket oluşturulabilir.
• İş gereksinimleriniz nedeniyle de kendi etiketinizi üretmeyi tercih edebilirsiniz.

2.Özel Etiket Oluşturma Prosedürü


2.1 Tracking Numarası Alma
Kolay Gönderi Sorgulama Metodu ile takip numarasını almanız gerekmektedir.

2.2 Barkod Oluşturma
• Alınan tracking numarası ile linear barcode generasyonu yapılmalıdır.

2.3 Etiket Kompozisyonu
Generated barkoda ek olarak aşağıdaki parametreler için:
o Operasyon tarafından anlaşılabilmesi için Amazon Kolay gönderi olduğu bilgisi eklenmesini,
o Alıcı bilgisi,
o Kargo firmasının isminin eklenmesini öneriyoruz.
o Tercihinize bağlı olarak; custom business datalarınızı ekleyebilir ve düzenlemelerinizi yapabilirsiniz.


3.Implementation ve Test
Oluşturulan etiketin kargo firması tarafından scanning validasyonu ve uyumluluk kontrolü yapılmalıdır. Örnek bir test gönderisi üzerinden yapabilirsiniz.


4.Önemli Notlar
• Test sürecinde farklı kargo firmaları ile uyumluluk kontrol edilmeli.
• Barkod kalitesi düzenli olarak test edilmeli.
• Rate limit aşımlarına dikkat edilmeli.
• Daha detaylı bilgi için Amazon SP API dokümantasyonuna başvurulmalıdır.