Ödeme İşlemlerini Listeleme
Açıklama
ERP'ye entegre edilmiş tüm ödeme işlemlerini sorgulamak için.
- URL:
/erp/payments?page=1\&pageSize=10 - Method:
GET - Header: AccessToken'ı unutmayın!
- Filters: clientReferenceCode, referenceCode, transactionId, NonIntegrated, StartDate, EndDate, userCode, vendorErpCode filtreleri kullanabilirsiniz. Sayfalama da mevcut.
- Önemli Not: vposTransactionDetails.erpTransactionCode alanı doluysa, işlem ERP'ye başarıyla aktarılmış demektir. Ayrıca, tarih aralığı filtreleri (startDate, endDate) de kullanabilirsiniz.
Query Parametreleri (Filtreleme)
| Parametre | Tip | Açıklama |
|---|---|---|
| clientReferenceCode | string | Müşteri tarafından belirlenen referans kod |
| referenceCode | string | Netahsilat işlem referansı |
| transactionId | string | Veritabanındaki işlem ID’si |
| NonIntegrated | boolean | Aktarılmış veya aktarılmamış durumu |
| StartDate | string($date-time) | Ödeme tarihi başlangıç |
| EndDate | string($date-time) | Ödeme tarihi bitiş |
| userCode | string | İşlemi gerçekleştiren kullanıcının kodu |
| vendorErpCode | string | POS sağlayıcısının ERP’deki kodu |
Bu alanlardan biri veya birkaçı ile kombinasyonlu filtreleme yapılabilir.
- Örnek Yanıt
- Örnek CURL
{
"data": [
{
"clientReferenceNumber": null,
"referenceNumber": "NTH15P0000000092",
"tenantId": "2e64d939-d56f-4c78-a76f-84d0d445067b",
"tenantPosId": "a17b5b02-388e-f011-98fc-005056b0d2e5",
"commRate": 0.0000,
"currencyType": "TRY",
"transactionDate": "2025-09-11T14:37:39.3580599",
"transactionDetailId": "f12b4f75-590e-46c2-a6e7-08ddf12841c8",
"installment": 1,
"lastAmount": 52.00,
"lastNetAmount": 52.00,
"id": "5285c1d5-68c5-402d-8ac7-dce5191ac175",
"vposCommRate": 0.0000,
"bankPaymentDays": null,
"paymentSetErpCode": "Kobi",
"vPosERPCode": "",
"impersonated": true,
"paidTenantId": null,
"rePayPlanCode": null,
"agent": {
"agentId": "1f9c9e65-1bf3-48fc-887a-42c325d21cd2",
"name": "0210 Deneme 0210 Deneme",
"email": "[email protected]",
"agentCode": "NT53240185",
"erpCode": "",
"workplaceCode": null,
"departmentCode": null,
"speCode": null,
"authCode": null,
"projectCode": null,
"salesmanCode": null,
"busTranCode": null,
"branchCode": null,
"businessCode": null,
"isCompany": false,
"isCustomer": true,
"taxNumber": null,
"customerRepresentativeIds": [],
"dynamicFields": []
},
"currencyId": "8e6cc739-83e0-4af5-accf-a55476e758c6",
"paymentAccountTransactions": [
{
"amount": 0.0,
"erpCode": null,
"transactionErpCode": null
}
],
"paymentGeneral": {
"plusInstallment": 0,
"deferral": 0,
"commApplyType": "Dışında",
"provisionNumber": null,
"paymentSetName": null,
"paymentItemGroupName": null,
"paymentItemName": null,
"paymentItemErpCode": null,
"paymentItemCode": null,
"paymentItemStartDate": null,
"paymentItemEndDate": null,
"paymentItemAmount": null,
"dynamicFields": []
},
"paymentContact": {
"taxNumber": "00000000000",
"fullName": "John Doe",
"description": "test",
"phoneNumber": "5074458449",
"email": "[email protected]"
},
"paymentSet": {
"id": "2762130d-d34d-4ddf-b8c0-ca9c49b8c5e5",
"name": "Ödeme Seti",
"erpCode": "55555",
"transactionType": "Provizyon",
"commApplyType": "Dışında"
},
"creditCard": {
"cardHolderName": "John Doe",
"cardNumber": "415565******6111",
"cardType": "Visa",
"cardBank": "QNB Finansbank",
"cardClass": "Classic"
},
"erpTransactionCode": null,
"erpTransactionCodeUpdateDate": null,
"errorMessage": null,
"errorCode": null,
"transactionStatusId": 0
}
]
}
curl --location 'https://prodtest_gw.finrota.com/erp/payments?referenceNumber=NTH15P0000000090' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMmNjMWFkZDUtYTZmZi00ZjMxLWE0YzYtYzdlMzYwNzdhODNlIiwiVGVuYW50SWQiOiIyZTY0ZDkzOS1kNTZmLTRjNzgtYTc2Zi04NGQwZDQ0NTA2N2IiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NDI5OTk0Mjg2MDU3ODkiLCJuYmYiOjE3NTg1MzAzNDIsImV4cCI6MTc1ODcwMzE0MiwiaWF0IjoxNzU4NTMwMzQyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.9oo4RgktUmuN6MZ3W4h9jOdZXHlEHC_e0KPOCFy2Jag'