Giderler

Giderler kaynağı, şirketinizin gider pusulası kayıtlarını sunar. Oluşturma ve kesinleştirme için Gider pusulası işlemleri sayfasına bakın.

`GET /v1/expenses` — gider listesi

Örnek istek

curl 'https://api.sarraf.pro/v1/expenses?startDate=2026-09-01T00:00:00.000Z&pageSize=25' \
  -u 'apiUserId:secretKey'

Sorgu parametreleri

Ortak parametreler için Genel Bakış.

Parametre	Tür	Açıklama
`idNo`	string	Müşteri TCKN/VKN tam eşleşme
`serial` / `number`	string	Belge seri / numarası
`bankCode`	string	Banka kodu
`isCheck`	boolean	Mahsup/pusula durumu
`isExcel`	boolean	Excel ile yüklenenler
`formalized`	boolean	`true`: yalnız resmileşmiş (`printStamp` olan) kayıtlar
`startDate` / `endDate`	date-time	`transactionDate` aralığı
`updatedSince`	date-time	Artımlı senkronizasyon
`q`	string	Numerikse `idNo`, metinse ünvan araması
`documentMode`	string	`paper` veya `electronic`. Alanı olmayan eski kayıtlar `paper` kabul edilir
`eDocumentState`	string	Elektronik gönderim durumu; değerler E-gider pusulası sayfasındadır
`eDocumentNumber`	string	Resmi e-gider numarası tam eşleşme

Sıralama whitelist’i: transactionDate, createdAt, updatedAt, amount. Varsayılan transactionDate:asc.

Cevap alanları (liste öğesi)

id, stamp, serial, number, transactionDate, amount, exchanges, quantity, unitName, attribute (mahiyet), idNo, nameSurname, bankName, bankCode, isCheck, isExcel, printStamp, printDate, createdDate, updatedAt documentMode belge türünü gösterir. Kağıt kayıtlarda eDocument: null döner. Elektronik kayıtlarda eDocument resmi numara, UUID, ortam, gönderim kabulü, yerel kesinleştirme ve sağlayıcı/GİB rapor durumunu taşır. Gönderim ve dosya işlemleri için E-gider pusulası sayfasına bakın.

Cevap — `200`

{
  "success": true,
  "data": [
    {
      "id": "6aae79498d76c7a5471ede43",
      "documentMode": "paper",
      "eDocument": null,
      "serial": "C",
      "number": "160998",
      "transactionDate": "2026-09-19T11:58:00.000Z",
      "amount": 18730,
      "exchanges": 6848.41,
      "quantity": 2.5,
      "unitName": "GRM",
      "attribute": "GRAM SAF ALTIN",
      "idNo": "1976926558",
      "nameSurname": "ÖRNEK SATICI",
      "bankName": "ÖRNEK BANKASI",
      "bankCode": "0012",
      "isCheck": true,
      "isExcel": false,
      "printDate": "2026-09-19T12:00:15.878Z",
      "createdDate": "2026-09-19T11:59:00.000Z",
      "updatedAt": "2026-09-19T12:00:15.878Z"
    }
  ],
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z",
    "page": 1,
    "limit": 25,
    "total": 114,
    "pages": 5
  }
}

`GET /v1/expenses/{id}` — gider detayı

Liste alanlarına ek olarak:

Alan	Anlam
`description`, `address`	Açıklama ve adres
`customerInfo`	Müşteri bilgi bloğu
`lines[]`	Kalem satırları: `quantity`, `attribute`, `unitName`, `price`, `amount`, `description`, `stockCode`, `stamp`, `bankCode`
`invoiceNo`	Takas ise ilgili fatura numaraları
`isSwap`, `vSchema`, `currentCode`	Takas ve şema bilgileri
`bankTransactionId`	İlgili banka hareketi — Banka hareketi detayı ile çapraz sorgulanabilir

Gider pusulası oluşturma, kesinleştirme ve taslak iptali için Gider pusulası işlemleri sayfasına bakın. API üzerinden oluşturulan pusulalar da bu uçlarda görünür.

Örnek istek

curl 'https://api.sarraf.pro/v1/expenses/6aae79498d76c7a5471ede43' \
  -u 'apiUserId:secretKey'

Cevap — `200`

{
  "success": true,
  "data": {
    "id": "6aae79498d76c7a5471ede43",
    "documentMode": "paper",
    "eDocument": null,
    "serial": "C",
    "number": "160998",
    "transactionDate": "2026-09-19T11:58:00.000Z",
    "amount": 18730,
    "exchanges": 6848.41,
    "quantity": 2.5,
    "unitName": "GRM",
    "attribute": "GRAM SAF ALTIN",
    "idNo": "1976926558",
    "nameSurname": "ÖRNEK SATICI",
    "printDate": "2026-09-19T12:00:15.878Z",
    "description": "ALTIN ALIMI",
    "customerInfo": {
      "TaxNumber": "1976926558",
      "Name": "ÖRNEK SATICI",
      "City": "İSTANBUL",
      "Country": "TÜRKİYE"
    },
    "currentCode": null,
    "bankTransactionId": "6aae791c1ae24632118287e3",
    "lines": [
      {
        "quantity": 2.5,
        "attribute": "GRAM SAF ALTIN",
        "unitName": "GRM",
        "price": 7492,
        "amount": 18730,
        "stockCode": "GRALTIN"
      }
    ]
  },
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z"
  }
}

Başlangıç

API'ye Giriş

Müşteriler

Banka

Faturalar

KMTS

Giderler

`GET /v1/expenses` — gider listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/expenses/{id}` — gider detayı

Örnek istek

Cevap — `200`

​GET /v1/expenses — gider listesi

​Örnek istek

​Sorgu parametreleri

​Cevap alanları (liste öğesi)

​Cevap — 200

​GET /v1/expenses/{id} — gider detayı

​Örnek istek

​Cevap — 200

`GET /v1/expenses` — gider listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/expenses/{id}` — gider detayı

Örnek istek

Cevap — `200`