Abacus Web API

Acenta ve operatör uygulamalarınızdan Abacus'e alış/satış faturası, tahsilat ve ödeme fişi aktarmak, aktarılan kayıtları sorgulamak ve geri almak için kullanılan REST servisi.

Genel Bakış

Nasıl çalışır?

Abacus Web API; acenta ve operatör yazılımlarının muhasebe tanımlarını okumasını, alış/satış faturalarını ve tahsilat/ödeme fişlerini Abacus'e aktarmasını, aktarılan kayıtları sorgulamasını ve gerektiğinde geri almasını sağlar. Tüm istekler bir Bearer token ile yetkilendirilir.

Temel adres{{baseUrl}} — kurulumunuza özel adres, Abacus ekibi verir
Kimlik doğrulamaOAuth 2.0 password akışı, Authorization: Bearer <token>
HTTP metotlarıYalnızca GET ve POST. PUT ve DELETE kullanılmaz.
Uç nokta biçimi{{baseUrl}}/api/{controller}/{action} — örn. /api/values/updateintegration. Action adları büyük/küçük harfe duyarlı değildir.
Gövde biçimiJSON (önerilen). updateintegration XML de kabul eder.
Karakter setiUTF-8
Tarihyyyy-MM-dd veya yyyy-MM-ddTHH:mm:ss (örn. 2026-08-05)
Ondalık sayıJSON'da nokta: 36.5544. Binlik ayırıcı kullanmayın.

Entegrasyon adımları

  1. Token alın

    POST /token ile erişim token'ı alın; 2 gün boyunca tüm isteklerde kullanın.

  2. Tanımları okuyun

    Hesap kodları, kullanıcılar, dövizler, şubeler ve masraf merkezlerini okuyup kendi sisteminizle eşleştirin.

  3. Belgeyi gönderin

    POST /api/values/updateintegration ile fatura veya fişi gönderin. Yanıttaki id (fiş no) ve GuidId değerlerini saklayın.

  4. Kontrol edin

    GetSlipListX ve GetInvoiceReportX ile aktarılan kayıtları sorgulayın.

  5. Gerekirse düzeltin

    Kayıt güncelleme yoktur: hatalı kaydı integrationreturn ile geri alın, düzeltip yeniden gönderin.

i

Başlamadan önce Abacus ekibinden şunları alın: temel adres, kullanıcı adı ve parola, bağlantı (connection) adı ve kayıtlarınızda görünecek entegrasyon kullanıcı kodu (KayitEdenString, örn. CONNECT). Ayrıntı için SSS.

Güncelleme

Önceki dokümana göre değişenler

Bu doküman Abacus Web API'nin güncel koduna göre yeniden hazırlanmıştır. Mevcut entegrasyonunuzu aşağıdaki maddelere göre kontrol edin.

KonuGüncel durum
PUTHiçbir uç nokta PUT kullanmaz. GetSlipListX artık POST'tur. PUT ile yapılan çağrı 405 Method Not Allowed döner.
Token süresi2 gün (expires_in ≈ 172799 saniye).
InsertCardcode1…code5 parametrelerinin hepsi adreste bulunmalıdır (boş olabilir). E-belge bilgileri için isteğe bağlı EAIdNo, EACustName, EATaxOffice, EAAddress, EAEmail eklendi.
Yeni tanım uç noktalarıgetintbranches (şubeler) ve getintwhcodes (tevkifat kodları).
getintaccountsYanıtta hesabın döviz kodu (CurrCode) ve KDV oranı (VatRatio) da döner.
integrationreturnFiş no dışında rezervasyon no (Voucher), ResInfo ve bağlı fiş (SourceSlipNo) ile geri alma; geri alanı kaydetmek için UserCode.
Yanıt biçimiNesnelerde "$id" alanı bulunur; null değerli alanlar yanıta yazılmaz. Bkz. Yanıt ve Hata Biçimi.
SınıflarTüm istek ve yanıt sınıfları (Icmal, Detay, InvoiceReport, KonaklamaVergisi, Slip…) alan alan belgelendi. Bkz. Sınıflar.
Kimlik Doğrulama

Token alma

/token adresine application/x-www-form-urlencoded gövdeyle POST gönderin. Dönen access_token'ı sonraki tüm isteklerin Authorization başlığında kullanın.

Form alanıZorunluAçıklama
grant_typeEvetHer zaman password.
usernameEvetAbacus ekibinin verdiği API kullanıcı adı.
passwordEvetAPI parolası.
connectionEvetBağlanılacak şirket veritabanının adı (Abacus ekibi verir). Bağlantıya bir şube atanmışsa kayıtlar o şubeye yazılır.
# İstek
POST {{baseUrl}}/token
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=APIKULLANICI&password=APIPAROLA&connection=BAGLANTIADI
// Yanıt — HTTP 200
{
  "access_token": "4ZVKa96Egt0Ep1MkQUXVKb9NrDsvMfAtS245AN4dL1hi...",
  "token_type": "bearer",
  "expires_in": 172799
}
// Hatalı giriş — HTTP 400
{
  "error": "invalid_grant",
  "error_description": "Seçilen bağlantı tanımlı değil."
}

Sonraki isteklerde:

GET {{baseUrl}}/api/values/getintaccounts
Authorization: Bearer ACCESS_TOKEN
!

Token 2 gün geçerlidir. Her istek için yeni token almayın; token'ı saklayıp yeniden kullanın. Süresi dolmuş veya geçersiz token ile yapılan istek 401 Unauthorized döner; bu durumda /token ile yeniden token alıp isteği tekrarlayın.

Kurallar

Yanıt ve hata biçimi

Tüm yanıtlar JSON'dur. Aşağıdaki kurallar bütün uç noktalar için geçerlidir.

  • ✓ İş hataları HTTP 200 ile döner. Aktarım, geri alma gibi işlemlerde başarıyı HTTP koduna göre değil, yanıttaki error alanına göre değerlendirin: boş ("") veya yoksa başarılı, doluysa hata mesajıdır.
  • ✓ "$id" alanı: Yanıttaki her nesnede "$id": "1" gibi bir alan bulunur. Serileştiricinin referans numarasıdır, yok sayın. Aynı nesne tekrar ederse "$ref" görülebilir.
  • ✓ Boş alanlar yazılmaz: Değeri null olan alanlar yanıtta hiç bulunmaz. Eksik alanı null kabul edin. Sayısal (null olamayan) alanlar ise 0 olarak gelir.
  • ✓ Tarihler 2026-08-05T00:00:00 biçiminde döner.
  • ✓ Mesaj metinleri kurulum diline ve sürüme göre değişebilir. Kodunuzda mesaj metnine göre karar vermeyin; mesajı kullanıcıya veya loga yazın.
HTTPNe zaman?Gövde
200İstek işlendi (iş hatası da olabilir).Uç noktanın yanıt sınıfı; hata varsa error dolu.
400/token: kullanıcı, parola veya bağlantı hatalı.{"error":"invalid_grant","error_description":"..."}
401Token yok, geçersiz veya süresi dolmuş.{"Message":"Authorization has been denied for this request."}
404Uç nokta adı veya zorunlu adres parametresi yanlış/eksik.{"Message":"No HTTP resource was found..."}
405Yanlış metot (ör. PUT, ya da POST uç noktasına GET).{"Message":"The requested resource does not support http method 'PUT'."}
500Beklenmeyen sunucu hatası.{"Message":"An error has occurred."} — isteği ve saati Abacus destek ekibine iletin.
Referans Veriler

Muhasebe tanımları

Belge göndermeden önce bu listeleri okuyup kendi kodlarınızla eşleştirin (çaprazlama). Belgede kodları (Code) gönderirsiniz; Abacus kimlikleri kendisi çözer. Liste uç noktalarının tamamı IntegrationDefault dizisi döner.

MetotUç noktaDönerKullanıldığı alan
GET/api/values/getintaccountsMuavin (alt) hesap kodları: Id, Code, Name, CurrCode, VatRatioIcmal.CariKod, Detay.HesapKod
GET/api/values/geinttusersAbacus kullanıcıları: Id, Code, NameIcmal.KayitEdenString (= Code)
GET/api/values/getintcurrenciesDöviz cinsleri: Id, Code (TRY, USD, EUR…), NameDovizCinsiString
GET/api/values/getintbranchesŞubeler: Id, Code (şube adı), Name (ünvan)Icmal.IsyeriId (= Id)
GET/api/values/getcostaccountsMasraf merkezleri: Id, Code, NameDetay.MasrafMerkezi (= Code)
GET/api/values/getintwhcodesTevkifat kodları: Id, Code (601, 602…), NameIcmal.TevkifatKodu (= Code)
GET/api/values/InsertCardYeni hesap kartı açar, CardObject dönerYeni cari / hesap
// GET /api/values/getintaccounts — örnek yanıt
[
  { "$id": "1", "Id": 338, "Code": "120.08.235", "Name": "YAZ TUR", "CurrCode": "EUR", "VatRatio": 0.0 },
  { "$id": "2", "Id": 689, "Code": "600.01.002", "Name": "YURT DIŞI SATIŞLAR", "CurrCode": "", "VatRatio": 10.0 }
]
!

Liste okunurken sunucuda hata oluşursa dizi tek elemanlı döner ve bu elemanın Id değeri 0 olur (Name alanında teknik hata bulunur). Id = 0 olan bir kaydı geçerli tanım olarak kullanmayın.

InsertCard — yeni hesap kartı açma

Verilen üst koda bağlı, sıradaki boş numarayla yeni bir muavin hesap açar. Örneğin 120.01 altında son kod 120.01.024 ise yeni kart 120.01.025 olur; altında hiç kod yoksa 120.01.001 açılır. Hesaplanan kod zaten varsa yeni kart açılmaz, mevcut kart döner.

ParametreZorunluAçıklama
code1…code5Evet*Üst kodun seviyeleri (120, 01…). Beşi de adreste bulunmalıdır; kullanmadıklarınızı boş geçin (code4=&code5=). Eksik parametre 404 döner.
accountnameEvetHesap adı (ünvan).
EAIdNoHayırVKN / TCKN. Doluysa karta e-belge bilgileri de yazılır.
EACustName, EATaxOffice, EAAddress, EAEmailHayırE-belge ünvanı, vergi dairesi, adres ve e-posta.
GET {{baseUrl}}/api/values/InsertCard?code1=120&code2=01&code3=&code4=&code5=&accountname=YAZ%20TUR&EAIdNo=9300199600
Authorization: Bearer ACCESS_TOKEN

// Yanıt — CardObject
{ "$id": "1", "Id": 1204, "Code": "120.01.025", "Name": "YAZ TUR" }
i

Alternatif: Kartı önceden açmak yerine belgeyi OpenCards: true ile gönderirseniz, Abacus'te bulunmayan CariKod ve HesapKod kartları aktarım sırasında açılır. /api/values/UpdateAccCard uç noktası Abacus masaüstü uygulamasının iç kart modelini kullanır; entegrasyonlarda InsertCard veya OpenCards kullanın.

Ana Entegrasyon

Fatura / fiş aktarımı

Tüm alış/satış faturaları ve tahsilat/ödeme fişleri tek uç noktaya gönderilir. Gövde bir Icmal nesnesidir (belge başlığı + Detay satırları). Yanıt bir errorhandler nesnesidir.

MetotUç noktaGövdeYanıt
POST/api/values/updateintegrationIcmal (JSON veya XML)errorhandler

Her belgede zorunlu alanlar

AlanKural
TarihBelge tarihi. Kur bu tarihe göre aranır.
DocType, IsSlipBelge türü. Bkz. Belge Türleri.
CariKodAbacus'te tanımlı cari hesap kodu (veya OpenCards: true).
KayitEdenStringAbacus kullanıcı kodu. Kullanıcı tanımlı ve ilgili şubede yetkili olmalıdır. Boş veya tanımsızsa belge reddedilir.
DovizCinsiString, KurBelge dövizi ve kuru. TL belgede "TRY" ve 1. Bkz. Döviz, Kur ve KDV.
KaynakGönderen sistemin adı (örn. "Sejour", "MyApp"). Boş gönderilen kayıt integrationreturn ile geri alınamaz.
DetayEn az bir satır. Her satırda HesapKod, DovizCinsiString, DovizTutar (KDV dahil), Kdv, Kur. Satırların DovizTutar toplamı 0 olamaz.

Örnek 1 — Döviz (USD) satış faturası, JSON

POST {{baseUrl}}/api/values/updateintegration
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "Tarih": "2026-08-05",
  "DocType": 1,
  "IsSlip": 0,
  "CariKod": "120.01.024",
  "KayitEdenString": "CONNECT",
  "DovizCinsiString": "USD",
  "Kur": 32.4567,
  "EvrakSeri": "ABC",
  "EvrakNo": "ABC2026000000123",
  "Aciklama": "Ağustos konaklama faturası",
  "Kaynak": "MyApp",
  "EACustName": "Örnek Turizm Ltd. Şti.",
  "EAIdNo": "9300199600",
  "EATaxOffice": "Muratpaşa",
  "EAEmail": "muhasebe@ornekturizm.com",
  "EAAddress": "Lara Cad. No:1 Antalya",
  "Detay": [
    {
      "HesapKod": "600.01.002",
      "DovizCinsiString": "USD",
      "DovizTutar": 1100.00,
      "Kdv": 10,
      "Kur": 32.4567,
      "Aciklama1": "Konaklama 2 gece",
      "ResNo": "PX061022",
      "ResServiceType": "Kon",
      "ResServiceName": "ADORA GOLF HOTEL",
      "ResGuestName": "ALİ VELİ",
      "ResCountry": "TR",
      "GirisTarihi": "2026-08-10",
      "CikisTarihi": "2026-08-12",
      "indirimler": []
    }
  ]
}

Örnek 2 — TL alış faturası (tevkifatlı), JSON

{
  "Tarih": "2026-08-05",
  "DocType": 3,
  "IsSlip": 0,
  "CariKod": "320.01.010",
  "KayitEdenString": "CONNECT",
  "DovizCinsiString": "TRY",
  "Kur": 1,
  "EvrakSeri": "TRF",
  "EvrakNo": "TRF2026000000045",
  "Kaynak": "MyApp",
  "TevkifatKodu": "624",
  "Detay": [
    { "HesapKod": "740.01.001", "DovizCinsiString": "TRY", "DovizTutar": 12000.00, "Kdv": 20, "Kur": 1,
      "Aciklama1": "Transfer hizmeti", "MasrafMerkezi": "OPR", "indirimler": [] }
  ]
}

Örnek 3 — Tahsilat fişi, JSON

{
  "Tarih": "2026-08-06",
  "DocType": 3,
  "IsSlip": 1,
  "CariKod": "120.01.024",
  "KayitEdenString": "CONNECT",
  "DovizCinsiString": "TRY",
  "Kur": 1,
  "EvrakNo": "TAH-2026-0098",
  "Aciklama": "Banka havalesi",
  "Kaynak": "MyApp",
  "Detay": [
    { "HesapKod": "102.01.001", "DovizCinsiString": "TRY", "DovizTutar": 25000.00, "Kdv": 0, "Kur": 1, "indirimler": [] }
  ]
}

Örnek 4 — Satış faturası, XML

<?xml version="1.0" encoding="UTF-8"?>
<Icmal>
  <Tarih>2026-08-05</Tarih>
  <DocType>1</DocType>
  <IsSlip>0</IsSlip>
  <CariKod>120.01.024</CariKod>
  <KayitEdenString>CONNECT</KayitEdenString>
  <DovizCinsiString>USD</DovizCinsiString>
  <Kur>32.4567</Kur>
  <EvrakNo>ABC2026000000123</EvrakNo>
  <Kaynak>MyApp</Kaynak>
  <Detay>
    <HesapKod>600.01.002</HesapKod>
    <DovizCinsiString>USD</DovizCinsiString>
    <DovizTutar>1100.00</DovizTutar>
    <Kdv>10</Kdv>
    <Kur>32.4567</Kur>
  </Detay>
  <Detay>
    ...ikinci satır...
  </Detay>
</Icmal>
i

XML notları: Kök eleman Icmal, her satır ayrı bir Detay elemanıdır. Ondalıkta nokta veya virgül kabul edilir (32.4567 / 32,4567), binlik ayırıcı kullanmayın. XML'de EBOran alanının adı EBOrani'dir; BiletNo elemanı hem TicketNo'ya hem EvrakNo'ya yazılır; MusAdi, EACustName yerine kullanılabilir. IsyeriId, IsEInv, KurAlis, MasrafMerkeziId ve UntaxType XML'de okunmaz. Yeni entegrasyonlarda JSON kullanın.

Yanıt

// Başarılı — HTTP 200
{
  "$id": "1",
  "id": 2500,
  "id2": 0,
  "error": "",
  "Token": "",
  "Token1": "120.01.024",
  "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059"
}

// İş hatası — HTTP 200, error dolu
{
  "$id": "1",
  "id": 0,
  "id2": 0,
  "error": "Abacus Error : User Not Found KayitEdenString-CONNECTX",
  "Token": ""
}

Mesajlar Abacus'ün dil tablosundan gelir; kurulumunuza göre Türkçe veya İngilizce olabilir (örn. User Not Found / Kullanıcı bulunamadı).

AlanAnlamı
errorBoşsa aktarım başarılı. Doluysa belge kaydedilmemiştir; mesajı gösterin, düzeltip yeniden gönderin.
idAbacus fiş numarası (SlipNo). Geri alma ve sorgulama için saklayın.
id2Varsa bağlı EB/avans veya virman fişinin numarası; yoksa 0.
GuidIdKaydın benzersiz kimliği. Sorgulamada GuidId filtresiyle kullanın; saklayın.
Token1Kullanılan cari hesap kodu.
errdatainfoYalnız hata durumunda, teknik teşhis bilgisi. Son kullanıcıya göstermeyin; destek talebine ekleyin.

Belge reddedilme nedenleri

  • ✓ Gövde boş, JSON/XML okunamıyor veya Detay boş / null satır içeriyor.
  • ✓ Detay satırlarının DovizTutar toplamı 0.
  • ✓ CariKod, HesapKod, MasrafMerkezi veya döviz kodu Abacus'te tanımlı değil (cari ve hesap için OpenCards: true gönderilebilir).
  • ✓ KayitEdenString boş, tanımsız veya kullanıcı ilgili şubede yetkili değil.
  • ✓ Kur 0 gönderildi ve Abacus'te o tarih için kur bulunamadı.
  • ✓ Alış faturasında (DocType 3) aynı cari için aynı EvrakSeri + EvrakNo daha önce aktarılmış. Şube ayarlarına göre diğer belge türlerinde de mükerrer belge no kontrolü yapılabilir.
Belge Türleri

DocType & IsSlip

Gönderdiğiniz belgenin türü bu iki alanla belirlenir. Fişlerde (IsSlip = 1) DocType borç/alacak yönünü belirler.

İşlemDocTypeIsSlipCari hesapDetay hesapları
Satış faturası10BorçAlacak (gelir + KDV)
Satış iade faturası20AlacakBorç
Alış faturası30AlacakBorç (gider + KDV)
Alış iade faturası40BorçAlacak
Tahsilat fişi (müşteriden para girişi)31AlacakBorç (kasa/banka)
Ödeme fişi (tedarikçiye para çıkışı)11BorçAlacak (kasa/banka)
i

IsCollect alanı ("1" / "2") yalnız Abacus ile ayrıca kurgulanan tahsilat/tediye detaylandırma senaryoları içindir. Standart entegrasyonda göndermeyin veya boş bırakın.

Tutar Kuralları

Döviz, kur ve KDV

TL belgeler: Kur = 1

TL belgede DovizCinsiString: "TRY" gönderin ve hem başlıkta hem her satırda Kur alanına 1 yazın. 0 yazmayın: 0, "kuru Abacus bulsun" anlamına gelir; Abacus o tarih için TRY kuru arar, kur kaydı bulunmazsa belge "kur bulunamadı" (Exchange rate can not found) hatasıyla reddedilir.

Dövizli belgeler

GönderdiğinizAbacus'ün davranışı
Kur > 0Gönderilen kur kullanılır. TL tutar = DovizTutar × Kur.
Kur = 0Tarih günündeki Abacus kur tablosundan alış kuru alınır. O gün için kur yoksa belge reddedilir.
Satırda TLTutar > 0 ve DovizTutar > 0TL tutar olarak TLTutar kullanılır, satır kuru TLTutar / DovizTutar olarak hesaplanır (kuruş farkı oluşmaz).
Satır dövizi belge dövizinden farklıSatırın DovizCinsiString ve Kur değerleri kullanılır; satır kuru 0 ise o dövizin günlük kuru alınır.
i

Şubeye özel entegrasyon ayarları açıksa Abacus gönderilen kuru yok sayıp kuru kendi tablosundan yeniden hesaplayabilir. Kurulumunuzdaki ayarı Abacus ekibinden öğrenebilirsiniz.

KDV: DovizTutar KDV dahildir

DovizTutar (ve varsa TLTutar) satırın KDV dahil toplamıdır. Abacus KDV'yi bu tutarın içinden ayırır: Matrah = DovizTutar / (1 + Kdv/100), KDV = DovizTutar − Matrah. Cari hesaba satırların KDV dahil toplamı yazılır.

// DovizTutar: 1100.00, Kdv: 10  →  Matrah 1000.00 + KDV 100.00, cari 1100.00
  • ✓ Kdv tam sayı yüzde oranıdır: 0, 1, 8, 10, 18, 20.
  • ✓ KDV istisnalı satırlarda Kdv: 0 ve gerekiyorsa UntaxType (istisna türü kodu) gönderin.
  • ✓ Konaklama vergisi için satırda AccomodationRate (oran, örn. 2) ve ResServiceType: "Kon" gönderin. AccomodationRate > 0 ve ResServiceType boşsa Abacus "Kon" kabul eder; AccomodationRate: 0 konaklama vergisi hesaplanmaz demektir.
  • ✓ Satır indirimi için indirimler listesine { "Aciklama": "...", "DovizTutar": 50.00 } ekleyin; tutar satırın döviz tutarından düşülür. İndirim yoksa boş liste ([]) gönderin, null göndermeyin.
  • ✓ Tutarları 2 ondalıkla, kurları en fazla 6 ondalıkla gönderin.
Düzeltme

Geri alma (integrationreturn)

Aktarılmış bir kaydı güncellemek için bir uç nokta yoktur. Düzeltme her zaman geri al → düzelt → yeniden gönder şeklinde yapılır. Yeniden gönderilen belge yeni bir fiş numarası alır.

MetotUç noktaYanıt
GET/api/values/integrationreturn?SlipNo=2500&UserCode=CONNECTerrorhandler
ParametreTipAçıklama
SlipNointAktarım yanıtındaki id. Bağlı virman fişleri de birlikte silinir.
VoucherstringAlternatif: satırlardaki ResNo değeriyle eşleşen kaydı geri alır.
ResInfostringAlternatif: satırlardaki ResInfo değeriyle eşleşen kaydı geri alır.
SourceSlipNointYalnız bağlı fişi (EB/avans/virman) geri alır: değeri ana fiş numarasıdır.
UserCodestringGeri alma işlemini yapan Abacus kullanıcı kodu (örn. CONNECT). İşlem bu kullanıcı adına loglanır.
// Başarılı
{ "$id": "1", "id": 0, "id2": 0, "error": "", "Token": "" }

// Bulunamadı
{ "$id": "1", "id": 2500, "id2": 0, "error": "Slip Not Found-in Db:ABACUS_FIRMA", "Token": "" }
  • ✓ En az bir filtre (SlipNo, Voucher veya ResInfo) gönderilmelidir.
  • ✓ Yalnız API ile aktarılmış kayıtlar (Kaynak dolu) geri alınabilir; Abacus'te elle girilen kayıtlar bu uç noktayla silinemez.
  • ✓ GİB'e gönderilmiş e-fatura geri alınamaz.
  • ✓ Filtre birden fazla belgeyle eşleşirse işlem yapılmaz ve hata döner; bu durumda SlipNo ile geri alın.
Sorgulama

Sorgulama & önizleme

MetotUç noktaGövde / parametreYanıt
POST/api/values/GetInvoiceReportXSlipFiterInvoiceReportResponse
POST/api/values/GetSlipListXVoucherFilterSlipRequestMessage
GET/api/default/GetInvoiceHtml?eguideid=E-fatura ETTN (UUID)HTML metni (JSON string)
GET/api/default/GetInvoiceByte?eguideid=E-fatura ETTN (UUID)PDF, Base64 (JSON string)

GetInvoiceReportX — fatura raporu

Faturaları (yalnız DocType 1–4; fişler bu raporda yer almaz) belge başlığı ve isterseniz satır düzeyinde döner. Yanıtta ayrıca KDV satırları (KdvRows) ve konaklama vergisi satırları (KonnaklamaVergisi) bulunur.

// İstek — tarih aralığı + fiş numarası aralığı
POST {{baseUrl}}/api/values/GetInvoiceReportX
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "DateBegin": "2026-08-01",
  "DateEnd": "2026-08-31",
  "VoucherNoBegin": 2400,
  "VoucherNoEnd": 2600,
  "DocType": 1,
  "Details": false
}

// İstek — tek belge
{ "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059", "Details": true }
// Yanıt — Örnek 1'deki fatura için (kısaltılmış)
{
  "$id": "1",
  "Handler": { "$id": "2", "id": 0, "id2": 0, "error": "", "Token": "" },
  "InvoiceReport": [
    {
      "$id": "3",
      "Id": 81231, "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059", "SlipNo": 2500,
      "DocType": 1, "RowType": 0, "Dates": "2026-08-05T00:00:00",
      "DocNo": "ABC2026000000123", "InvSerie": "ABC",
      "Code": "120.01.024", "Name": "ÖRNEK TURİZM LTD. ŞTİ.",
      "Currency": "USD", "Total": 35702.37, "TotalCurr": 1100.00, "ExcRate": 32.4567,
      "ResNo": "PX061022", "ResGuestName": "ALİ VELİ",
      "EAIdNo": "9300199600", "EACustName": "Örnek Turizm Ltd. Şti.",
      "RecDate": "2026-08-05T14:22:10", "RecUser": 12,
      "Amount0": 0.0, "VatTotal": 0.0, "RowVatAmount": 0.0, "...": "..."
    }
  ],
  "KonnaklamaVergisi": [],
  "KdvRows": [
    { "$id": "4", "Id": 81232, "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059",
      "Credit": 32456.70, "CreditCurr": 1000.00, "VatAmount": 3245.67, "VatAmountCurr": 100.00,
      "VatRatio": 10.0, "AccCardId": 689, "VatCardId": 412, "AccomodationVatRate": 0.0 }
  ]
}

// Konaklama vergisi hesaplanmış bir faturada KonnaklamaVergisi elemanı (örnek değerler)
{ "$id": "5", "Id": 90412, "GuidId": "7d1c...", "Credit": 640.00, "CreditCurr": 19.72,
  "AccCardId": 0, "AccomodationCalc": true, "AccomodationVatRate": 2.0 }
!

Önemli: Yanıttaki liste adı KonnaklamaVergisi'dir (çift n); elemanları KonaklamaVergisi sınıfındadır. KdvRows ve KonnaklamaVergisi fiş numarası aralığına göre doldurulur; satırları faturaya GuidId ile bağlayın. Handler.error doluysa rapor alınamamıştır.

GetSlipListX — fiş listesi

Fatura ve fişleri belge (fiş) düzeyinde, satır başına bir kayıt olarak listeler. Aktardığınız kayıtların Abacus'te olup olmadığını, kilit/onay/e-defter durumlarını kontrol etmek için kullanın.

// İstek — CONNECT kullanıcısının ağustosta API ile aktardığı kayıtlar
POST {{baseUrl}}/api/values/GetSlipListX
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "BeginDate": "2026-08-01",
  "EndDate": "2026-08-31",
  "Source": [1],
  "RecUser": 12
}

// Yanıt (kısaltılmış)
{
  "$id": "1",
  "errhandler": { "$id": "2", "id": 0, "id2": 0, "error": "", "Token": "" },
  "SlipList": [
    { "$id": "3", "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059", "SlipNo": 2500,
      "DocType": 1, "DocNo": "ABC2026000000123", "Dates": "2026-08-05T00:00:00", "BranchId": 1,
      "Total": 35702.37, "TotalCurr": 1100.00, "CurrId": 2, "IntSource": "MyApp",
      "Lock": false, "Confirm": false, "EledgerSent": false, "EarchiveCancel": false, "IntState": 0,
      "RecDate": "2026-08-05T14:22:10", "RecUser": 12, "CategoryId": 0 }
  ]
}

GetInvoiceHtml / GetInvoiceByte — e-fatura önizleme

eguideid parametresi e-faturanın ETTN (UUID) değeridir. Fatura Abacus E-Fatura ekranında onaylanıp e-fatura XML'i oluştuktan sonra çalışır.

  • ✓ GetInvoiceHtml: Faturanın HTML görüntüsünü JSON string olarak döner. Fatura bulunamazsa "<h5>E-Fatura Bulunamadı...</h5>" metni döner.
  • ✓ GetInvoiceByte: Faturanın PDF dosyasını Base64 kodlu JSON string olarak döner; Base64'ü çözerek .pdf olarak kaydedin. Fatura bulunamazsa null döner.
Veri Modelleri

Sınıflar (modeller)

İstek ve yanıtlarda kullanılan tüm sınıflar. JSON alan adları tablodaki adlarla birebir aynıdır (büyük/küçük harf dahil). Tiplerdeki ? alanın boş (null) olabileceğini gösterir.

Icmal belge başlığı — updateintegration gövdesi

AlanTipZorunluAçıklama
TarihDateTimeEvetBelge tarihi; kur bu tarihe göre aranır.
DocTypebyteEvet1 Satış, 2 Satış iade, 3 Alış, 4 Alış iade. Fişlerde yön belirler (tablo).
IsSlipbyteEvet0 Fatura, 1 Fiş (tahsilat/ödeme).
CariKodstringEvetCari hesap kodu (getintaccounts → Code). Tanımsızsa OpenCards: true ile açılır.
KayitEdenStringstringEvetKaydı yapan Abacus kullanıcı kodu (geinttusers → Code). Kullanıcı ilgili şubede yetkili olmalıdır. Entegrasyona özel kullanıcı önerilir (SSS).
DovizCinsiStringstringEvetBelge dövizi: TRY, USD, EUR… (getintcurrencies → Code).
KurdecimalEvetBelge kuru. TL belgede 1. Dövizde kur veya 0 (Abacus günlük kuru bulur). Bkz. Kur.
KaynakstringEvetGönderen sistemin adı. Kayıtlarda entegrasyon kaynağı olarak saklanır; boşsa kayıt API ile geri alınamaz.
DetayList<Detay>EvetBelge satırları; en az bir satır.
EvrakNostringÖnerilirBelge (fatura) numarası. Alış faturasında aynı cari + seri + no ikinci kez kabul edilmez.
EvrakSeristringHayırBelge serisi, en fazla 3 karakter (fazlası kırpılır).
AciklamastringHayırBelge açıklaması (en fazla 250 karakter). Boşsa ilk satırın Aciklama1 değeri kullanılır.
IsyeriIdintHayırŞube Id (getintbranches → Id). Token'daki bağlantıya şube atanmışsa o şube geçerlidir; tek şubeli yapıda otomatik seçilir.
OpenCardsbool?Hayırtrue: Abacus'te olmayan CariKod, HesapKod, EBHesapKodu, AvansHesapKodu kartlarını aç.
EACustNamestringHayırE-belge alıcı ünvanı / adı. Boşsa cari karttan alınır.
EAIdNostringHayırAlıcı VKN (10 hane) / TCKN (11 hane). Boşsa cari karttan alınır.
EATaxOfficestringHayırAlıcı vergi dairesi.
EAAddressstringHayırAlıcı adresi.
EAEmailstringHayırAlıcı e-posta adresi (e-arşiv gönderimi).
IsEInvbool?HayırE-fatura mı? Faturalarda cari karttaki e-fatura mükellefiyet bilgisine göre Abacus tarafından yeniden belirlenir.
TevkifatKodustringHayırTevkifat kodu (getintwhcodes → Code, örn. 624). Alış faturasında tevkifat oranı ve hesabı uygulanır; tanımsız kod tevkifat üretmez.
TicketNostringHayırBilet numarası (bilet entegrasyonları).
AttachmentsstringHayırEk dosya adı / yolu; oluşturulan satırlara yazılır.
KurAlisdecimal?HayırAlış (maliyet) kuru. Boş/0 ise kurdan tamamlanır.
SatTarihi, TurTarihiDateTime?HayırSatış ve tur tarihi. Şubede tur/bilet aktarım ayarı açıksa belge veya kur tarihi olarak kullanılabilir.
EBHesapKodustringHayırEB (erken rezervasyon) virmanının hesap kodu.
EBOranstringHayırEB oranı, metin (örn. "10"). Boş veya "0": EB işlemi yapılmaz. XML adı EBOrani.
DovizEBTutardecimal?HayırEB tutarı (belge dövizinde). TL karşılığı DovizEBTutar × Kur.
AvansHesapKodustringHayırAvans virmanının hesap kodu.
AvansOranistringHayırAvans yüzdesi, metin. Boş veya "0": avans işlemi yapılmaz. EB ve avans alanları alış iadesinde (DocType 4) dikkate alınmaz. Oluşan bağlı fişin no'su yanıtta id2.
VirmanList<Detay>HayırAna belgeye bağlı virman satırları. Her satır karşılıklı iki muhasebe satırı üretir; hesaplar önceden tanımlı olmalıdır. Virman kaydedilemezse ana belge de geri alınır.
IsCollectstringHayırYalnız Abacus ile kurgulanan özel senaryolar ("1" tahsilat, "2" tediye detaylandırma). Standart entegrasyonda göndermeyin.
CariId, KayitEden, DovizCinsiintGöndermeyinAbacus bunları CariKod, KayitEdenString, DovizCinsiString kodlarından doldurur.

Detay belge satırı — Icmal.Detay ve Icmal.Virman

AlanTipZorunluAçıklama
HesapKodstringEvetGelir / gider / hizmet hesabı (fişlerde kasa/banka hesabı). getintaccounts → Code.
DovizCinsiStringstringEvetSatır dövizi; genellikle belge dövizinin aynısı.
DovizTutardecimalEvetSatırın KDV dahil toplamı (satır dövizinde, 2 ondalık). Tüm satırların toplamı 0 olamaz.
KdvintEvetKDV yüzdesi: 0, 1, 8, 10, 18, 20.
KurdecimalEvetSatır kuru. TL satırda 1. 0 ise belge kuru veya günlük kur kullanılır.
TLTutardecimal?HayırSatırın KDV dahil TL tutarı. > 0 ise TL tutar olarak doğrudan kullanılır ve kur TLTutar / DovizTutar hesaplanır.
Aciklama1, Aciklama2stringHayırMuhasebe satırı açıklamaları (en fazla 250 karakter).
ResNostringHayırRezervasyon / voucher numarası. integrationreturn?Voucher= ile geri almada kullanılır.
ResInfostringHayırRezervasyon ek bilgisi (pax, operasyon notu).
ResServiceTypestringHayırServis türü: Kon konaklama, Trf transfer; diğerleri serbest metin.
ResServiceNamestringHayırServis adı (örn. otel adı).
ResGuestNamestringHayırMisafir / müşteri adı.
ResCountrystringHayırMisafir ülkesi.
GirisTarihi, CikisTarihiDateTime?HayırRezervasyon giriş / çıkış tarihi.
AccomodationRateint?HayırKonaklama vergisi oranı (%). > 0 ise konaklama vergisi ayrıştırılır; 0 ise hesaplanmaz; ResServiceType: "Kon" iken boş bırakılırsa 1 kabul edilir.
UntaxTypeshort?HayırKDV istisna / muafiyet türü kodu.
MasrafMerkezistringHayırMasraf merkezi kodu (getcostaccounts → Code). Gönderilirse tanımlı olmalıdır.
MasrafMerkeziIdint?HayırKod yerine masraf merkezi Id.
indirimlerList<indirim>ÖnerilirSatır indirimleri; tutarlar satırın döviz tutarından düşülür. İndirim yoksa [] gönderin.
IndirimSatiribool?Hayırtrue: satır belge toplamına katılmayan bir indirim satırıdır.
F1…F6stringHayırSerbest alanlar (150 karakter). Örn. F1 müşteri adı, F2 voucher/fatura no, F3 oda tipi. F6 sayısal değer olmalıdır.
DovizTutarAlisdecimal?HayırSatırın alış (maliyet) tutarı, döviz.
TLTutarAlisdecimal?HayırSatırın alış (maliyet) tutarı, TL.
DovizCinsiStringAlisstringHayırAlış tutarının döviz kodu.
KurAlisdecimal?HayırAlış kuru.
HesapIdintHayırHesapKod yerine hesap Id. Kod göndermeniz önerilir.
DovizCinsi, DovizTutarOrg, TLTutarOrg, price, pricecurr, AccomodationAmount, AccomodationAmountNotRounding, AccomodationAmountTry, AccomodationAmountTryNotRounding—GöndermeyinAbacus'ün hesaplama sırasında doldurduğu iç alanlar.

indirim Detay.indirimler elemanı

AlanTipAçıklama
Aciklamastringİndirim açıklaması.
DovizTutardecimalİndirim tutarı (satır dövizinde); satırın DovizTutar'ından düşülür.

errorhandler işlem sonucu — updateintegration, integrationreturn; raporlarda Handler / errhandler

AlanTipAçıklama
errorstringBoş ("") ise başarılı; dolu ise hata mesajı. Abacus servis hataları "Abacus Error : " önekiyle gelir.
idintAktarımda oluşan fiş numarası (SlipNo).
id2intBağlı EB/avans/virman fiş numarası; yoksa 0.
GuidIdstringOluşan kaydın benzersiz kimliği.
Token1stringAktarımda kullanılan cari hesap kodu.
Token, Token2, Token3stringTeknik alanlar; entegrasyonda kullanmayın.
errdatainfostringHata durumunda teknik teşhis bilgisi (destek için).
SqlQuerystringTeknik alan; kullanmayın.

IntegrationDefault tanım listesi elemanı — getint* uç noktaları

AlanTipAçıklama
IdintKaydın Abacus Id'si. 0 ise liste hata ile dönmüştür.
CodestringBelgede gönderilecek kod (hesap kodu, kullanıcı kodu, döviz kodu, masraf merkezi kodu, tevkifat kodu). getintbranches'te şube adı.
NamestringAd / açıklama. getintbranches'te şube ünvanı.
CurrCodestringYalnız getintaccounts: hesabın döviz kodu (boş = dövizsiz/TL).
VatRatiodecimal?Yalnız getintaccounts: hesap kartında tanımlı KDV oranı.

CardObject InsertCard yanıtı

AlanTipAçıklama
IdintHesap kartı Id.
CodestringAçılan (veya zaten var olan) hesap kodu; belgede CariKod / HesapKod olarak kullanın.
NamestringHesap adı.

SlipFiter GetInvoiceReportX gövdesi

Sınıfta başka raporların da kullandığı çok sayıda alan vardır; aşağıdakiler bu uç noktada dikkate alınanlardır. Diğer alanları göndermeyin. Hiçbir filtre gönderilmezse yetkili olduğunuz tüm faturalar döner; mutlaka tarih veya numara aralığı verin.

AlanTipAçıklama
DateBegin, DateEndDateTimeBelge tarihi aralığı (dahil).
VoucherNoBegin, VoucherNoEndintFiş numarası (SlipNo) aralığı.
GuidIdstringTek belge. Gönderilirse diğer filtreler yok sayılır.
GuidIdListList<string>Belge listesi.
DocTypebyte?Tek belge türü (1–4).
InvTypeList<int>Birden çok belge türü, örn. [1,2].
InvNostringBelge numarası (EvrakNo), tam eşleşme.
seriestringBelge serisi (EvrakSeri).
AccCodeBegin, AccCodeEndstringHesap kodu aralığı.
GroupCodestringHesap kartı grup kodu.
CurrIdintDöviz Id (getintcurrencies → Id).
BranchIdList<int>Şube Id listesi.
DueDateBegin, DueDateEndDateTimeVade tarihi aralığı.
CategoriyId, SlipTypes, PayTypes, VouchertypesList<int>Kategori, fiş türü, ödeme türü, belge türü Id listeleri (Abacus tanımları).
F1…F5stringHesap kartının F1–F5 özel alanlarına göre filtre.
Detailsboolfalse (varsayılan): yalnız belge başlık satırları (RowType 0). true: hizmet satırları da (RowType 1).
ColumnsList<string>Yanıttan çıkarılacak InvoiceReport alanları (yanıtı küçültmek için), örn. ["Address1","Address2","BankIban"]. Boş bırakırsanız tüm alanlar gelir.

InvoiceReportResponse GetInvoiceReportX yanıtı

AlanTipAçıklama
HandlererrorhandlerHandler.error doluysa rapor alınamamıştır.
InvoiceReportList<InvoiceReport>Fatura başlık (ve Details: true ise hizmet) satırları.
KonnaklamaVergisiList<KonaklamaVergisi>Konaklama vergisi satırları. Adı çift n ile yazılır.
KdvRowsList<KonaklamaVergisi>KDV taşıyan hizmet satırları (matrah, KDV, tevkifat).

InvoiceReport InvoiceReportResponse.InvoiceReport elemanı — bir muhasebe satırı

Her eleman bir muhasebe satırıdır. RowType 0 belgenin cari hesap (başlık) satırıdır ve fatura toplamını taşır; RowType 1 hizmet (gelir/gider) satırıdır. Bir faturanın satırları aynı GuidId'yi paylaşır.

AlanTipAçıklama
Belge ve satır
IdintMuhasebe satırı Id.
GuidIdstringBelge kimliği (aktarım yanıtındaki GuidId).
SlipNointFiş numarası (aktarım yanıtındaki id).
DocTypebyte1 Satış, 2 Satış iade, 3 Alış, 4 Alış iade.
RowTypebyte?0 cari (başlık) satırı, 1 hizmet satırı.
GeneralTypebyte?Abacus iç satır sınıfı; bilgi amaçlı.
DatesDateTimeBelge (muhasebe) tarihi.
DocDateDateTime?Evrak tarihi.
DocNostringBelge numarası (EvrakNo).
InvSeriestringBelge serisi (EvrakSeri).
DueDateDateTime?Vade tarihi.
OrderNoint?Sipariş / sıra numarası.
CategorystringKategori adı.
RowRemark, RowRemark2stringSatır açıklamaları (Aciklama1, Aciklama2).
UnitRemark, Quantitystring / decimal?Birim ve miktar.
CostCenterIdint?Masraf merkezi Id.
VatRatiodecimal?Satırın KDV oranı.
WhtTax, WhRateshort? / stringTevkifat kodu ve oranı.
UnTaxTypeshort?KDV istisna türü.
AttachmentsstringEk dosya bilgisi.
Hesap ve tutar
Code, Name, Name2stringSatırın hesap kodu ve adları (RowType 0'da cari hesap).
CurrencystringSatır döviz kodu.
Totaldecimal?Satır tutarı, TL (borç + alacak). RowType 0'da faturanın KDV dahil TL toplamı.
TotalCurrdecimal?Satır tutarı, döviz.
ExcRatedecimal?Kur.
Rezervasyon
ResNo, ResInfo, ResServiceType, ResServiceName, ResGuestName, ResCountrystringAktarımdaki Detay rezervasyon alanları.
CiDate, CoDateDateTime?Giriş / çıkış tarihi (GirisTarihi, CikisTarihi).
E-belge alıcısı (belgeyle gönderilen)
EAIdNo, EACustName, EATaxOffice, EAAddress, EAEmailstringAktarımdaki Icmal e-belge alanları.
Cari kart bilgileri (Abacus'teki karttan)
IdNo, TaxOffice, isEInv, EWorkTypestring / bool? / byte?VKN/TCKN, vergi dairesi, e-fatura mükellefi mi, çalışma türü.
Address1, Address2, Street, BuildingNumber, CitySubdivisionName, City, Country, PostCodestringAdres bilgileri.
Tel, Tel2, Fax, Fax2, Email, Web, AuthorPerson, AuthorPerson2stringİletişim bilgileri ve yetkililer.
ExpiryDay, PayDayint?Vade günü (ikisi de aynı değeri taşır).
BankName, BankBranch, BankAccount, BankIbanstringBanka bilgileri.
Özel alanlar ve kayıt bilgisi
F1…F5stringSatırın metin özel alanları.
F6…F10decimal?Satırın sayısal özel alanları.
RecDateDateTime?Kayıt zamanı.
RecUserint?Kaydı yapan kullanıcının Id'si (geinttusers → Id). Entegrasyon kullanıcınızın kayıtlarını bununla ayırın.
Bu uç noktada doldurulmayan alanlar
Sınıfta bulunan ancak GetInvoiceReportX tarafından doldurulmayan alanlar: Amount0, Amount1, Amount8, Amount10, Amount18, Amount20, VatAmount1…VatAmount20, VatCardId1…VatCardId20, RowVatAmount, RowVatAmountCurr, VatTotal, VatTotalCurr, AccomodationLocal, AccomodationCurrency, AccomodationVatRate, WhAmount, WhMatrahTotal, TutarYazi, TutarYaziEng, TutarYaziCurrTr, TutarYaziCurrEng, CostCode, CostName, Tevkifat, CrossAccountCode, CrossAccountName, RecUserName. Sayısal olanlar 0 gelir, diğerleri yanıtta bulunmaz. KDV ve konaklama vergisi tutarları için KdvRows ve KonnaklamaVergisi listelerini kullanın.

KonaklamaVergisi KonnaklamaVergisi ve KdvRows listelerinin elemanı

Aynı sınıf iki listede kullanılır; her listede farklı alanlar doldurulur. Tutarlar: Debit/Credit TL, DebitCurr/CreditCurr döviz; satır tutarı borç + alacaktır (biri doludur: satışta alacak, alışta borç).

AlanTipKonnaklamaVergisiKdvRowsAçıklama
Idint✓✓Muhasebe satırı Id.
GuidIdstring✓✓Belge kimliği; InvoiceReport.GuidId ile eşleştirin.
Debit, Creditdecimal?✓✓TL borç / alacak. KonnaklamaVergisi'nde konaklama vergisi tutarı; KdvRows'ta satırın KDV hariç tutarı (matrah).
DebitCurr, CreditCurrdecimal?✓✓Aynı tutarların döviz karşılığı.
AccomodationCalcbool?✓—Konaklama vergisi hesaplandı mı.
AccomodationVatRatedecimal?✓✓Konaklama vergisi oranı (%); yoksa 0.
VatRatiodecimal?—✓KDV oranı (%).
VatAmount, VatAmountCurrdecimal?—✓KDV tutarı, TL ve döviz.
WhAmount, WhAmountCurrdecimal?—✓Tevkifat tutarı, TL ve döviz.
NotApplyWhbool?—✓true: bu satıra tevkifat uygulanmaz.
AccCardIdint— (0)✓Satırın hesap kartı Id (getintaccounts → Id).
VatCardIdint?—✓KDV hesabının kart Id'si.

VoucherFilter GetSlipListX gövdesi

Aşağıdakiler bu uç noktada dikkate alınan alanlardır. Bitiş tarihi verilmezse bugüne kadarki tüm kayıtlar aranır.

AlanTipAçıklama
BeginDate, EndDateDateTimeBelge tarihi aralığı.
RecBeginDate, RecEndDateDateTimeKayıt (aktarım) zamanı aralığı.
GuidIdstringTek belge.
GuidIdsList<string>Belge listesi.
BeginVouhcer, EndVouhcerintFiş numarası aralığı. Alan adı bu yazımla (Vouhcer) gönderilmelidir.
BeginVouhcerTarget, EndVouhcerTargetintBağlı fişler için ana fiş numarası (SourceSlipNo) aralığı.
DocNo, SerialstringBelge numarası ve serisi.
DocTypesList<int>Belge türleri (0 fiş, 1–4 fatura).
SlipTypesList<int>Fiş türleri (2 tahsilat, 3 tediye…).
SourceList<int>[1] yalnız API ile aktarılanlar, [2] yalnız Abacus'te girilenler, boş = hepsi.
ResNostringRezervasyon numarası.
RecUserint?Kaydı yapan kullanıcı Id (geinttusers → Id), örn. CONNECT kullanıcısının Id'si.
BranchId, CategoryIdes, VoucherTypesList<int>Şube, kategori, belge türü Id listeleri.
ColumnsList<string>Yanıttan çıkarılacak Slip alanları, örn. ["OwnerRemark","VoucherRemark"].

SlipRequestMessage GetSlipListX yanıtı

AlanTipAçıklama
errhandlererrorhandlererrhandler.error doluysa liste alınamamıştır.
SlipListList<Slip>Bulunan fişler.

Slip SlipRequestMessage.SlipList elemanı — bir fiş/belge

AlanTipAçıklama
GuidIdstringBelge kimliği.
SlipNoint?Fiş numarası.
SourceSlipNoint?Bağlı fişse ana fişin numarası.
SlipTypebyte?Fiş türü (2 tahsilat, 3 tediye; diğerleri muhasebe fiş türleri).
DocTypebyte?0 fiş, 1–4 fatura türleri.
DocNostringBelge numarası.
Dates, DocDateDateTime?Belge tarihi, evrak tarihi.
BranchIdint?Şube Id.
Total, TotalCurrdecimal?Borç toplamı, TL ve döviz.
CurrIdint?Döviz Id.
IntSourcestringEntegrasyon kaynağı (aktarımdaki Kaynak); Abacus'te girilen kayıtlarda boş.
IntStateshort?Entegrasyon durum kodu.
RecDate, RecUserDateTime? / int?Kayıt zamanı ve kaydı yapan kullanıcı Id.
ChgDate, ChgUserDateTime? / int?Son değişiklik zamanı ve kullanıcısı.
Lock, LockUser, LockDatebool? / int? / DateTime?Kilit durumu.
Confirm, ConfirmUser, ConfirmDatebool? / int? / DateTime?Onay durumu.
EledgerSentbool?E-deftere gönderildi mi.
EarchiveCancelbool?E-arşiv iptal edildi mi.
Attachmentbool?Ek dosyası var mı.
Proformabool?Proforma mı.
OwnerRemark, VoucherType, VoucherRemark, PayTypeId, OrderNo, CategoryId, SecurityId, CrossAccount—Açıklama, belge türü, ödeme türü, sıra no, kategori, güvenlik grubu ve karşı hesap bilgileri.
UAEreporting_status, UAEexchange_status, UAEstatus_messagestringYalnız BAE e-fatura kurulumlarında dolu; Türkiye'de boş.
Sık Sorulanlar

Sık sorulan sorular

PUT kullanılıyor mu? Kaydı nasıl güncellerim?

Hayır. Tüm uç noktalar GET veya POST'tur; GetSlipListX dahil sorgulamalar POST ile yapılır. Aktarılmış bir kaydı güncelleyen bir uç nokta yoktur: kaydı integrationreturn ile geri alın, düzeltip updateintegration ile yeniden gönderin. Yeni kayıt yeni bir fiş numarası alır.

KayitEdenString için entegrasyona özel bir Abacus kullanıcısı (örn. "CONNECT") açılabilir mi?

Evet, önerilen yöntem budur. Abacus destek ekibinden veya Abacus yöneticinizden entegrasyona özel bir kullanıcı (örn. CONNECT) açılmasını ve kayıtların yazılacağı şubede yetkilendirilmesini isteyin; ardından tüm belgelerde "KayitEdenString": "CONNECT" gönderin. Kullanıcı tanımlı ve şubede yetkili olmazsa belge reddedilir.

Kayıtlarınızı ayırt etmek için: geinttusers ile CONNECT kullanıcısının Id'sini bulun. GetSlipListX'te "RecUser": Id ve "Source": [1] filtreleriyle yalnız sizin aktardığınız kayıtları listeleyin; GetInvoiceReportX yanıtında her satırın RecUser alanı bu Id'yi taşır. Düzeltmek için kaydı integrationreturn?SlipNo=...&UserCode=CONNECT ile geri alıp yeniden gönderin; geri alma işlemi de CONNECT adına kaydedilir.

GetInvoiceReportX yanıtındaki InvoiceReport ve KonaklamaVergisi sınıflarının alanları nelerdir?

Yanıt bir InvoiceReportResponse nesnesidir: Handler, InvoiceReport, KonnaklamaVergisi (çift n) ve KdvRows. Tüm alanlar açıklamalarıyla InvoiceReport ve KonaklamaVergisi tablolarında, doldurulmayan alanların listesiyle birlikte yer alır. KDV ve konaklama vergisi tutarlarını KdvRows ve KonnaklamaVergisi listelerinden, GuidId ile eşleştirerek alın.

TL belgelerde Kur alanına 0 mı, 1 mi yazılmalı?

1 yazın; hem Icmal.Kur hem her Detay.Kur için. 0, Abacus'ün kuru o tarihin kur tablosundan bulması anlamına gelir; TRY için kur kaydı bulunmazsa belge "kur bulunamadı" hatasıyla reddedilir. Dövizli belgede ise kendi kurunuzu gönderin veya Abacus'ün günlük kurunu kullanmak için 0 gönderin.

DovizTutar KDV dahil mi, hariç mi?

KDV dahil. Abacus KDV'yi satır tutarının içinden ayırır (Matrah = DovizTutar / (1 + Kdv/100)). Örnek: DovizTutar 1100, Kdv 10 → matrah 1000, KDV 100.

Aynı faturayı yanlışlıkla iki kez gönderirsem ne olur?

Alış faturalarında aynı cari için aynı seri + numara ikinci kez kabul edilmez ve hata döner. Diğer belge türlerinde kontrol şube ayarlarına bağlıdır. Yeniden göndermeden önce GetSlipListX'te DocNo filtresiyle belgenin Abacus'te olup olmadığını kontrol edin; mükerrer kaydı integrationreturn ile geri alın.

Yanıtta neden "$id" alanı var, bazı alanlar neden gelmiyor?

"$id" serileştiricinin referans numarasıdır, yok sayın. Değeri null olan alanlar yanıta yazılmaz; eksik alanı null kabul edin. Ayrıntı: Yanıt ve Hata Biçimi.

Hata olup olmadığını nasıl anlarım?

HTTP kodu 200 olsa bile yanıttaki error alanına bakın: boşsa başarılı, doluysa belge kaydedilmemiştir. Mesaj metni dile ve sürüme göre değişebileceğinden kodunuzda metne göre karar vermeyin.

Hangi şubeye kayıt atılır?

Token alırken kullandığınız bağlantıya bir şube atanmışsa kayıtlar o şubeye yazılır ve IsyeriId yok sayılır. Atanmamışsa IsyeriId (getintbranches → Id) kullanılır; tek şubeli yapıda şube otomatik seçilir. KayitEdenString kullanıcısı bu şubede yetkili olmalıdır.

Postman koleksiyonu güncel mi?

Koleksiyon hazır istek örnekleri içerir. Koleksiyonla bu doküman arasında fark görürseniz (ör. PUT kullanan eski bir istek) bu dokümanı esas alın.

Entegrasyona başlayalım

Kullanıcı, parola, bağlantı adı ve entegrasyon kullanıcı kodunuzu alın; koleksiyondaki hazır isteklerle uç noktaları hemen deneyin.