Cari Hesap Hareketi Güncelleme

Açıklama

Mevcut bir cari hesap hareketini güncellemek için kullanılır. Güncellenecek kayıt, istek gövdesinde gönderilen UpdateErpCode (mevcut ERP kodu) veya Id (sistem ID'si) alanlarından biri referans alınarak bulunur. Kaydın yeni ERP kodu ise yine istek gövdesindeki erpCode alanı ile set edilir.

• Endpoint: /cat/cat
• Method: PUT

İstek Örneği

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

Request Body

Alan	Zorunlu	Format	Açıklama / Kontrol
UpdateErpCode	Koşullu	String	Güncellenecek kaydın mevcut ERP kodu. Eğer Id alanı boşsa bu alan zorunludur.
Id	Koşullu	Guid	Güncellenecek kaydın sistemdeki benzersiz ID'si. Eğer UpdateErpCode alanı boşsa bu alan zorunludur.
AgentErpCode	Evet	String	İlgili ajanın ERP kodu. Boş olamaz.
amount	Evet	Decimal	Yeni borç tutarı. (> 0) olmalıdır.
paidAmount	Hayır	Decimal	Ödenen tutar. Pozitif bir sayı olmalıdır. amount değerinden büyük olamaz.
documentNo	Evet	String	Yeni belge numarası. Boş olamaz.
currentAccountErpCode	Evet	String[]	Cari hesabın ERP kodu. Boş olamaz.
currentAccountTransactionType	Evet	String (Enum)	Şu değerlerden biri olmalıdır: "Senet", "Çek", "Kredi Kartı", "Borç dekont", "Fatura", "Havale", "Sipariş", "Devir", "Virman".
dueDate	Evet	DateTime	Yeni vade tarihi (ISO 8601: YYYY-MM-DD).
transactionDate	Evet	DateTime	Yeni işlem tarihi (ISO 8601: YYYY-MM-DD). dueDate tarihinden sonra olamaz.
currencyId	Evet	String	Para birimi kodu (örn: "TRY"). Sistemde tanımlı olmalıdır.
erpCode	Evet	String	Hareketin yeni veya güncel ERP kodu. Boş olamaz.
description	Hayır	String	Yeni işlem açıklaması.

İş Kuralları ve Notlar

• Referans Belirleme: Bir kaydı güncellemek için UpdateErpCode veya Id alanlarından en az birini göndermeniz zorunludur. İkisi de boş bırakılırsa istek 400 Bad Request hatası alır.
• Kayıt Bulunamazsa: Gönderilen UpdateErpCode veya Id ile eşleşen bir hareket sistemde bulunamazsa, 404 Not Found hatası döner.
• ERP Kodu Yönetimi: UpdateErpCode güncellenecek kaydı bulmak için kullanılırken, erpCode alanı bu kaydın yeni ERP kodunu belirler. Eğer ERP kodunu değiştirmek istemiyorsanız, iki alana da aynı değeri gönderebilirsiniz.
• Mükerrer ERP Kodu: Atamak istediğiniz yeni erpCode, (güncellediğiniz kayıt hariç) başka bir kayıtta zaten kullanılıyorsa, sistem 409 Conflict hatası döner.
• Tarih Kontrolü: transactionDate alanı, dueDate alanından sonraki bir tarih olamaz.

Başarılı İstek (Request)

{  
    "agentErpCode": "NT26822394",  
    "amount": 4500,  
    "paidAmount": 0,  
    "documentNo": "DemoTest",  
    "currentAccountErpCode": "441B3BF1-8F5F-4CCD-A116-7CD90D3E4C04",  
    "documentType": "Senet",  
    "dueDate": "2025-08-05T07:51:00.157Z",  
    "transactionDate": "2025-08-05T07:51:00.157Z",  
    "currencyCode": "USD",  
    "description": "test test",  
    "updateErpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",  
    "erpCode":"12001450"  
}

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

{  
    "result": {  
        "erpCode": "12001450",  
        "createdAt": "2025-10-01T16:06:08.2428899+03:00"  
    },  
    "status": "success",  
    "message": "Cari hesap işlemi güncellendi."  
}

Örnek cURL

curl --location --request PUT 'https://prodtest_gw.finrota.com/cat/cat' \  
--header 'Content-Type: application/json' \  
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMjBhZmRmZTctYjdiZi00N2UyLWJhYzQtYjQ5YThjNGJiMDc5IiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NTA5MTIxMjczOTI1ODciLCJuYmYiOjE3NTkzMjE2MTIsImV4cCI6MTc1OTQ5NDQxMiwiaWF0IjoxNzU5MzIxNjEyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.5lyBbGfKMzfQZJ5Rz73rR254oy7ne_xGpEBDr7lTtPk' \  
--data '{  
    "agentErpCode": "NT26822394",  
    "amount": 4500,  
    "paidAmount": 0,  
    "documentNo": "DemoTest",  
    "currentAccountErpCode": "441B3BF1-8F5F-4CCD-A116-7CD90D3E4C04",  
    "documentType": "Senet",  
    "dueDate": "2025-08-05T07:51:00.157Z",  
    "transactionDate": "2025-08-05T07:51:00.157Z",  
    "currencyCode": "USD",  
    "description": "test test",  
    "updateErpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",  
    "erpCode":"12001450"  
}'