Finans ve ERP

Firmanın finansı

Firmanın ERP'den okunan finans özeti ve satış faturaları: bakiye, vadesi geçen tutar, kredi limiti, risk oranı (bakiye ÷ limit), açık / vadesi geçen fatura sayısı ve tutarı, son 12 ay ciro, ortalama vade ve son fatura. Tutarlar ERP'nin dövizinde (currency; ciro revenue_currency). Firma bir ERP carisiyle eşleşmemişse ya da kullanıcı finans bilgisini göremiyorsa (Ayarlar → Muhasebe ve ERP → Finans bilgisini kimler görür) finance: null döner. Firma kartı (GET /api/v1/customers/{id}) aynı özeti finance alanında ve firmanın tax_no, tax_office alanlarını da verir.

GET/api/v1/customers/{id}/finance

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: MüşterilerKapsam: crm.read

Yol parametreleri

idintegerzorunlu

Firma kimliği.

Sorgu parametreleri

statusstringisteğe bağlıvarsayılan: all

Fatura süzgeci.

Değerlerallopenoverduepaid

limitintegeristeğe bağlıvarsayılan: 50

En çok fatura (1–500).

Hatalar

HTTP	error	Anlamı
`404`	`not_found`	Kayıt bulunamadı.
`403`	`module`	Modül lisansta ya da kullanıcının izinlerinde kapalı.

İstek

curl "https://ornek.solk.app/api/v1/customers/9/finance?status=all&limit=5" \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/customers/9/finance?status=all&limit=5", {
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://ornek.solk.app/api/v1/customers/9/finance",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"status": "all", "limit": 5},
)
print(r.json())

Yanıt

{
  "finance": {
    "accounts": [
      {
        "code": "120.01.045",
        "conn": "Logo ara katmanı",
        "how": "tax",
        "kind": "api",
        "name": "Kumsal Plastik Ambalaj San. ve Tic. A.Ş."
      }
    ],
    "as_of": "2026-10-09T23:14",
    "avg_terms_days": 50,
    "balance": 218450.5,
    "credit_limit": 500000.0,
    "currency": "TRY",
    "last_invoice": {
      "currency": "TRY",
      "date": "2026-09-30",
      "due": "2026-11-29",
      "id": 2,
      "kind": "sales",
      "lines": [],
      "net": 132000.0,
      "no": "SF2026000455",
      "order_ref": "PO-7745",
      "overdue": false,
      "remaining": 158400.0,
      "status": "open",
      "status_label": "Açık",
      "total": 158400.0
    },
    "open_amount": 217800.0,
    "open_invoices": 2,
    "overdue": 59400.0,
    "overdue_invoices": 1,
    "revenue_12m": 313800.0,
    "revenue_currency": "EUR",
    "risk_pct": 44
  },
  "invoices": [
    {
      "currency": "TRY",
      "date": "2026-09-30",
      "due": "2026-11-29",
      "id": 2,
      "kind": "sales",
      "lines": [],
      "net": 132000.0,
      "no": "SF2026000455",
      "order_ref": "PO-7745",
      "overdue": false,
      "remaining": 158400.0,
      "status": "open",
      "status_label": "Açık",
      "total": 158400.0
    },
    {
      "currency": "TRY",
      "date": "2026-08-28",
      "due": "2026-09-27",
      "id": 1,
      "kind": "sales",
      "lines": [
        {
          "code": "HS30",
          "name": "HS 30 Isıl Yapışma Laki",
          "price": 110,
          "qty": 450
        }
      ],
      "net": 49500.0,
      "no": "SF2026000412",
      "order_ref": "PO-7702",
      "overdue": true,
      "remaining": 59400.0,
      "status": "open",
      "status_label": "Vadesi geçti",
      "total": 59400.0
    }
  ],
  "ok": true,
  "total": 3
}

Örnek yanıt örnek veriyle çalışan bir v54 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.