Cari Hesap Hareketlerini Listeleme
Açıklama
Cari hesap hareketlerini tekil olarak veya sayfalı bir liste halinde sorgulamak için kullanılır.
Tekil Sorgulama
- Endpoint:
/cat/cat?erpCode={erpCode} - Method:
GET
Listeleme
- Endpoint:
/cat/cat/list?page=1&pageSize=98 - Method:
GET
Query Parametreleri
| Parametre | Zorunlu | Format | Açıklama |
|---|---|---|---|
Id | Koşullu | Guid | Tek bir kaydı getirmek için kullanılır. |
ErpCode | Koşullu | String | Tek bir kaydı getirmek için kullanılır. Id verilmemişse önceliklidir. |
Page | Hayır | Integer | Getirilecek sayfa numarası. (Varsayılan: 1) |
PageSize | Hayır | Integer | Sayfa başına kayıt sayısı. (Varsayılan: 10) |
Davranış Kuralları
- Tekil Sorgulama:
IdveyaErpCodeparametrelerinden biri gönderilirse, sadece o kaydın detayı döner. - Listeleme:
IdveErpCodeboş bırakılırsa, sistemPagevePageSizedeğerlerine göre sayfalı bir liste döner. Tüm kayıtların tek seferde çekilmesine izin verilmez.
İstek Örneği
- Header:
Authorization: Bearer {token},Content-Type: application/json - Body:
JSON
İstek Örneği (Tekil Sorgu) GET /cat/cat?erpCode=CAT123456
- Başarılı Yanıt (Tekil Sorgu)
- Örnek cURL
{
"erpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",
"accountErpCode": "441B3BF1-8F5F-4CCD-A116-7CD90D3E4C04",
"amount": 1550.0000,
"currencyCode": "TRY",
"transactionDate": null,
"dueDate": "2025-09-20T00:00:00",
"description": "test cat"
}
curl --location 'https://prodtest_gw.finrota.com/cat/cat?erpCode=7044dac0-bbb3-4845-a316-702e2702b1673' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMjBhZmRmZTctYjdiZi00N2UyLWJhYzQtYjQ5YThjNGJiMDc5IiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NTA5MTIxMjczOTI1ODciLCJuYmYiOjE3NTkzMjE2MTIsImV4cCI6MTc1OTQ5NDQxMiwiaWF0IjoxNzU5MzIxNjEyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.5lyBbGfKMzfQZJ5Rz73rR254oy7ne_xGpEBDr7lTtPk'
İstek Örneği (Listeleme) GET /cat/cat/list?page=1&pageSize=98
- Başarılı Yanıt (Liste)
- Örnek cURL
{
"data": [
{
"erpCode": "",
"accountErpCode": "jhj hhh",
"amount": -111.0000,
"currencyCode": "TRY",
"transactionDate": "2025-10-01T10:44:36",
"dueDate": "2025-10-04T10:44:38",
"description": ""
},
{
"erpCode": "593be506-e384-44d2-8c4c-3ffb3dc4d304",
"accountErpCode": "D915B2D3-3451-44CD-9E4B-777711565143",
"amount": 1525.0000,
"currencyCode": "TRY",
"transactionDate": null,
"dueDate": "2025-09-05T07:50:01.961",
"description": "test cat 3"
},
{
"erpCode": "CFDA782E-378D-4CAD-A749-4178B9E87458",
"accountErpCode": "D915B2D3-3451-44CD-9E4B-777711565143",
"amount": 100.0000,
"currencyCode": "TRY",
"transactionDate": "2025-01-15T18:04:03",
"dueDate": "2025-01-15T18:04:05",
"description": ""
},
]
}
curl --location 'https://prodtest_gw.finrota.com/cat/cat/list?page=1&pageSize=98' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMjBhZmRmZTctYjdiZi00N2UyLWJhYzQtYjQ5YThjNGJiMDc5IiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NTA5MTIxMjczOTI1ODciLCJuYmYiOjE3NTkzMjE2MTIsImV4cCI6MTc1OTQ5NDQxMiwiaWF0IjoxNzU5MzIxNjEyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.5lyBbGfKMzfQZJ5Rz73rR254oy7ne_xGpEBDr7lTtPk'