# Firma oluştur

`POST /api/v1/customers`

Yeni firma açar (durum verilmezse `Prospect`, sorumlu isteği yapan kullanıcı). Aynı adda firma varsa `409 exists`, benzer adlar varsa `409 similar` döner ve `similar` listesi gelir — yine de açmak için `confirm_new: true` gönderin. İsteğe bağlı olarak ilk kişi de açılır.

## Gövde

| Alan | Tür | Açıklama |
|---|---|---|
| `name` (zorunlu) | string | Firma adı (en çok 200 karakter). |
| `status` | string | Durum. Değerler: `AC`, `Prospect` |
| `city` | string | Şehir. |
| `sector` | string | Sektör. |
| `phone` | string | Telefon. |
| `website` | string | Web sitesi. |
| `address` | string | Adres. |
| `note` | string | Not. |
| `owner_id` | integer | Sorumlu kullanıcı (yalnız yönetici). |
| `visit_period_days` | integer | Kaç günde bir ziyaret edilmeli. |
| `potential_kg` | number | Aylık potansiyel miktar (kurulumun ana biriminde). |
| `contact_name` | string | İlk kişinin adı (ana kişi olur). |
| `contact_title` | string | İlk kişinin unvanı. |
| `contact_email` | string | İlk kişinin e-postası. |
| `contact_phone` | string | İlk kişinin telefonu. |
| `confirm_new` | boolean | Benzer adlar olsa da aç. |

## Yanıt

```json 200
{
  "customer": {
    "act": {
      "addr": "Bursa",
      "c": 31,
      "mail": "selin.kara@kuzeyplastik.com.tr",
      "n": "Kuzey Plastik Sanayi",
      "tel": "+90 224 555 01 02",
      "url": "/customers/31",
      "wa": "902245550102",
      "who": "Selin Kara"
    },
    "active": true,
    "address": "",
    "at_risk": false,
    "barrier": "",
    "can_edit": true,
    "city": "Bursa",
    "commit_kg": null,
    "competitors": [],
    "contacts": [
      {
        "customer": "Kuzey Plastik Sanayi",
        "customer_id": 31,
        "department": "",
        "email": "selin.kara@kuzeyplastik.com.tr",
        "id": 58,
        "is_former": false,
        "is_main": true,
        "name": "Selin Kara",
        "note": "",
        "phone": "",
        "rid": "003URRQi11tfUY7",
        "title": "Satın Alma Müdürü",
        "wa": ""
      }
    ],
    "created_at": "2026-10-02T20:07:00",
    "currency": "EUR",
    "currency_default": "",
    "demos": [],
    "events": [
      {
        "badge": null,
        "dot": "#94a3b8",
        "icon": "building",
        "kind": "firma",
        "note": "",
        "opp_id": null,
        "planned": false,
        "state": null,
        "sub": "Firma #31 · Deniz Aksoy",
        "title": "Firma kaydı açıldı",
        "url": "",
        "when": "2026-10-02",
        "who": ""
      }
    ],
    "extra_kg": null,
    "id": 31,
    "initials": "KP",
    "last_visit": null,
    "main_contact": {
      "email": "selin.kara@kuzeyplastik.com.tr",
      "name": "Selin Kara",
      "phone": "",
      "wa": ""
    },
    "mgmt_note": "",
    "mgmt_support": false,
    "name": "Kuzey Plastik Sanayi",
    "next_visit_due": null,
    "note": "",
    "offers": [],
    "open_actions": [],
    "open_opps": 0,
    "opps": [],
    "orders": [],
    "our_kg_current": null,
    "our_kg_target": null,
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "pending_state": null,
    "period": 180,
    "phone": "+90 224 555 01 02",
    "potential_kg": null,
    "prices": [],
    "priority_score": 0.0,
    "rid": "001QJi5Zr1Hk2VH",
    "sector": "Plastik",
    "share_current": null,
    "share_start": null,
    "share_target": null,
    "status": "Prospect",
    "status_label": "Prospect",
    "supplier_note": "",
    "threads": [],
    "threads_n": 0,
    "unit": "kg",
    "visit_overdue_days": 0,
    "visit_period_days": null,
    "visit_postponed_until": null,
    "visit_state": "none",
    "visits": [],
    "website": "kuzeyplastik.com.tr"
  },
  "ok": true
}
```

```json 409
{
  "error": "similar",
  "message": "Benzer adlı firma var — mevcut kaydı seçin ya da confirm_new=1 ile yeni açın.",
  "ok": false,
  "similar": [
    {
      "active": true,
      "at_risk": false,
      "city": "Kocaeli",
      "currency": "EUR",
      "currency_default": "",
      "id": 2,
      "initials": "FA",
      "last_visit": "2026-09-24",
      "main_contact": {
        "email": "elif.karaca@filizambalaj.example",
        "name": "Elif Karaca",
        "phone": "0 (262) 000 27 12",
        "wa": "902620002712"
      },
      "name": "Filiz Ambalaj Ltd. Şti.",
      "next_visit_due": "2026-12-23",
      "open_opps": 1,
      "owner": {
        "full_name": "Deniz Aksoy",
        "id": 1,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "pending_state": "soon",
      "period": 90,
      "phone": "0 (262) 000 83 56",
      "potential_kg": 40000.0,
      "rid": "001rutEPiRkEPfD",
      "sector": "Gıda ambalajı",
      "status": "AC",
      "status_label": "Aktif Müşteri",
      "unit": "kg",
      "visit_overdue_days": -82,
      "visit_state": "ok"
    }
  ]
}
```