GittiGidiyor
GittiGidiyor API

Sale Service

İstekte bulunan kurumsal kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki satış bilgilerini listeleme ve sıralama, satış için puan ve yorum girme, girilen yoruma cevap verme gibi işlemler gerçekleştirilebilir.

getAccountTransactionsV2

Bu metot banka hesabınıza gerçekleşen veya gerçekleşecek olan para transferleri hareketlerine ulaşmak için kullanılır.

Hesap Hareketlerim > Satış Raporlarım > Tamamlanan Satış Hareketleri alanındaki bilgiler dönmektedir. (Bkz: https://www.gittigidiyor.com/BanaOzel/hesaplarim.php)



İzin Hakları:

Bu metodda kullanıcıların güvenliği için http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Bu doğrulama için gerekli bilgileri Api Anahtarları sayfanızdan kontrol edebilirsiniz. Web servis çağırımlarında kullanıcılar kendi kullanıcı adlarını ve role passwordlerini kullanmalıdırlar. Ayrıca, kurumsal servis katmanında işlem yapılır ise -servislere erişim esnasında- diğer katmanlarda olduğu gibi uygulama anahtarı, istek imzası ve o anki zaman değeri yollanarak istek (request) başına doğrulama gerçekleşir.



Erişim:

WSDL Adresi:https://dev.gittigidiyor.com:8443/listingapi/ws/IndividualSaleService?wsdl


Servis Metot İmzası:

SaleServiceResponse getAccountTransactionsV2(String apiKey, String sign, long time, String startDate, String endDate, Int startOffSet, Int rowCount, String lang);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
startDate: String
    Başlangıç tarihi.
endDate: String
    Bitiş tarihi.
startOffSet: Int
    Kaçıncı indeksten başlayacak?
rowCount: 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.


Örnek İstek:

<sale:getAccountTransactionsV2>
   <apiKey>VKdTa9fGHt5ESTfkBfnutwSDNZVV8b9H</apiKey>
   <sign>E869FC0739DD082DD0BC0267EAA4D7FA</sign>
   <time>1585904203618</time>
   <startDate>2020-03-29</startDate>
   <endDate>2020-04-3</endDate>
   <startOffSet>0</startOffSet>
   <rowCount>20</rowCount>
   <lang>tr</lang>
</sale:getAccountTransactionsV2>


Sonuç Parametreleri:

saleCode: String
    Satış kodu
productId: Int
    Ürüne ait tekil anahtar
productTitle: String
    Ürün başlığı
buyerNick: String
    Alıcıya ait kullanıcı adı
price: Decimal
    Hesabınıza aktarılan tutar
commissionPrice: Decimal
    Kesilen komiston tutarı
ggCommission: Decimal
    GittiGidiyor komisyon oranı
dailyOfferCommission: Decimal
    Satış Ek Hizmet Bedeli (G.Fırsat, Pazarlama Des.)
paidPrice: Decimal
    Ürünün satış fiyatı
approveDate: String
    Alıcının onayı sonrasındaki ilk iş günü. (10 günlük para transfer sürecinin başladığı ilk gün)
approve: String
    Transfer gerçekleşme durumu.
iban: String
    Ödemenin aktarıldığı IBAN/Hesap No.


Örnek Sonuç:

<sale:getAccountTransactionsV2Response xmlns:sale="http://sale.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
         <responseTime>03/04/2020 08:08:29</responseTime>
         <timeElapsed>48 ms</timeElapsed>
         <totalCount>1</totalCount>
         <sales>
            <sale>
               <saleCode>SC12345678</saleCode>
               <productId>123456789</productId>
               <productTitle>API test ürünü</productTitle>
               <buyerNick>operasyontest</buyerNick>
               <price>40.7418</price>
               <commissionPrice>9.2482</commissionPrice>
               <ggCommission>17.00</ggCommission>
               <dailyOfferCommission>0.7499</dailyOfferCommission>
               <paidPrice>49.9900</paidPrice>
               <approveDate>2020-03-05 01:48:57</approveDate>
               <approve>Y</approve>
               <iban> TR320010009999901234567890</iban>
            </sale>
         </sales>
   </return>
</sale:getAccountTransactionsV2Response>