HuginOps APILeads

Create Lead

View as Markdown
# Create Lead - Ön Sipariş Oluşturma Yeni bir ön sipariş (lead) oluşturur. Bu endpoint, müşterinin bankaya ilk kez gitmesi durumunda kullanılır. ## Request Body ### Zorunlu Alanlar | Parametre | Tip | Max Uzunluk | Açıklama | | --- | --- | --- | --- | | `firstName` | string | 60 | Ad | | `lastName` | string | 60 | Soyad | | `cellularPhone` | string | - | SMS alabilen cep telefonu | | `email` | string | - | Email adresi | | `shippingAddress` | object | - | Teslimat adresi | | `shippingAddress.street` | string | 150 | Sokak adresi | | `shippingAddress.district` | string | 30 | İlçe | | `shippingAddress.cityCode` | int | - | İl kodu 0–99 | | `companyName` | string | 100 | Firma resmi ünvanı | | `companyKnownAs` | string | 100 | Slipteki tabela adı | | `taxOfficeName` | string | 50 | Vergi dairesi adı | | `vkn` | string | - | Vergi kimlik numarası (TCKN veya VKN en az biri) | | `tckn` | string | - | TC kimlik numarası | | `leadQuantity` | int | - | Sipariş adedi (1–999, varsayılan: 1) | | `productCode` | string | 10 | Ürün kodu | ### Opsiyonel Alanlar | Parametre | Tip | Max Uzunluk | Açıklama | | --- | --- | --- | --- | | `branchCode` | int | - | Cihazın kullanılacağı şubenin mali kodu | | `terminalId` | string | 50 | Terminal ID (normalize edilir: son 8 karakter veya 0 ile doldurulur) | | `merchantId` | string | 50 | Üye işyeri numarası | | `deviceId` | string | 12 | Cihaz sicil numarası (mali id)| | `invoiceNumber` | string | 50 | Cihazın satış faturasının numarası | | `invoiceDate` | string | 50 |Cihazın satış faturasının tarihi | | `bankOrderNo` | string | 50 | Banka referans numarası | | `phone` | string | - | Sabit telefon | | `shippingAddress.county` | string | 30 | Semt | | `shippingAddress.postCode` | int | - | Posta kodu 0–99999 | | `billingAddress` | object | - | Fatura adresi | | `billingAddress.street` | string | 150 | Fatura adresi sokak | | `billingAddress.county` | string | 20 | Fatura adresi semt | | `billingAddress.district` | string | 20 | Fatura adresi ilçe | | `billingAddress.postCode` | int | - | Fatura adresi posta kodu 0–99999 | | `billingAddress.cityCode` | int | - | Fatura il kodu 0–99 | | `comments` | string | 1000 | Açıklamalar | ## İş Kuralları 1. **TCKN/VKN Validasyonu**: - TCKN: 11 haneli, doğrulama yapılır. - VKN: 10 haneli, doğrulama yapılır. - En az biri (TCKN VEYA VKN) zorunlu 2. **Telefon Normalizasyonu**: - Boşluk ve parantez karakterleri temizlenir - 10 karakterden uzunsa: Son 10 karakter alınır 3. **Email Normalizasyonu**: - Geçersiz email formatı ise boş string yapılır (hata verilmez) 4. **Terminal ID ile Sipariş**: - Terminal ID ile kayıt için sadece 1 adet sipariş geçilebilir (`lead_quantity` > 1 olamaz) - Eğer terminal ID zaten varsa, mevcut sipariş döner (yeni sipariş oluşturulmaz) 5. **Ürün kodu**: Aşağıdaki tablodaki geçerli ürün kodlarını kullanabılabilir | Değer | |-------| | OKC_T300 | | OKC_S1 | | V507_N910 | | V507_N750 | | MPOS_N910 | | MPOS_N750 | ## Response Başarılı durumda dönen `leadId` değeri, sipariş takip numarasıdır ve diğer endpoint'larda kullanılır.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
firstNamestringRequired
lastNamestringRequired
emailstringRequiredformat: "email"
phonestringRequired
cellularPhonestringRequired
shippingAddressobjectRequired
billingAddressobjectRequired
companyNamestringRequired
companyKnownAsstringRequired
vknstringRequired
tcknstringRequired
terminalIdstringRequired
taxOfficeNamestringRequired
productCodestringRequired
leadQuantityintegerRequired

Response

OK
statusstring
dataobject
metadataobject

Errors

400
Bad Request Error