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 birimlerapp.units. - Her ürünün kendi birimi olabilir. Fırsat yanıtlarında
unit(ör.lt),unit_codeve fiyat birimipu(ör.€/lt) ürünün birimini gösterir. - Alan adlarındaki
_kgeki tarihseldir:potential_kg,commit_kggibi 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, listelerdevalue_openvebase_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çinvalue_short(ör."338K","2,46M") vecur_symkullanı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).