API Reference

Planlı Rapor

Planlı Rapor Oluşturma

Giriş

Amazon'dan sipariş, ürün, satış ve kategori gibi verilerin mevcut olduğu raporları belirlediğiniz periyotlara göre almak için kullanılabileceğiniz metottur.

Planlı Rapor Oluşturma Aşamaları

Amazon'dan talep edeceğiniz planlı raporu almak için aşağıdaki adımları tamamlamanız gerekmektedir.

  1. Planlı Rapor Oluşturma Talebi
  2. Planlı Rapor Bildirimini Alma
  3. Planlı Rapor Dokümanını Alma

 Planlı Rapor Oluşturma Talebi

  1. 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öndermeniz gereklidir.

    İstek Limiti

❗️

 Bu servise 45 saniyede 1 defa istek gönderebilirsiniz.

🚧

Parametre Açıklamaları

DeğerAçıklama
reportTypeRapor türü değerleri için Rapor Türleri sayfasını inceleyebilirsiniz.
reportOptionsRapor özellikleri için Rapor Türleri sayfasındaki tabloda bulunan reportOptions değerlerini inceleyebilirsiniz.
dataStartTimeBelirli bir tarih aralığında raporu talep etmek için başlangıç tarihi bilgisi girebilirsiniz. Başlangıç tarihi, bitiş tarihi ile beraber gönderilmelidir. Başlangıç ve bitiş tarihi belirtilmediğinde, rapor en güncel tarihli bilgileri verir.
dataEndTimeBelirli bir tarih aralığında raporu talep etmek için bitiş tarihi bilgisi girebilirsiniz. Bitiş tarihi, başlangıç tarihi ile beraber gönderilmelidir. Başlangıç ve bitiş tarihi belirtilmediğinde, rapor en güncel tarihli bilgileri verir.
periodPlanlı rapor oluşturabilmek için belirleyeceğiniz süreyi temsil eder. Süre detaylarını incelemek için tıklayınız.

 Planlı Rapor Bildirimini Alma

  1. 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.
  2. 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.

📘

Rapor bildirimlerini almak için Notifications yöntemini kullanmalısınız.

    İstek Limiti

❗️

 Bu servise 1.5 dakikada 1 defa istek gönderebilirsiniz.

 Planlı Rapor Dokümanı Alma

  1. Planlı rapor dokümanını almak için, rapor doküman ID'si (reportDocumentId) ile birlikte Rapor Dokümanını Alma metodunu kullanarak işlem yapmanız gereklidir.

    İstek Limiti

❗️

 Bu servise 1.5 dakikada 1 defa istek gönderebilirsiniz.

Planlı Raporu Listeleme

Giriş

Planlı raporun süre, bir sonraki oluşturulma tarihi ve rapor türünü öğrenmek için kullanabileceğiniz metottur.

Planlı Rapor Listeleme Talebi

  1. Planlı raporu listelemek için, planlanan rapor ID'si (reportScheduledId) ile birlikte Planlı Rapor Listeleme metodunu kullanarak işlem yapmanız gereklidir.

İstek Limiti

❗️

Bu servise 45 saniyede 1 defa istek gönderebilirsiniz.

Planlı Raporu İptal Etme

Giriş

Planlı rapor oluşturma talebini iptal etmek için kullanılabileceğiniz metottur.

Planlı Rapor İptal Etme Talebi

  1. Planlı rapor talebini iptal etmek için, planlanlı rapor ID'si (reportScheduleId) ile birlikte Planlı Rapor İptal Etme Metodu ile işlem yapmanız gereklidir.

İstek Limiti

❗️

 Bu servise 45 saniyede 1 defa istek gönderebilirsiniz.

Planlı Rapor Oluşturma Değerleri ve Açıklamaları

🚧

Period

DeğerAçıklama
PT5M5 dakika
PT15M15 dakika
PT30M30 dakika
PT1H1 saat
PT2H2 saat
PT4H4 saat
PT8H8 saat
PT12H12 saat
P1D1 gün
P2D2 gün
P3D3 gün
PT84H84 saat
P7D7 gün
P14D14 gün
P15D15 gün
P18D18 gün
P30D30 gün
P1M1 ay

Önemli Notlar

📘

Ö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.