Anlık Rapor Oluşturma ve İndirme

Rapor Oluşturma Talebinde Bulunma

Anlık olarak işlem ve ödeme raporu talebinde bulunabilirsiniz.

URL

POST/file-reporting/v1/report-demands

İstek Parametreleri

Rapor oluşturma talebi için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

startDate

String

zorunlu

Raporun başlangıç tarihi. Bu tarihten sonraki işlemler rapora dahil edilir. "2025-01-01T09:30:32" örneğindeki gibi yyyy-MM-ddTHH:MM:SS formatında olmalıdır.

endDate

String

zorunlu

Raporun bitiş tarihi. Bu tarihten önceki işlemler rapora dahil edilir. "2025-01-01T09:30:32" örneğindeki gibi yyyy-MM-ddTHH:MM:SS formatında olmalıdır.

reportType

ReportType

zorunlu

Rapor tipi.

Değerler:

TRANSACTION

PAYMENT

reportPeriod

ReportPeriod

zorunlu

Raporun hangi periyotlarda alınacağı bilgisi.

Değerler:

INSTANT

Webhook Ayarları Yapılması

Raporunuz oluşturulduğunda Craftgate servislerinden REPORT_CREATED webhook alacaksınız.

Üye İşyeri Paneli > Yönetim > Üye İşyeri Ayarları > Webhook Ayarları bölümünden REPORT_CREATED etkinleştirilmelidir.

Raporun İndirilmesi

Webhook bildirimi alındıktan sonra webhook ile gelen payloadId değeri reportId'ye karşılık gelmektedir. reportId bilgisiyle Craftgate servislerine gelip ilgili raporu CSV veya XLSX formatında indirebilirsiniz.

Webhook Bildirimi Örneği

{
    "eventType": "REPORT_CREATED",
    "eventTime": "2025-10-22T14:36:51.123456",
    "eventTimestamp": 1761133011,
    "status": "SUCCESS",
    "payloadId": "15",
    "payload": {
        "reportId": "15",
        "reportType": "TRANSACTION"
    }
}

Detaylı bilgi için bkz Webhook Bildirimleri

URL

GET/file-reporting/v1/reports/:reportId

İstek Parametreleri

Rapor indirmek için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

fileType

ReportFileType

zorunlu

Rapor için dosya tipi.

Değerler:

CSV

XLSX

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.