Firmalar

Firmayı getir

Firma kartının tamamı: kişiler, fırsatlar, son ziyaretler ve denemeler, açık aksiyonlar, teklifler, siparişler, zaman tüneli, rakipler, fiyatlar ve e-posta yazışmaları (threads).

GET/api/v1/customers/{id}

Yetkilendirme

Authorizationheaderzorunlu
Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Modül: MüşterilerKapsam: crm.read

Yol parametreleri

idintegerzorunlu
Firma kimliği.

Hatalar

HTTPerrorAnlamı
404not_foundKayıt bulunamadı.
İstek
curl https://ornek.solk.app/api/v1/customers/1 \
  -H "Authorization: Bearer $SOLK_API_KEY"
Yanıt
{
  "customer": {
    "act": {
      "addr": "İstanbul Organize Sanayi Bölgesi, 3. Cadde No: 25, İstanbul, İstanbul",
      "c": 1,
      "mail": "selin.dogan@alizepaketleme.example",
      "n": "Alize Paketleme San. ve Tic. A.Ş.",
      "tel": "0 (212) 000 55 24",
      "url": "/customers/1",
      "wa": "902120005524",
      "who": "Selin Doğan"
    },
    "active": true,
    "address": "İstanbul Organize Sanayi Bölgesi, 3. Cadde No: 25, İstanbul",
    "at_risk": false,
    "barrier": "",
    "can_edit": true,
    "categories": [
      "Plastik ve Ambalaj"
    ],
    "categories_source": "auto",
    "city": "İstanbul",
    "commit_kg": 1700.0,
    "competitors": [],
    "connection": {
      "computed_at": "2026-10-15T11:02",
      "first_interaction": "2026-08-10T12:00",
      "label": "Güçlü",
      "last_interaction": "2026-10-15T06:02",
      "last_kind": "email_in",
      "next_interaction": null,
      "next_kind": null,
      "strength": 4,
      "strongest_user_id": 1
    },
    "contacts": [
      {
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "department": "Satın Alma",
        "email": "selin.dogan@alizepaketleme.example",
        "id": 1,
        "is_former": false,
        "is_main": true,
        "name": "Selin Doğan",
        "note": "",
        "phone": "0 (212) 000 55 24",
        "rid": "003axHLVxmQvHIP",
        "title": "Satın Alma Müdürü",
        "wa": "902120005524"
      }
    ],
    "created_at": "2026-04-07T09:00:00",
    "currency": "EUR",
    "currency_default": "",
    "custom_fields": [
      {
        "key": "segment",
        "label": "Segment",
        "type": "select",
        "value": "C — fırsat"
      }
    ],
    "demos": [
      {
        "action_date": "2026-09-14",
        "action_done": true,
        "action_state": "done",
        "customer_id": 1,
        "date": "2026-09-09",
        "id": 1,
        "line": "",
        "next_action": "Fiyat Teklifi",
        "opp_id": 1,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "product_id": 1,
        "result": "Başarılı",
        "rid": "a0D9BjB9UFYRZ3N",
        "status": "Deneme Gerçekleştirilmiştir",
        "tech_note": "Mürekkep uyumu iyi; şeffaflık beklentiyi karşıladı.",
        "user": "Deniz Aksoy"
      }
    ],
    "events": [
      {
        "badge": null,
        "dot": "#94a3b8",
        "icon": "geo-alt",
        "kind": "plan",
        "note": "",
        "opp_id": null,
        "planned": true,
        "state": null,
        "sub": "periyot 90 gün · son ziyaret 04.10.2026",
        "title": "Planlanan: ziyaret vadesi",
        "url": "",
        "when": "2027-01-02",
        "who": ""
      }
    ],
    "extra_kg": 800.0,
    "id": 1,
    "initials": "AP",
    "last_visit": "2026-10-04",
    "main_contact": {
      "email": "selin.dogan@alizepaketleme.example",
      "name": "Selin Doğan",
      "phone": "0 (212) 000 55 24",
      "wa": "902120005524"
    },
    "mgmt_note": "",
    "mgmt_support": false,
    "name": "Alize Paketleme San. ve Tic. A.Ş.",
    "next_visit_due": "2027-01-02",
    "note": "",
    "objects": [
      {
        "icon": "gear-wide-connected",
        "key": "uretim_hatti",
        "label": "Üretim hattı",
        "plural": "Üretim hatları",
        "rows": [
          {
            "id": 1,
            "name": "Laminasyon Hattı 1",
            "sub": "Solventsiz laminasyon · 300"
          }
        ]
      }
    ],
    "offers": [
      {
        "currency": "EUR",
        "date": "2026-09-21",
        "id": 1,
        "is_primary": true,
        "kg": 1500.0,
        "lines": 1,
        "locked": true,
        "monthly_amount": 5880.0,
        "payment_days": 120,
        "pdf_url": "/offers/1/pdf",
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "pu": "€/kg",
        "quote_no": "TKL-2026-0001",
        "state": "presented",
        "status": "Kabul",
        "unit": "kg",
        "valid_until": "2026-10-21"
      }
    ],
    "open_actions": [
      {
        "customer": "",
        "customer_id": null,
        "date": "2026-10-30",
        "icon": "⚡",
        "id": 73,
        "key": "visit:73",
        "kind": "visit",
        "label": "Ziyaret Planla",
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_id": 31,
        "src": "Ziyaret",
        "state": "open",
        "url": "/action/visit/73"
      }
    ],
    "open_opps": 1,
    "opps": [
      {
        "bant": 0,
        "base_currency": "EUR",
        "close_date": "2027-04-12",
        "cur_sym": "€",
        "currency": "EUR",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_city": "İstanbul",
        "customer_id": 1,
        "days_in_stage": 1,
        "detail_status": "",
        "fc": "Omitted",
        "health": null,
        "health_color": null,
        "health_manual": false,
        "health_note": "",
        "id": 44,
        "initials": "AP",
        "is_account": true,
        "is_open": false,
        "last_update": "2026-10-15",
        "lifetime_left": 179,
        "line": "",
        "name": "Müşteri Takibi",
        "next_step": null,
        "offer_price": null,
        "owner": {
          "color": "#5867e8",
          "full_name": "Deniz Aksoy",
          "id": 1,
          "photo": null,
          "role": "admin",
          "role_label": "Yönetici",
          "username": "admin"
        },
        "payment_days": null,
        "potential_kg": null,
        "prob": 0.0,
        "probability": null,
        "product": "",
        "product_id": null,
        "pu": "€/kg",
        "rid": "006l87fvwUhNwPa",
        "sla_days": null,
        "sla_left": null,
        "source": "",
        "stage": "Account",
        "stage_label": "Müşteri Takibi",
        "start_date": "2026-10-14",
        "trend": "",
        "trend_label": "Otomatik",
        "type": "Müşteri Takibi",
        "unit": "kg",
        "unit_code": "kg",
        "value": 0,
        "value_base": 0,
        "value_short": "0"
      }
    ],
    "orders": [
      {
        "amount": 2744.0,
        "currency": "EUR",
        "customer_id": 1,
        "customer_po": "",
        "date": "2026-10-15",
        "due_date": "2026-10-25",
        "erp": null,
        "id": 1,
        "kg": 700.0,
        "kind": "İlk Sipariş",
        "note": "",
        "opp_id": 1,
        "payment_days": 120,
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "product_id": 1,
        "pu": "€/kg",
        "status": "Açık",
        "unit": "kg"
      }
    ],
    "our_kg_current": 1600.0,
    "our_kg_target": 2400.0,
    "owner": {
      "color": "#5867e8",
      "full_name": "Deniz Aksoy",
      "id": 1,
      "photo": null,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "pending_state": "open",
    "period": 90,
    "phone": "0 (212) 000 15 65",
    "pot": {
      "on": true,
      "title": "Potansiyel ve pazar payı"
    },
    "potential_kg": 8000.0,
    "potentials": [
      {
        "gap": 800.0,
        "grp": "",
        "label": "Tüm ürünler",
        "legacy": true,
        "ours": 1600.0,
        "ours_auto": 233.3,
        "ours_manual": 1600.0,
        "ours_src": "manual",
        "potential": 8000.0,
        "share": 20.0,
        "share_target": 30.0,
        "supplier": "Distribütör ürünü",
        "unit": "kg",
        "unit_label": "kg"
      }
    ],
    "prices": [
      {
        "currency": "EUR",
        "id": 1,
        "payment_days": 120,
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "product_id": 1,
        "pu": "€/kg",
        "source": "TKL-2026-0001 (Win)",
        "valid_until": "2027-10-13"
      }
    ],
    "priority_score": 10.0,
    "relations": [
      {
        "id": 3,
        "kind": "customer",
        "label": "Şubeler / bağlı firmalar",
        "name": "Lotus Medikal Ambalaj San. Tic. Ltd. Şti.",
        "type": "parent"
      }
    ],
    "rid": "001ORO926mXCqn8",
    "sector": "Gıda ambalajı",
    "share_current": 20.0,
    "share_start": null,
    "share_target": 30.0,
    "status": "AC",
    "status_label": "Aktif Müşteri",
    "supplier_note": "Distribütör ürünü",
    "tax_no": null,
    "tax_office": null,
    "threads": [
      {
        "category": "musteri",
        "category_color": "#2a78d6",
        "category_label": "Müşteri yazışması",
        "category_source": "rule",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "id": 1,
        "last_at": "2026-10-15T06:02:00",
        "last_dir": "in",
        "n": 2,
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_how": "single",
        "opp_id": 31,
        "opp_note": "firmanın tek açık projesi",
        "peer": "Selin Doğan",
        "subject": "Tanışma görüşmesi ve teknik föyler",
        "suggested": false,
        "waiting": true
      }
    ],
    "threads_n": 2,
    "unit": "kg",
    "visit_overdue_days": -79,
    "visit_period_days": null,
    "visit_postponed_until": null,
    "visit_state": "ok",
    "visits": [
      {
        "action_date": "2026-10-30",
        "action_done": false,
        "action_state": "open",
        "contact": "Selin Doğan",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "date": "2026-10-04",
        "id": 73,
        "line": "",
        "next_action": "Ziyaret Planla",
        "note": "Aylık tüketim ve stok seviyesi konuşuldu; sipariş tahmini alındı.",
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_id": 31,
        "product": "",
        "result": "Bütçe onayı bekleniyor",
        "rid": "00UuPRn6Jj1l9UU",
        "topic": "Tanışma",
        "type": "Call",
        "user": "Deniz Aksoy"
      }
    ],
    "website": "www.alizepaketleme.example"
  },
  "ok": true
}

Örnek yanıt örnek veriyle çalışan bir v98 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.