Creating a Current Account Transaction

Description

Used to create a new current account transaction (debt record). This service is designed to ensure data synchronization between systems and guarantees that financial transactions are recorded accurately, completely, and uniquely. Upon a successful call, the related record is created in the system and can be tracked using the erpCode value.

• Endpoint: /cat/cat
• Method: POST

Request Body

Field	Required	Format	Description / Validation
AgentErpCode	Yes	String	ERP code of the related agent. Cannot be empty.
amount	Yes	Decimal	Debt amount. Must be a positive number.
paidAmount	No	Decimal	Paid amount. Must be a positive number.
documentNo	Yes	String	Document number. Cannot be empty.
currentAccountErpCode	Yes	String	ERP code of the current account. Cannot be empty.
documentType	Yes	String (Enum)	Must be one of "Senet", "Çek", "Kredi Kartı", "Borç dekont", "Fatura", "Havale", "Sipariş", "Devir", "Virman".
dueDate	Yes	DateTime	Due date (ISO 8601: YYYY-MM-DD).
transactionDate	Yes	DateTime	Transaction date (ISO 8601: YYYY-MM-DD).
currencyId	Yes	String	Currency code (e.g., "TRY", "USD"). Must be defined in the system.
erpCode	Yes	String	Unique ERP code of the transaction. Cannot be empty and must not have been used before.
description	No	String	Transaction description.

Request Example

• Header: Authorization: Bearer {token}, Content-Type: application/json
• Body: JSON

Successful Request

{  
    "agentErpCode": "NT26822394",  
    "amount": 1550,  
    "paidAmount": 0,  
    "documentNo": "df912e15-a3d6-447f-8456-397152ffaca9a96",  
    "currentAccountErpCode": "441B3BF1-8F5F-4CCD-A116-7CD90D3E4C04",  
    "documentType": "Ödeme",  
    "dueDate": "2025-09-20",  
    "currencyCode": "TRY",  
    "erpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",  
    "description": "test cat"  
}

Successful Response

{  
    "result": {  
        "erpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",  
        "createdAt": "2025-10-01T15:32:46.2582116+03:00"  
    },  
    "status": "success",  
    "message": "Cari hesap işlemi oluşturuldu."  
}

Sample cURL

curl --location 'https://prodtest_gw.finrota.com/cat/cat' \  
--header 'Content-Type: application/json' \  
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMjBhZmRmZTctYjdiZi00N2UyLWJhYzQtYjQ5YThjNGJiMDc5IiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NTA5MTIxMjczOTI1ODciLCJuYmYiOjE3NTkzMjE2MTIsImV4cCI6MTc1OTQ5NDQxMiwiaWF0IjoxNzU5MzIxNjEyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.5lyBbGfKMzfQZJ5Rz73rR254oy7ne_xGpEBDr7lTtPk' \  
--data '{  
    "agentErpCode": "NT26822394",  
    "amount": 1550,  
    "paidAmount": 0,  
    "documentNo": "df912e15-a3d6-447f-8456-397152ffaca9a96",  
    "currentAccountErpCode": "441B3BF1-8F5F-4CCD-A116-7CD90D3E4C04",  
    "documentType": "Ödeme",  
    "dueDate": "2025-09-20",  
    "currencyCode": "TRY",  
    "erpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",  
    "description": "test cat"  
}'