Cari Hesap Hareketi Oluşturma

Açıklama

Yeni bir cari hesap hareketi (borç kaydı) oluşturmak için kullanılır. Bu servis, sistemler arası veri senkronizasyonu sağlamak amacıyla tasarlanmıştır ve finansal hareketlerin doğru, eksiksiz ve benzersiz şekilde kaydedilmesini garanti eder. Başarılı çağrıda ilgili kayıt sistemde oluşturulur, erpCode değeriyle takip edilebilir.

• Endpoint: /cat/cat
• Method: POST

Request Body

Alan	Zorunlu	Format	Açıklama / Kontrol
AgentErpCode	Evet	String	İlgili ajanın ERP kodu. Boş olamaz.
amount	Evet	Decimal	Borç tutarı. Pozitif bir sayı olmalıdır.
paidAmount	Hayır	Decimal	Ödenen tutar. Pozitif bir sayı olmalıdır.
documentNo	Evet	String	Belge numarası. Boş olamaz.
currentAccountErpCode	Evet	String	Cari hesabın ERP kodu. Boş olamaz.
documentType	Evet	String (Enum)	"Senet", "Çek", "Kredi Kartı", "Borç dekont", "Fatura", "Havale", "Sipariş", "Devir", "Virman" değerlerinden biri olmalı.
dueDate	Evet	DateTime	Vade tarihi (ISO 8601: YYYY-MM-DD).
transactionDate	Evet	DateTime	İşlem tarihi (ISO 8601: YYYY-MM-DD).
currencyId	Evet	String	Para birimi kodu (örn: "TRY", "USD"). Sistemde tanımlı olmalıdır.
erpCode	Evet	String	Hareketin benzersiz ERP kodu. Boş olamaz ve daha önce kullanılmamış olmalıdır.
description	Hayır	String	İşlem açıklaması.

İstek Örneği

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

Başarılı İstek (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"  
}

Başarılı Yanıt (Request)

{  
    "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."  
}

Örnek 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"  
}'