Müşteri Güncelleme

• Endpoint: /vendor/customer/{Code}
• HTTP Method: PUT
• Request Content-Type: application/json
• Yetkilendirme: Geçerli AccessToken zorunludur. (Bkz: 2. Kimlik Doğrulama)

Açıklama

Bu servis aracılığıyla, sistemde mevcut olan bir müşteri kaydı güncellenebilir.
Hem bireysel hem de kurumsal müşteriler desteklenir.
Sadece değiştirilecek alanlar gönderilebilir; gönderilmeyen alanlar korunur.

Not: code ve erpCode alanları zorunludur. updateCode mevcut kaydı belirtirken, code yeni müşteri kodunu temsil eder (değiştirilebilir).

Header Bilgileri

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

Update Referans Alanı

Alan Adı	Tip	Zorunlu	Açıklama
updateCode	string	Evet	Güncellenecek müşterinin üye kodu (code)

Request Body Alanları

Alan Adı	Tip	Zorunlu	Açıklama
code	string	Evet	Müşteri kodu (benzersiz).
erpCode	string	Evet	ERP sistemindeki benzersiz müşteri kodu.
firstName	string	Bireysel	Bireysel müşteriler için ad.
lastName	string	Bireysel	Bireysel müşteriler için soyad.
companyName	string	Kurumsal	Kurumsal müşteriler için firma adı.
isCompany	boolean	Hayır	true: Kurumsal, false: Bireysel.
isForeignNational	boolean	Hayır	Yabancı uyruklu müşteri mi?
tckn	string	Bireysel	Türkiye Cumhuriyeti Kimlik No (bireysel).
taxNumber	string	Kurumsal	Vergi numarası (kurumsal).
taxOffice	string	Kurumsal	Vergi dairesi (kurumsal).
email	string	Hayır	Müşteri e-posta adresi.
phone	string	Hayır	Sabit telefon numarası.
mobile	string	Hayır	Cep telefonu numarası.
countryCode	string	Hayır	Ülke kodu (örn. "TR").
cityCode	string	Hayır	Şehir kodu.
districtCode	integer	Hayır	İlçe kodu.
currencyCode	string	Hayır	Para birimi kodu (örn. "TRY").
address	string	Hayır	Adres bilgisi.
paymentSetId	string	Hayır	İlişkili ödeme seti kimliği.
customerRepresentativeIds	array(string)	Hayır	Müşteri temsilcisi ID listesi.
canUseMobile	boolean	Hayır	Mobil uygulama kullanım izni.
sendMail	boolean	Hayır	Güncelleme sonrası bilgilendirme e-postası gönderilsin mi?
isActive	boolean	Hayır	Müşteri aktif mi?
title	string	Hayır	Ünvan veya ek açıklama (opsiyonel).

Alan adı farklılıkları hakkında not: Oluşturma servisindeki bazı alan adları ile (örn. countryCode vs countryCodeISO, currencyCode vs currencyTypeId) bu servisteki alan adları farklılık gösterebilir. Güncelleme isteğinde bu tabloda verilen adları kullanınız.

Örnek İstek

{  
  "code": "501",  
  "erpCode": "501",  
  "phone": "5000000000",  
  "countryCode": "TR",  
  "cityCode": "10",  
  "districtCode": 494,  
  "currencyCode": "TRY",  
  "address": "test",  
  "taxOffice": "Silifke",  
  "paymentSetId": "504978bf-bebd-40c5-89aa-b76f3a20341c",  
  "customerRepresentativeIds": [  
    "a90b225c-fa6e-418d-8c03-93946a05e355"  
  ],  
  "isForeignNational": false,  
  "isCompany": false,  
  "firstName": "vendor",  
  "lastName": "test5",  
  "email": "[email protected]",  
  "mobile": "5000000000",  
  "canUseMobile": false,  
  "sendMail": true,  
  "isActive": true,  
  "tckn": "00000000000"  
}

Başarılı Yanıt

{  
  "status": "success",  
  "message": "Müşteri başarıyla güncellendi"  
}

Örnek cURL

curl --location --request PUT 'https://pgw.netahsilatdemo.com/vendor/customer/501' \  
--header 'Content-Type: application/json' \  
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJwd3N2MS5hcGkiLCJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiYTI3NmYyOGEtOWMwYS00NGYxLWIxNjgtMTJiMGY3NTEwMWYzIiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NjE5NDQzNzQ5NjM1ODYiLCJuYmYiOjE3NjA0MjQ4MzcsImV4cCI6MTc2MDU5NzYzNywiaWF0IjoxNzYwNDI0ODM3LCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.G0FFvRyNF_qCYQvUjvDWzGuf05JpJujSgC5ZMV9_BIQ' \  
--data-raw '{  
  "code": "501",  
  "erpcode": "501",  
  "phone": "5000000000",  
  "countryCode": "TR",  
  "cityCode": "10",  
  "districtCode": 494,  
  "currencyCode": "TRY",  
  "address": "test",  
  "taxOffice": "Silifke",  
  "paymentSetId": "504978bf-bebd-40c5-89aa-b76f3a20341c",  
  "customerRepresentativeIds": [  
    "a90b225c-fa6e-418d-8c03-93946a05e355"  
  ],  
  "isForeignNational": false,  
  "isCompany": false,  
  "firstName": "John",  
  "lastName": "Doe",  
  "email": "[email protected]",  
  "mobile": "5000000000",  
  "canUseMobile": false,  
  "sendMail": true,  
  "isActive": true,  
  "tckn": "00000000000"  
}'

Kullanım Notları ve En İyi Uygulamalar

• Kısmi Güncelleme: Sadece güncellenecek alanları gönderin; gönderilmeyen alanlar korunur.
• Alan Uyumluğu: Oluşturma (POST) ve güncelleme (PUT) için alan adları değişiklik gösterebilir (örn. countryCode ↔ countryCodeISO).
• Kimlik Alanları: updateCode, güncellenecek kaydın mevcut code değerine işaret eder. code alanını değiştiriyorsanız, hem updateCode (eski kod) hem de code (yeni kod) gövdede yer alabilir.
• E-posta Bildirimi: sendMail=true verilirse sistem yapılandırmanıza göre bilgilendirme e-postası tetiklenebilir.
• Para Birimi/Ödeme Seti: currencyTypeId ve paymentSetId değerlerinin sisteminizde tanımlı olduğundan emin olun; aksi halde 404 dönebilir.
• İstemci Tarafı Kontroller: Token süresi dolmuşsa önce yenileyip isteği tekrar deneyin (Bkz: 2.2 Token’ın Süresi ve Yenileme).