Patron API System

İhracat Takip Sistemi Backend Servis Dokümantasyonu v1.0

https://patron.kodfabrikasi.net/AllServices/Services.php?do={SERVICE_NAME}

🔐 Kimlik Doğrulama (Auth)

login POST

Kullanıcı girişi yapar ve oturum için gerekli token bilgisini döner.

Parametreler
  • email Kullanıcı e-posta adresi
  • password Kullanıcı şifresi

register KAMU POST

Uygulama dışından yeni bir Yönetici (Admin) başvurusu oluşturur.

Parametreler
  • name Yönetici adı ve soyadı
  • email Yönetici iletişim e-postası
  • password Yönetici şifresi

addUser ÖZEL POST

Yönetici paneli içerisinden ekibe yeni bir üye (İhracatçı, Operasyon, Finans) ekler.

Parametreler
  • token Yönetici oturum anahtarı
  • name Yeni üye adı
  • email Yeni üye e-posta
  • password Yeni üye şifresi
  • role admin | exporter | operation | finance

👥 Müşteri Yönetimi

getCustomers POST

Sorumlu olduğunuz müşterileri listeler. Filtreleme rolünüze göre otomatik yapılır.

Parametreler
  • token Oturum anahtarı

saveCustomer POST

Müşteri kaydını oluşturur veya günceller.

Parametreler
  • token Oturum anahtarı
  • id Güncelleme için ID (Yeni kayıt için 0)
  • company_name Firma resmi adı
  • country_id Ülke ID
  • currency USD | EUR
  • payment_term_days Vade gün sayısı
  • exporter_id Sorumlu ihracatçı kullanıcı ID
  • operation_id Sorumlu operasyoncu kullanıcı ID

💵 Satış ve Tahsilat

getSales POST

Tüm satış kayıtlarını ve detaylarını listeler.

Parametreler
  • token Oturum anahtarı

saveSale POST

Yeni satış kaydeder. Vade tarihi boşsa müşteri vadesinden hesaplanır.

Parametreler
  • token Oturum anahtarı
  • customer_id Müşteri ID
  • sale_date Satış tarihi (YYYY-MM-DD)
  • country_id Ülke ID
  • amount Tutar
  • currency USD | EUR
  • due_date Ödeme vade tarihi (Opsiyonel)

saveCollection POST

Bir satışa ait tahsilat kaydı oluşturur. Bakiye kapanırsa satış durumu güncellenir.

Parametreler
  • token Finans veya Admin token
  • sale_id İlgili satış kaydı ID
  • amount Tahsil edilen miktar
  • date Tahsilat tarihi

📊 Dashboard ve Raporlar

getDashboard POST

Dashboard özet verileri, trendler ve gecikme segmentlerini döner.

Parametreler
  • token Oturum anahtarı

getReport POST

Özel rapor çıktılarını listeler.

Parametreler
  • token Oturum anahtarı
  • type overdue | country_sales | monthly_trend

🛠 Yardımcı Servisler

getCountries POST

Sistemdeki ülkeleri listeler. Müşteri ve satış eklerken ülke seçimi için kullanılır.

Parametreler
  • token Oturum anahtarı

getUsers POST

Sistemdeki kullanıcıları listeler. Özellikle müşteri atamaları için tercih edilir.

Parametreler
  • token Oturum anahtarı
  • role (Opsiyonel) exporter | operation vb.

deleteCustomer ADMIN POST

Müşteriyi pasife çeker ve arşivler.

Parametreler
  • token Yönetici anahtarı
  • id Müşteri ID

uploadFile MULTIPART POST

Satış kaydına evrak, PDF veya görsel yükler.

Parametreler
  • token Oturum anahtarı
  • sale_id İlgili satış ID
  • file Yüklenecek dosya