Bayi Güncelleme

• Endpoint: /vendor/dealer
• HTTP Method: PUT
• 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 aracılığıyla sistemde mevcut bir bayi (vendor) ve ona bağlı bayi kullanıcı(lar) bilgileri güncellenebilir. İstek, bayi temel bilgilerini ve opsiyonel olarak kullanıcı bilgilerini içerir.

Güncellenecek bayi updateCode alanı ile belirtilmelidir. Gönderilmeyen alanlar sistemdeki mevcut değerlerini korur.

Header Bilgileri

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

Update Referans Alanı

Alan Adı	Tip	Zorunlu	Açıklama
updateCode	string	Evet	Güncellenecek bayi kodu (sistemde kayıtlı olmalı)

Request Body Alanları

Vendor (Bayi) Bilgileri

Alan Adı	Tip	Zorunlu	Açıklama
code	string	Evet	Bayi kodu (benzersiz olmalı)
erpCode	string	Evet	ERP sistemindeki bayi kodu (benzersiz olmalı)
name	string	Evet	Bayi adı
countryCode	string	Evet	Ülke kodu (örn. "TR")
cityCode	string	Hayır	Şehir kodu
districtCode	string	Hayır	İlçe kodu
address	string	Hayır	Adres bilgisi
phone	string	Hayır	Sabit telefon numarası
taxNumber	string	Hayır	Vergi numarası (kurumsal için)
taxOffice	string	Hayır	Vergi dairesi (kurumsal için)
isCompany	boolean	Evet	true: Kurumsal, false: Bireysel
isForeignNational	boolean	Hayır	Yabancı uyruklu mu
paymentSetId	string	Hayır	Varsayılan ödeme seti tanımı
currencyCode	string	Hayır	Para birimi kodu (örn. "TRY")
customerRepresentativeIds	array(string)	Hayır	Bayi temsilcisi ID listesi
usablePaymentSetDefinitionIds	array(string)	Hayır	Kullanılabilir ödeme seti ID listesi
parentTenantId	string	Hayır	Üst tenant ID (bayi hiyerarşisi için)

Örnek Request Body

{  
    "code": "601",  
    "phone": "5000000000",  
    "erpCode": "601",  
    "countryCode": "TKM",  
    "cityCode": "10",  
    "districtCode": 494,  
    "currencyCode": "TRY",  
    "address": "test1111",  
    "taxNumber": "00000000000",  
    "paymentSetId": "00cfced3-c429-444e-8125-fff3a7fb553a",  
    "customerRepresentativeIds": [  
        "c0dc9553-4bb7-4611-9e93-1d58c65a3fa6",  
        "4b80f492-ed80-445d-943f-2125125e3667"  
    ],  
    "isForeignNational": false,  
    "isCompany": false,  
    "name": "test bayisi vendor01101",  
    "parentTenantId": "670683c1-2fe0-4846-87b2-6cba9b793ab2",  
    "usablePaymentSetDefinitionIds": [  
        "958949df-0d90-4851-bcb8-1acb62c4dc95",  
        "79ce2e5f-51cb-4d29-beca-955685e86c50"  
    ],  
    "users": [  
    /* {  
            "canUseMobile": true,  
            "description": "test",  
            "email": "[email protected]",  
            "gsm": "5000000000",  
            "isActive": true,  
            "name": "John",  
            "surname": "Doe",  
            "roles": [  
                "61002d8f-8fdd-430a-96dd-c5d87f5c9bda"  
            ],  
            "sendMail": false,  
            "userType": 8387,  
            "code": "test000feafasdvagvawerg",  
            "id": "79d12dbf-ef35-4e50-bdbe-a2df6bd5e316"  
        }*/  
    ]  
}

Başarılı Response

{  
    "status": "success",  
    "message": "Bayi başarıyla güncellendi.",  
    "customerId": "1426472f-15fa-43a5-9930-9f80234594fd"  
}

Notlar ve En İyi Uygulamalar

• updateCode: Güncellenecek bayi bu alanla tanımlanmalıdır.
• Kısmi Güncelleme: Gönderilmeyen alanlar mevcut değerleriyle korunur.
• vendor ve users: Alanlar birlikte veya ayrı gönderilebilir.
• isCompany = false: Bireysel bayi; vergi alanları opsiyoneldir.
• isCompany = true: Kurumsal bayi; taxNumber ve taxOffice zorunludur.
• sendRegisterMail = true: Güncelleme sonrası kullanıcıya e-posta gönderilir.
• Token yenileme: Token süresi dolarsa API 401 Unauthorized döner; yeni token alınarak istek tekrarlanmalıdır.