Servis Adresi
POST /Dealer/GetAccountingList
İstek Parametreleri
PaymentDealerAuthentication
| Parametre |
Açıklama |
| DealerCode string |
Ruut sistemi tarafından verilen bayi kodu |
| Username string |
Ruut sistemi tarafından verilen Api kullanıcı adı |
| Password string |
Ruut sistemi tarafından verilen Api şifresi |
| CheckKey string |
Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) String olarak birleştirilen bu bilgilerin SHA-256 hash algoritmasından geçirilmesiyle oluşturulur.
Buraya tıklayarak deneme ekranına gidebilirsiniz. |
DealerAccountingRequest
| Parametre |
Açıklama |
| TransferStartDate datetime |
Transferin başlangıç tarihi ve saati (yyyy-MM-dd HH:mm) (zorunlu) |
| TransferEndDate datetime |
Transferin bitiş tarihi ve saati (yyyy-MM-dd HH:mm) (zorunlu) |
| CurrencyCode string |
Para birimi. Opsiyonel alandır, hiç gönderilmezse veya boş gönderilirse tüm para birimleri gösterilir. Diğer değerler: USD, EUR, GBP |
| SubDealerId integer |
Alt bayi Id. Üst bayi alt bayiye yatırılacak tutarı görmek istediğinde bu alanı kullanmalıdır. Eğer üst bayi değilseniz bu alanı göndermeyiniz veya boş gönderiniz. |
Returns
| Parametre |
Açıklama |
| AccountingList array |
| DealerAccountingId integer | Bayi muhasebe Id. |
| CurrencyCode string | Para birimi. |
| TransferDate datetime | Bayiye ödemenin yapılacağı gün. |
| SalesCount integer | Başarılı satış işlemlerinin sayısı. |
| SalesTotal decimal | Başarılı satış işlemlerinin toplam tutarı. |
| SalesCommissionTotal decimal | Satış işlemlerinin toplam komisyonu. |
| RefundCount integer | Başarılı iadelerin sayısı. |
| RefundTotal decimal | Başarılı iadelerin toplam tutarı. |
| RefundCommissionTotal decimal | İade işlemlerinin toplam komisyonu. |
| BlockedCount integer | Bayiye eklenen bloke sayısı. |
| BlockedAmount decimal | Bayiye eklenen bloke tutarı. |
| UnBlockedCount integer | Bayiden çözülen blokelerin sayısı. |
| UnBlockedAmount decimal | Bayiden çözülen blokelerin toplam tutarı. |
| ChargebackCount integer | Bankadan gönderilen itirazların sayısı. |
| ChargebackAmount decimal | Bankadan gönderilen itirazların toplam tutarı. |
| ChargebackCancelCount integer | Bankadan gönderilen itirazların iptal sayısı. |
| ChargebackCancelAmount decimal | Bankadan gönderilen itirazların iptal tutarı. |
| DepositAmount decimal | Depozito tutarı. |
| DepositCount integer | Depozito sayısı. |
| OperationFeeCount integer | Operasyonel ücretlerin toplam sayısı. |
| OperationFeeAmount decimal | Operasyonel ücretlerin toplam tutarı. |
| OperationFeeCanceledCount integer | Operasyonel ücretlerin iadelerinin toplam sayısı. |
| OperationFeeCanceledAmount decimal | Operasyonel ücretlerin iadelerinin toplam tutarı. |
| RefundRequestCount integer | Bayiden gelen iade isteklerinin sayısı. |
| RefundRequestAmount decimal | Bayiden gelen iade isteklerin toplam tutarı. |
| TransferCost decimal | EFT işlem ücreti. |
| TransferredAmount decimal | Bayiye yatırılacak toplam tutar. |
| StatementList string | İlgili muhasebe kaydına ait ekstre listesi. |
|
Örnek İstek (JSON)
{
"DealerAuthentication":{
"DealerCode":"XXX",
"Username":"XXX",
"Password":"XXX",
"CheckKey":"560512c3549bf8050064d12fe0325e9c0510a6f477830e96191acf111a679091"
},
"DealerAccountingRequest":{
"TransferStartDate":"2019-02-27",
"TransferEndDate":"2019-03-10",
"CurrencyCode":"TL",
"SubDealerId":""
}
}
Başarılı İstek Sonucu
Gönderilen istek verileri Ruut’ da başarılı bir şekilde işlenmişse, geri dönüş nesnesinin
"ResultCode" alanında "Success" bilgisi yazar. "Data" alanında ise Ruut'dan dönen işlem
sonucu bulunur. "Data" içinde yer alan "IsSuccessful" (true/false) alanı kontrol edilerek
işlemin durumu kontrol edilir. Bu alanda false dönmesi durumunda aynı nesne içindeki
ResultCode ve ResultMessage alanları kontrol edilerek işlemin neden
başarısız olduğu görülebilir. "IsSuccessful" : true olması durumunda ise "ListItemCount" alanında
transaction sayısı yazar.
En fazla 31 günlük tarih aralığında olan veriler gösterilebilir.
Bayiye yatırılacak paranın hesaplanma yöntemi şöyledir:
TransferredAmount = SalesTotal - SalesCommissionTotal + RefundCommissionTotal - BlockedAmount + UnBlockedAmount - RefundRequestAmount - ChargebackAmount + ChargebackCancelAmount + DepositAmount - TransferCost
Başarılı Sonuç Örneği
{
"Data":{
"IsSuccesfull":true,
"ResultCode":"00",
"ResultMessage":"",
"ListItemCount":1,
"AccountingList":[
{
"DealerAccountingId":600,
"CurrencyCode":"TL",
"TransferDate":"2020-06-17T00:00:00",
"SalesCount":0,
"SalesTotal":0.00,
"SalesCommissionTotal":0.00,
"RefundCount":0,
"RefundTotal":0.00,
"RefundCommissionTotal":0.00,
"BlockedCount":0,
"BlockedAmount":0.00,
"UnBlockedCount":0,
"UnBlockedAmount":0.00,
"ChargebackCount":0,
"ChargebackAmount":0.00,
"ChargebackCancelCount":0,
"ChargebackCancelAmount":0.00,
"DepositCount":0,
"DepositAmount":0.00,
"OperationFeeCount":0,
"OperationFeeAmount":0.00,
"OperationFeeCanceledCount":0,
"OperationFeeCanceledAmount":0.0,
"RefundRequestCount":0,
"RefundRequestAmount":0.00,
"TransferCost":0.00,
"TransferredAmount":0.00,
"StatementList":""
}
]
},
"ResultCode":"Success",
"ResultMessage":"",
"Exception":null
}
Başarısız İstek Sonucu
| ResultCode | Açıklama |
|---|
| DealerAccounting.GetAccountingList.InvalidDateTimeFormat | Tarih saat biçimi geçersiz. |
| DealerAccounting.GetAccountingList.NoMoreThanThirtyOneDays | 31 günden fazla olmamalı. |
| DealerAccounting.GetAccountingList.InvalidDateRange | Tarih aralığı geçersiz. |
| DealerAccounting.GetAccountingList.InvalidCurrencyCode | Para birimi hatalı. (TL, USD, EUR şeklinde olmalı) |
| DealerAccounting.GetAccountingList.InvalidSubDealerId | Alt bayi id geçersiz. |
| DealerAccounting.GetAccountingList.MissingRequest | Eksik istek. |
| DealerAccounting.GetAccountingList.InvalidRequest | CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir. |
| DealerAccounting.GetAccountingList.InvalidAccount | Böyle bir bayi bulunamadı. |
| EX | Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data":null,
"ResultCode":"DealerAccounting.GetAccountingList.NoMoreThanThirtyOneDays",
"ResultMessage":"",
"Exception":null
}