Temel kavramlar

Birim ve döviz

Miktarlar ürünün biriminde, fiyatlar kaydın dövizinde tutulur; toplamlar kurulumun ana dövizine çevrilir.

Solk sanayi satışları için tasarlandı: bir fırsatın değeri çoğu zaman aylık miktar × birim fiyat ile hesaplanır ve farklı ürünler farklı birimlerle (kg, ton, litre, adet, m²…) satılır.

Birimler

  • Kurulumun ana birimi firma ayarıdır (ör. kg); firma potansiyeli ve panolar bu birimdedir. GET /api/v1/me → app.unit_default, açık birimler app.units.
  • Her ürünün kendi birimi olabilir. Fırsat yanıtlarında unit (ör. lt), unit_code ve fiyat birimi pu (ör. €/lt) ürünün birimini gösterir.
  • Alan adlarındaki _kg eki tarihseldir: potential_kg, commit_kg gibi alanlar ürünün ya da kurulumun biriminde miktar taşır, her zaman kilogram değildir.

Dövizler

  • Kurulumun ana dövizi vardır (app.currency_base, ör. EUR) ve açık dövizler listesi (app.currencies).
  • Her firmanın varsayılan işlem dövizi olabilir (currency_default); fırsat ve teklifler kendi dövizlerini taşır (currency, cur_sym).
  • Toplamlar ve panolar ana dövize çevrilmiş değerle hesaplanır: fırsatlarda value_base, listelerde value_open ve base_currency.

Kurlar

Kurlar her iş günü Türkiye Cumhuriyet Merkez Bankası'ndan alınır (22 döviz). Yönetici döviz alış ya da satış kurunu seçer; bir gün için elle kur girip sabitleyebilir. Çevrim, kaydın tarihindeki değil güncel kurla yapılır — geçmiş raporlar kur değiştikçe ana dövizde değişebilir.

API'de sayılar

  • Miktar ve tutarlar JSON sayısıdır (12000, 2.35); binlik ayırıcı ya da para simgesi yoktur. Gösterim için value_short (ör. "338K", "2,46M") ve cur_sym kullanın.
  • İstek gövdelerinde sayıları JSON sayısı olarak gönderin. Metin olarak gönderilen "2,35" ve "1.250,50" de doğru çözülür (Türkçe yazım: nokta binlik, virgül ondalık).