Anonim

Kurumsal

Servisler

Accounting Service

İstekte bulunan kurumsal kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki bakiye bilgileri, Bakiye Detay Sorgulama, Satış Kodu ile SRS detay Sorgulama, Para Transfer Geçmişi Geliştirmesi, Bakiye Detay Sorgulama gibi işlemleri gerçekleştirebilir.

getBalances

Bu metod istenen tarihler arasındaki satışların, istenen durumdaki (tamamlanan ve bekleyen) para transfer bilgilerini sorgulamak için kullanılır. Satıcı konumundaki kullanıcı bu metot aracılığı ile GittiGidiyor BanaÖzel sayfasında yer alan "Hesap Hareketlerim" altındaki Para Transfer Geçmişi ve Beklenen Para Transferi bölümüyle aynı sonuçları elde edebilir.

Başlangıç tarihi ile bitiş tarihi arasında max 31 gün olabilir

İ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/IndividualAccountingService?wsdl Servis Metot İmzası:Kopyala
balanceServiceResponse getBalances(String apiKey, String sign, long time, String lang, String startDate, String endDate, int pageNumber, int pageSize,String balanceTransferStatus)
İstek Parametreleri:Kopyala 
apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    İşlemin gerçekleştirildiği zaman.
lang: String
    Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.
startDate: String
    Başlangıç tarihi.
endDate: String
    Bitiş tarihi.
pageNumber: Int
    Kaçıncı sayfadan başlayacak?
pageSize: Int
    Kaç kayıt listelenecek?
balanceTransferStatus: String
    COMPLETED = İşlemi tamamlanmış ve satıcıya aktarılmış para transferleri
    WAITING_FOR_STATUS = Satıcıya aktarılması beklenen para transferleri
Örnek İstek:Kopyala 
<acc:getBalances>
   <apiKey>PhGWkTJFW83sGycrDX6nbwXr34HsvtuB</apiKey>
   <sign>9f4e23cdba76d634af5fe6954fee84f4</sign>
   <time>1608273813669</time>
   <lang>tr</lang>
   <balanceRequest>
      <startDate>01/01/2020 10:30:00</startDate>
      <endDate>31/01/2020 10:30:00</endDate>
      <pageNumber>2</pageNumber>
      <pageSize>1</pageSize>
      <balanceTransferStatus>COMPLETED</balanceTransferStatus>
   </balanceRequest>
</acc:getBalances>
Sonuç Parametreleri:Kopyala 
balanceCode:
    Bakiye kodu
amount:
    Satıcı tutarı
debtAmount:
    Borç tutarı
logisticsAmount:
    Kargo kesintisi
originalSellerAmount:
    Satış tutarı
balanceStatus:
    Durumu
iban:
    IBAN
accountNumber:
    Hesap no
bankAccountTitle: 
    Banka hesap sahibi adı
completionDate:
    Tamamlanma tarihi
    Beklenen Para Transferlerinde boş gelecektir.
pageNumber: Int
    Dönen kaynağın sayfası
pageSize: Int
    Dönen kayıt limiti
totalCount:long
     pageNumber ve pageSize bağımsız toplam kayıt sayısı
Örnek Sonuç:Kopyala 
<acc:getBalancesResponse xmlns:acc="http://accounting.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>18/12/2020 10:05:59</responseTime>
      <timeElapsed>2589 ms</timeElapsed>
      <balances>
         <balance>
            <balanceCode>SELLER-BC-403241cc-c30f-4935-9818-4bf433ba3420</balanceCode>
            <amount>450.64</amount>
            <debtAmount>100.00</debtAmount>
            <logisticsAmount>0.00</logisticsAmount>
            <originalSellerAmount>550.64</originalSellerAmount>
            <balanceStatus>TRANSFERRED</balanceStatus>
            <iban>TR323456456723453455456724</iban>
            <accountNumber>1234567890</accountNumber>
            <bankAccountTitle>test XXX</bankAccountTitle>
            <completionDate>14/01/2020</completionDate>
         </balance>
      </balances>
      <pageNumber>2</pageNumber>
      <pageSize>1</pageSize>
      <totalCount>2</totalCount>
   </return>
</acc:getBalancesResponse>