Sözleşme

Sözleşme CRUD işlemleri, durum yönetimi ve imzalama.

GET /api/v1/sozlesme

Sözleşme Listesi

Sözleşmeleri sayfalanmış olarak listeler. Durum, tip ve tarih filtresi destekler.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`page`	integer	Opsiyonel	Sayfa numarası (varsayılan: 1)
`per_page`	integer	Opsiyonel	Sayfa başı kayıt (varsayılan: 25, maks: 100)
`durum`	integer	Opsiyonel	Durum filtresi (1=Taslak, 2=Onay Bekliyor, 3=Aktif, 4=Askıda, 5=Süresi Dolmuş, 6=Yenilendi, 7=Feshedildi, 8=İptal)
`tip_id`	integer	Opsiyonel	Sözleşme tipi (1=Satış, 2=Alış, 3=Hizmet, 4=Kiralama, ...)
`cari_id`	integer	Opsiyonel	Cari kart ID

Response 200

{
    "success": true,
    "data": [
        {
            "sz_id": 1,
            "sz_no": "SZ-2026-001",
            "sz_baslik": "Annual Maintenance Contract",
            "sz_durum": 3,
            "sz_tutar": 50000,
            "sz_baslangic_tarih": "2026-01-01",
            "sz_bitis_tarih": "2026-12-31",
            "sz_imza_durumu": 2
        }
    ],
    "meta": {
        "current_page": 1,
        "total": 24
    }
}

GET /api/v1/sozlesme/{id}

Sözleşme Detay

Sözleşme detayını taraflar, maddeler ve ödeme planı dahil döner.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`id`	integer	Zorunlu	Sözleşme ID

Response 200

{
    "success": true,
    "data": {
        "sz_id": 1,
        "sz_no": "SZ-2026-001",
        "sz_baslik": "Annual Maintenance Contract",
        "sz_durum": 3,
        "sz_tutar": 50000,
        "taraflar": [
            {
                "st_unvan": "ABC Ltd.",
                "st_rol": "buyer"
            }
        ],
        "maddeler": [
            {
                "sm_sira": 1,
                "sm_baslik": "Scope",
                "sm_icerik": "..."
            }
        ],
        "odeme_plani": [
            {
                "sop_tutar": 12500,
                "sop_vade": "2026-04-01"
            }
        ]
    }
}

POST /api/v1/sozlesme

Sözleşme Oluştur

Yeni sözleşme oluşturur.

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`sz_baslik`	string	Zorunlu	Sözleşme başlığı
`sz_tip_id`	integer	Zorunlu	Sözleşme tipi (1=Satış, 2=Alış, 3=Hizmet, 4=Kiralama, ...)
`sz_cari_id`	integer	Zorunlu	Cari kart ID
`sz_baslangic_tarih`	date	Zorunlu	Başlangıç tarihi (YYYY-MM-DD)
`sz_bitis_tarih`	date	Opsiyonel	Bitiş tarihi (YYYY-MM-DD)
`sz_tutar`	decimal	Opsiyonel	Sözleşme tutarı

Request Body

{
    "sz_baslik": "Annual Support Contract",
    "sz_tip_id": 3,
    "sz_cari_id": 1,
    "sz_baslangic_tarih": "2026-03-01",
    "sz_bitis_tarih": "2027-02-28",
    "sz_tutar": 36000
}

Response 201

{
    "success": true,
    "data": {
        "sz_id": 25,
        "sz_no": "SZ-2026-025"
    },
    "message": "Contract created."
}

PATCH /api/v1/sozlesme/{id}/durum

Durum Güncelle

Sözleşme durumunu günceller (aktifleştir, askıya al, feshet vb.).

Kimlik doğrulama gerektirir

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`id`	integer	Zorunlu	Sözleşme ID
`durum`	integer	Zorunlu	Yeni durum kodu

Request Body

{
    "durum": 3
}

Response 200

{
    "success": true,
    "message": "Contract status updated."
}

cURL Örneği

GET /api/v1/sozlesme

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