getSalesByDateRange

SaleServiceResponse getSalesByDateRange(String apiKey, String sign, long time, Boolean withData, String byStatus, String byUser, String orderBy, String orderType, String startDate, String endDate, Int pageNumber, Int pageSize, String lang);

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
withData: Boolean 
    true: Listelenen ürünler tüm bilgileri ile birlikte listelenir.
    false: Sadece satış kodları listelenir.
byStatus: String 
    Durum parametresi(filtresi)

    S: Kargo Yapılacaklar
    C: Onay Bekleyenler
    P: Para transferleri
    O: Tamamlananlar
    V: Aktif Satışlar
    I: İptali beklenenler
    R: İptal olanlar / İade konumunda olanlar
byUser: String
    Kullanıcı filtresi. 
orderBy: String
    Sıralama filtresi

    P: Satış koduna göre sıralama
    C: Satış fiyatına göre sıralama
    A: Son harekete göre sıralama 
orderType: String
    İstekte bulunduktan sonra dönen cevapların ID'lerinin artan ya da azalan sırada dönmesini sağlar.

    orderType=A ise artarak,
    orderType=D ise azalarak dönüş yapılır. 
startDate: String
    Başlangıç tarihi.
endDate: String
    Bitiş tarihi. 
pageNumber: Int
    Kaçıncı sayfadan başlayacak?
pageSize: Int
    Kaç kayıt listelenecek?
lang: String
    Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.

    Hata mesajı lang=tr ise Türkçe,
    lang=en ise İngilizce olarak çıkar.

<sale:getSalesByDateRange>
   <apiKey>BVFMj7BXV5fEEuVh8KEAgMAeJMRNDJY6</apiKey>
   <sign>911220D6AC85518590CE70D8FFFBF4E3</sign>
   <time>1586254267097</time>
   i<withData>true</withData>
   <byStatus>R</byStatus>
   i<byUser></byUser>
   i<orderBy>P</orderBy>
   i<orderType>A</orderType>
   <startDate>01/09/2021 00:00:00</startDate>
   <endDate>30/09/2021 23:59:00</endDate>
   <pageNumber>1</pageNumber>
   <pageSize>1</pageSize>
   i<lang>tr</lang>
</sale:getSalesByDateRange>

saleCount: Int
    Dönen işlem sayısı.

saleCode: String
    Satış kodu.
status: String
    İşlemin bulunduğu statünün açıklaması.
statusCode: String
    İşlemin bulunduğu statü.
productId: Int
    Ürün tekil anahtarı.
productTitle: String
    Ürün başlığı.
price: String
    Ürün fiyatı.
cargoPayment: String
    Kargo ücretini hangi tarafın ödeyeceğini belirtir.
cargoCode: String
    Grup Gönderi Kodu(GGK).
amount: Int
    Adet.
endDate: String
    Ürün bitiş tarihi.
thumbImageLink: String
    Ürün fotoğrafı.
lastActionDate: String
    Son hareket tarihi.

buyerInfo: orderBuyerInfoType
    Alıcı bilgileri.

    username: String
        Kulanıcı adı.
    name: String
        Adı.
    surname: String
        Soyadı.
    phone: String
        Telefon numarası.
    mobilePhone: String
        Cep telefonu numarası.
    email: String
        E-mail adresi. (Bu alanın dönmesi için Müşteri Hizmetleri üzerinden e-fatura mükellefi olan satıcılar talep oluşturmalıdır.)
    address: String
        Adres.
    district: String
        İlçe.
    city: String
        İl.
    zipCode: Int
        Posta kodu.

invoiceInfo: aleInvoiceType (Sadece alıcı fatura bilgilerini doldurduğunda döner.)
    Alıcının fatura bilgileri.

    fullname: String
        Ad soyad.
    address: String
        Adres.
    district: String
        İlçe.
    cityCode: Int
        Şehir kodu.
    zipCode: Int
        Posta kodu.
    phoneNumber: String
        Telefon numarası.
    companyTitle: String
        Şirket ünvanı.
    tcCertificate: String
        Tc kimlik no/ Vergi no.

    taxOffice: String
        Vergi Dairesi Adı
    taxNumber: String
        Vergi Kimlik Numarası

variantId: Long
    Varyanta ait tekil anahtar.
itemId: String
    Satışa konulan ürünün entegrasyon yapan firma tarafındaki takip kodu.

Sözleşmeli kargolar için parametreler > shippingInfo:

deliveryOption: String
   Kargolama yöntemi.
   REGULAR: Normal gönderi
   SAME_DAY_DELIVERY: Aynı gün teslimat
   NEXT_DAY_DELIVERY: Ertesi gün teslimat.
shippingFirmName: String
   Sözleşmeli kargo adı.
shippingFirmId: Int
   Sözleşmeli kargoya ait numara.
combinedShipping: String
   Birlikte gönderilmesi gereken siparişler varsa (combined) 'Y' döner yoksa 'N' döner.
shippingPaymentType: shippingPaymentType
   Kargo ücreti tipi.
   BUYER: Alıcı kapıda öder.
   SELLER: Satıcı kargo firmasına öder. 
   PAY_IN_THE_BASKET: Alıcı sepette ödedi.
   PLATFORM: GG öder. (Satıcı GittiGidiyor'a Öder)
cargoCode: String
   Birlikte gönderilmesi gereken (combined) siparişleri kargoya vermek için kullanılacak kod bu alanda dönülecektir.
shippingNotice: String
   Sadece birlikte gönderilmesi gereken siparişlerde döner. Combined bildirimi.
combinedSaleCodes: String
   Birlikte gönderilmesi gereken siparişlere ait satış kodları.
shippingExpireDate: String
   Kargolama bitiş tarihi.

statusCode açıklamaları:

STATUS_WAITING_CARGO_INFO : Satıcının kargo bilgilerini girmesi bekleniyor.
STATUS_WAITING_APPROVAL : Satıcı kargo bilgilerini girdi. Alıcının onay vermesi bekleniyor.
STATUS_APPROVED : İşlem alıcı ya da GG tarafından otomatik onaylandı.
STATUS_FRAUD_REPORTED : Alıcı üründe sorun yaşadığını bildirdi.
STATUS_GIVEN_BACK_PRODUCT : Alıcı ürünü iade etti ve iade kargo bilgilerini girdi. Satıcının iade onayı vermesi bekleniyor.
STATUS_GIVEN_BACK_PAYMENT : İşlem iptal ile sonuçlandı. Alıcıya para iadesi yapıldı.
STATUS_PROVISION_CC_CHECK : Alıcının yaptığı ödeme güvenliği için kotrol ediliyor.
STATUS_EARLY_CANCEL_REQUESTED : Alıcı kargolanmamış ürün için iptal talep etti.
STATUS_EARLY_CANCEL_ACCEPTED : Satıcı alıcının kargolanmamış ürün için iptal talebini kabul etti.
STATUS_INSTANT_REFUNDED : İşlem hızlı iade kapsamında iptal edildi.
STATUS_COOLING_OFF_PERIOD_REQUESTED : Alıcı onaylanmış işlemde sorun bildirdi.
STATUS_COOLING_OFF_PERIOD_SHIPPING_SENT_BACK : Alıcı onaylanmış için iade kargo bilgisi bildirdi.
STATUS_COOLING_OFF_PERIOD_SELLER_APPROVED : Satıcı onaylanmış işlemde iade ürünün kendisine geldiğini onayladı.
STATUS_COOLING_OFF_PERIOD_SELLER_CHARGEBACK_CLAIM : Satıcı onaylanmış işlemde iade işlemine onay verdi ya da işlem GG tarafından otomatik iptal edildi.
STATUS_INSTANT_REFUND_AFTER_SHIPPING_WAITING_APPROVAL : Alıcı hızlı iade talep etti.
STATUS_INSTANT_REFUND_AFTER_SHIPPING : İşlem için hızlı iade talebi onaylandı. Ürün bedeli iade edilecek.

<sale:getSalesByDateRangeResponse xmlns:sale="http://sale.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>07/04/2020 13:54:03</responseTime>
      <timeElapsed>83 ms</timeElapsed>
      <saleCount>1</saleCount>
      <sales>
         <sale>
            <saleCode>SC123456789</saleCode>
            <status>Satıcının kargo bilgilerini sisteme girmesi bekleniyor</status>
            <statusCode>STATUS_WAITING_CARGO_INFO</statusCode>
            <productId>123456789</productId>
            <productTitle>__ggtest Deneme API Ürünü</productTitle>
            <price>2899.0</price>
            <cargoPayment>Satıcı Öder</cargoPayment>
            <cargoCode>GGK12345678</cargoCode>
            <amount>1</amount>
            <endDate>27/09/2022 08:42:01</endDate>
            <buyerInfo>
               <username>GittiGidiyor</username>
               <name>Gitti</name>
               <surname>Gidiyor</surname>
               <phone>850-2523229</phone>
               <mobilePhone>850-2523229</mobilePhone>
               <email>api.destek@gittigidiyor.com</email>
               <address>My Office İş Mrkz., Çiğdem Sk., No: 1/14, 34746 Barbaros Mah., Ataşehir, İstanbul</address>
               <district>Ataşehir</district>
               <city>İstanbul</city>
               <zipCode>34746</zipCode>
            </buyerInfo>
            <thumbImageLink>https://mcdn201.gittigidiyor.net/123456/tn9/123456789_tn9_0.jpg</thumbImageLink>
            <lastActionDate>29/09/2021 23:50:00</lastActionDate>
            <variantId>0</variantId>
            <moneyDate>29/09/2021 23:49:44</moneyDate>
            <itemId>12345678</itemId>
            <shippingInfo>
               <shippingFirmName>yurtici</shippingFirmName>
               <combinedShipping>N</combinedShipping>
               <shippingPaymentType>SELLER</shippingPaymentType>
               <cargoCode>SC123456789</cargoCode>
               <shippingExpireDate>08/10/2021 23:49:44</shippingExpireDate>
            </shippingInfo>
         </sale>
      </sales>
      <nextPageAvailable>true</nextPageAvailable>
   </return>
</sale:getSalesByDateRangeResponse>

Siparişte gönderilmesi gereken tek ürün varsa 'shippingInfo' aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   <shippingFirmId>25</shippingFirmId>
   <combinedShipping>N</combinedShipping>
   <shippingPaymentType>PAY_IN_THE_BASKET</shippingPaymentType>
   <cargoCode>SC115713918</cargoCode>
   <shippingExpireDate>25/12/2020 23:59:59</shippingExpireDate>
</shippingInfo>

Birlikte gönderilmesi gereken siparişler varsa shippingInfo aşağıdaki bilgileri döner. 

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   <shippingFirmId>25</shippingFirmId>
   <combinedShipping>Y</combinedShipping>
   <shippingPaymentType>PAY_IN_THE_BASKET</shippingPaymentType>
   <cargoCode>GGK90307978</cargoCode>
   <shippingNotice>SC115713830,SC115713831 siparişlerini GGK90307978 kargo kodu ile birlikte göndermelisiniz.</shippingNotice>
   <combinedSaleCodes>
      <saleCode>SC115713830</saleCode>
      <saleCode>SC115713831</saleCode>
   </combinedSaleCodes>
   <shippingExpireDate>25/12/2020 23:59:59</shippingExpireDate>
</shippingInfo>

deliveryOption: 
SAME_DAY_DELIVERY dönerse aynı gün teslimat,
NEXT_DAY_DELIVERY dönerse ertesi gün teslimat,
REGULAR dönerse normal gönderidir.

shippingPaymentType:
BUYER ise alıcı kargo firmasına öder,
SELLER ise satıcı kargo firmasına öder,
PAY_IN_THE_BASKET ise alıcı sepette ödedi,
PLATFORM ise GG öder (Satıcı GittiGidiyor'a Öder).

Hata Kodu
Mesaj
Çözüm
	

    
129
    
rowCount parametresi 100 den büyük olamaz
    
pageSize parametresine 1-100 arasında bir değer girişi yapabilirsiniz.


    
134
    
Lütfen sıralamak için P (ürünId ye göre) - C (satış fiyatına göre) - A (son harekete göre) parametrelerinden birini kullanınız giriniz.
    
orderBy alanı için hatalı veya geçersiz parametre girişi yapılmış olabilir. Sıralamak için P (ürünId ye göre) - C (satış fiyatına göre) - A (son harekete göre) parametrelerinden birini kullanabilirsiniz.


    
146
    
Ödeme bekleyenler için (T) | Kargo yapılacaklar için (V) | Onay bekleyenler için (P) | Para transferleri için (A) | İade konumundakiler için (S) | Tamamlananlar için (R) parametresini girmelisiniz
    
byStatüs alanı için hatalı veya geçersiz parametre girişi  yapılmış olabilir.  S: Kargo Yapılacaklar | C: Onay Bekleyenler | P: Para transferleri | O: Tamamlananlar | V: Aktif Satışlar | I: İptali beklenenler | R: İptal olanlar / İade konumunda olanlar.
	

    
147
    
Lütfen azalan sırada listelemek için (D) | artan sırada listemek için (A) kullanınız
    
orderType alanı için hatalı veya geçersiz parametre girişi  yapılmış olabilir.  Azalan sırada listelemek için (D) | artan sırada listemek için (A) kullanınız.
	

    
780
    
Geçersiz başlama tarihi. Lütfen kontrol edip tekrar deneyiniz
    
startDate parametesi içerisinde gönderdiğiniz tarih bilgisi boş veya hatalı olabilir. Tarih bilgisi (Y-m-d H:i:s) şekinde olmalıdır. Girdiğiniz değeri kontrol ederek tekrar deneyiniz.
	

    
781
    
Geçersiz bitiş tarihi. Lütfen kontrol edip tekrar deneyiniz.
    
endDate parametesi içerisinde gönderdiğiniz tarih bilgisi boş veya hatalı olabilir.Tarih bilgisi (Y-m-d H:i:s) şekinde olmalıdır Girdiğiniz değeri kontrol ederek tekrar deneyiniz.


    
782
    
Başlangıç tarihi bitiş tarihinden sonra olamaz.
    
startDate parametesi içinde gönderdiğiniz tarih endDate içinde yer alan tarihten sonra olmaması gerekmektedir. Girdiğiniz değeri kontrol ederek tekrar deneyebilirsiniz.


    
1072
    
Sayfa numarası birden küçük veya boş olamaz.
    
pageNumber parametresi birden küçük veya boş gönderilmemeldidir. Girdiğiniz bilgiyi kontrol ediniz.


    
1073
    
Sayfa boyutu birden küçük veya boş olamaz.
    
pageSize kısmı 1 den küçük ve boş gönderilmemelidir. Girdiğiniz değeri kontrol ederek tekrar deneyebilirsiniz.