Muhasebe seçeneklerini oku

{
  "status": true,
  "result": {
    "currencies": [
      "TRY",
      "USD",
      "EUR",
      "GBP",
      "CHF",
      "CAD",
      "AUD",
      "JPY",
      "CNY",
      "AED",
      "SAR",
      "RUB",
      "DKK",
      "NOK",
      "SEK"
    ],
    "units": [
      {
        "code": "C62",
        "description": "Adet"
      },
      {
        "code": "PR",
        "description": "Çift"
      },
      {
        "code": "DAY",
        "description": "Gün"
      },
      {
        "code": "WEE",
        "description": "Hafta"
      },
      {
        "code": "MON",
        "description": "Ay"
      },
      {
        "code": "ANN",
        "description": "Yıl"
      },
      {
        "code": "MIN",
        "description": "Dakika"
      },
      {
        "code": "SEC",
        "description": "Saniye"
      },
      {
        "code": "HUR",
        "description": "Saat"
      },
      {
        "code": "CMQ",
        "description": "cm3(CMQ)"
      },
      {
        "code": "MMQ",
        "description": "mm3"
      },
      {
        "code": "CMT",
        "description": "cm"
      },
      {
        "code": "CMK",
        "description": "cm2"
      },
      {
        "code": "KTM",
        "description": "km"
      },
      {
        "code": "MLT",
        "description": "ml"
      },
      {
        "code": "MMT",
        "description": "mm"
      },
      {
        "code": "B32",
        "description": "Kg.m2"
      },
      {
        "code": "CCT",
        "description": "Ton başına taşıma kapasitesi"
      },
      {
        "code": "D30",
        "description": "Brüt kalori değeri"
      },
      {
        "code": "D40",
        "description": "1000 litre"
      },
      {
        "code": "GRM",
        "description": "Gram"
      },
      {
        "code": "GT",
        "description": "Gros ton"
      },
      {
        "code": "KGM",
        "description": "Kilogram"
      },
      {
        "code": "KWH",
        "description": "Kilowatt saat"
      },
      {
        "code": "LPA",
        "description": "Saf alkol litresi"
      },
      {
        "code": "LTR",
        "description": "Litre"
      },
      {
        "code": "MTK",
        "description": "m2"
      },
      {
        "code": "MTQ",
        "description": "m3"
      },
      {
        "code": "MTR",
        "description": "Metre"
      },
      {
        "code": "NCL",
        "description": "Hücre"
      },
      {
        "code": "R9",
        "description": "1000 m3"
      },
      {
        "code": "SET",
        "description": "Set"
      },
      {
        "code": "T3",
        "description": "1000 adet"
      },
      {
        "code": "MGM",
        "description": "mg"
      },
      {
        "code": "TNE",
        "description": "Metric Ton"
      },
      {
        "code": "KJO",
        "description": "kj"
      },
      {
        "code": "CLT",
        "description": "cl"
      },
      {
        "code": "BX",
        "description": "Kutu"
      },
      {
        "code": "PA",
        "description": "Paket(PA)"
      },
      {
        "code": "FTK",
        "description": "Ayak Kare "
      },
      {
        "code": "DMK",
        "description": "Desimetre Kare"
      },
      {
        "code": "RO",
        "description": "Rulo"
      },
      {
        "code": "SA",
        "description": "Çuval"
      },
      {
        "code": "BJ",
        "description": "Kova"
      },
      {
        "code": "PK",
        "description": "Paket(PK)"
      },
      {
        "code": "LK",
        "description": "BAĞ"
      },
      {
        "code": "DR",
        "description": "BİDON"
      },
      {
        "code": "CG",
        "description": "KARTON"
      },
      {
        "code": "CS",
        "description": "KASA"
      },
      {
        "code": "JR",
        "description": "KAVANOZ"
      },
      {
        "code": "NPL",
        "description": "KOLİ"
      },
      {
        "code": "M43",
        "description": "MIL"
      },
      {
        "code": "PF",
        "description": "PALET"
      },
      {
        "code": "BG",
        "description": "POŞET"
      },
      {
        "code": "BK",
        "description": "SEPET"
      },
      {
        "code": "BO",
        "description": "ŞİŞE"
      },
      {
        "code": "H87",
        "description": "TANE"
      },
      {
        "code": "TN",
        "description": "TENEKE"
      },
      {
        "code": "26",
        "description": "TON"
      },
      {
        "code": "TU",
        "description": "TÜP"
      },
      {
        "code": "G52",
        "description": "cm3(G52)"
      },
      {
        "code": "K51",
        "description": "MKCAL"
      },
      {
        "code": "J39",
        "description": "MMBTU"
      },
      {
        "code": "SM3",
        "description": "SM3"
      },
      {
        "code": "CT",
        "description": "Karton"
      }
    ],
    "taxes": [
      {
        "code": "0015",
        "name": "KDV",
        "minPercent": 0,
        "maxPercent": 100,
        "precision": 4
      }
    ],
    "withholding": {
      "minPercent": 0,
      "maxPercent": 100,
      "precision": 4,
      "basis": "vat"
    },
    "paymentAccounts": {
      "items": [
        {
          "id": "507f1f77bcf86cd799439012",
          "name": "Merkez kasa",
          "code": "K-001",
          "type": "cash",
          "currencyCode": "TRY"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 25,
        "total": 1,
        "totalPages": 1
      }
    }
  }
}

{
  "status": false,
  "code": "INVALID_REQUEST",
  "message": "Alan, tarih, hassasiyet, gövde veya başlık geçersiz."
}

{
  "status": false,
  "code": "UNAUTHORIZED",
  "message": "API kimlik bilgileri doğrulanamadı."
}

{
  "status": false,
  "message": "Ürün, IP, modül izni veya kaynak kapsamı uygun değil."
}

{
  "status": false
}

{
  "status": false,
  "code": "RECORD_CHANGED",
  "message": "İlişki, bakiye, kur, sürüm veya işlem kilidi çakışması. İlgili kaydı ve işlem durumunu okuyun."
}

{
  "status": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "status": false,
  "message": "Üzgünüz, bir hata oluştu."
}

GET

https://api.muhasip.pro

accounting

options

{
  "status": true,
  "result": {
    "currencies": [
      "TRY",
      "USD",
      "EUR",
      "GBP",
      "CHF",
      "CAD",
      "AUD",
      "JPY",
      "CNY",
      "AED",
      "SAR",
      "RUB",
      "DKK",
      "NOK",
      "SEK"
    ],
    "units": [
      {
        "code": "C62",
        "description": "Adet"
      },
      {
        "code": "PR",
        "description": "Çift"
      },
      {
        "code": "DAY",
        "description": "Gün"
      },
      {
        "code": "WEE",
        "description": "Hafta"
      },
      {
        "code": "MON",
        "description": "Ay"
      },
      {
        "code": "ANN",
        "description": "Yıl"
      },
      {
        "code": "MIN",
        "description": "Dakika"
      },
      {
        "code": "SEC",
        "description": "Saniye"
      },
      {
        "code": "HUR",
        "description": "Saat"
      },
      {
        "code": "CMQ",
        "description": "cm3(CMQ)"
      },
      {
        "code": "MMQ",
        "description": "mm3"
      },
      {
        "code": "CMT",
        "description": "cm"
      },
      {
        "code": "CMK",
        "description": "cm2"
      },
      {
        "code": "KTM",
        "description": "km"
      },
      {
        "code": "MLT",
        "description": "ml"
      },
      {
        "code": "MMT",
        "description": "mm"
      },
      {
        "code": "B32",
        "description": "Kg.m2"
      },
      {
        "code": "CCT",
        "description": "Ton başına taşıma kapasitesi"
      },
      {
        "code": "D30",
        "description": "Brüt kalori değeri"
      },
      {
        "code": "D40",
        "description": "1000 litre"
      },
      {
        "code": "GRM",
        "description": "Gram"
      },
      {
        "code": "GT",
        "description": "Gros ton"
      },
      {
        "code": "KGM",
        "description": "Kilogram"
      },
      {
        "code": "KWH",
        "description": "Kilowatt saat"
      },
      {
        "code": "LPA",
        "description": "Saf alkol litresi"
      },
      {
        "code": "LTR",
        "description": "Litre"
      },
      {
        "code": "MTK",
        "description": "m2"
      },
      {
        "code": "MTQ",
        "description": "m3"
      },
      {
        "code": "MTR",
        "description": "Metre"
      },
      {
        "code": "NCL",
        "description": "Hücre"
      },
      {
        "code": "R9",
        "description": "1000 m3"
      },
      {
        "code": "SET",
        "description": "Set"
      },
      {
        "code": "T3",
        "description": "1000 adet"
      },
      {
        "code": "MGM",
        "description": "mg"
      },
      {
        "code": "TNE",
        "description": "Metric Ton"
      },
      {
        "code": "KJO",
        "description": "kj"
      },
      {
        "code": "CLT",
        "description": "cl"
      },
      {
        "code": "BX",
        "description": "Kutu"
      },
      {
        "code": "PA",
        "description": "Paket(PA)"
      },
      {
        "code": "FTK",
        "description": "Ayak Kare "
      },
      {
        "code": "DMK",
        "description": "Desimetre Kare"
      },
      {
        "code": "RO",
        "description": "Rulo"
      },
      {
        "code": "SA",
        "description": "Çuval"
      },
      {
        "code": "BJ",
        "description": "Kova"
      },
      {
        "code": "PK",
        "description": "Paket(PK)"
      },
      {
        "code": "LK",
        "description": "BAĞ"
      },
      {
        "code": "DR",
        "description": "BİDON"
      },
      {
        "code": "CG",
        "description": "KARTON"
      },
      {
        "code": "CS",
        "description": "KASA"
      },
      {
        "code": "JR",
        "description": "KAVANOZ"
      },
      {
        "code": "NPL",
        "description": "KOLİ"
      },
      {
        "code": "M43",
        "description": "MIL"
      },
      {
        "code": "PF",
        "description": "PALET"
      },
      {
        "code": "BG",
        "description": "POŞET"
      },
      {
        "code": "BK",
        "description": "SEPET"
      },
      {
        "code": "BO",
        "description": "ŞİŞE"
      },
      {
        "code": "H87",
        "description": "TANE"
      },
      {
        "code": "TN",
        "description": "TENEKE"
      },
      {
        "code": "26",
        "description": "TON"
      },
      {
        "code": "TU",
        "description": "TÜP"
      },
      {
        "code": "G52",
        "description": "cm3(G52)"
      },
      {
        "code": "K51",
        "description": "MKCAL"
      },
      {
        "code": "J39",
        "description": "MMBTU"
      },
      {
        "code": "SM3",
        "description": "SM3"
      },
      {
        "code": "CT",
        "description": "Karton"
      }
    ],
    "taxes": [
      {
        "code": "0015",
        "name": "KDV",
        "minPercent": 0,
        "maxPercent": 100,
        "precision": 4
      }
    ],
    "withholding": {
      "minPercent": 0,
      "maxPercent": 100,
      "precision": 4,
      "basis": "vat"
    },
    "paymentAccounts": {
      "items": [
        {
          "id": "507f1f77bcf86cd799439012",
          "name": "Merkez kasa",
          "code": "K-001",
          "type": "cash",
          "currencyCode": "TRY"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 25,
        "total": 1,
        "totalPages": 1
      }
    }
  }
}

{
  "status": false,
  "code": "INVALID_REQUEST",
  "message": "Alan, tarih, hassasiyet, gövde veya başlık geçersiz."
}

{
  "status": false,
  "code": "UNAUTHORIZED",
  "message": "API kimlik bilgileri doğrulanamadı."
}

{
  "status": false,
  "message": "Ürün, IP, modül izni veya kaynak kapsamı uygun değil."
}

{
  "status": false
}

{
  "status": false,
  "code": "RECORD_CHANGED",
  "message": "İlişki, bakiye, kur, sürüm veya işlem kilidi çakışması. İlgili kaydı ve işlem durumunu okuyun."
}

{
  "status": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "status": false,
  "message": "Üzgünüz, bir hata oluştu."
}

Ne yapar?

Desteklenen para birimlerini, birimleri ve hesaplama kurallarını döndürür. KDV yüzdesini uygulamanız belirler; bu cevap işlemin vergi mevzuatına uygunluğunu doğrulamaz. Ödeme/kasa izni varsa aktif nakit/banka hesaplarının güvenli listesi sayfalı döner; diğer izinlerde hesap listesi boştur.

Ön koşullar ve izin

contacts, cash, transactions veya payments modüllerinden en az birinde açık read ya da write izni gerekir. Ödeme hesabı listesi yalnız cash veya payments izniyle döner. Kimlik ve izinler · Muhasebe veri kuralları

İstek örnekleri

Kimlikleri kendi kayıtlarınızla değiştirin. Yazmada iş niyetine özel anahtarı istekten önce saklayın; örnek anahtarını farklı işler için yeniden kullanmayın. Alan ve cevap tanımları bu sayfanın API referansında yer alır.

curl --request GET 'https://api.muhasip.pro/accounting/options?page=1&limit=25' \
  --user "$MUHASIP_API_USER_ID:$MUHASIP_API_SECRET" \
  --header 'Accept: application/json'

<?php
$apiUserId = getenv("MUHASIP_API_USER_ID");
$secret = getenv("MUHASIP_API_SECRET");
if (!$apiUserId || !$secret) {
    throw new RuntimeException("API kimlik bilgileri eksik.");
}
$curl = curl_init("https://api.muhasip.pro/accounting/options?page=1&limit=25");
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => $apiUserId . ":" . $secret,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        "Accept: application/json"
    ]
]);
$response = curl_exec($curl);
$httpStatus = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($response === false) {
    curl_close($curl);
    throw new RuntimeException("Bağlantı sonucu belirsiz; yazma işlemini yeniden göndermeden durumunu kontrol edin.");
}
curl_close($curl);
$result = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
echo json_encode(["httpStatus" => $httpStatus, "response" => $result], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);

async function main() {
  const apiUserId = process.env.MUHASIP_API_USER_ID
  const secret = process.env.MUHASIP_API_SECRET
  if (!apiUserId || !secret) throw new Error("API kimlik bilgileri eksik.")
  const authorization = Buffer.from(`${apiUserId}:${secret}`, "utf8").toString("base64")
  const response = await fetch("https://api.muhasip.pro/accounting/options?page=1&limit=25", {
    method: "GET",
    headers: {
      Authorization: `Basic ${authorization}`,
      Accept: "application/json"
    },
    signal: AbortSignal.timeout(30000)
  })
  const result = await response.json()
  console.log({ httpStatus: response.status, response: result })
}
main().catch(() => {
  console.error("İstek tamamlanamadı; yazma sonucunu kontrol etmeden yeniden göndermeyin.")
  process.exitCode = 1
})

Cevabı değerlendirin

Aşağıdaki cevap temsilîdir. Birim kataloğu örnekte kısaltılmıştır.

{
  "status": true,
  "result": {
    "currencies": [
      "TRY",
      "USD",
      "EUR",
      "GBP",
      "CHF",
      "CAD",
      "AUD",
      "JPY",
      "CNY",
      "AED",
      "SAR",
      "RUB",
      "DKK",
      "NOK",
      "SEK"
    ],
    "units": [
      {
        "code": "C62",
        "description": "Adet"
      },
      {
        "code": "PR",
        "description": "Çift"
      }
    ],
    "taxes": [
      {
        "code": "0015",
        "name": "KDV",
        "minPercent": 0,
        "maxPercent": 100,
        "precision": 4
      }
    ],
    "withholding": {
      "minPercent": 0,
      "maxPercent": 100,
      "precision": 4,
      "basis": "vat"
    },
    "paymentAccounts": {
      "items": [
        {
          "id": "507f1f77bcf86cd799439012",
          "name": "Merkez kasa",
          "code": "K-001",
          "type": "cash",
          "currencyCode": "TRY"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 25,
        "total": 1,
        "totalPages": 1
      }
    }
  }
}

page 1 tabanlıdır; varsayılan limit=25, üst sınır 100’dür. pagination.total filtrelenmiş kayıt sayısıdır. Eşzamanlı ekleme/düzeltmeler sayfalar arasında sonuçları değiştirebilir.

Hata durumunda

HTTP / kod	İzlenecek adım
`400 INVALID_REQUEST`	Alanları, tarihi, ondalık hassasiyeti ve desteklenmeyen alanları kontrol edin.
`401` / `403`	Kimlik, IP ve açık modül iznini doğrulayın.
`404 RESOURCE_NOT_FOUND`	Kaynağın ve bağlı kimliklerin doğru olduğunu, bu kaynak türünde kullanılabildiğini kontrol edin.

Hata yönetimi · İşlem takibi

Sonraki adım

Muhasebe veri kurallarını uygulayın.

Yetkilendirmeler

Authorization

string

header

gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Sorgu Parametreleri

page

integer

varsayılan:1

1 tabanlı sayfa.

Gerekli aralık: 1 <= x <= 100000

limit

integer

varsayılan:25

Sayfa başına kayıt.

Gerekli aralık: 1 <= x <= 100

string

Ödeme hesabı adında arama.

Required string length: 1 - 100

currencyCode

enum<string>

Ödeme hesapları para birimi filtresi. İşlem para birimi. Uygulama tutar hassasiyeti bütün bu birimlerde 2 basamaktır.

Mevcut seçenekler:

TRY,

USD,

EUR,

GBP,

CHF,

CAD,

AUD,

JPY,

CNY,

AED,

SAR,

RUB,

DKK,

NOK,

SEK

Yanıt

Kayıt veya hesaplama sonucu.

status

enum<boolean>

gerekli

Mevcut seçenekler:

true

result

object

gerekli

Show child attributes

Servis ve uygulamalar

Cari hesaplar

Kasa ve transferler

Alış-satış (e-belgesiz)

Ödemeler ve mahsuplaşma