Firmalar
Müşteri ve aday firmalar — CRM'deki her kaydın bağlandığı ana nesne.
Firma (API'de customer) CRM'in merkezidir. Kişiler, fırsatlar, ziyaretler, denemeler, teklifler, siparişler, sözleşmeler, destek talepleri ve e-posta yazışmaları bir firmaya bağlanır. Firma kartı bunların hepsini tek sayfada gösterir; API'de GET /api/v1/customers/{id} aynı içeriği döndürür.
Durum
| Değer | Anlamı |
|---|---|
Prospect |
Aday — henüz satış yapılmamış firma. Yeni firmaların varsayılanı. |
AC |
Aktif müşteri. Bir fırsat kazanıldığında firma kendiliğinden AC olur. |
Firmalar silinmez, pasife alınır (active: false): pasif firmalar listelerden ve hatırlatıcılardan çıkar, geçmişi korunur. API'de silme ucu yoktur; pasif firmaları GET /api/v1/customers?active=0 listeler. Ayrıntı: Pasifleştirme ve silme.
Alanlar
Liste uçları her firma için satır biçimini, tekil uç kart biçimini döndürür. Kart, satırdaki her alanı da içerir.
| Alan | Tür | Açıklama |
|---|---|---|
id |
integer | Kurulum içindeki kimlik. |
rid |
string | 15 karakterlik kalıcı kayıt kimliği (001…). Kayıt kimlikleri. |
name |
string | Firma adı (en çok 200 karakter). |
status, status_label |
string | AC / Prospect ve görünen adı. |
owner |
user | Sorumlu satışçı (id, full_name, role). |
city, sector, phone |
string | İletişim bilgileri. |
main_contact |
object | Ana kişinin adı, telefonu, e-postası ve WhatsApp numarası (wa). |
visit_state |
string | Ziyaret takvimi: overdue gecikti, soon yaklaşıyor, ok, none takvim yok. |
last_visit, next_visit_due |
date | Son ziyaret ve sıradaki ziyaret günü. |
open_opps |
integer | Açık fırsat sayısı. |
at_risk |
boolean | Müşteri risk altında (uzun süredir ziyaret ya da sipariş yok). |
potential_kg, unit |
number, string | Aylık potansiyel ve kurulumun ana birimi. Birim ve döviz. |
currency |
string | Firmanın işlem dövizi. |
pending_state |
string | En acil açık aksiyonun durumu. |
Kartta ayrıca: address, website, note, supplier_note (mevcut tedarikçi), barrier (engel), mgmt_support, visit_period_days, pay alanları (share_start, share_current, share_target), miktar hedefleri (our_kg_current, our_kg_target, commit_kg), contacts, opps, visits, demos, offers, orders, open_actions, events (zaman tüneli), competitors, prices, threads ve can_edit gelir.
Mükerrer koruması
Firma açarken ad, mevcut firmalarla karşılaştırılır:
- Aynı ad (büyük-küçük harf, şirket türü ekleri ve noktalama yok sayılarak) varsa
409 existsdöner ve mevcut firmacustomeralanında gelir. - Benzer adlar varsa
409 similardöner ve adaylarsimilarlistesinde gelir. Doğru firmayı seçin ya da yine de açmak içinconfirm_new: truegönderin.
Bu kural firma oluştur, görüşme kaydet ve gelen kancalarda (form, veri eşitleme) aynıdır.
Otomatik açılan firmalar
E-posta eşitlemesi, form başvuruları, Segment ve veri eşitleme kancaları yeni firma açabilir. E-postadan açılan firmalar alan adından tanınır (auto_domain) ve firma kartında "otomatik açıldı" bandıyla görünür; kullanıcı yanlışsa tek tıkla geri alır.