# 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}`](/rest-api/companies/get) 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](/concepts/archiving).

## 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](/concepts/record-ids). |
| `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](/concepts/units-currency). |
| `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 exists` döner ve mevcut firma `customer` alanında gelir.
- Benzer adlar varsa `409 similar` döner ve adaylar `similar` listesinde gelir. Doğru firmayı seçin ya da yine de açmak için `confirm_new: true` gönderin.

Bu kural [firma oluştur](/rest-api/companies/create), [görüşme kaydet](/rest-api/activities/log) 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.

## İlgili uçlar

:::cards
- [Firmaları listele](/rest-api/companies/list) list | Süzme, sıralama, sayfalama.
- [Firma oluştur](/rest-api/companies/create) plus | Mükerrer korumalı açma, ilk kişiyle birlikte.
- [Firmayı güncelle](/rest-api/companies/update) pencil | Kısmi güncelleme.
- [Ziyareti ertele](/rest-api/companies/postpone) clock | Ziyaret terminini ileri al.
:::