MaxiFilo REST API

Araç marka listesi. MARKA tablosundan.

Markaya göre model listesi. marka_id query parametresi zorunlu. Yanıt: id, name, marka_id, tsrb_kodu (araç create/update'te aynen gönderilir).

Araç segment listesi.

Model yılı listesi. Yanıt: id, name, model_yili

Web popup_katalog_iscilik.php ile aynı liste. Token cari_id + genel kayıtlar (CARI_ID null/0/-1).

Opsiyonel: q veya arama (kod/ad arama). Yanıt: id, kod, ad, grup, fiyat

Token cari kapsamındaki tek dosyanın özet detayını döner. Tam detay için GET /v1/dosya/detay/{id} kullanın.

Yanıt: id, kod, dosya_no, surec_id, arac, servis, servis_bolum, surucu, talep, teslim tarihleri, ikame_talebi, cekici_talebi, arac_serviste

Yeni servis talebi oluşturur. plaka ile token cari_id kapsamında ARAC kaydı aranır; bulunamazsa talep oluşturulmaz. servis_vkn zorunludur — ilgili cari aranır (yoksa Servis bulunamadı). bakim_periyot opsiyonel / null geçilebilir. Web talepKaydet ile aynı: açık plaka kontrolü, KM geçmişi, audit log, dosya sorumlusu atama, ikame talebi (ikame_talebi=1) ve randevu güncelleme dahil. E-posta gönderilmez.

HTTP 201 — oluşturulan talep detayı döner.

{
  "servis_bolum": "BAKIM",
  "servis_vkn": "0000000000",
  "plaka": "34ABC123",
  "talep": "Motor sesi geliyor.",
  "km": "194452.85",
  "tahmini_teslim_tarih": "2026-07-10",
  "ikame_talebi": 0
}

Mevcut talebi günceller. kod alanı zorunludur (detay yanıtındaki kod değeri). servis_vkn gönderilirse ilgili cari aranır (yoksa Servis bulunamadı); gönderilmezse mevcut servis korunur. Plaka değişirse araç bilgileri yine ARAC tablosundan alınır. Teslim edilmiş talepler (surec_id >= 10) güncellenemez.

{
  "kod": "abc123...",
  "servis_bolum": "BAKIM",
  "servis_vkn": "0000000000",
  "plaka": "34ABC123",
  "talep": "Güncellenmiş açıklama."
}

POST — Yeni evrak yükler. Payload'daki shared_system_id TALEP_RESIM.SYSTEM_SHARED_ID olarak kaydedilir. Aynı shared_system_id bu talepte varsa dosya içeri alınmaz (durum: zaten_mevcut). Yeni kayıt için HTTP 201; yalnızca mevcut kayıtlar varsa HTTP 200.

DELETE — Gönderilen ID'leri siler (DB + disk). Body: evrak_ids dizisi.

{
  "dosyalar": [
    {
      "shared_system_id": "15",
      "evrak_tipi_id": 11,
      "dosya_adi": "ruhsat.pdf",
      "base64": "JVBERi0xLj..."
    }
  ]
}

Yanıt: durum, mesaj, islenen_dosyalar[] (shared_system_id, evrak_tipi_id, dosya_adi, uzanti, durum: kabul_edildi / zaten_mevcut / reddedildi)

{
  "durum": "basarili",
  "mesaj": "Payload başarıyla alındı ve işleniyor.",
  "islenen_dosyalar": [
    {
      "shared_system_id": "15",
      "evrak_tipi_id": 11,
      "dosya_adi": "ruhsat.pdf",
      "uzanti": "pdf",
      "durum": "kabul_edildi"
    }
  ]
}

DELETE body örneği:

{
  "evrak_ids": [692, 693]
}

POST — Yeni fotoğraf yükler. Evrak ile aynı: shared_system_id zorunlu, aynı ID tekrar gelirse içeri alınmaz. TALEP.RESIM_VAR = 1 güncellenir. Yeni kayıt için HTTP 201.

DELETE — Gönderilen ID'leri siler (DB + disk). Body: resim_ids dizisi.

{
  "dosyalar": [
    {
      "shared_system_id": "15",
      "resim_tipi_id": 2,
      "dosya_adi": "on_taraf.png",
      "base64": "iVBORw0KGgo..."
    }
  ]
}

Yanıt evrak ile aynı yapı: durum, mesaj, islenen_dosyalar[] (shared_system_id, resim_tipi_id, dosya_adi, uzanti, durum).

DELETE body örneği:

{
  "resim_ids": [690, 691]
}

GET /v1/talep/{id}/notlar — Talebe ait notları listeler. Her kayıtta Maxi id ve system_shared_id döner. system_shared_id Maxi not ID'sidir.

GET /v1/talep/{id}/notlar/{notId} — Tek not detayı.

POST /v1/talep/{id}/notlar — Yeni not kaydeder. Kayıt sonrası SYSTEM_SHARED_ID Maxi'nin kendi not ID'si olarak yazılır. HTTP 201.

PUT /v1/talep/{id}/notlar/{notId} — Not metnini günceller. system_shared_id boşsa Maxi ID yazılır.

Silme (DELETE) yok.

POST / PUT body:

{
  "talep_notu": "ZFS talep notu"
}

Yanıt öğesi: id (Maxi not ID), system_shared_id (Maxi not ID, string), talep_id, talep_notu, tarih, ekleyen

{
  "id": 987654,
  "system_shared_id": "987654",
  "talep_id": 439,
  "talep_notu": "ZFS talep notu",
  "tarih": "2026-08-14 14:18",
  "ekleyen": "Sistem"
}

GET — Parça (PARCA) ve işçilik (ISCILIK) satırları + özet tutarlar. Her satırda system_shared_id, onay_durumu, durum döner.

PUT — Onay güncelleme. Gönderilen satırlarda onay_durumu ve system_shared_id güncellenir (DURUM=1). onay_durumu=0 (onaysız) veya payload’da olmayan satırlar ONAY_DURUMU=3 (red) + DURUM=1 yapılır. Diğer kalem alanları (fiyat, kod vb.) gönderilebilir; şu an işlenmez. POST kaydet ve DELETE kapatılmıştır.

Gelen tüm aktif kalemler onay_durumu=1 ise ve dosyada bekleyen bir ONAY_SURECI (DURUM_ID=4) varsa basamaklar otomatik onaylanır, süreç tamamlanır ve dosya Tamire Başlandı yapılır. Herhangi bir kalem onaylı değilse onay sürecine dokunulmaz.

Zorunlu (her satır): id, system_shared_id, onay_durumu. Opsiyonel: quote_id + diğer kalem alanları.

onay_durumu: 0=Onaysız, 1=Onay tamamlandı, 2=Onay bekliyor, 3=Red.

{
  "quote_id": 12345,
  "parcalar": [{
    "id": 696,
    "system_shared_id": "1500",
    "parca_kodu": "OEM001",
    "alt_parca_kodu": "ALT001-GUN",
    "parca_adi": "Kaput",
    "marka": "Orijinal",
    "adet": 1,
    "orjinal_fiyat": 1300,
    "tedarik_fiyati": 1100,
    "iskonto": 10,
    "kdv": 20,
    "tedarikci": 1,
    "onay_durumu": 1
  }],
  "iscilikler": [{
    "id": 697,
    "system_shared_id": "2681",
    "iscilik_kodu": "IS001",
    "iscilik_adi": "Boya",
    "adet": 1,
    "servis_fiyat": 450,
    "filo_fiyat": 550,
    "iskonto": 5,
    "kdv": 20,
    "katalog_iscilik_id": 1502,
    "onay_durumu": 1
  }]
}

Manuel süreç ilerletme — web TalepSurec.php ile aynı kurallar. Zorunlu body: kod. surec_alt için ek: surec_alt_id.

islem değerleri:

• arac_serviste — KM + tahmini teslim tarihi zorunlu
• yedek_parca_bekliyor, yedek_parca_tamamlandi
• surec_alt, arac_musteriye_verildi, arac_servise_tekrar_alindi

POST /v1/talep/439/surec/arac_serviste
{ "kod": "..." }

Talep fatura işlemleri — web TalepFatura.php ile aynı kurallar. Teslim şartı: surec_id >= 10. Mevcut CARI_HAREKET (HAREKET_ID=1) teslimde oluşmuş olmalıdır.

GET — Fatura bilgisi, cari hareketler, detay satırları ve ekspertiz özet tutarları.

POST — İlk fatura kaydı. Zorunlu body: kod, fatura_no (16 hane), fatura_tarih (YYYY-MM-DD veya DD.MM.YYYY). Opsiyonel: fatura_aciklama. Tutar ve KDV teslimde oluşmuş CARI_HAREKET / ekspertiz özetinden otomatik alınır (web modalındaki readonly alanlar gibi).

PUT — Mevcut faturayı güncelle: kod, fatura_no, fatura_tarih, fatura_aciklama. Kontrol edilmiş fatura düzenlenemez.

POST /v1/talep/{id}/fatura/ekspertizden-yeniden-olustur — CARI_HAREKET sil/yeniden oluştur (PARCA + ISCILIK). Body: kod.

Fatura belgesi (PDF/resim) — web popup_cari_hareket_resim_yukle. Teslim + fatura kaydı sonrası. Disk: img/maxifleet/cari_hareket/{yıl}/{cari_hareket_id}/

• GET /v1/talep/{id}/fatura/belgeler — Belge listesi + base64. Query: cari_hareket_id (opsiyonel)
• POST /v1/talep/{id}/fatura/belgeler — Yükle. Body: kod, dosyalar[] (dosya_adi, base64). jpg/png/pdf vb.
• DELETE /v1/talep/{id}/fatura/belgeler — Body: kod, belge_ids[]
• GET /v1/dosya/faturalar/{talepNo} — Dosya bazlı fatura + ekler (base64)

POST /v1/talep/439/fatura
{
  "kod": "...",
  "fatura_no": "ABC1234567890123",
  "fatura_tarih": "2026-06-28",
  "fatura_aciklama": ""
}

Fatura kontrol / onay — web onay-islemleri/dosya-fatura ve FaturaKontrol.php. Token cari_id kapsamındaki, henüz kontrol edilmemiş (KONTROL_EDILDI = 0) cari hareket faturaları.

GET /v1/fatura-kontrol — Onay bekleyen liste. Sayfalama: page, page_size (varsayılan 50).

Query filtreleri: islem_no, talep_no, plaka, fatura_no, servis_id, finans_kalemi_id, kayit_tarih_baslangic / kayit_tarih_bitis, fatura_tarih_baslangic / fatura_tarih_bitis (YYYY-MM-DD).

POST /v1/fatura-kontrol/{id}/onayla — Faturayı kontrol edildi işaretle. {id} = CARI_HAREKET.ID (işlem no). Body gerekmez. kullanici_id JWT'den alınır.

GET /v1/fatura-kontrol?page=1&page_size=50&plaka=34MDK4983

POST /v1/fatura-kontrol/273/onayla

Tek araç detayını getirir. Araç token cari kapsamında değilse 404 döner.

Zorunlu alanlar: plaka, tsrb_kodu, model_yili, motor_no, sasi_no, durum, segment_id, yakit_sort_code, vites_id, son_km. tsrb_kodu = modeller tanımındaki değer (aynen). segment_id varsayılanı -3 (belirtilmemiş). Yakıt eşleştirmesi yakit_sort_code ile yapılır; NONE = belirtilmemiş. Ruhsat sahibi token cari_id'den otomatik doldurulur.

{
  "plaka": "34ABC123",
  "tsrb_kodu": "0031007",
  "model_yili": 2022,
  "motor_no": "CAX123456",
  "sasi_no": "WVWZZZ1KZAW123456",
  "durum": 1,
  "segment_id": -3,
  "yakit_sort_code": "D",
  "vites_id": 1,
  "son_km": 45000
}

Mevcut aracı günceller. Gönderilen alanlar güncellenir; gönderilmeyenler korunur. segment_id: -3 = belirtilmemiş (geçerli).

{
  "tsrb_kodu": "0031007",
  "son_km": 48000,
  "durum": 1,
  "segment_id": -3
}