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).
Yetkilendirme
AuthorizationheaderzorunluBearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Modül: MüşterilerKapsam:
crm.readYol parametreleri
idintegerzorunluFirma kimliği.
Hatalar
| HTTP | error | Anlamı |
|---|---|---|
404 | not_found | Kayıt bulunamadı. |
İstek
curl https://ornek.solk.app/api/v1/customers/1 \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/customers/1", {
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
},
});
const data = await res.json();import os, requests
r = requests.get(
"https://ornek.solk.app/api/v1/customers/1",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())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ı.