Fırsatlar

Fırsatı güncelle

Sık değişen alanlar: miktar, birim fiyat (değişince teklif geçmişine yazılır), vade, kapanış tarihi (değişiklik günlüğe yazılır), sonraki adım tarihi, not, ürün, tür, hat, ad, öngörü kategorisi ve aşama etiketi. Aşama değiştirmek için aşama ucunu kullanın.

POST/api/v1/opportunities/{id}/fields

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: FırsatlarKapsam: crm.write

Yol parametreleri

idintegerzorunlu

Fırsat kimliği.

Gövde application/json

potential_kgnumberisteğe bağlı

Aylık miktar.

offer_pricenumberisteğe bağlı

Birim fiyat.

payment_daysintegeristeğe bağlı

Vade (gün).

close_datestringisteğe bağlı

Kapanış tarihi (YYYY-MM-DD).

next_step_datestringisteğe bağlı

Sonraki adım tarihi.

notestringisteğe bağlı

Not.

product_idintegeristeğe bağlı

Ürün.

typestringisteğe bağlı

Tür.

linestringisteğe bağlı

Hat.

namestringisteğe bağlı

Ad.

forecast_catstringisteğe bağlı

Öngörü kategorisi.

DeğerlerPipelineBest CaseCommitClosedOmitted

detail_statusstringisteğe bağlı

Aşamaya uyan ayrıntı etiketi (Makro hattı).

Hatalar

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

İstek

curl -X POST https://ornek.solk.app/api/v1/opportunities/53/fields \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "close_date": "2026-11-16",
  "forecast_cat": "Best Case",
  "note": "Numune onayı bekleniyor."
}'

const res = await fetch("https://ornek.solk.app/api/v1/opportunities/53/fields", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "close_date": "2026-11-16",
    "forecast_cat": "Best Case",
    "note": "Numune onayı bekleniyor."
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/opportunities/53/fields",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "close_date": "2026-11-16",
        "forecast_cat": "Best Case",
        "note": "Numune onayı bekleniyor."
    },
)
print(r.json())

Yanıt

{
  "ok": true,
  "opp": {
    "bant": 0,
    "bant_a": false,
    "bant_b": false,
    "bant_n": false,
    "bant_t": false,
    "base_currency": "EUR",
    "can_edit": true,
    "can_revive": false,
    "close_category": "",
    "close_date": "2026-11-16",
    "close_reason": "",
    "closed_at": null,
    "competitor": "Mevcut tedarikçi",
    "cur_sym": "€",
    "currency": "EUR",
    "customer": "Kuzey Plastik Sanayi",
    "customer_city": "Bursa",
    "customer_id": 31,
    "days_in_stage": 0,
    "demos": [],
    "detail_status": "",
    "fc": "Best Case",
    "gate_ok": false,
    "gate_problems": [
      "BANT kriterleri 4/4 sağlanmalı (Budget · Authority · Need · Time)"
    ],
    "guide": "BANT 4/4",
    "health": {
      "grade": "success",
      "label": "sağlıklı",
      "score": 85
    },
    "health_color": "g",
    "health_manual": false,
    "health_note": "",
    "health_why": [
      [
        "−15"
      ]
    ],
    "id": 53,
    "initials": "KP",
    "is_account": false,
    "is_open": true,
    "last_update": "2026-10-02",
    "lifetime_left": 180,
    "line": "",
    "logs": [
      {
        "date": "2026-10-02T20:07:00",
        "from": null,
        "note": "Proje açıldı (mobil)",
        "to": "Qualify",
        "user": "Deniz Aksoy"
      }
    ],
    "name": "Streç film tedariki",
    "next_stage": "Viable",
    "next_step": "Karar verici / yetkili kişiyi belirle (Authority)",
    "note": "Numune onayı bekleniyor.",
    "notes": [],
    "offer_price": 2.35,
    "offers": [],
    "orders": [],
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "payment_days": 60,
    "potential_kg": 12000.0,
    "prob": 0.1,
    "probability": null,
    "product": "",
    "product_id": null,
    "pu": "€/kg",
    "rid": "006BMHmVNZ9nFLS",
    "sla_days": 30,
    "sla_left": 30,
    "source": "",
    "stage": "Qualify",
    "stage_label": "Qualify",
    "start_date": "2026-10-02",
    "steps": [
      {
        "assignee": {
          "full_name": "Deniz Aksoy",
          "id": 1,
          "role": "admin",
          "role_label": "Yönetici",
          "username": "admin"
        },
        "auto": false,
        "done": false,
        "due_date": null,
        "id": 467,
        "note": "",
        "stage": "Qualify",
        "state": "open",
        "title": "Karar verici / yetkili kişiyi belirle (Authority)"
      }
    ],
    "tags": [],
    "tasks": [],
    "threads": [],
    "threads_n": 0,
    "trend": "",
    "trend_label": "Otomatik",
    "type": "",
    "unit": "kg",
    "unit_code": "kg",
    "value": 338400.0,
    "value_base": 338400.0,
    "value_short": "338K",
    "visits": [],
    "weighted": 33840.0
  }
}

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