Kayıtlar — Era belgeleri

era ile müşteri, potansiyel müşteri, sipariş ve diğer kayıtları bulmak, toplu eklemek, güncellemek ve arşivlemek.

İşletmendeki kayıtlar (müşteriler, potansiyel müşteriler, siparişler, randevular, ürünler…) dört komutla yönetilir: records find, records create, records update ve records archive. Kayıt türü komuttan sonraki ilk kelimedir.

era records find customer --q "Ayşe"

Kayıt türleri

Tür	Ne	Bul	Ekle	Güncelle	Arşivle
`lead`	Potansiyel müşteri	✓	✓	✓	✓
`customer`	Müşteri	✓	✓	✓	✓
`order`	Sipariş (ekleme taslak sipariş açar)	✓	✓	✓	iptal
`booking`	Randevu	✓	✓	✓	iptal
`product`	Ürün	✓	✓	✓	✓
`conversation`	Gelen kutusu konuşması	✓	✓	etiket	—
`invoice` · `quote`	Fatura · teklif (eklemek için `document create`)	✓	—	✓	✓
`shipment`	Kargo	✓	✓	—	iptal
`table_row`	Bir tablonun satırı (`--table "Tablo adı"`)	✓	✓	✓	✓
`expense`	Gider	✓	✓	✓	✓
`task`	Görev	✓	✓	✓	✓
`channel_order`, `integration`, `approval`, `agent`, `table`	Pazaryeri siparişi, bağlı uygulama, onay bekleyenler, ajanlar, tablolar	✓	—	—	—
`module_row`	Herhangi bir modülün tablosu (`--module` ve `--table` ile)	✓	—	—	—

Bir tür yalnızca o modül açıksa ve rolünün yetkisi varsa çalışır. O an elinde olan türlerin ve alanların kesin listesi için era tools çalıştır. Kapalı bir modülün türü listede görünmez.

Bulmak

# Ada, telefona, e-postaya ya da numaraya göre ara
era records find lead --q "0532" --limit 20

# Sayı say
era records find customer --mode count

# Tek bir kaydı getir
era records find order --mode get --id "<sipariş-id>"

# Bir tablonun satırları
era records find table_row --table "Stok" --limit 100

Bir sütuna göre süzmek için --where bir JSON nesnesi alır (sütun → değer). Satır sınırı yoktur: sonuçta next değeri varsa aynı komutu --next <değer> ile tekrarla, next boş gelene kadar devam et. Bütün listeyi tek dosya olarak istiyorsan sayfalamak yerine dışa aktar.

Eklemek

Ekleme her zaman bir liste alır, tek kayıt da olsa:

era records create customer --items '[{"name":"Ayşe Demir","email":"[email protected]"}]'

Çok sayıda kayıt için JSON dosyası en güvenli yoldur:

era records create lead --json @adaylar.json

adaylar.json bir dizi olabilir; dizi kendiliğinden items olur:

[
  { "name": "Ayşe Demir", "email": "[email protected]", "message": "Fiyat listesi istedi" },
  { "name": "Mehmet Kaya", "phone": "+905320000000" }
]

Aynı ad, telefon ya da e-posta zaten varsa kayıt atlanır. Var olanı güncellemek istersen --dedupe update ekle. Sonuçta kaç kaydın eklendiği, kaçının atlandığı ve hangisinin neden başarısız olduğu tek tek yazar. Toplu işlemde bir adet sınırı yoktur.

Güncellemek

era records update lead --json @degisiklikler.json

[
  { "id": "<kayıt-id>", "set": { "name": "Yeni ad" } },
  { "id": "<kayıt-id>", "stage": "Kazanıldı", "addTags": ["vip"] }
]

stage bir potansiyel müşterinin aşamasını adıyla değiştirir; etiketler de adıyla verilir, yoksa oluşturulur.

Arşivlemek

era records archive customer --ids '["<id-1>","<id-2>"]'

Arşivleme ve silme riskli işlemlerdir: komut, Era'da senin onay kartını bekler ve kararın gelince sonucu döndürür. Fatura ve gider için --reason zorunludur. Kart beklerken aynı komutu yeniden çalıştırma; reddettiysen o istek kapanmıştır (çıkış kodu 4).

Listede olmayan bir işlem mi?

Bir modülün özel bir eylemi gerekiyorsa era run <eylem-adı> --json @girdi.json kullan. Doğru eylem adı ve alanları, ajanın iş klasöründeki era-actions becerisinde yazar. Girdi hatalıysa Era hatayı, düzeltmeyi ve beklenen şemayı döndürür.

Windows'ta Türkçe karakterler

Windows PowerShell, bir komuta borudan (|) gönderilen metindeki Türkçe harfleri soru işaretine çevirebilir. Ad ve notları her zaman UTF-8 bir dosyaya yazıp --json @dosya.json ile ver. Yazdıktan sonra kaydedilen adları kontrol et.

Daha fazlası: era komutu · Dosyalar · Tam komut listesi · Satış modülü