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.
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ğrulama | OAuth 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çimi | JSON (önerilen). updateintegration XML de kabul eder. |
| Karakter seti | UTF-8 |
| Tarih | yyyy-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ı
Token alın
POST /tokenile erişim token'ı alın; 2 gün boyunca tüm isteklerde kullanın.Tanımları okuyun
Hesap kodları, kullanıcılar, dövizler, şubeler ve masraf merkezlerini okuyup kendi sisteminizle eşleştirin.
Belgeyi gönderin
POST /api/values/updateintegrationile fatura veya fişi gönderin. Yanıttakiid(fiş no) veGuidIddeğerlerini saklayın.Kontrol edin
GetSlipListXveGetInvoiceReportXile aktarılan kayıtları sorgulayın.Gerekirse düzeltin
Kayıt güncelleme yoktur: hatalı kaydı
integrationreturnile geri alın, düzeltip yeniden gönderin.
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.
Ö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.
| Konu | Güncel durum |
|---|---|
| PUT | Hiçbir uç nokta PUT kullanmaz. GetSlipListX artık POST'tur. PUT ile yapılan çağrı 405 Method Not Allowed döner. |
| Token süresi | 2 gün (expires_in ≈ 172799 saniye). |
InsertCard | code1…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ı). |
getintaccounts | Yanıtta hesabın döviz kodu (CurrCode) ve KDV oranı (VatRatio) da döner. |
integrationreturn | Fiş no dışında rezervasyon no (Voucher), ResInfo ve bağlı fiş (SourceSlipNo) ile geri alma; geri alanı kaydetmek için UserCode. |
| Yanıt biçimi | Nesnelerde "$id" alanı bulunur; null değerli alanlar yanıta yazılmaz. Bkz. Yanıt ve Hata Biçimi. |
| Sınıflar | Tüm istek ve yanıt sınıfları (Icmal, Detay, InvoiceReport, KonaklamaVergisi, Slip…) alan alan belgelendi. Bkz. Sınıflar. |
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ı | Zorunlu | Açıklama |
|---|---|---|
grant_type | Evet | Her zaman password. |
username | Evet | Abacus ekibinin verdiği API kullanıcı adı. |
password | Evet | API parolası. |
connection | Evet | Bağ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.
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
erroralanı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
nullolan alanlar yanıtta hiç bulunmaz. Eksik alanınullkabul edin. Sayısal (null olamayan) alanlar ise0olarak gelir. - ✓ Tarihler
2026-08-05T00:00:00biç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.
| HTTP | Ne 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":"..."} |
401 | Token yok, geçersiz veya süresi dolmuş. | {"Message":"Authorization has been denied for this request."} |
404 | Uç nokta adı veya zorunlu adres parametresi yanlış/eksik. | {"Message":"No HTTP resource was found..."} |
405 | Yanlış metot (ör. PUT, ya da POST uç noktasına GET). | {"Message":"The requested resource does not support http method 'PUT'."} |
500 | Beklenmeyen sunucu hatası. | {"Message":"An error has occurred."} — isteği ve saati Abacus destek ekibine iletin. |
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.
| Metot | Uç nokta | Döner | Kullanıldığı alan |
|---|---|---|---|
| GET | /api/values/getintaccounts | Muavin (alt) hesap kodları: Id, Code, Name, CurrCode, VatRatio | Icmal.CariKod, Detay.HesapKod |
| GET | /api/values/geinttusers | Abacus kullanıcıları: Id, Code, Name | Icmal.KayitEdenString (= Code) |
| GET | /api/values/getintcurrencies | Döviz cinsleri: Id, Code (TRY, USD, EUR…), Name | DovizCinsiString |
| GET | /api/values/getintbranches | Şubeler: Id, Code (şube adı), Name (ünvan) | Icmal.IsyeriId (= Id) |
| GET | /api/values/getcostaccounts | Masraf merkezleri: Id, Code, Name | Detay.MasrafMerkezi (= Code) |
| GET | /api/values/getintwhcodes | Tevkifat kodları: Id, Code (601, 602…), Name | Icmal.TevkifatKodu (= Code) |
| GET | /api/values/InsertCard | Yeni hesap kartı açar, CardObject döner | Yeni 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.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
code1…code5 | Evet* | Ü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. |
accountname | Evet | Hesap adı (ünvan). |
EAIdNo | Hayır | VKN / TCKN. Doluysa karta e-belge bilgileri de yazılır. |
EACustName, EATaxOffice, EAAddress, EAEmail | Hayır | E-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" }
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.
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.
| Metot | Uç nokta | Gövde | Yanıt |
|---|---|---|---|
| POST | /api/values/updateintegration | Icmal (JSON veya XML) | errorhandler |
Her belgede zorunlu alanlar
| Alan | Kural |
|---|---|
Tarih | Belge tarihi. Kur bu tarihe göre aranır. |
DocType, IsSlip | Belge türü. Bkz. Belge Türleri. |
CariKod | Abacus'te tanımlı cari hesap kodu (veya OpenCards: true). |
KayitEdenString | Abacus kullanıcı kodu. Kullanıcı tanımlı ve ilgili şubede yetkili olmalıdır. Boş veya tanımsızsa belge reddedilir. |
DovizCinsiString, Kur | Belge dövizi ve kuru. TL belgede "TRY" ve 1. Bkz. Döviz, Kur ve KDV. |
Kaynak | Gönderen sistemin adı (örn. "Sejour", "MyApp"). Boş gönderilen kayıt integrationreturn ile geri alınamaz. |
Detay | En 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>
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ı).
| Alan | Anlamı |
|---|---|
error | Boşsa aktarım başarılı. Doluysa belge kaydedilmemiştir; mesajı gösterin, düzeltip yeniden gönderin. |
id | Abacus fiş numarası (SlipNo). Geri alma ve sorgulama için saklayın. |
id2 | Varsa bağlı EB/avans veya virman fişinin numarası; yoksa 0. |
GuidId | Kaydın benzersiz kimliği. Sorgulamada GuidId filtresiyle kullanın; saklayın. |
Token1 | Kullanılan cari hesap kodu. |
errdatainfo | Yalnı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
Detayboş /nullsatır içeriyor. - ✓
DetaysatırlarınınDovizTutartoplamı 0. - ✓
CariKod,HesapKod,MasrafMerkeziveya döviz kodu Abacus'te tanımlı değil (cari ve hesap içinOpenCards: truegönderilebilir). - ✓
KayitEdenStringboş, tanımsız veya kullanıcı ilgili şubede yetkili değil. - ✓
Kur0 gönderildi ve Abacus'te o tarih için kur bulunamadı. - ✓ Alış faturasında (
DocType 3) aynı cari için aynıEvrakSeri+EvrakNodaha önce aktarılmış. Şube ayarlarına göre diğer belge türlerinde de mükerrer belge no kontrolü yapılabilir.
DocType & IsSlip
Gönderdiğiniz belgenin türü bu iki alanla belirlenir. Fişlerde (IsSlip = 1) DocType borç/alacak yönünü belirler.
| İşlem | DocType | IsSlip | Cari hesap | Detay hesapları |
|---|---|---|---|---|
| Satış faturası | 1 | 0 | Borç | Alacak (gelir + KDV) |
| Satış iade faturası | 2 | 0 | Alacak | Borç |
| Alış faturası | 3 | 0 | Alacak | Borç (gider + KDV) |
| Alış iade faturası | 4 | 0 | Borç | Alacak |
| Tahsilat fişi (müşteriden para girişi) | 3 | 1 | Alacak | Borç (kasa/banka) |
| Ödeme fişi (tedarikçiye para çıkışı) | 1 | 1 | Borç | Alacak (kasa/banka) |
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.
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ğiniz | Abacus'ün davranışı |
|---|---|
Kur > 0 | Gönderilen kur kullanılır. TL tutar = DovizTutar × Kur. |
Kur = 0 | Tarih 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 > 0 | TL 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. |
Ş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
- ✓
Kdvtam sayı yüzde oranıdır:0,1,8,10,18,20. - ✓ KDV istisnalı satırlarda
Kdv: 0ve gerekiyorsaUntaxType(istisna türü kodu) gönderin. - ✓ Konaklama vergisi için satırda
AccomodationRate(oran, örn.2) veResServiceType: "Kon"gönderin.AccomodationRate> 0 veResServiceTypeboşsa Abacus"Kon"kabul eder;AccomodationRate: 0konaklama vergisi hesaplanmaz demektir. - ✓ Satır indirimi için
indirimlerlistesine{ "Aciklama": "...", "DovizTutar": 50.00 }ekleyin; tutar satırın döviz tutarından düşülür. İndirim yoksa boş liste ([]) gönderin,nullgöndermeyin. - ✓ Tutarları 2 ondalıkla, kurları en fazla 6 ondalıkla gönderin.
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.
| Metot | Uç nokta | Yanıt |
|---|---|---|
| GET | /api/values/integrationreturn?SlipNo=2500&UserCode=CONNECT | errorhandler |
| Parametre | Tip | Açıklama |
|---|---|---|
SlipNo | int | Aktarım yanıtındaki id. Bağlı virman fişleri de birlikte silinir. |
Voucher | string | Alternatif: satırlardaki ResNo değeriyle eşleşen kaydı geri alır. |
ResInfo | string | Alternatif: satırlardaki ResInfo değeriyle eşleşen kaydı geri alır. |
SourceSlipNo | int | Yalnız bağlı fişi (EB/avans/virman) geri alır: değeri ana fiş numarasıdır. |
UserCode | string | Geri 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,VoucherveyaResInfo) gönderilmelidir. - ✓ Yalnız API ile aktarılmış kayıtlar (
Kaynakdolu) 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
SlipNoile geri alın.
Sorgulama & önizleme
| Metot | Uç nokta | Gövde / parametre | Yanıt |
|---|---|---|---|
| POST | /api/values/GetInvoiceReportX | SlipFiter | InvoiceReportResponse |
| POST | /api/values/GetSlipListX | VoucherFilter | SlipRequestMessage |
| 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.pdfolarak kaydedin. Fatura bulunamazsanulldöner.
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
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
Tarih | DateTime | Evet | Belge tarihi; kur bu tarihe göre aranır. |
DocType | byte | Evet | 1 Satış, 2 Satış iade, 3 Alış, 4 Alış iade. Fişlerde yön belirler (tablo). |
IsSlip | byte | Evet | 0 Fatura, 1 Fiş (tahsilat/ödeme). |
CariKod | string | Evet | Cari hesap kodu (getintaccounts → Code). Tanımsızsa OpenCards: true ile açılır. |
KayitEdenString | string | Evet | Kaydı yapan Abacus kullanıcı kodu (geinttusers → Code). Kullanıcı ilgili şubede yetkili olmalıdır. Entegrasyona özel kullanıcı önerilir (SSS). |
DovizCinsiString | string | Evet | Belge dövizi: TRY, USD, EUR… (getintcurrencies → Code). |
Kur | decimal | Evet | Belge kuru. TL belgede 1. Dövizde kur veya 0 (Abacus günlük kuru bulur). Bkz. Kur. |
Kaynak | string | Evet | Gönderen sistemin adı. Kayıtlarda entegrasyon kaynağı olarak saklanır; boşsa kayıt API ile geri alınamaz. |
Detay | List<Detay> | Evet | Belge satırları; en az bir satır. |
EvrakNo | string | Önerilir | Belge (fatura) numarası. Alış faturasında aynı cari + seri + no ikinci kez kabul edilmez. |
EvrakSeri | string | Hayır | Belge serisi, en fazla 3 karakter (fazlası kırpılır). |
Aciklama | string | Hayır | Belge açıklaması (en fazla 250 karakter). Boşsa ilk satırın Aciklama1 değeri kullanılır. |
IsyeriId | int | Hayır | Şube Id (getintbranches → Id). Token'daki bağlantıya şube atanmışsa o şube geçerlidir; tek şubeli yapıda otomatik seçilir. |
OpenCards | bool? | Hayır | true: Abacus'te olmayan CariKod, HesapKod, EBHesapKodu, AvansHesapKodu kartlarını aç. |
EACustName | string | Hayır | E-belge alıcı ünvanı / adı. Boşsa cari karttan alınır. |
EAIdNo | string | Hayır | Alıcı VKN (10 hane) / TCKN (11 hane). Boşsa cari karttan alınır. |
EATaxOffice | string | Hayır | Alıcı vergi dairesi. |
EAAddress | string | Hayır | Alıcı adresi. |
EAEmail | string | Hayır | Alıcı e-posta adresi (e-arşiv gönderimi). |
IsEInv | bool? | Hayır | E-fatura mı? Faturalarda cari karttaki e-fatura mükellefiyet bilgisine göre Abacus tarafından yeniden belirlenir. |
TevkifatKodu | string | Hayır | Tevkifat kodu (getintwhcodes → Code, örn. 624). Alış faturasında tevkifat oranı ve hesabı uygulanır; tanımsız kod tevkifat üretmez. |
TicketNo | string | Hayır | Bilet numarası (bilet entegrasyonları). |
Attachments | string | Hayır | Ek dosya adı / yolu; oluşturulan satırlara yazılır. |
KurAlis | decimal? | Hayır | Alış (maliyet) kuru. Boş/0 ise kurdan tamamlanır. |
SatTarihi, TurTarihi | DateTime? | Hayır | Satış ve tur tarihi. Şubede tur/bilet aktarım ayarı açıksa belge veya kur tarihi olarak kullanılabilir. |
EBHesapKodu | string | Hayır | EB (erken rezervasyon) virmanının hesap kodu. |
EBOran | string | Hayır | EB oranı, metin (örn. "10"). Boş veya "0": EB işlemi yapılmaz. XML adı EBOrani. |
DovizEBTutar | decimal? | Hayır | EB tutarı (belge dövizinde). TL karşılığı DovizEBTutar × Kur. |
AvansHesapKodu | string | Hayır | Avans virmanının hesap kodu. |
AvansOrani | string | Hayır | Avans 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. |
Virman | List<Detay> | Hayır | Ana 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. |
IsCollect | string | Hayır | Yalnız Abacus ile kurgulanan özel senaryolar ("1" tahsilat, "2" tediye detaylandırma). Standart entegrasyonda göndermeyin. |
CariId, KayitEden, DovizCinsi | int | Göndermeyin | Abacus bunları CariKod, KayitEdenString, DovizCinsiString kodlarından doldurur. |
Detay belge satırı — Icmal.Detay ve Icmal.Virman
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
HesapKod | string | Evet | Gelir / gider / hizmet hesabı (fişlerde kasa/banka hesabı). getintaccounts → Code. |
DovizCinsiString | string | Evet | Satır dövizi; genellikle belge dövizinin aynısı. |
DovizTutar | decimal | Evet | Satırın KDV dahil toplamı (satır dövizinde, 2 ondalık). Tüm satırların toplamı 0 olamaz. |
Kdv | int | Evet | KDV yüzdesi: 0, 1, 8, 10, 18, 20. |
Kur | decimal | Evet | Satır kuru. TL satırda 1. 0 ise belge kuru veya günlük kur kullanılır. |
TLTutar | decimal? | Hayır | Satırın KDV dahil TL tutarı. > 0 ise TL tutar olarak doğrudan kullanılır ve kur TLTutar / DovizTutar hesaplanır. |
Aciklama1, Aciklama2 | string | Hayır | Muhasebe satırı açıklamaları (en fazla 250 karakter). |
ResNo | string | Hayır | Rezervasyon / voucher numarası. integrationreturn?Voucher= ile geri almada kullanılır. |
ResInfo | string | Hayır | Rezervasyon ek bilgisi (pax, operasyon notu). |
ResServiceType | string | Hayır | Servis türü: Kon konaklama, Trf transfer; diğerleri serbest metin. |
ResServiceName | string | Hayır | Servis adı (örn. otel adı). |
ResGuestName | string | Hayır | Misafir / müşteri adı. |
ResCountry | string | Hayır | Misafir ülkesi. |
GirisTarihi, CikisTarihi | DateTime? | Hayır | Rezervasyon giriş / çıkış tarihi. |
AccomodationRate | int? | Hayır | Konaklama 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. |
UntaxType | short? | Hayır | KDV istisna / muafiyet türü kodu. |
MasrafMerkezi | string | Hayır | Masraf merkezi kodu (getcostaccounts → Code). Gönderilirse tanımlı olmalıdır. |
MasrafMerkeziId | int? | Hayır | Kod yerine masraf merkezi Id. |
indirimler | List<indirim> | Önerilir | Satır indirimleri; tutarlar satırın döviz tutarından düşülür. İndirim yoksa [] gönderin. |
IndirimSatiri | bool? | Hayır | true: satır belge toplamına katılmayan bir indirim satırıdır. |
F1…F6 | string | Hayır | Serbest alanlar (150 karakter). Örn. F1 müşteri adı, F2 voucher/fatura no, F3 oda tipi. F6 sayısal değer olmalıdır. |
DovizTutarAlis | decimal? | Hayır | Satırın alış (maliyet) tutarı, döviz. |
TLTutarAlis | decimal? | Hayır | Satırın alış (maliyet) tutarı, TL. |
DovizCinsiStringAlis | string | Hayır | Alış tutarının döviz kodu. |
KurAlis | decimal? | Hayır | Alış kuru. |
HesapId | int | Hayır | HesapKod yerine hesap Id. Kod göndermeniz önerilir. |
DovizCinsi, DovizTutarOrg, TLTutarOrg, price, pricecurr, AccomodationAmount, AccomodationAmountNotRounding, AccomodationAmountTry, AccomodationAmountTryNotRounding | — | Göndermeyin | Abacus'ün hesaplama sırasında doldurduğu iç alanlar. |
indirim Detay.indirimler elemanı
| Alan | Tip | Açıklama |
|---|---|---|
Aciklama | string | İndirim açıklaması. |
DovizTutar | decimal | İndirim tutarı (satır dövizinde); satırın DovizTutar'ından düşülür. |
errorhandler işlem sonucu — updateintegration, integrationreturn; raporlarda Handler / errhandler
| Alan | Tip | Açıklama |
|---|---|---|
error | string | Boş ("") ise başarılı; dolu ise hata mesajı. Abacus servis hataları "Abacus Error : " önekiyle gelir. |
id | int | Aktarımda oluşan fiş numarası (SlipNo). |
id2 | int | Bağlı EB/avans/virman fiş numarası; yoksa 0. |
GuidId | string | Oluşan kaydın benzersiz kimliği. |
Token1 | string | Aktarımda kullanılan cari hesap kodu. |
Token, Token2, Token3 | string | Teknik alanlar; entegrasyonda kullanmayın. |
errdatainfo | string | Hata durumunda teknik teşhis bilgisi (destek için). |
SqlQuery | string | Teknik alan; kullanmayın. |
IntegrationDefault tanım listesi elemanı — getint* uç noktaları
| Alan | Tip | Açıklama |
|---|---|---|
Id | int | Kaydın Abacus Id'si. 0 ise liste hata ile dönmüştür. |
Code | string | Belgede gönderilecek kod (hesap kodu, kullanıcı kodu, döviz kodu, masraf merkezi kodu, tevkifat kodu). getintbranches'te şube adı. |
Name | string | Ad / açıklama. getintbranches'te şube ünvanı. |
CurrCode | string | Yalnız getintaccounts: hesabın döviz kodu (boş = dövizsiz/TL). |
VatRatio | decimal? | Yalnız getintaccounts: hesap kartında tanımlı KDV oranı. |
CardObject InsertCard yanıtı
| Alan | Tip | Açıklama |
|---|---|---|
Id | int | Hesap kartı Id. |
Code | string | Açılan (veya zaten var olan) hesap kodu; belgede CariKod / HesapKod olarak kullanın. |
Name | string | Hesap 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.
| Alan | Tip | Açıklama |
|---|---|---|
DateBegin, DateEnd | DateTime | Belge tarihi aralığı (dahil). |
VoucherNoBegin, VoucherNoEnd | int | Fiş numarası (SlipNo) aralığı. |
GuidId | string | Tek belge. Gönderilirse diğer filtreler yok sayılır. |
GuidIdList | List<string> | Belge listesi. |
DocType | byte? | Tek belge türü (1–4). |
InvType | List<int> | Birden çok belge türü, örn. [1,2]. |
InvNo | string | Belge numarası (EvrakNo), tam eşleşme. |
serie | string | Belge serisi (EvrakSeri). |
AccCodeBegin, AccCodeEnd | string | Hesap kodu aralığı. |
GroupCode | string | Hesap kartı grup kodu. |
CurrId | int | Döviz Id (getintcurrencies → Id). |
BranchId | List<int> | Şube Id listesi. |
DueDateBegin, DueDateEnd | DateTime | Vade tarihi aralığı. |
CategoriyId, SlipTypes, PayTypes, Vouchertypes | List<int> | Kategori, fiş türü, ödeme türü, belge türü Id listeleri (Abacus tanımları). |
F1…F5 | string | Hesap kartının F1–F5 özel alanlarına göre filtre. |
Details | bool | false (varsayılan): yalnız belge başlık satırları (RowType 0). true: hizmet satırları da (RowType 1). |
Columns | List<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ı
| Alan | Tip | Açıklama |
|---|---|---|
Handler | errorhandler | Handler.error doluysa rapor alınamamıştır. |
InvoiceReport | List<InvoiceReport> | Fatura başlık (ve Details: true ise hizmet) satırları. |
KonnaklamaVergisi | List<KonaklamaVergisi> | Konaklama vergisi satırları. Adı çift n ile yazılır. |
KdvRows | List<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.
| Alan | Tip | Açıklama |
|---|---|---|
| Belge ve satır | ||
Id | int | Muhasebe satırı Id. |
GuidId | string | Belge kimliği (aktarım yanıtındaki GuidId). |
SlipNo | int | Fiş numarası (aktarım yanıtındaki id). |
DocType | byte | 1 Satış, 2 Satış iade, 3 Alış, 4 Alış iade. |
RowType | byte? | 0 cari (başlık) satırı, 1 hizmet satırı. |
GeneralType | byte? | Abacus iç satır sınıfı; bilgi amaçlı. |
Dates | DateTime | Belge (muhasebe) tarihi. |
DocDate | DateTime? | Evrak tarihi. |
DocNo | string | Belge numarası (EvrakNo). |
InvSerie | string | Belge serisi (EvrakSeri). |
DueDate | DateTime? | Vade tarihi. |
OrderNo | int? | Sipariş / sıra numarası. |
Category | string | Kategori adı. |
RowRemark, RowRemark2 | string | Satır açıklamaları (Aciklama1, Aciklama2). |
UnitRemark, Quantity | string / decimal? | Birim ve miktar. |
CostCenterId | int? | Masraf merkezi Id. |
VatRatio | decimal? | Satırın KDV oranı. |
WhtTax, WhRate | short? / string | Tevkifat kodu ve oranı. |
UnTaxType | short? | KDV istisna türü. |
Attachments | string | Ek dosya bilgisi. |
| Hesap ve tutar | ||
Code, Name, Name2 | string | Satırın hesap kodu ve adları (RowType 0'da cari hesap). |
Currency | string | Satır döviz kodu. |
Total | decimal? | Satır tutarı, TL (borç + alacak). RowType 0'da faturanın KDV dahil TL toplamı. |
TotalCurr | decimal? | Satır tutarı, döviz. |
ExcRate | decimal? | Kur. |
| Rezervasyon | ||
ResNo, ResInfo, ResServiceType, ResServiceName, ResGuestName, ResCountry | string | Aktarımdaki Detay rezervasyon alanları. |
CiDate, CoDate | DateTime? | Giriş / çıkış tarihi (GirisTarihi, CikisTarihi). |
| E-belge alıcısı (belgeyle gönderilen) | ||
EAIdNo, EACustName, EATaxOffice, EAAddress, EAEmail | string | Aktarımdaki Icmal e-belge alanları. |
| Cari kart bilgileri (Abacus'teki karttan) | ||
IdNo, TaxOffice, isEInv, EWorkType | string / bool? / byte? | VKN/TCKN, vergi dairesi, e-fatura mükellefi mi, çalışma türü. |
Address1, Address2, Street, BuildingNumber, CitySubdivisionName, City, Country, PostCode | string | Adres bilgileri. |
Tel, Tel2, Fax, Fax2, Email, Web, AuthorPerson, AuthorPerson2 | string | İletişim bilgileri ve yetkililer. |
ExpiryDay, PayDay | int? | Vade günü (ikisi de aynı değeri taşır). |
BankName, BankBranch, BankAccount, BankIban | string | Banka bilgileri. |
| Özel alanlar ve kayıt bilgisi | ||
F1…F5 | string | Satırın metin özel alanları. |
F6…F10 | decimal? | Satırın sayısal özel alanları. |
RecDate | DateTime? | Kayıt zamanı. |
RecUser | int? | 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ç).
| Alan | Tip | KonnaklamaVergisi | KdvRows | Açıklama |
|---|---|---|---|---|
Id | int | ✓ | ✓ | Muhasebe satırı Id. |
GuidId | string | ✓ | ✓ | Belge kimliği; InvoiceReport.GuidId ile eşleştirin. |
Debit, Credit | decimal? | ✓ | ✓ | TL borç / alacak. KonnaklamaVergisi'nde konaklama vergisi tutarı; KdvRows'ta satırın KDV hariç tutarı (matrah). |
DebitCurr, CreditCurr | decimal? | ✓ | ✓ | Aynı tutarların döviz karşılığı. |
AccomodationCalc | bool? | ✓ | — | Konaklama vergisi hesaplandı mı. |
AccomodationVatRate | decimal? | ✓ | ✓ | Konaklama vergisi oranı (%); yoksa 0. |
VatRatio | decimal? | — | ✓ | KDV oranı (%). |
VatAmount, VatAmountCurr | decimal? | — | ✓ | KDV tutarı, TL ve döviz. |
WhAmount, WhAmountCurr | decimal? | — | ✓ | Tevkifat tutarı, TL ve döviz. |
NotApplyWh | bool? | — | ✓ | true: bu satıra tevkifat uygulanmaz. |
AccCardId | int | — (0) | ✓ | Satırın hesap kartı Id (getintaccounts → Id). |
VatCardId | int? | — | ✓ | 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.
| Alan | Tip | Açıklama |
|---|---|---|
BeginDate, EndDate | DateTime | Belge tarihi aralığı. |
RecBeginDate, RecEndDate | DateTime | Kayıt (aktarım) zamanı aralığı. |
GuidId | string | Tek belge. |
GuidIds | List<string> | Belge listesi. |
BeginVouhcer, EndVouhcer | int | Fiş numarası aralığı. Alan adı bu yazımla (Vouhcer) gönderilmelidir. |
BeginVouhcerTarget, EndVouhcerTarget | int | Bağlı fişler için ana fiş numarası (SourceSlipNo) aralığı. |
DocNo, Serial | string | Belge numarası ve serisi. |
DocTypes | List<int> | Belge türleri (0 fiş, 1–4 fatura). |
SlipTypes | List<int> | Fiş türleri (2 tahsilat, 3 tediye…). |
Source | List<int> | [1] yalnız API ile aktarılanlar, [2] yalnız Abacus'te girilenler, boş = hepsi. |
ResNo | string | Rezervasyon numarası. |
RecUser | int? | Kaydı yapan kullanıcı Id (geinttusers → Id), örn. CONNECT kullanıcısının Id'si. |
BranchId, CategoryIdes, VoucherTypes | List<int> | Şube, kategori, belge türü Id listeleri. |
Columns | List<string> | Yanıttan çıkarılacak Slip alanları, örn. ["OwnerRemark","VoucherRemark"]. |
SlipRequestMessage GetSlipListX yanıtı
| Alan | Tip | Açıklama |
|---|---|---|
errhandler | errorhandler | errhandler.error doluysa liste alınamamıştır. |
SlipList | List<Slip> | Bulunan fişler. |
Slip SlipRequestMessage.SlipList elemanı — bir fiş/belge
| Alan | Tip | Açıklama |
|---|---|---|
GuidId | string | Belge kimliği. |
SlipNo | int? | Fiş numarası. |
SourceSlipNo | int? | Bağlı fişse ana fişin numarası. |
SlipType | byte? | Fiş türü (2 tahsilat, 3 tediye; diğerleri muhasebe fiş türleri). |
DocType | byte? | 0 fiş, 1–4 fatura türleri. |
DocNo | string | Belge numarası. |
Dates, DocDate | DateTime? | Belge tarihi, evrak tarihi. |
BranchId | int? | Şube Id. |
Total, TotalCurr | decimal? | Borç toplamı, TL ve döviz. |
CurrId | int? | Döviz Id. |
IntSource | string | Entegrasyon kaynağı (aktarımdaki Kaynak); Abacus'te girilen kayıtlarda boş. |
IntState | short? | Entegrasyon durum kodu. |
RecDate, RecUser | DateTime? / int? | Kayıt zamanı ve kaydı yapan kullanıcı Id. |
ChgDate, ChgUser | DateTime? / int? | Son değişiklik zamanı ve kullanıcısı. |
Lock, LockUser, LockDate | bool? / int? / DateTime? | Kilit durumu. |
Confirm, ConfirmUser, ConfirmDate | bool? / int? / DateTime? | Onay durumu. |
EledgerSent | bool? | E-deftere gönderildi mi. |
EarchiveCancel | bool? | E-arşiv iptal edildi mi. |
Attachment | bool? | Ek dosyası var mı. |
Proforma | bool? | 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_message | string | Yalnız BAE e-fatura kurulumlarında dolu; Türkiye'de boş. |
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.