Bayi Oluşturma

• Endpoint: /vendor/dealer
• 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 aracılığıyla sistemde yeni bir bayi (vendor) ve ona bağlı bayi kullanıcı(lar) oluşturulabilir. İstek, hem bayi temel bilgilerini hem de kullanıcı bilgilerini birlikte içerir.

Her kayıt için code ve erpCode değerleri sistemde benzersiz olmalıdır. Kayıt işlemi tamamlandığında bayi oluşturulur ve kullanıcı(lar) ilgili bayiye bağlanır.

Header Bilgileri

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

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	Kurumsal mı (true) / bireysel mi (false)
isForeignNational	boolean	Hayır	Yabancı uyruklu mu
paymentSetId	string	Hayır	Varsayılan ödeme seti tanımı
paymentExCurrencyType	string	Hayır	Ödeme para birimi tipi
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)

Not: isCompany = true ise taxNumber ve taxOffice alanları zorunludur.

Users (Bayi Kullanıcı) Bilgileri

Alan Adı	Tip	Zorunlu	Açıklama
code	string	Evet	Kullanıcı kodu (benzersiz olmalı)
name	string	Evet	Kullanıcı adı
surname	string	Evet	Kullanıcı soyadı
email	string	Evet	Kullanıcı e-posta adresi
gsm	string	Evet	Cep telefonu numarası
erpCode	string	Hayır	Kullanıcının ERP kodu
description	string	Hayır	Kullanıcı açıklaması
isActive	boolean	Hayır	Aktif / pasif durumu
canUseMobile	boolean	Hayır	Mobil kullanım izni
roles	array(string)	Hayır	Kullanıcının yetki ID listesi
ruleName	array(string)	Hayır	Yetki seti isimleri (örnek: "ROLE_ADMIN")
userType	integer	Hayır	Kullanıcı tipi
sendRegisterMail	boolean	Hayır	Kayıt sonrası bilgilendirme e-postası gönderilsin mi

Not

• sendRegisterMail = true ise, sisteme yeni kullanıcıya bilgilendirme e-postası gönderilir.
• Bir bayi oluşturulurken en az bir kullanıcı (users) tanımlanmalıdır.

Örnek İstek

{  
    "code": "600",  
    "phone": "5000000000",  
    "erpCode": "600",  
    "countryCode": "TKM",  
    "cityCode": "10",  
    "districtCode": 494,  
    "currencyCode": "TRY",  
    "address": "test",  
    "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": "test",  
            "surname": "kullanıcı",  
            "roles": [  
                "61002d8f-8fdd-430a-96dd-c5d87f5c9bda"  
            ],  
            "sendMail": false,  
            "userType": 8387,  
            "code": "test000feafasdvagvawerg"  
        }  
    ]  
}

Başarılı Yanıt

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

Not

• customerId alanı, oluşturulan bayinin sistemdeki benzersiz kimliğidir.
• Bazı sistemlerde bu değer code ile aynı olabilir.

Notlar ve En İyi Uygulamalar

• vendor ve users alanları birlikte gönderilmelidir.

• Benzersizlik: code ve erpCode değerleri sistem genelinde benzersiz olmalıdır.

• Kurumsal zorunluluk:

  • isCompany = true → taxNumber, taxOffice zorunlu
  • isCompany = false → taxNumber, taxOffice opsiyonel

• E-posta bildirimi: sendRegisterMail = true ise kayıt sonrası kullanıcıya bilgilendirme e-postası gönderilir.

• Token yenileme: Token süresi dolduysa yeni token alınıp istek tekrar gönderilmelidir.