Adım adım entegrasyon rehberi

Bu sayfa, firmanızın TheFinly'ye veri göndermesi için IT ve entegrasyon sorumlularına yöneliktir. İki yol vardır: ERP'nizden API ile otomatik gönderim veya Excel şablonuyla manuel yükleme.

A) API ile gönderim

Uç noktalar

Mizan: POST https://<alan>/api/v1/ingest/trial-balance
Açık kalemler (alacak ve borç yaşlandırma): POST https://<alan>/api/v1/ingest/open-items
Stok hareketleri: POST https://<alan>/api/v1/ingest/inventory. asOfDate (yyyy-MM-dd) isteğe bağlıdır. Eksikse stok tarihi, sıkı modda da, hareketlerin en geç gününden türetilir ve yanıtta uyarı döner.

İstek başlıkları

Yalnızca HTTPS ve POST kabul edilir.
Content-Type: application/json
Authorization: Bearer <API_KEY> veya X-Api-Key: <API_KEY>
Şirket kimliği her zaman API anahtarından belirlenir; gövdeye şirket kimliği yazmayın.

API anahtarı

Anahtarı Şirket Yöneticiniz TheFinly'de Entegrasyonlar sayfasında oluşturur ve size güvenli bir kanaldan iletir.
Anahtar yalnızca bir kez gösterilir; güvenli bir yerde saklayın. E-postada veya belgelerde paylaşmayın.
Anahtar sızarsa Şirket Yöneticisi onu hemen iptal eder ve yenisini oluşturur. İptal anında geçerli olur.

Minimal örnek gövde (mizan)

{
  "externalId": "demo-2024-12",
  "period1": {
    "label": "2023",
    "periodEnd": "2023-12-31",
    "lines": [
      { "accountCode": "DEMO-001", "debit": 400000, "credit": 0, "balance": 400000, "templateKey": "HAZIR_DEGERLER" }
    ]
  },
  "period2": {
    "label": "2024",
    "periodEnd": "2024-12-31",
    "lines": [
      { "accountCode": "DEMO-001", "debit": 450000, "credit": 0, "balance": 450000, "templateKey": "HAZIR_DEGERLER" }
    ]
  }
}

Örnek sentetiktir ve kısaltılmıştır. Tam alan listesi, zorunlu anahtarlar ve açık kalem gövdesi için firmanıza iletilen API belgesine bakın. Tarihler JSON'da yyyy-MM-dd, tutarlar düz sayı olarak yazılır (ör. 4800000).

Yanıt kodları özeti

401: anahtar eksik, geçersiz veya iptal edilmiş.
403: firma hesabı askıya alınmış.
409: aynı externalId farklı içerikle daha önce gönderilmiş.
413: istek gövdesi çok büyük (en çok 4 MB).
422: doğrulama hatası; hiçbir şey kaydedilmez, errors listesine bakın.
429: istek sınırı aşıldı; kısa bir süre bekleyip tekrar deneyin.

B) Excel ile manuel yükleme

Şablonu indirin:
Şablonu firmanızın verileriyle doldurun; sütun başlıklarını değiştirmeyin.
TheFinly'ye giriş yapın ve Yükle sayfasından dosyayı yükleyin.

ERP veri aktarımı (Entegrasyonlar → Aktarım) Şirket Yöneticisi yetkisi ister.

C) Destek

Sorularınız için önce Şirket Yöneticinize, gerekirse TheFinly destek (support@thefinly.com) adresine başvurun.

TheFinly'ye giriş yap