Abacus Web API

Nasıl çalışır?

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

Token alma

/token uç noktasına kullanıcı bilgilerinizle POST göndererek erişim token'ı alırsınız. Dönen access_token'ı sonraki tüm isteklerin Authorization başlığında kullanın.

# İstek — gövde (form)
POST {{baseUrl}}/token

username=PRGRUSER&password=PRGPASWORD&grant_type=password&connection=PRGCONNECTION

// Yanıt
{
  "access_token": "4ZVKa96Egt0Ep1MkQUXVKb9NrDsvMfAtS245AN4dL1hi...",
  "token_type": "bearer",
  "expires_in": 86399
}

Sonraki isteklerde:

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

Muhasebe Tanımları

Fatura aktarmadan önce hesap kodu, kullanıcı, döviz ve masraf merkezi tanımlarını okuyup eşleştirme (çaprazlama) yapın. Eşleştirmede genellikle Code alanı kullanılır.

// GET /api/values/getintaccounts — örnek yanıt
[
  { "Id": 338, "Code": "120.08.235", "Name": "YAZ TUR" },
  { "Id": 689, "Code": "100.01.001", "Name": "MUHASEBE TL KASA" }
]

Fatura / Fiş Aktarımı

Tüm alış/satış faturaları ve tahsilat/ödeme fişleri tek uç noktaya gönderilir. İşlem türü, gövdedeki DocType ve IsSlip alanlarıyla belirlenir. Gövde JSON ya da XML olabilir.

Örnek — Satış faturası (JSON)

POST {{baseUrl}}/api/values/updateintegration
Authorization: Bearer ACCESS_TOKEN

{
  "Tarih": "2025-01-17",
  "CariKod": "120.01.024",
  "EvrakNo": "123456789",
  "Kur": 3.45,
  "DovizCinsiString": "USD",
  "DocType": 1,
  "IsSlip": 0,
  "Kaynak": "Sejour",
  "KayitEdenString": "Sejour",
  "EACustName": "Zeytindalı yazılım",
  "EAEmail": "ornek@firma.com",
  "EAIdNo": "9300199600",
  "Detay": [
    {
      "HesapKod": "600.01.002",
      "DovizCinsiString": "USD",
      "DovizTutar": 109.8,
      "Kdv": 10,
      "Kur": 29.5481,
      "ResNo": "PX061022",
      "ResServiceName": "ADORA GOLF HOTEL",
      "ResGuestName": "ALİ VELİ",
      "GirisTarihi": "2017-01-11",
      "CikisTarihi": "2017-01-12"
    }
  ]
}

Örnek — Satış faturası (XML)

<?xml version="1.0" encoding="UTF-8"?>
<Icmal>
  <Tarih>2017-01-17</Tarih>
  <CariKod>120.01.024</CariKod>
  <EvrakNo>SGB2017000000066</EvrakNo>
  <Kur>3,45</Kur>
  <DovizCinsiString>USD</DovizCinsiString>
  <DocType>1</DocType>
  <IsSlip>0</IsSlip>
  <Kaynak>Sejour</Kaynak>
  <KayitEdenString>Sejour</KayitEdenString>
  <Detay>
    <HesapKod>600.01.002</HesapKod>
    <DovizCinsiString>USD</DovizCinsiString>
    <DovizTutar>109,8</DovizTutar>
    <Kdv>0</Kdv>
    <Kur>3,45</Kur>
  </Detay>
</Icmal>

Yanıt

{
  "id": 2500,
  "error": "",
  "GuidId": "05b34756-cbf2-472f-b223-a379c56f5059"
}

DocType & IsSlip

Gönderdiğiniz belgenin türü bu iki alanla belirlenir:

Sorgulama & Önizleme

// POST /api/values/GetInvoiceReportX — gövde
{
  "DateBegin": "2024-01-01T00:00:00",
  "DateEnd": "2024-12-31T00:00:00",
  "VoucherNoBegin": 1,
  "VoucherNoEnd": 100
}

Icmal & Detay alanları

Fatura aktarımında kullanılan Icmal (fatura başlığı) ve Detay (satırlar) modellerinin alanları. ✅ zorunlu alanları gösterir.