Fatura

Alış ve satış fatura işlemleri.

GET /api/v1/fatura

Fatura Listesi

Faturaları listeler.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`tip`	string	Opsiyonel	Fatura tipi (satis, alis)
`tarih_baslangic`	date	Opsiyonel	Başlangıç tarihi
`tarih_bitis`	date	Opsiyonel	Bitiş tarihi
`cari_id`	integer	Opsiyonel	Cari kart ID filtresi

Response 200

{
    "success": true,
    "data": [
        {
            "ft_id": 1,
            "ft_faturaNo": "FTR-2026-001",
            "ft_cariUnvani": "ABC Teknoloji Ltd.",
            "ft_genelToplam": 12500,
            "ft_tarih": "2026-02-20",
            "ft_tip": "satis"
        }
    ]
}

POST /api/v1/fatura

Fatura Oluştur

Yeni fatura oluşturur. Stok hareketleri ve cari hareketler otomatik oluşturulur.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`ft_senaryoTuru`	string	Zorunlu	Senaryo türü (SATIS, ALIS)
`ft_cariId`	integer	Zorunlu	Cari kart ID
`ft_tarih`	date	Zorunlu	Fatura tarihi (YYYY-MM-DD)
`kalemler`	array	Zorunlu	Fatura kalemleri dizisi

Request Body

{
    "ft_senaryoTuru": "SATIS",
    "ft_cariId": 1,
    "ft_tarih": "2026-02-22",
    "kalemler": [
        {
            "stok_id": 1,
            "miktar": 5,
            "birim_fiyat": 250,
            "kdv_oran": 20
        }
    ]
}

Response 201

{
    "success": true,
    "data": {
        "ft_id": 45,
        "ft_faturaNo": "FTR-2026-045",
        "ft_genelToplam": 1500
    },
    "message": "Fatura başarıyla oluşturuldu."
}

cURL Örneği

GET /api/v1/fatura

curl -X GET https://api.pratikesnaf.com/api/v1/fatura \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"