Firmalar

Firmayı güncelle

Yalnız gönderilen alanlar değişir; boş metin alanı temizler. PUT ve POST da kabul edilir. Firmayı düzenleme yetkisi gerekir (sorumlu, yönetici ya da görünürlük kuralının izin verdiği kullanıcı).

PATCH/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.write

Yol parametreleri

idintegerzorunlu

Firma kimliği.

Gövde application/json

namestringisteğe bağlı

Firma adı.

statusstringisteğe bağlı

Durum.

DeğerlerACProspect

owner_idintegeristeğe bağlı

Sorumlu (yalnız yönetici).

visit_period_daysintegeristeğe bağlı

Ziyaret sıklığı (gün).

sector / city / phone / website / address / notestringisteğe bağlı

Metin alanları.

supplier_note / barrier / mgmt_notestringisteğe bağlı

Mevcut tedarikçi, engel ve yönetim notu.

potential_kg / commit_kg / our_kg_current / our_kg_targetnumberisteğe bağlı

Miktar alanları (aylık).

share_start / share_current / share_targetnumberisteğe bağlı

Pay yüzdeleri.

mgmt_supportbooleanisteğe bağlı

Yönetim desteği var.

Hatalar

HTTP	error	Anlamı
`403`	`forbidden`	Kaydı görme / düzenleme yetkiniz yok.
`404`	`not_found`	Kayıt bulunamadı.

İstek

curl -X PATCH https://ornek.solk.app/api/v1/customers/31 \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "AC",
  "visit_period_days": 30,
  "note": "Yıllık sözleşme görüşülüyor."
}'

const res = await fetch("https://ornek.solk.app/api/v1/customers/31", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "status": "AC",
    "visit_period_days": 30,
    "note": "Yıllık sözleşme görüşülüyor."
  }),
});
const data = await res.json();

import os, requests

r = requests.patch(
    "https://ornek.solk.app/api/v1/customers/31",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "status": "AC",
        "visit_period_days": 30,
        "note": "Yıllık sözleşme görüşülüyor."
    },
)
print(r.json())

Yanıt

{
  "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": true,
    "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": "Yıllık sözleşme görüşülüyor.",
    "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": 30,
    "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": "AC",
    "status_label": "Aktif Müşteri",
    "supplier_note": "",
    "threads": [],
    "threads_n": 0,
    "unit": "kg",
    "visit_overdue_days": 0,
    "visit_period_days": 30,
    "visit_postponed_until": null,
    "visit_state": "none",
    "visits": [],
    "website": "kuzeyplastik.com.tr"
  },
  "ok": true
}

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