Veri kaynakları ve hesaplama bütünlüğü
Uygulamadaki verilerin nereden geldiği, ne zaman yenilendiği ve hangi değerlerin birbiri yerine kullanılamayacağı. Uygulama, API'lere her sayfa açılışında yeniden bağlanmaz; senkronizasyonlar veriyi Supabase'e kaydeder.
Kaynak → Supabase → Ekran
| Gösterilen veri | Asıl kaynak / API | Kayıt | Kullanım ve önemli sınır |
|---|---|---|---|
| Grexon deposu, stok ve barkodlar | Grexon Fulfillment API | stock_state | Amazon SKU / barkodla eşleştirilir; belirsiz eşleşme veya bilinmeyen miktar sıfır sayılmaz. |
| Amazon FBM ürün / adet / teklif | Amazon SP-API Listings Items, All Listings raporu | stock_state | FBM stok miktarı; siparişte gerçekleşen satış tutarı değildir. |
| Amazon FBA stok | Amazon SP-API FBA Inventory | stock_state | Satılabilir miktar; Amazon liste raporundaki ürünlerden farklı kapsam içerebilir. |
| FBM, Shopify, Kaufland ve manuel siparişler | Grexon Orders API; mevcut kayıtlar için Shopify/Kaufland API tutar zenginleştirmesi | order_state | Sipariş numarası, ürün, durum ve doğrulanabilen sipariş toplamı. |
| Amazon FBM sipariş toplamı | Grexon sipariş numarasıyla Amazon SP-API Orders PROCEEDS | order_state | Sipariş toplamı; otomatik olarak SKU satış gelirine bölünmez. |
| Amazon FBA siparişleri / toplam | SP-API Orders; eksikte Orders Reports API doğrulaması | amazon_fba_state | FBA kaydı aynı sipariş numarasıyla diğer kaynaktaysa bu kayıt önceliklidir. |
| Kârlılık ürün satış geliri | SP-API Orders ürün PROCEEDS; açıkça SKU'ya bağlı uygun Finances ürün tutarı yedeği | profit_order_items / profit_finance_state | Gerçek ürün geliri bilinmiyorsa katalog fiyatıyla doldurulmaz; iptal ve belirsiz işlemler hariçtir. |
| Amazon komisyon ve finans kesintileri | SP-API Finances v2024-06-19 | profit_finance_events / profit_finance_state | Yalnızca güvenilir şekilde SKU/siparişe atanabilen giderler; aksi hâlde tahmini/eksik etiketi. |
| Ürün alış maliyeti ve navlun | Yüklenen Excel veya manuel SKU kayıtları | profit_costs / profit_freight | Amazon API maliyet bildirmez. Eksik maliyet uydurulmaz. |
| Güncel Amazon teklif fiyatı | SP-API Listings Items | profit_prices | Güncel teklif ≠ geçmişte gerçekleşmiş sipariş fiyatı. |
| Hedef fiyat için FBA ücretleri | Amazon Finances son 90 gün (yeterli örneklem); yoksa güncel Fee Preview; sınırlı gerçekleşen geçmiş; en son SKU bazlı manuel ücret | profit_finance_state / profit_fee_preview_state (veya ayarlar) / profit_costs | Fee Preview en fazla 7 günlük ve yalnızca EUR/SKU bazlı yerel FBA gönderim ücretidir; toplam Amazon ücretini ve komisyonu içermez. Kaynak Gerçek, Tahmini veya Manuel olarak işaretlenir; hiçbir ücret yoksa hesaplanmaz. Siparişlerin gerçekleşen giderleri değişmez. |
| Reklam gideri | Kullanıcının Amazon Ads panelinden girdiği aylık Spend (EUR) tutarı; girilmemiş aylarda ayarlanmış reklam yüzdesi | profit_settings.monthly_ads_eur / Ücret & Vergiler | Aylık Spend bütün ayın tekilleştirilmiş Amazon siparişlerine satış tutarı oranında bir kez dağıtılır; eski reklam yüzde varsayımı ve otomatik reklam KDV’si aynı ayda düşülmez. İndirilemeyen fatura vergisi ancak ayrıca doğrulanıp ayrı gider yazılır. Kâr verisi eksik siparişlerin payı ayrı gösterilir. Ads API kullanılmaz; net kâr hâlâ bazı gider varsayımları içerir. |
İki ekranda aynı gün ve sipariş ne demek?
- Tek tarih kuralı: Satış kanalının verdiği sipariş anı önceliklidir; gün sınırı her yerde Europe/Istanbul (UTC+3). Örneğin 16 Kasım 21:30 UTC, Türkiye'de 17 Kasım gününe dahildir.
- Tek sipariş kimliği: Aynı haricî sipariş numarası iki snapshot'ta bulunursa tek gösterilir. Amazon FBA kaynağı önceliklidir.
- Kapsam farkı: Sipariş Merkezi Shopify, Kaufland, Grexon ve Amazon'u birlikte gösterir; Kârlılık Merkezi'nin sipariş sayısı yalnızca Amazon FBA + FBM kapsamıdır.
- Para farkı: Sipariş Merkezi siparişin doğrulanmış toplamını; Kârlılık Merkezi doğrulanmış ürün bazlı tahsilatını kullanır. Kargo, promosyon, KDV ve henüz kesinleşmeyen işlem nedeniyle bu tutarlar aynı olmak zorunda değildir.
- Eksik veri: Bir ürünün maliyet veya geliri yoksa kârlılık sonucu hesaplanamaz; sayı sıfır değildir.
Güncellik: Stok, sipariş, FBA ve finans yenilemelerinin saatleri farklı olabilir. Sayfalardaki “Kaynak / son senkronizasyon” satırları, bu farkı takip etmek içindir. Finans ve sipariş güncellemeleri GitHub Actions ile periyodik çalışır.