Temel kavramlar

Aşamalar ve kapılar

Satış aşamaları kuruluma göre tanımlanır; aşama kapıları açıksa fırsat ancak koşulları sağladığında ilerler.

Her kurulumun satış hattı Ayarlar → Aşamalar sayfasında tanımlanır: açık aşamaların anahtarı, adı ve rengi, kazanıldı / kaybedildi / iptal adları, İptal aşamasının açık olup olmadığı ve aşama kuralları.

Aşama anahtarları

API her zaman anahtarı kullanır; ad kullanıcıya gösterilir. Kapanış anahtarları sabittir:

Anahtar Anlamı
Win Kazanıldı
Lost Kaybedildi
Cancel İptal (kurulumda kapalı olabilir)
Account Müşteri takibi kabı (satış hunisinde sayılmaz)

Açık aşama anahtarları kuruluma özeldir. Örneğin Teknik satış süreci — 8 aşama kalıbı Qualify, Viable, Present Solution, Negotiation, Expect to Close; yeni bir kurulumun varsayılanı Hızlı başlangıç — 4 aşama kalıbı Lead, In Progress kullanır. Kalıp Ayarlar → Aşamalar'dan seçilir, sonra aşamalar serbestçe düzenlenir (Pipeline ve satış öngörüsü). Anahtarları sabit kodlamayın — GET /api/v1/me yanıtından okuyun:

"constants": {
  "stages": ["Qualify", "Viable", "Present Solution", "Negotiation", "Expect to Close", "Win", "Lost", "Cancel"],
  "open_stages": ["Qualify", "Viable", "Present Solution", "Negotiation", "Expect to Close"],
  "stage_labels": { "Qualify": "Qualify", "Win": "Win", "Lost": "Lost", "…": "…" },
  "stage_sla": { "Qualify": 30, "Viable": 60, "Present Solution": 60, "Negotiation": 30, "Expect to Close": 15 },
  "stage_rules": true
}

Aşama kapıları

Kapılar Ayarlar → Aşamalar → Kurallar bölümünde düzenlenir — her satış hattında (yalnız Teknik satış sürecinde değil):

  • Aşama kapıları anahtarı: açıkken fırsat bir aşamadan ileri geçmeden önce o aşamanın çıkış koşulları denetlenir; kapalıyken aşamalar serbestçe değişir.
  • Sırayla ilerlesin: ileri geçiş yalnız bir sonraki aşamaya yapılır. Kapalıysa aşama atlanabilir; atlanan aşamaların koşulları da aranır.
  • Çıkış koşulları: kapı haritasında aşamanın satırına (ya da aşama çekmecesinde Çıkış koşulları'na) tıklayın, Koşul ekle ile listeden seçin. Her koşul Engeller (sağlanmadan geçilemez) ya da Uyarır (geçilir, eksik hatırlatılır) olabilir; bir aşamaya en çok 10 koşul.
  • Kazanıldı: hangi aşamalardan seçilebileceği (hepsi seçiliyse her aşamadan) ve Kazanmak için ek koşullar. Kazanırken bulunulan aşamanın çıkış koşulları da aranır.
  • Geri gitmek, Kaybedildi ve İptal her zaman serbesttir. Kapanmış bir fırsat yeniden açılmaz; Fırsatı canlandır yeni kayıt açar.
  • Varsayılana dön hattın varsayılan kapılarını geri getirir. Hazır kalıp ya da kalıp uygulandığında da kapılar kalıbın varsayılanına döner.

Koşul listesi:

Koşul Ne zaman sağlanır?
BANT 4/4 Bütçe, yetki, ihtiyaç ve zaman işaretli
Karar verici bağlı Fırsata en az bir kişi bağlı (karar vericiler ya da görüşmedeki kişi)
Ürün seçildi Fırsatta ürün seçili
Tutar girildi Miktar × fiyat ya da tahmini tutar
Kapanış tarihi güncel Beklenen kapanış tarihi geçmemiş
Görüşme yapıldı Fırsat başladıktan sonra ziyaret, arama ya da online görüşme
Yüz yüze görüşme Fırsat başladıktan sonra yüz yüze ziyaret (firma ayarına göre online da sayılır)
Deneme yapıldı · Deneme sonucu olumlu Deneme kaydı · son denemenin sonucu Başarılı ya da Kısmen Olumlu (Denemeler modülü)
Teklif fiyatı · Teklif kaydı Teklif fiyatı (ya da tahmini tutar) girildi · fırsatta kayıtlı teklif var
Sipariş alındı Fırsata bağlı ilk sipariş
Kontrol listesi tamam Aşamanın kontrol adımları bitti
Sıradaki adım planlı Bugün ya da sonrası için tarihli sonraki adım, aksiyon ya da görev
Özel alan dolu Seçilen fırsat özel alanı boş değil

Teknik satış süreci kalıbının varsayılan kapıları: Qualify → BANT 4/4 · Viable → yüz yüze görüşme + ürün · Present Solution → deneme sonucu olumlu · Negotiation → teklif fiyatı; sırayla; Win yalnız Negotiation ve Expect to Close'dan. Kapıları değiştirmediğiniz sürece davranış önceki sürümlerle aynıdır.

Engelleyen koşul sağlanmazsa aşama ucu 409 gate döner:

{
  "ok": false,
  "error": "gate",
  "message": "Viable aşamasına geçmek için: Fırsata en az bir karar verici (kişi) bağlanmalı",
  "gate_problems": ["Fırsata en az bir karar verici (kişi) bağlanmalı"]
}

Fırsatın tekil ucu gate_ok, gate_problems (engelleyenler), gate_warnings (yalnız uyaranlar) ve next_stage alanlarını taşır; kapıların tamamı GET /api/v1/me → constants.stage_gates'te. Fırsat sayfasındaki aşama şeridi de bulunulan aşamanın koşullarını işaretleriyle gösterir; Hızlı Giriş aşama seçerken aynı kurala göre uyarır.

Süreler (SLA)

Her açık aşamanın gün hedefi (stage_sla) ve fırsatın toplam yaşam süresi (opp_lifetime_days, varsayılan 180 gün) vardır. Aşmalar fırsatın sla_left ve lifetime_left alanlarında eksi değer olarak görünür ve sağlık puanını düşürür. Değerler Ayarlar → Aşama kurulumu kartından kuruluma göre değişir.

Kontrol listesi

Her açık aşamanın bir kontrol listesi vardır: fırsat aşamaya girince adımlar fırsatta açılır, termin verilen adım Aksiyonlar'a düşer. Liste Ayarlar → Aşamalar'da aşamanın ayrıntılarında düzenlenir (sürükleyerek sıralanır, Enter ile eklenir).

  • Aşama kapıları açıkken Teknik satış sürecinin adımları kilitlidir: BANT kutuları, yüz yüze ziyaret, ürün, deneme sonucu, teklif fiyatı ve sipariş girildiğinde kendiliğinden tamamlanırlar. Bu aşamalara kendi adımlarınızı ekleyebilirsiniz; kilitli adımların sonuna gelir.
  • Diğer aşamalarda (ve kapılar kapalıyken) liste tamamen sizindir.
  • Var olan fırsatlarda yeni adımlar fırsat sayfası açıldığında eklenir; listeden çıkarılan adımlar o fırsatlarda kalır.

Kazanma ve kaybetme

  • Win: firma AC (aktif müşteri) olur, kabul edilen teklifin kalemleri firmaya anlaşmalı fiyat olarak yazılır, Sözleşmeler modülü açıksa taslak sözleşme açılır ve uygulamalara opp_won olayı gider.
  • Lost / Cancel: reason alanı kayıp nedeni olarak saklanır (constants.loss_reasons; listede yoksa Diğer). Lost'ta uygulamalara opp_lost olayı gider.
  • Her aşama değişikliğinde ayrıca opp_stage olayı (eski ve yeni aşamayla) gönderilir.