> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt > Use this file to discover all available pages before exploring further. # Alt kayıtlar > Adres, telefon, link, yetkili, banka hesabı, grup üyeliği ve parametre kuralları. Carinin alt kayıtları iki şekilde yönetilir: * **Cari oluştururken**: `POST /customers` gövdesindeki listelerle, cariyle aynı işlemde. Herhangi bir kayıt hatalıysa cari de oluşmaz. * **Sonradan**: Her alt kaydın kendi endpoint'leriyle (`/customers/{customerId}/addresses` vb.). Bu endpoint'ler listeleme, detay, ekleme, güncelleme ve silme sunar. [Cari güncelleme](/tr/v1/customers/update) alt kayıtları değiştirmez. Alt kayıtları kendi endpoint'leriyle güncelleyin. Cari kullanıcıya görünmüyorsa tüm alt kayıt endpoint'leri **404** döner. Alt kayıt güncellemeleri **tam değiştirme** şeklinde çalışır: gönderilmeyen alanlar temizlenir. ## Adresler `/customers/{customerId}/addresses` | Alan | Kural | | ---------------------------- | --------------------------------------------------------------------------------------------------- | | `DistrictId` | **Zorunlu.** [İlçe listesinden](/tr/v1/definitions/districts/list) bir ID. İl ve ülke ilçeden gelir | | `Address` | **Zorunlu.** Açık adres | | `PostalCode` | Posta kodu | | `IsInvoiceAddress` | Fatura adresi mi | | `CoordinateX`, `CoordinateY` | Konum koordinatları | Yanıttaki `FullAddress` alanı ilçe, il ve ülkeyle birleştirilmiş tam adrestir ve sadece okunur. ### Fatura adresi kuralları Bir carinin her zaman **tam olarak bir** fatura adresi vardır. * **Cari oluştururken** tek adres gönderilirse o adres fatura adresi olur. Birden fazla adres gönderilirse tam olarak birinde `IsInvoiceAddress: true` olmalıdır. * **Adres eklerken** carinin ilk adresi her zaman fatura adresi olur. `IsInvoiceAddress: true` ile eklenen yeni adres fatura adresi olur ve önceki adresin işareti kaldırılır. * Fatura adresinin işareti güncelleme ile **kaldırılamaz** ve fatura adresi **silinemez**. Önce başka bir adresi fatura adresi yapın. ## Telefonlar `/customers/{customerId}/telephones` | Alan | Kural | | ------------- | ------------------------------- | | `Number` | **Zorunlu.** Telefon numarası | | `NumberType` | `1` Sabit hat, `2` Cep telefonu | | `Extension` | Dahili numara | | `Description` | Açıklama | ## Linkler `/customers/{customerId}/links` | Alan | Kural | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `Value` | **Zorunlu.** E-posta adresi ya da URL | | `LinkType` | `0` Diğer, `1` E-posta, `2` Web sitesi, `3` LinkedIn, `4` Instagram, `5` X. Tip `1` ise değer geçerli bir e-posta adresi olmalıdır | | `Description` | Açıklama | ## Yetkililer `/customers/{customerId}/representatives` | Alan | Kural | | --------------------------- | --------------------------------------- | | `FullName` | **Zorunlu.** Ad soyad | | `Position` | Görev | | `Email` | E-posta. Gönderilirse geçerli olmalıdır | | `Gsm`, `Phone`, `Extension` | Cep, sabit telefon, dahili | | `Link` | Bağlantı (ör. LinkedIn profili) | | `Description` | Açıklama | ## Banka hesapları `/customers/{customerId}/bank-accounts` | Alan | Kural | | ------------------------- | --------------------------------------------------------------------------- | | `BankName` | **Zorunlu.** Banka adı | | `CurrencyId` | **Zorunlu.** [Döviz listesinden](/tr/v1/definitions/currencies/list) bir ID | | `Iban` | IBAN | | `Branch`, `AccountNumber` | Şube ve hesap numarası | | `Description` | Açıklama | `Iban` ya da `Branch` ile `AccountNumber` birlikte gönderilmelidir. ## Grup üyelikleri `/customers/{customerId}/group-members` | Alan | Kural | | --------------- | ---------------------------------------------------------------------------------------- | | `GroupDetailId` | **Zorunlu.** [Cari gruplarındaki](/tr/v1/customers/definitions/groups) bir detayın ID'si | * Bir cari aynı grup detayına yalnızca bir kez üye olabilir. * Bazı gruplar **zorunlu** olarak tanımlanmış olabilir. Cari oluştururken her zorunlu gruptan en az bir detay gönderilmelidir. Bu kontrol yalnızca oluşturmada yapılır; üyelik silinirken kontrol edilmez. ## Parametreler `/customers/{customerId}/parameters` | Alan | Kural | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ParameterDefinitionId` | **Zorunlu.** [Cari parametre tanımlarından](/tr/v1/customers/definitions/parameter-definitions/list) bir ID. Bir caride aynı tanım bir kez kullanılabilir | | `Value` | **Zorunlu.** Formatı tanımın tipine göre değişir | | Tip | Anlamı | Örnek `Value` | | --- | ------------------------ | ----------------------- | | `0` | Metin | `"Öncelikli"` | | `1` | Evet/Hayır | `true` | | `2` | Tam sayı | `12` | | `3` | Ondalık sayı (nokta ile) | `12.5` | | `4` | Tarih | `"2026-09-17"` | | `5` | Saat | `"14:30"` | | `6` | Tarih ve saat | `"2026-09-17T14:30:00"` | Yanıttaki `ParameterType` tanımın tipini, `Value` bu tipe uygun değeri gösterir. ## E-fatura etiketleri E-fatura etiketleri (GİB posta kutusu alias'ları) API ile gönderilemez, sadece okunur. Cari oluştururken `QueryEInvoiceLabels: true` gönderirseniz cari kaydedildikten sonra etiketler e-fatura entegratöründen `TaxNumber` ile sorgulanır: * Bulunan etiketler kaydedilir, ilki varsayılan olarak işaretlenir. * Sorgu başarısız olursa **cari yine de oluşturulur**; etiketler boş kalır. Etiketler [cari detayında](/tr/v1/customers/get) `EInvoiceLabels` listesinde döner.