Rapor Oluşturma Süreci
Amazon'dan sipariş, ürün, satış ve kategori gibi verileri almak için rapor metotlarını kullanabilirsiniz. Rapor oluşturma süreci için aşağıdaki diagramı inceleyebilirsiniz.
Amazon sisteminde mağazanız için talep edebileceğiniz çeşitli rapor türleri bulunmaktadır. Bu rapor türlerini incelemek için tıklayınız.
Rapor Oluşturma
Talep edebileceğiniz rapor türlerine göre rapor oluşturmak için aşağıdaki adımları izleyebilirsiniz:
- Rapor talep etmek için, rapor türü (reportType) ve mağaza id (marketplaceIds) bilgilerini rapor oluşturma metodunu kullanarak göndermelisiniz.
- Raporun hazır olma durumunu kontrol etmek için, rapor ID'si (reportId) ile birlikte rapor listeleme metodundan işlem yapmalısınız.
- Rapor listeleme işlemi sonucunda iletilen rapor hazırlık durumunu (processingStatus) kontrol etmelisiniz. (“processingStatus": "DONE” gelmesi raporun hazır olduğu anlamına gelmektedir.) Raporun hazır olduğu durumda, işlem sonucunda raporun doküman ID’sini (reportDocumentId) bir sonraki adımda kullanmak üzere saklayınız.
- Raporu indirmek için, rapor doküman ID’sini belirterek rapor dokümanı alma metodunu kullanın. İşlem sonucunda dönen rapor linkini (url) bir sonraki adımda kullanmak üzere saklayınız.
- Rapor dokümanı alma metodunun sonucunda dönen rapor linkini (url) kullanarak raporu indirin.
Planlı Rapor Oluşturma
Önceden oluşturulmuş rapor planındaki aynı rapor türü (reportType), aynı mağaza id (marketplaceIds) ve farklı süre (period) bilgileri ile yeniden rapor talep edilirse; önceki plan iptal olacak ve güncel işlemde belirtilen süreye göre rapor yeni planda oluşturularak iletilecektir.
Talep edebileceğiniz rapor türlerine göre planlı rapor oluşturmak için aşağıdaki adımları izleyebilirsiniz:
- Planlı rapor talep etmek için, rapor türü (reportType), mağaza id (marketplaceIds) ve süre (period) bilgilerini planlı rapor oluşturma metodunu kullanarak göndermelisiniz.
- Talep ettiğiniz raporun hazır olma durumu REPORT_PROCESSING_FINISHED bildirimi ile iletilecektir. Bildirimi Amazon SQS kuyruğundan düzenli aralıklarla sorgulayabilirsiniz. Bir önceki adımda oluşturduğunuz süre aralığında sorgulama yapabilirsiniz.
- Sorgulama sonuçlanırsa, Amazon SQS kuyruğu sizlere raporun doküman ID’sini (reportDocumentId) iletecektir.
- Raporun hazır olduğu durumda, işlem sonucunda raporun doküman ID’sini (reportDocumentId) bir sonraki adımda kullanmak üzere saklayınız.
- Raporu indirmek için, rapor doküman ID’sini belirterek rapor dokümanı alma metodunu kullanın. İşlem sonucunda dönen rapor linkini (url) bir sonraki adımda kullanmak üzere saklayınız.
- Rapor dokümanı alma metodunun sonucunda dönen rapor linkini (url) kullanarak raporu indirin.
Önemli Notlar
Son aşamada indirilen raporlar Gzip formatındadır. Sıkıştırılmış rapor içeriklerini açarak, içinde bulunan dosyaları sisteminizde dilediğiniz gibi kullanabilirsiniz.
Süre (period) parametresinde gönderilebilecek değerlerin detayları için tıklayınız.