Cari Hesap Oluşturma

• Endpoint: /vendor/currentAccount
• HTTP Method: POST
• Request Content-Type: application/json
• Response Content-Type: application/json
• Yetkilendirme: Geçerli AccessToken zorunludur.
  (Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama

Bu servis, Portal ekranındaki işlemlerle aynı mantıkta çalışarak yeni bir cari hesap kaydı oluşturmak için kullanılır.

Cari hesaplar, bayi, müşteri veya tedarikçi gibi taraflara ait finansal kayıtlar olup ödeme/tahsilat süreçlerinde kullanılır.

Her cari hesap için sistemde benzersiz bir code ve erpCode değeri bulunmalıdır.

Header Bilgileri

Header Adı	Zorunlu	Açıklama
Authorization	Evet	Bearer {AccessToken} formatında geçerli token
Content-Type	Evet	application/json

Request Body

Alan Adı	Tip	Zorunlu	Açıklama
code	string	Evet	Cari hesap kodu (benzersiz).
currencyCode	string	Evet	Para birimi kodu (örn. "TRY", "USD").
currentAccountType	string	Evet	Cari hesap tipi (örn. "Müşteri", "Tedarikçi", "Bayi").
customerOrDealerCode	string	Evet	Hesabın bağlı olduğu müşteri veya bayi kodu.
description	string	Hayır	Cari hesap açıklaması.
erpCode	string	Evet	ERP sistemindeki cari hesap kodu (benzersiz).
isVisibleOnPayment	boolean	Hayır	Ödeme ekranlarında görünsün mü? (varsayılan: false).
accountName	string	Evet	Cari hesap adı.
taxNumber	string	Hayır	Vergi numarası (şirket hesapları için).
tcknNumber	string	Hayır	T.C. kimlik numarası (bireysel hesaplar için).
title	string	Hayır	Cari hesap unvanı.

Örnek Request

{  
  "code": "CA-001",  
  "currencyCode": "USD",  
  "currentAccountType": "Bayi",  
  "customerOrDealerCode": "DEALER-123",  
  "description": "Yurt Dışı Bayi Cari Hesabı",  
  "erpCode": "ERP-ACC-001",  
  "isVisibleOnPayment": true,  
  "accountName": "ABC Dış Ticaret Hesabı",  
  "taxNumber": "00000000000",  
  "tcknNumber": "00000000000",  
  "title": "Yetkili Bayi"  
}  

customerOrDealerCode alanı, mevcut bir müşteri veya bayi kodu olmalıdır.
Aynı code veya erpCode ile ikinci bir kayıt oluşturulamaz.

Başarılı Response (200 OK)

{  
  "isSuccess": true,  
  "message": "Cari hesap başarıyla oluşturuldu."  
}

Notlar & En İyi Uygulamalar

• code ve erpCode alanları sistemde benzersiz olmalıdır; aksi durumda istek 409 Conflict döner.
• currentAccountType alanı sistemde tanımlı değerlerden biri olmalıdır (örn. "Müşteri", "Tedarikçi", "Bayi").
• customerOrDealerCode mutlaka sistemde mevcut bir müşteri veya bayi kaydına karşılık gelmelidir.
• isVisibleOnPayment = true olarak işaretlenen hesaplar, ödeme ekranlarında listelenir.
• Bireysel hesaplarda tcknNumber, kurumsal hesaplarda taxNumber alanı doldurulmalıdır.
• Token süresi dolmuşsa istek 401 Unauthorized döner; yeni token alınarak tekrar gönderilmelidir.