Alış-satış belgelerini listele

{
  "status": true,
  "result": {
    "items": [
      {
        "id": "507f1f77bcf86cd799439014",
        "version": 0,
        "contactId": "507f1f77bcf86cd799439011",
        "direction": "sale",
        "issueDate": "2026-10-19",
        "dueDate": "2026-10-19",
        "currencyCode": "TRY",
        "exchangeRate": 1,
        "description": "",
        "receiptNumber": "SATIS-ORNEK-001",
        "notes": [],
        "lines": [
          {
            "name": "Danışmanlık hizmeti",
            "description": "",
            "quantity": 2,
            "unitCode": "C62",
            "unitPrice": 100,
            "grossAmount": 200,
            "discountAmount": 0,
            "vatRate": 20,
            "vatAmount": 40,
            "withholdingPercent": 0,
            "withheldVatAmount": 0,
            "lineTotal": 240
          }
        ],
        "totals": {
          "grossAmount": 200,
          "lineDiscountAmount": 0,
          "documentDiscountAmount": 0,
          "discountAmount": 0,
          "taxes": [
            {
              "code": "0015",
              "rate": 20,
              "amount": 40
            }
          ],
          "withheldVatAmount": 0,
          "payableAmount": 240
        },
        "baseCurrencyCode": "TRY",
        "payableBaseAmount": 240,
        "paidBaseAmount": 0,
        "remainingBaseAmount": 240,
        "overpaidBaseAmount": 0,
        "isClosed": false,
        "tracksStock": false,
        "createdAt": "2026-10-19T09:00:00.000Z"
      }
    ],
    "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

invoices

{
  "status": true,
  "result": {
    "items": [
      {
        "id": "507f1f77bcf86cd799439014",
        "version": 0,
        "contactId": "507f1f77bcf86cd799439011",
        "direction": "sale",
        "issueDate": "2026-10-19",
        "dueDate": "2026-10-19",
        "currencyCode": "TRY",
        "exchangeRate": 1,
        "description": "",
        "receiptNumber": "SATIS-ORNEK-001",
        "notes": [],
        "lines": [
          {
            "name": "Danışmanlık hizmeti",
            "description": "",
            "quantity": 2,
            "unitCode": "C62",
            "unitPrice": 100,
            "grossAmount": 200,
            "discountAmount": 0,
            "vatRate": 20,
            "vatAmount": 40,
            "withholdingPercent": 0,
            "withheldVatAmount": 0,
            "lineTotal": 240
          }
        ],
        "totals": {
          "grossAmount": 200,
          "lineDiscountAmount": 0,
          "documentDiscountAmount": 0,
          "discountAmount": 0,
          "taxes": [
            {
              "code": "0015",
              "rate": 20,
              "amount": 40
            }
          ],
          "withheldVatAmount": 0,
          "payableAmount": 240
        },
        "baseCurrencyCode": "TRY",
        "payableBaseAmount": 240,
        "paidBaseAmount": 0,
        "remainingBaseAmount": 240,
        "overpaidBaseAmount": 0,
        "isClosed": false,
        "tracksStock": false,
        "createdAt": "2026-10-19T09:00:00.000Z"
      }
    ],
    "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?

E-belgesiz alış-satış kayıtlarını listeler. Tarih aralığı belge tarihine uygulanır. Mali belge çıktısı, e-belge, teklif, fiş veya farklı uygulama kaydı bu kaynakla değiştirilmez.

Ön koşullar ve izin

Gereken izin: muhasip:transactions:read. Bu kaynak için açık izin tanımlanmalıdır; genel erişim veya yönetici yetkisi bu iznin yerine geçmez. İlişkili bütün kimlikler aynı firma kapsamında olmalıdır. 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/invoices?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/invoices?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/invoices?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.

{
  "status": true,
  "result": {
    "items": [
      {
        "id": "507f1f77bcf86cd799439014",
        "version": 0,
        "contactId": "507f1f77bcf86cd799439011",
        "direction": "sale",
        "issueDate": "2026-10-19",
        "dueDate": "2026-10-19",
        "currencyCode": "TRY",
        "exchangeRate": 1,
        "description": "",
        "receiptNumber": "SATIS-ORNEK-001",
        "notes": [],
        "lines": [
          {
            "name": "Danışmanlık hizmeti",
            "description": "",
            "quantity": 2,
            "unitCode": "C62",
            "unitPrice": 100,
            "grossAmount": 200,
            "discountAmount": 0,
            "vatRate": 20,
            "vatAmount": 40,
            "withholdingPercent": 0,
            "withheldVatAmount": 0,
            "lineTotal": 240
          }
        ],
        "totals": {
          "grossAmount": 200,
          "lineDiscountAmount": 0,
          "documentDiscountAmount": 0,
          "discountAmount": 0,
          "taxes": [
            {
              "code": "0015",
              "rate": 20,
              "amount": 40
            }
          ],
          "withheldVatAmount": 0,
          "payableAmount": 240
        },
        "baseCurrencyCode": "TRY",
        "payableBaseAmount": 240,
        "paidBaseAmount": 0,
        "remainingBaseAmount": 240,
        "overpaidBaseAmount": 0,
        "isClosed": false,
        "tracksStock": false,
        "createdAt": "2026-10-19T09:00:00.000Z"
      }
    ],
    "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

Belgeden tahsilata ilerleyin. Dönen kimlikleri ve version değerini saklayın; mali yazma sonrasında ilgili belge ve cari bakiyesini okuyun.

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

currencyCode

enum<string>

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

contactId

string

Cari filtresi. 24 karakterli kayıt kimliği.

Pattern: ^[a-f0-9A-F]{24}$

direction

enum<string>

İşlem yönü.

Mevcut seçenekler:

sale,

purchase

string

Belge referansında arama.

Required string length: 1 - 100

from

string<date>

Başlangıç günü dahil. YYYY-MM-DD; 1900-01-01–2199-12-31. Saat gönderilmez.

string<date>

Bitiş günü dahil. YYYY-MM-DD; 1900-01-01–2199-12-31. Saat gönderilmez.

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

Muhasebe seçenekleri

Fatura ve e-belge

Banka hesapları ve hareketleri

Banka otomasyonları

İş akışları ve alanlar

POS ve tahsilat

E-Pos

GİB e-Arşiv

Pazaryeri

Online işlemler

Proje ve görevler

Ajanda

Takvim

Mali işlem durumu

Alış-satış belgelerini listele

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım

Yetkilendirmeler

Sorgu Parametreleri

Yanıt

​Ne yapar?

​Ön koşullar ve izin

​İstek örnekleri

​Cevabı değerlendirin

​Hata durumunda

​Sonraki adım

Yetkilendirmeler

Sorgu Parametreleri

Yanıt

Ne yapar?

Ön koşullar ve izin

İstek örnekleri

Cevabı değerlendirin

Hata durumunda

Sonraki adım