Skip to main content
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 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 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

​
Linkler

/customers/{customerId}/links

​
Yetkililer

/customers/{customerId}/representatives

​
Banka hesapları

/customers/{customerId}/bank-accounts Iban ya da Branch ile AccountNumber birlikte gönderilmelidir.

​
Grup üyelikleri

/customers/{customerId}/group-members
  • 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 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 EInvoiceLabels listesinde döner.