# empuno Ajan API'si ve CLI > Yönetim panelindeki her işlem bir komuttur. Kimlik: `Authorization: Bearer emp_live_…` (Ajan anahtarı). Katalog: https://empuno.com/api/company/v1/catalog ## Nedir? empuno **Ajan API'si** ve **`empuno` CLI**, yönetim panelinde yapabildiğiniz her işlemi — izin onayı, bordro, vardiya planı, ekipman zimmeti, PDKS, masraf, işe alım, evrak — yapay zekâ ajanlarınıza ve otomasyonlarınıza açar. İlke **panel = API**: her panel ekranı ve butonu, panelle birebir aynı doğrulama, iş kuralı ve yetki kontrolünden geçen bir **komuttur**. Şu an 426 komut (247 yazma işlemi), 28 modül. Panele yeni bir özellik geldiğinde komutu kendiliğinden eklenir; CLI güncellemesi gerekmez. ## Hızlı başlangıç (CLI) CLI npm'de `empuno` paketidir; tek dosyadır, bağımlılığı yoktur, Node.js 18 veya üstü yeterlidir. Kurmadan `npx empuno …` ile de çalışır. ```bash # 1) Kur (npm'siz ortamda: curl -fsSL https://empuno.com/cli/empuno.mjs -o ~/.local/bin/empuno && chmod +x ~/.local/bin/empuno) npm i -g empuno # 2) Giriş — anahtar: panel → Firma Ayarları → API → Yeni anahtar → Tür: Ajan echo "emp_live_…" | empuno login --key-stdin # 3) Keşfet empuno whoami # firma, kimin adına, kaç komut empuno commands izin # anahtar kelimeyle komut ara empuno describe leave-requests.reject # parametreler, alanlar, gereken yetki, hız sınırı empuno reference sgk_exit_codes # bir alanın geçerli değerleri # 4) Çalıştır empuno leave-requests.index --status pending empuno leave-requests.approve 123 empuno leave-requests.reject 124 --rejection_reason "Yoğun dönem" empuno employees.documents.store 45 --document_type is_sozlesmesi --file file=./sozlesme.pdf ``` Komut adı panel rotasının adıdır (`manager.` öneki olmadan). Yol parametreleri sırayla verilir; diğer `--alan değer` bayrakları okuma komutunda sorgu parametresi, yazma komutunda JSON gövdesi olur. `--alan @dosya` ya da `--file alan=dosya` multipart yükleme yapar. Çıktı her zaman JSON'dur; çıkış kodu 0 başarı, 1 API hatası, 2 kullanım hatası, 3 ağ hatası, 4 satır hatası (yalnız `--strict`: istek işlendi ama `data.failed > 0`). Sayı dönüşümü (CLI 1.5.0): değerler katalogdaki doğrulama kuralına göre çevrilir — kuralı `string`, `email`, `date`, `regex`, `digits` olan alanlar (TC, IBAN, telefon, sicil no) **metin** gider; kural bilinmiyorsa 10 ve daha uzun haneli tam sayılar metin kalır. `--no-coerce` dönüşümü tamamen kapatır (eski sürümde TC sayıya çevrilip "must be a string" hatası verebiliyordu). Ortam değişkenleri: `EMPUNO_API_KEY`, `EMPUNO_URL`, `EMPUNO_PROFILE`, `EMPUNO_NO_UPDATE_CHECK=1` (güncelleme uyarısını kapatır; açıkken aynı sürüm için günde bir kez basılır — bayrak: `--no-update-check`). Birden çok firma için `empuno login --profile acme` ve `--profile acme`. **Geçerli değerler:** bir alanın kabul ettiği değerleri tahmin etmeyin — `empuno reference` (ya da `GET /api/company/v1/reference/{ad}`; adsız çağrı tam listeyi verir): `sgk_exit_codes`, `employee_document_types`, `equipment_categories`, `currencies`, `ticket_kinds`, `departments`, `branches`, `leave_types`; bordro için `payroll_options`, `earning_types`, `deduction_types`, `payroll_period_statuses`, `payroll_parameters` (`--date` / `--year`), `payroll_declaration_fields`, `sgk_document_types`, `sgk_missing_day_reasons`, `muhsgk_payment_types`, `insurance_groups`, `incentive_codes`, `attendance_codes`, `hour_sources`, `work_schedules`; çalışma dönemleri için `sgk_workplaces`, `employment_kinds`, `sgk_workplace_zone_types`; hata kodları `agent_errors`. **Listeler:** okuma komutları `--per_page` (en fazla 100) ve `--page` alır; yanıttaki sayfalama bloğu toplamı verir. ## Ajanınıza verin Ajanınızın (Claude, ChatGPT, kendi ajanınız) talimatlarına şunu eklemeniz yeterli: ``` empuno İK sistemine `empuno` CLI ile erişimin var. - Önce `empuno commands ` ile komutu bul, `empuno describe ` ile yol parametrelerini, alanları ve kuralları öğren; sonra komutu çalıştır. - Çıktı JSON: okumada `data`, yazmada `ok` / `message` / `redirect.params` (yeni kaydın kimliği). - 422 → `errors` nesnesindeki alanları düzeltip tekrar dene. 403 → anahtarın yetkisi yetmiyor, kullanıcıya hangi yetkinin (`required_permission`) gerektiğini söyle; tekrar deneme. - Geri alınamaz işlemlerden (silme, bordro kesinleştirme/ödeme, işten çıkış) önce kullanıcıdan onay al. - Toplu ya da geri alınması zor bir yazmadan önce aynı komutu `--validate` ile dene (hiçbir şey kaydedilmez, gidecek e-posta/iş listelenir; HTTP'de `X-Empuno-Dry-Run: 1`). - Betikte her yazmaya iş anahtarından türetilmiş `--idempotency-key` ver (ör. avans--; TC gibi kişisel veri koyma); yanıtta `data.id` / `data.results` esastır. - 500 → işlem yapılmış olabilir: önce okuma komutuyla doğrula; aynı anahtarla tekrar göndermek işlemi yeniden yapmaz (409 idempotency_replay_unavailable), yapılmadıysa yeni anahtarla gönder. - Bordroyu doğrulamak için gerçek dönem açıp profil değiştirmek yerine `payroll.simulate` ve `payroll.calculate --dry_run 1` kullan (yan etkisiz); bir rakamın nedenini `payroll.employee-slip <çalışan> --explain 1` ile sor. Dönemleri id yerine YYYY-AA ile an; 409 ambiguous_period gelirse `candidates[]`'tan id seç. - Grup anahtarıyla çalışıyorsan HER komutta (okuma dahil) `--company ` ver; firmalar: `empuno companies`. Yanıttaki `meta.company_id` hangi firmada çalıştığını söyler — yazmadan önce doğrula. - Yapamadığın bir işlem, hata ya da geliştirme önerisi için empuno ekibine talep aç: `empuno tickets open "" --kind missing_command|bug|feature --body "…"`; yanıtları `empuno tickets --unread` ile kontrol et. - Belge: https://empuno.com/api-docs/agent.txt ``` ## Doğrudan HTTP ile CLI yalnızca kolaylıktır; her komut düz bir HTTPS isteğidir. Anahtar `Authorization: Bearer` (veya `X-API-Key`) başlığında gider; çerez, oturum veya CSRF jetonu gerekmez. ```bash # Komut kataloğu (yalnız bu anahtarın çağırabildikleri; ?all=1 hepsi) curl -H "Authorization: Bearer $EMPUNO_API_KEY" https://empuno.com/api/company/v1/catalog # Okuma komutu: leave-requests.index curl -H "Authorization: Bearer $EMPUNO_API_KEY" "https://empuno.com/manager/leave-requests?status=pending" # Yazma komutu: leave-requests.reject curl -X POST -H "Authorization: Bearer $EMPUNO_API_KEY" -H "Content-Type: application/json" \ -d '{"rejection_reason":"Yoğun dönem"}' https://empuno.com/manager/leave-requests/124/reject ``` Gövde JSON ya da (dosya varsa) `multipart/form-data` olabilir. Dosyalı bir güncellemeyi (PUT/PATCH) `POST` + `_method=PUT` alanıyla gönderin; multipart gövdede PUT/PATCH desteklenmez (CLI bunu kendisi yapar). `employees.update` (PUT ya da PATCH) ve `advance-payments.update` **yalnız gönderdiğiniz alanları** yazar; gönderilmeyen alan olduğu gibi kalır, bilerek gönderilen boş değer siler. Örn. yalnız giriş tarihi: `empuno employees.update 45 --hire_date 2019-04-01`. Diğer güncelleme komutlarında zorunlu alanlar için `empuno describe `. ## Güvenli yazma: deneme (dry_run) ve tekrar anahtarı **Deneme (dry_run):** her yazma komutu kaydetmeden denenebilir — `X-Empuno-Dry-Run: 1` başlığı, gövdede `dry_run: true` ya da CLI'da `--validate` (CLI 1.5.0 ve üstü). Komut panelle aynı doğrulama ve iş kurallarından geçer, sonra tüm değişiklikler geri alınır. Yanıt `dry_run: true`, "Deneme (kaydedilmedi): …" mesajı ve `dry_run_report` taşır; oluşacak kayıtların kimliği `null` döner. Okumalarda (GET) dry_run yok sayılır. | Kanal | Denemede ne olur? | | --- | --- | | Veritabanı | Değişiklik yapılır ve **geri alınır**. `dry_run_report.changes` tablo bazında sayılar verir: `inserts` satır sayısı, `updates` / `deletes` SQL ifadesi sayısı. | | E-posta, bildirim, push, kuyruk işi | **Gönderilmez, listelenir**: `side_effects.mail` (alıcı maskeli), `notifications`, `jobs`. Kayıttan sonra kuyruğa atılan işler (ör. onay push'u) da listede görünür. | | Dosya (belge, fotoğraf, PDF) | **Taklit edilir**: bellekte yazılır, kalıcı depoya gitmez; `side_effects.storage` listesinde görünür. | | Dış servis (AI, çeviri, üçüncü taraf API) | **Desteklenmez**: komut `422 dry_run_unsupported` döner (`blocked` hedefi gösterir), hiçbir şey kaydedilmez, AI kredisi harcanmaz. AI çağıran komutlar baştan reddedilir. | | Önbellek | Bu istek için geçici bir depo kullanılır; gerçek önbelleğe dokunulmaz. | | Hız sınırı | Gerçektir: denemeler de sayılır. | Hangi komutun denenebildiği katalogdadır (`empuno describe `, `GET /api/company/v1/catalog`): `dry_run` = `sandbox` (çalıştır + geri al), `native` (komut kendi önizlemesini döndürür; ör. `data-migration.*.commit`, `payroll-items.bulk` — satır bazlı `results[]` ve `null` kimliklerle) ya da `unsupported` (gerekçe `dry_run_note`). Denemeler işlem günlüğüne "Deneme" rozetiyle düşer. **Tekrar anahtarı (Idempotency-Key):** ağ kopması ya da betik hatasıyla aynı yazmanın iki kez yapılmasını önler. Yazma isteğine `Idempotency-Key: ` başlığı (ya da gövdede `client_request_id`; CLI'da `--idempotency-key`, CLI 1.5.0 ve üstü) ekleyin. Kurallar: - Aynı anahtar + aynı içerik, 24 saat içinde → işlem ikinci kez yapılmaz; ilk yanıt `"idempotent_replay": true` ve `Idempotent-Replayed: true` başlığıyla döner. - Aynı anahtar + FARKLI içerik → `422 idempotency_key_reused` (yeni işlem için yeni anahtar). - İlk istek hâlâ işleniyorsa → `409 idempotency_in_progress` + `Retry-After`; bekleyip AYNI anahtarla yeniden deneyin (yeni anahtarla değil). - Reddedilen istek (4xx: doğrulama, yetki, iş kuralı) anahtarı serbest bırakır: düzeltip aynı anahtarla tekrar gönderebilirsiniz. - **Bir anahtarla işlem en fazla bir kez yapılır.** Sonucu belirsiz istekler aynı anahtarla yeniden ÇALIŞTIRILMAZ, `409 idempotency_replay_unavailable` döner: önceki deneme sunucu hatasıyla bittiyse (`reason: previous_attempt_failed` — komut kaydı yazıp sonra hata vermiş olabilir), ilk istek kilit süresinde bitmediyse (`stale_lock`; sonradan biterse aynı anahtar kayıtlı yanıtı döndürür) ya da yanıt dosyaysa (`not_stored`; dosya içeriği saklanmaz). Bu durumda işlemin yapılıp yapılmadığını okuma komutuyla doğrulayın; yapılmadıysa YENİ anahtarla gönderin. - Anahtarlar API anahtarı başına ayrıdır; en fazla 120 karakter. Denemeler (dry_run) anahtarı tüketmez. - **Anahtara kişisel veri koymayın** (TC kimlik no, ad soyad, maaş): iş anahtarından türetin, ör. `avans--2026-12`. Sunucu anahtarı düz metin saklamaz (yalnız özeti), kayıtlı yanıt şifrelidir. - Panelden anahtar bazında "Her yazmada tekrar anahtarı zorunlu" açılabilir; açıkken anahtarsız yazma `400 idempotency_key_required` alır. - Talep ucu (`/api/company/v1/tickets`) bu katmanın dışındadır ve farklı çalışır: aynı `Idempotency-Key`li ya da aynı başlıklı açık bir talep (son 30 gün) varsa YENİ talep açılmaz, mevcut talep döner. Talep komutlarında `--validate` yoktur (CLI kullanım hatası verir). - CLI 1.5.0: `--idempotency-key auto` anahtarı içerikten üretir — bilerek tekrarlanan işlemlerde (profil değişince yeniden hesaplama, silip yeniden aktarma) **kullanmayın**, 24 saat boyunca eski yanıt döner. `--retry N` ağ hatası, 502/503/504 ya da `409 idempotency_in_progress` durumunda `Retry-After`'a uyarak (en çok 10 sn) aynı anahtarla yeniden dener; yazmada yalnız tekrar anahtarıyla çalışır, `500`'de yeniden denemez (sonuç belirsiz; okuma komutuyla doğrulayın). `empuno migrate` birden çok parçada anahtara `-1`, `-2` … ekler. ```bash # Önce dene: hiçbir şey kaydedilmez, gidecek e-posta/iş listelenir empuno advance-payments.store --employee_id 45 --amount 5000 --installment_count 2 --deduction_period 2026-12 --validate # Sonra gerçek yazma, iş anahtarıyla (tekrar çalışırsa ikinci kayıt oluşmaz) empuno advance-payments.store --employee_id 45 --amount 5000 --installment_count 2 --deduction_period 2026-12 \ --idempotency-key avans-0045-2026-12 --retry 3 # Toplu işlemde satır hatası varsa betik dursun (çıkış kodu 4) empuno payroll-items.bulk --json @kalemler.json --idempotency-key kalem-2026-12 --strict # HTTP curl -X POST -H "Authorization: Bearer $EMPUNO_API_KEY" -H "X-Empuno-Dry-Run: 1" \ -H "Content-Type: application/json" -d '{"name":"Ar-Ge"}' https://empuno.com/manager/departments curl -X POST -H "Authorization: Bearer $EMPUNO_API_KEY" -H "Idempotency-Key: dept-arge-2026" \ -H "Content-Type: application/json" -d '{"name":"Ar-Ge"}' https://empuno.com/manager/departments ``` Eski CLI (1.5.0 öncesi) de güvenlidir: sunucu `--validate` ve `--dry_run true` bayraklarını deneme, `--idempotency-key ` ve `--client_request_id ` bayraklarını tekrar anahtarı sayar. Yeni sürümün kolaylıkları (otomatik anahtar, yeniden deneme) için `npm i -g empuno@latest`. ## Başka sistemden geçiş: geçmiş veriyi yükleyin Ajanınız eski sistemin geçmişini bir kerede taşıyabilir: ayrılmışlar dahil çalışanlar, izin geçmişi, avanslar ve devreden bakiyeler, ödenmiş masraflar, geçmiş bordrolar, özlük evrakı. Tüm aktarım komutları aynı kurallara uyar: - **Yan etki yok:** davet, e-posta, push bildirimi gitmez; onay akışına girilmez; lisans tüketilmez. Kayıtlar yönetici kaydıdır ve geçmişte gerçekleşmiş sayılır. - **Çalışanı kendi anahtarınızla verin:** her satırda `identity_number` (TC), `employee_number` (empuno sicil no), `employee_id` ya da `employee_name` ("Ad Soyad"; yalnız firmada tek kişiyle eşleşirse). Önce kimlik aramanız gerekmez. - **Excel/CSV doğrudan:** `data-migration.files.parse` (kind + file) eski sistemin dışa aktarımını Türkçe başlıklarıyla (TC Kimlik No, Ad Soyad, Brüt, Net Ödenen…) kayıtlara çevirir; tarih, dönem ve 38.000,50 biçimi normalleşir, eksik zorunlu sütun `missing_required`'da. Dönen `records`'u ilgili commit'e verin. Yönetici aynı akışı panelde Veri Göçü → Dosyadan Aktar'da yapar. - **Departman adla:** çalışan aktarımında `department` (ad) verilebilir; bilinmeyen departman açılır, satırın `reason`'ında yazar. - **Ada göre eşleme:** izin türü (`leave_type`: ad ya da `annual` gibi tür anahtarı), masraf kategorisi (`category`) adla verilebilir; Türkçe büyük/küçük harf farkı önemsizdir. Geçerli değerler: `empuno reference`. - **Önce doğrulayın:** `--validate` (HTTP: `dry_run: true`) aynı işlemi yapar ama hiçbir şey yazmaz; satır sonuçları gerçek çalıştırmayla aynıdır. - **Tekrar çalıştırmak güvenlidir:** aynı kayıt (ve aynı dosya) ikinci kez yüklenmez, `skipped` döner. Çalışanlarda `--on_existing update` yalnız gönderilen alanları günceller. - **Satır bazlı sonuç:** yanıtta `results[]` her satır için `created | updated | skipped | failed`, oluşan kaydın kimliği ve hata nedeni. - **Doğrulamada kimlik yok:** `dry_run` yanıtında `created` satırının `id`'si `null`'dır (kayıt geri alındı); gerçek kimlikler yalnız gerçek çalıştırmada döner. - **Türk sayı biçimi:** Logo/Mikro/Excel dışa aktarımındaki `38.000,50` tutarları için CLI'ye `--decimal ,` verin; TC, tarih ve sicil no dokunulmaz. ```bash # Sıra: çalışanlar → izinler → avanslar → masraflar → bordrolar → evrak (JSON ya da Excel'den CSV) empuno migrate employees calisanlar.csv --validate empuno migrate employees calisanlar.csv # ayrılmışlar: status=terminated + termination_date, sgk_exit_code empuno migrate employments donemler.csv --validate # giriş-çıkış geçmişi + SGK işyeri sicili: employee_effects'i kontrol edin empuno migrate employments donemler.csv # identity_number, hire_date, termination_date, sgk_exit_code, sgk_workplace empuno migrate leaves izinler.csv # identity_number, leave_type, start_date, end_date, days empuno migrate advances avanslar.csv # amount, advance_date, deduction_period, deducted_amount (mahsup edilen) empuno migrate expenses masraflar.csv # expense_date, amount, category, merchant_name, status=paid empuno migrate payroll bordrolar.csv --decimal , # period, identity_number, gross_total, income_tax_base, net_pay (+ SGK/GV/DV kalemleri) empuno migrate payroll beyan.csv --on_existing update --update_fields declaration # aktarılmış aylara yalnız SGK/MUHSGK beyan alanları empuno migrate documents manifest.csv # file (yol), identity_number, document_type, document_date, period empuno attendance import puantaj.xlsx --validate # aylık puantaj (ızgara ya da özet) — bkz. "Puantaj" bölümü ``` | Veri | Komut | Not | | --- | --- | --- | | Çalışanlar (ayrılmışlar dahil) | `data-migration.employees.commit` | Çıkış tarihi/kodu, departman, şube, IBAN, SGK sicil/giriş, SGK işyeri (`sgk_workplace`), iç içe `employments[]`; TC ile eşler | | Çalışma dönemleri (giriş-çıkış, SGK işyeri) | `data-migration.employments.commit` | Her satır bir sigortalılık dönemi; kart aynası dönemlerden türetilir, `employee_effects[]` kıdem/izin etkisini gösterir. Bilinmeyen 26 haneli sicil işyeri olarak açılır | | Devreden yıllık izin | `employees.leave-opening.update` | "Şu tarih itibarıyla kalan izin" (çalışan başına tek kayıt); o tarihe kadarki yıldönümleri ve kullanımlar hesaba girmez | | İzin geçmişi | `data-migration.leaves.commit` | Onaylı geçmiş izin; bakiye hesabına girer | | Avanslar + devreden bakiye | `data-migration.advances.commit` | Bordro, `deduction_period`'dan itibaren kalan bakiyeden düşer | | Masraflar | `data-migration.expenses.commit` | Ödenmiş/onaylı; muhasebeye işlenmiş sayılır | | Geçmiş bordrolar | `data-migration.payroll.commit` | Ayrıca `payroll.manage` ister. Değerler aynen saklanır (yeniden hesaplanmaz); dönem kilitli "ödendi" açılır | | Bordro beyan bilgileri | `data-migration.payroll.commit` + `update_fields=declaration` | Aktarılmış aylara APHB/MUHSGK alanları; tutar, net ve kilit değişmez. Dosyadan: `kind=payroll_declaration` | | Özlük evrakı | `data-migration.documents.commit` | İstek başına ≤10 dosya (CLI parçalar); varsayılan yalnız yönetici görür | | Aylık puantaj (gün kodları ya da özet) | `payroll.attendance.commit` | Çalışan-ay başına tek kayıt; bordroda tek kaynak. Excel: `payroll.attendance.parse` ya da `data-migration.files.parse --kind attendance` (+ `period`, `code_map`). Ayrıca `payroll.manage` ister | | BES katılımcıları | `data-migration.pension-enrollments.commit` (`empuno migrate pension`) | Durum (aktif / ara verdi / caydı / ayrıldı), dahil olma, oran, cayma / ara verme tarihleri, sertifika no — geçmiş durum aynen yazılır. Plan önce `pension.plans.store`. Dosyadan: `kind=pension_enrollments`. Ayrıca `payroll.manage` | | Teşvik bilgileri + uygulanan kanun | `data-migration.incentive-facts.commit` (`empuno migrate incentive-facts`) | 6 ay sigortasız, İŞKUR, mesleki belge, sosyal yardım, 2828, işsizlik ödeneği kalan gün; Kanun No + Başlangıç → teşvik ataması (aktif). Engellilik oranı profile yazılmaz (uyarı). Dosyadan: `kind=incentive_facts`. Ayrıca `payroll.manage` | **Geçmiş bordro** müşavirin/eski yazılımın hesapladığı tutarlarla gelir; empuno onları yeniden hesaplamaz, yalnız saklar. Her satır bir çalışanın bir ayıdır (`period`: `2026-09`). Zorunlu: `gross_total`, `income_tax_base` (o ayın GV matrahı), `net_pay`. İsteğe bağlı: `sgk_days`, `sgk_employee`, `unemployment_employee`, `income_tax_final`, `stamp_tax_final`, `sgk_employer`, `employer_incentive_amount`, `employer_cost`, `earnings[]` / `deductions[]` (`{name, amount}`), `cumulative_tax_base`. Kalemde `earnings[].type` (leave_pay | notice | severance | severance_excess = kıdemin tavanı aşan vergili kısmı) ve kalemin kendi vergisi `earnings[].income_tax` / `stamp_tax` (MUHSGK 013/015 satırı bu değeri aynen alır); kesintide `deductions[].type` (advance | garnishment | alimony | tax_debt | bes | union | penalty | rd_retained | other — muhasebe sınıflandırması ad tahminine kalmaz). Dönemler motorun dokunmadığı "ödendi" durumunda açılır ve `Aktarıldı` etiketi taşır; avans/haciz yeniden mahsup edilmez. Aktarımdan sonra empuno ilk ayı **devraldığı kümülatif GV matrahıyla** hesaplar — yıl içinde başka işverenden gelenler için `cumulative_tax_base` (o ay sonundaki kümülatif) verin, yoksa aktarılan aylardan zincirlenir. İçinde empuno bordro dönemi olan ay aktarılmaz (test/taslak dönemiyse önce `payroll.destroy --reason "…"` ile silin; onaylanmışsa önce `payroll.cancel`); gelecek ay reddedilir. Net, brütten yasal kesintiler düşülünce 1 TL'den fazla sapıyorsa satır yine yazılır, `reason`'da uyarı döner. APHB gün alanları tamsayıdır: kesirli `sgk_days` / `rd_days` (ör. kısmi süreli 183,75 saat / 7,5 = 24,5) **yukarı** yuvarlanır (SSİY md. 101/3: "7,5 saatin altındaki çalışmalar 1 güne tamamlanır" → 25), kesirli `missing_day_count` aşağı; yuvarlama satırın `reason`'ında yazılır. `on_existing=update` yanıtında `results[].changed[]` değişen her alanı verir: beyan alanları kayıt adıyla (`sgk_days`, `employer_incentive_code` …), tutarlar fiş kolon adıyla (`gross_total`, `net_pay`, `sgk_employee_unemployment`, `additional_deductions_total` …), kalemler `earnings` / `deductions`. **Beyan alanları** (SGK APHB + MUHSGK; hepsi isteğe bağlı, kodlar `empuno reference …`): `employer_incentive_code` = APHB kanun no (4–5 hane, 5510 → 05510; açık uçlu — `incentive_codes`), `sgk_document_type` (01, 02, 13… — `sgk_document_types`), `missing_day_count` + `missing_day_reason` (01, 03–13, 15–29; 02 artık kullanılmıyor → 21/19/20 — `sgk_missing_day_reasons`), `sgk_occupation_code` (9999.99; "2512,1" → 2512.10), `sgk_workplace_registration_no` (26 hane, yalnız rakam; Excel'de METİN hücresi — firmanın işyeriyle eşleşirse fişe işyeri olarak da bağlanır), `sgk_workplace_id` / `sgk_workplace` (id, sicil ya da ad; bulunamazsa satır `failed`), `tax_payment_type` (011 | 012 | 014 — `muhsgk_payment_types`), `insurance_group` (normal | sgdp | none — `insurance_groups`), Ar-Ge: `rd_law` (5746 | 4691), `rd_rate`, `rd_days`, `rd_income_tax_exemption`, `rd_stamp_exemption`, `rd_sgk_support`; asgari ücret istisnası `mw_income_tax_exemption` / `mw_stamp_exemption`. Alan listesi ve hangi fişte düzenlendiği: `empuno reference payroll_declaration_fields`. Geçersiz kod yalnız o satırı düşürür (`failed` + doğru referans). **Kilitli dönemde yalnız beyan:** `--on_existing update --update_fields declaration` aktarılmış ayın mevcut pusulasına yalnız beyan alanlarını yazar; brüt, PEK, primler, kesilen GV/DV, net, kümülatif matrah, kalemler ve dönem durumu DEĞİŞMEZ (kayıttaki tutar alanları yok sayılır, satırın `reason`'ında yazar). Değişen alanlar `results[].changed`; aynı istek tekrarlanırsa satır `skipped` "değişiklik yok". Bu mod dönem açmaz: pusulası olmayan çalışan / aktarılmamış ay `failed`; empuno'nun hesapladığı ay için `payroll.declaration.update` önerilir; `on_existing=skip` ile 422. Tam güncellemede (`update_fields` yok) önceden girilmiş beyan KOD alanları (kanun no, belge türü, eksik gün/neden, meslek, sicil, ödeme türü, sigorta türü, Ar-Ge kanunu/oranı/günü) ve prim günü korunur; bir kod alanını silmek için açıkça `null` gönderin. Tutar türü beyan alanları (`mw_*`, `rd_income_tax_exemption`, `rd_stamp_exemption`, `rd_sgk_support`, `employer_incentive_amount`) kaydın tutarlarıyla birlikte gelir: tam kayıtta yoksa 0 sayılır (değişen alan `results[].changed`'de). Kanun no 05746 iken `rd_days` 0 olamaz (satır `failed`; boş = tüm prim günü). Prim günü temizlenemez: `sgk_days` boş/null yok sayılır (`reason`'da yazar). Dosyadan: `data-migration.files.parse --kind payroll_declaration` (Kanun No, Belge Türü, Eksik Gün, Eksik Gün Nedeni, Meslek Kodu, İşyeri Sicil No, Ödeme Türü, Sigorta Türü, Ar-Ge…; "Emekli", "YK üyesi" gibi değerler çevrilir) → dönen `records`'u `data-migration.payroll.commit`'e `on_existing=update`, `update_fields=declaration` ile verin. **Nakil ayında iki işyeri pusulası** (aynı vergi no, iki SGK sicili): müşavir aynı çalışan-ay için iki pusula verdiyse ikisini birlikte, her birinde kendi işyeriyle (`sgk_workplace_id` | `sgk_workplace` | `sgk_workplace_registration_no`) ve prim günüyle (`sgk_days`, zorunlu) gönderin — empuno çalışan başına TEK pusula yazar (GV kümülatifi ve asgari ücret istisnası işveren bazında tek): tutarlar, günler ve kalemler toplanır, işyeri kırılımı `sgk_segments[]`'e her pusulanın kendi değerleriyle yazılır (prim günü, eksik gün + neden, Ar-Ge günü, kanun no, belge türü, giriş/çıkış, PEK, primler, teşvik, Ar-Ge desteği, GV matrahı, kesilen GV/DV). Mutabakat işyeri başına APHB satırını ve MUHSGK işyeri payını bu değerlerden aynen verir. Pusulanın SGK giriş/çıkışı: `sgk_entry_date`, `sgk_exit_date`, `sgk_exit_code` (Dosyadan Aktar sütunları "İşyeri Giriş Tarihi" / "Giriş Günü", "İşyeri Çıkış Tarihi" / "Çıkış Günü", "İşten Çıkış Kodu"; ayın günü de olur: 16 → dönemin 16'sı; verilmezse nakil sınırına önceki işyerinde çıkış 16 + sonrakinde giriş yazılır; tarih yoksa sınır prim + eksik günden tahmin edilir, `reason`'da not). Yanıt: ilk kayıt fişin sonucunu (`created` / `updated` / `skipped` + `merged.records`), diğerleri `action: merged` (+ `merged_into`, aynı `slip_id`) döner; `data.merged` = birleşen ek kayıt sayısı. Tekrar güvenli; sonradan TEK kayıt gönderilirse o ayın tamamı sayılır ve dilimler kaldırılır. Aynı işyeri iki kez ya da işyeri belirtilmeyen iki kayıt eskisi gibi işlenir (ikincisi atlanır / `on_existing=update` ile ezer); dilimler çakışıyorsa (aynı ayda iki işyerinde eşzamanlı çalışma) grubun tüm kayıtları `failed`. `--update_fields declaration` ile iki işyerli kayıt, birleştirilmiş pusulanın dilim beyan alanlarını işyerine göre düzeltir (tutarlar kilitli; fiş düzeyi gün/eksik gün dilimlerden yeniden kurulur). Elinizde yapılandırılmış veri yoksa (ekran görüntüsü, düz metin liste) `data-migration.employees.parse` / `leaves.parse` metni ve görselleri AI ile kayıtlara çevirir (sorgu başına 2 AI kredisi); sonucu commit'e verirsiniz. ## İşten çıkış ödemeleri ve bordro hesaplama tercihleri Her işten çıkışta **kullanılmayan yıllık izin ücreti**, **ihbar** ve **kıdem tazminatı** hesaplanır ve çıkış ayının bordrosuna kalem olarak girer. Hak, SGK çıkış kodundan gelir (ör. 04 → kıdem + ihbar, 03 istifa → yalnız izin ücreti); "şartlara bağlı" kodlarda tazminatlar varsayılan kapalıdır. ```bash # Önce gör (yan etkisiz): çıkarsa ne öderiz? empuno employees.exit-settlement.show 45 --termination_date 2026-04-20 --sgk_exit_code 04 # Çıkar: ödemeler otomatik hesaplanıp onaylanır; izin gününü elle verebilirsiniz empuno employees.terminate 45 --termination_date 2026-04-20 --sgk_exit_code 04 --exit_leave_days 12 # Ayrılmış çalışanda düzelt / onayla (aktarılan çalışanın izin bakiyesi eksikse) empuno employees.exit-settlement.update 45 --leave_days 9 --include_notice false # Firma tercihleri ve güncel değerler empuno reference payroll_options empuno payroll-settings.options.update --sick_leave_pay first_two_paid --mw_exemption_partial_month full_month ``` - **Vergiler:** izin ücreti SGK + GV + DV (çıkış ayının ücretine eklenir); ihbar GV + DV (SGK yok); kıdem yalnız DV (GV istisna, SGK yok), tavanla sınırlı. - **Yakalama:** çıkışı başka yoldan (aktarım) girilmiş çalışan bordro hesabında bulunur; firma tercihine göre onay bekler (`flash.attention`) ya da doğrudan eklenir. Onaydan sonra dönemi yeniden hesaplayın. - **Tercihler** (`payroll-settings.options.update`, yalnız gönderilen anahtarlar): kıst ayda asgari ücret istisnası (varsayılan tam ay — GV Genel Tebliği 319), yıl içinde işe girende AÜ GV istisnasının kümülatifi (`mw_exemption_cumulative_start`, varsayılan `hire_month`: asgari ücretin kümülatif matrahı bu işverendeki giriş ayından başlar — 319 Örnek 7/15, 331 Örnek 1; ör. 2025/Eylül girişlide istisna 3.315,70, yıl başından beri çalışanda 4.420,93 TL; `january` eski takvim tablosu, Tebliğe aykırı), ücretsiz iznin hafta sonu (takvim / yalnız iş günü), rapor günleri (maaş tamamlama / ücretsiz / ilk 2 gün işveren), çıkış ödemesi ekleme, izin ücreti ve tazminat ücret esası (çıplak / giydirilmiş), kıdemde kısmi yıl yöntemi, kıdem tavanı aşımı. Her seçeneğin mevzuat dayanağı `empuno reference payroll_options` çıktısındaki `help` alanında. - **Gün hesabı (SGK 2020/20):** eksik günlü tam ayda prim günü = ayın takvim günü − eksik gün (31 çeken ayda 1 eksik → 30, Şubat'ta → 27); ücret 30 esaslı. Yarım gün ücretsiz izin SGK gününü düşürmez, yalnız ücretten düşer. - **Hak yoksa tutar 0:** kıdem için en az 1 tam yıl + kıdem doğuran kod, ihbar için bildirim süresine uyulmayan fesih gerekir; hak yoksa önizlemede `eligible=false`, tutar 0 ve `reason`; istense bile eklenmez (gönüllü ödeme ek kazanç olarak girilir). - **Müşavir bordrosu aktarılan ay:** `data-migration.payroll.commit` earnings[].type = leave_pay | notice | severance (+ days) ile çıkış kalemleri empuno çıkış ödemesi olarak kaydedilir (durum `imported`); tipli kalem yoksa o ayın onay bekleyen ödemesi `superseded` olur. Bordro dışında ödenen için: `employees.exit-settlement.update --dismiss true --notes "…"`. - **Kıdem tavanı** fesih tarihindeki dönemin tavanıdır (2026: 01.01–30.06 64.948,77 TL; 01.07–31.12 73.729,87 TL). ## Çalışma dönemleri, SGK işyerleri, kıdem ve izin süresi Bir çalışanın giriş-çıkış geçmişi **çalışma dönemleri** olarak tutulur: her dönem bir sigortalılık dönemidir (giriş, çıkış, SGK çıkış kodu, SGK işyeri, sigorta türü). Çalışan kartındaki `hire_date` / `termination_date` / `sgk_exit_code` / `termination_reason` bu dönemlerin **aynasıdır**: `hire_date` = güncel sözleşmenin başlangıcı (aynı işverende kesintisiz zincirin ilk dönemi). Dönemi hiç girilmemiş çalışan tek "örtük" dönemle (id=null) aynen eskisi gibi hesaplanır — okumak satır oluşturmaz. ```bash # 1) SGK işyerlerini açın (sicil METİN; boşluk/tire serbest; ad boşsa sicilden) empuno sgk-workplaces.store --registration_no "2 1041 02 02 4444444 006 05 88 000" --name "Merkez" empuno sgk-workplaces.store --registration_no "2 1041 02 02 5555555 035 01 88 000" --name "İzmir Teknopark" --zone_type technopark empuno reference sgk_workplaces # 2) Geçmişi yükleyin — önce deneme, employee_effects'i kontrol edin empuno migrate employments donemler.csv --validate empuno migrate employments donemler.csv # 3) Tek çalışan: oku / geçmiş dönem ekle / düzelt empuno employees.employments.index 45 empuno employees.employments.store 45 --hire_date 2016-02-01 --termination_date 2019-12-31 --sgk_exit_code 04 --severance_paid true empuno employees.employments.update 45 812 --iskur_exit_reason 2 # İŞKUR çıkış nedeni (SGK kodundan ayrı): empuno reference iskur_exit_reasons empuno employees.employments.update 45 812 --counts_for_severance false --override_note "2019 çıkışında kıdem ödendi (dekont)" # 4) Şirket içi nakil (aynı vergi no): 16 + ertesi gün giriş, iş ilişkisi sürer empuno employees.employments.transfer 45 --date 2026-07-16 --sgk_workplace "İzmir Teknopark" empuno sgk-workplaces.assign 2 --employee_ids 45,46,47 --mode transfer --date 2026-07-16 --validate # 5) Ayrılmış çalışanı yeniden işe alma (yeni dönem; e-posta yok, lisans tüketir) empuno employees.rehire 45 --hire_date 2026-11-02 # emekli olarak dönüş: dönem SGDP + bordro profili giriş tarihinden yeni sürüm (payroll.manage) empuno employees.rehire 45 --hire_date 2026-11-02 --insurance_group sgdp --update_payroll_profile true --validate # 6) Devreden yıllık izin (önceki sistemden kalan bakiye) empuno employees.leave-opening.update 45 --as_of_date 2025-12-31 --annual_days 12.5 ``` - **Kurallar:** dönemler çakışmaz; yalnız son dönem açık olabilir; aktif çalışanın son dönemi açık, ayrılmışınki kapalıdır. `continues_previous` = önceki dönemin çıkışının ertesi günü başlayan devam (nakil). İhlal `rejected` + `flash.rule` (kod) + `flash.hint` (sonraki komut) döner; kod listesi `empuno reference agent_errors` (`returned_as: "flash.rule"`). Çalışan kartındaki işe giriş tarihi (`employees.update --hire_date`, mobil, root admin) dönemlerle çakışırsa hiçbir alan yazılmaz: `flash.rule: hire_date_conflicts_periods` + hint (`employees.employments.update`). - **Ne nereden yapılır:** açık döneme çıkış → `employees.terminate` (hesap kapatma, bekleyen talepler, çıkış ödemesi); hatalı çıkışı geri alma → `employees.reactivate`; ayrılmış çalışanın yeni dönemi → `employees.rehire` (`--update_payroll_profile true` + `payroll.manage`: bordro profilinin sigorta grubu giriş tarihinden yeni sürümle dönemin sigorta türüne çekilir, çıkışta kapanmış profil yeniden açılır — yanıt `created.payroll_profile {action: versioned | reopened | updated | unchanged | missing}`; yetki yoksa `rejected` + `flash.rule: payroll_permission_required`; kutu işaretsizken profil kapanmışsa `payroll_profile_closed` uyarısı); işyeri düzeltme (tarihsiz) → `employees.update --sgk_workplace_id` ya da `sgk-workplaces.assign --mode correct`; tarihli nakil → `employees.employments.transfer` ya da `sgk-workplaces.assign --mode transfer`. - **16 çıkış kodu** yalnız aynı işverenin (aynı vergi no) başka SGK işyerine nakildir: işten çıkışta reddedilir, grup şirketleri arasında kullanılamaz (grup şirketine geçiş yeni işverende yeni sözleşmedir). `empuno reference sgk_exit_codes`: `usable_in_termination`, `retired` (29), `note`. - **Önceki hizmet** (`kind=prior_service`): aynı işveren sayılan grup şirketi / işyeri devri (4857 md. 6). Kapalı olmalı, `external_employer_name` zorunlu. - **Kıdem:** güncel sözleşme zinciri hep sayılır. Önceki zincir: elle karar (`counts_for_severance`) > kıdemi ödenmiş (`severance_paid` ya da aynı tarihli onaylı/aktarılmış çıkış ödemesi; ödeme aynı kesintisiz iş ilişkisinde ondan önceki dönemleri — nakil 16 öncesi — de kapsar: `reason_code: paid_chain`, `paid_by_employment_id`) > zamanaşımı (2017-10-25 öncesi çıkış 10, sonrası 5 yıl) > çıkış koduna göre hak. "Şartlara bağlı"/boş kodlu dönem `severance_prior_unknown_exit` tercihine göre (vars. hariç + `severance_decision_needed` uyarısı). Ayrıntı `employees.employments.index` → `timeline.severance.periods[]` (her dönem için sayılır/sayılmaz + gerekçe) ve `employees.exit-settlement.show` → `preview.service`. Kıdem değerlendirmesi, ihbar, kıdem ödemeleri ve karar notları `payroll.view` ister — yoksa okumada yer almaz (`timeline.severance_hidden: true`); `severance_paid*` / `counts_for_severance` yazmak `payroll.manage` ister (`flash.rule: payroll_permission_required`). - **Yıllık izin süresi:** `leave_prior_service` = combine (vars.; önceki dönemler izin kıdemine eklenir, iş K. md. 54) | current_only. Sözleşme öncesi yıldönümlerinde yeniden hak doğmaz (o dönemin izni kullanıldı ya da çıkışta ödendi), sözleşme öncesi izin kullanımı düşülmez. Devreden bakiye (`employees.leave-opening.update`): `as_of_date` itibarıyla kalan gün; sonraki yıldönümleri eklenir, `as_of_date` sonrası kullanım düşülür. Açılış sözleşmeye bağlıdır: yeniden işe alımdan sonra önceki sözleşmenin açılışı yeni bakiyeye eklenmez (`timeline.leave_opening_stale` + `leave_opening_stale` uyarısı; md. 59 — önceki dönemin izni çıkışta ödenir). Ücretsiz izin ötelemesi yalnız izne sayılan dönemlerdeki ücretsiz izinden. Geçmiş bir çıkışın kullanılmayan izni (`employees.exit-settlement.show`) yeniden işe alımdan sonra da çıkış anındaki sözleşmeyle hesaplanır. - **İhbar süresi:** `notice_service_basis` = current_contract (vars.; güncel sözleşme) | combined (önceki sayılan dönemlerle). - **Sicil numarası** 26 hanedir (mahiyet, işkolu, ünite, sıra no, il, ilçe, kontrol, aracı); METİN olarak gönderin — sayı olarak Excel/JSON'da son haneler kaybolur. `zone_type` (technopark / rd_center) ve `default_law_no` yalnız ipucudur: Ar-Ge kapsamı bordro profilinden, kanun no beyan kurallarından gelir; teknopark işyerine nakilde `rd_profile_hint` uyarısı profili güncelleme komutunu verir. - **Bordroda nakil ayı:** çalışan başına TEK fiş kalır (ücret, GV kümülatifi ve asgari ücret istisnası işveren bazında tek hesaplanır); nakil kıst yapmaz. Fişe `sgk_workplace_id` (son dilimin işyeri, dönemsiz çalışanda firmanın varsayılanı) ve ≥ 2 dilimde `sgk_segments[]` yazılır: işyeri başına gün, eksik gün + neden, giriş/çıkış (nakilde 16), Ar-Ge günü (profil aralığı ∩ dilim) ve PEK/prim payı (gün payıyla, son dilim kuruş farkını alır). Her işyeri kendi takvim gününü bildirir: 31 çeken ayda toplam 31 olabilir (25 koduyla azaltılmaz); kesintisiz nakilde Şubat 30'a tamamlanır — fark `transfer_february_completion` tercihine göre sonraki (vars., TÜRMOB 06.03.2024/60-1) ya da önceki işyerine. `slip.sgk_day_count` aylık toplamdır (30). Ay içinde çıkış + yeniden giriş: iki sözleşmenin günleri toplanır (kıst), devamı olmayan dönem sonu çıkış ödemesi niyeti üretir. Yeniden giren çalışanın eski sözleşmesindeki ay da bordroya girer (geçmiş ay yeniden hesabı). Uyarılar (`payroll.calculate` → `flash.warnings`): `workplace_missing`, `workplace_closed`, `insurance_group_mismatch` (dönem ↔ profil; hesap profile göre), `rd_zone_mismatch`, `transfer_31_day_ceiling` (31 günlük nakil ayında PEK taban/tavana bağlı → işyeri başına kontrol). Denemek için: `payroll.simulate --period 2026-02 --employee_id 45 --segments '[{"from":"2026-02-01","to":"2026-02-13","sgk_workplace_id":1},{"from":"2026-02-14","to":"2026-02-28","sgk_workplace_id":2}]'` (yanıt `workplace.sgk_segments`). - **Beyanda işyeri** (`payroll.declaration`): öncelik fişin dilimleri > fişin işyeri > fişteki ham sicil (firmanın işyerleriyle okuma anında eşleşir; eşleşmezse ham numara aynen + `workplace_registration_unmatched` bilgisi) > çalışma dönemlerinin o aya düşen dilimleri (canlı — dönemleri sonradan girseniz de eski fiş işyeri bazlı beyan verir, fiş değişmez) > varsayılan işyeri > yok (`workplace_missing`). Nakil ayında kişi işyeri başına APHB satırı alır, vergi satırları da gün payıyla işyerine bölünür (MUHSGK her sicil için ayrı). `--sgk_workplace_id ` yalnız o işyerinin satırları — ay içinde nakledilen çalışanın bordro detayı ve `summary.totals` (brüt, net, kesinti, işveren maliyeti) o işyerinin payıyla (`detail_rows[].workplace_share {days, total_days, ratio, full}`, `summary.totals.workplace_share_rows`; işyeri görünümlerinin toplamı bordroya eşit); `summary.by_workplace` işyeri toplamları; Excel'de işyeri başına "APHB – " sayfaları. - **Fişte işyeri dilimleri:** `payroll.employee-slip <çalışan>` → `slip.sgk_workplace_id` + `slip.sgk_segments[]` (gün, eksik gün + neden, giriş/çıkış kodu, PEK ve prim payları). Dönemi girilmemiş, tek işyerli çalışanda `sgk_segments` boştur. - **Okumalarda ek alanlar:** `employees.show` → `employments` (zaman çizelgesi; hesap hatasında null), `employee.sgk_workplace`, `sgkWorkplaces` (aktif işyerleri), `employmentExitCodes` (dönem kaydında geçerli tüm kodlar: 16 ve 29 dahil, `retired` + `note`); işten çıkış listesi `sgkExitCodes` 16 içermez. `employees.index --sgk_workplace_id ` süzer, satırda `sgk_workplace`. `payroll-settings.index` → `sgkWorkplaces`, `sgkWorkplaceMeta` (sicil parçaları, 81 il, bölge türleri, kanunlar). - **Panelde aynı uçlar:** Bordro Ayarları → **SGK İşyerleri** kartı (ekle / düzenle / varsayılan yap / kapat / sil / **Çalışan ata**: Düzeltme ya da tarihli Nakil, önce Doğrula) ve bölümlü **Hesaplama Tercihleri** (Çıkış, kıdem ve izin bölümünde dört yeni tercih); Firma Ayarları → Genel'de işyeri sayısı kartı; çalışan detayında **Çalışma Dönemleri** sekmesi (son sözleşme / izin kıdemi / kıdeme esas süre özeti, gerekçe rozetli zaman çizelgesi, Dönem ekle, İşyeri nakli, Devreden izin — her yazma önce `dry_run` etkilerini gösterir); **İşe Geri Al** iki seçenekli (Çıkışı geri al = `employees.reactivate` | Yeniden işe al = `employees.rehire`); Düzenle / Davet formlarında ve Çalışanlar listesinde SGK İşyeri; **Mutabakat**'ta işyeri filtresi + işyeri kartları; çıkış ödemesi kartında Hizmet dökümü; Veri Göçü → Dosyadan Aktar → "Çalışma dönemleri" (çalışan başına etki tablosu). - **Çalışanın kendisi:** `GET /api/v1/profile` (mobil) ve web profilinde `service` özeti — sözleşme başlangıcı, izin kıdemi başlangıcı ve süresi, yıllık izin hakkı (14/20/26), toplam hizmet, devreden izin `{as_of, days, source_label}`, dönemler (tarih, süre, işyeri adı, nakil). Kıdem tazminatı değerlendirmesi, yönetici notları ve çıkış gerekçesi çalışana gösterilmez. Web: Profil → "Hizmet Sürem"; mobil: Profil → Hizmet Sürem. ## SGK sicil geçmişi: işkolu / ilçe değişince yeni numara Aynı fiziksel işyeri işkolu (NACE), ilçe ya da ünite değişince SGK'dan **yeni 26 haneli numara** alır; sıra no ve il genelde aynı kalır, çalışanlar nakil olmaz. empuno'da işyerinin **güncel** numarası `registration_no`'dadır, eskileri geçerlilik aralığıyla **sicil geçmişinde** (`former_registrations`). Geçmiş dönemin APHB'si o tarihteki numarayla çözülür; aktarımda eski numara aynı işyerine eşleşir. Her numarayı ayrı işyeri açtıysanız **birleştirin**. ```bash # Ayrı açılmış eski siciller: öneri (aynı sıra no + il + aracı) → deneme → birleştir empuno sgk-workplaces.merge-suggestions empuno sgk-workplaces.merge 8 --source_ids 13,12,11 --validate # declaration_check.changed ve collapsed_transfers'a bakın empuno sgk-workplaces.merge 8 --source_ids 13,12,11 # Son gün fiş/dönemden bilinmiyorsa elle empuno sgk-workplaces.merge 9 --json '{"source_ids":[10],"valid_until":{"10":"2025-01-31"}}' --validate # SGK bugün yeni numara verdi (işkolu değişti): eski numara date − 1 son günüyle geçmişe empuno sgk-workplaces.change-registration 8 --registration_no "2 5231 01 01 1677872 035 23 07 000" --date 2025-08-01 --validate # Geçmişe eski numara ekle / kaldır empuno sgk-workplaces.registrations.store 9 --registration_no "2 6201 01 01 1893700 035 22 10 000" --valid_until 2025-01-31 empuno sgk-workplaces.registrations.destroy 9 41 ``` - **Düzeltme ≠ değişiklik:** `sgk-workplaces.update --registration_no` yanlış girilmiş numarayı DÜZELTİR (geçmişe yazılmaz, geçmiş APHB'ler de yeni numarayla görünür). SGK yeni numara verdiyse `sgk-workplaces.change-registration`. - **APHB'de numara:** fişteki/dilimdeki ham numara işyerinin (güncel ya da eski) numarasıysa o; değilse işyerinin dönem sonunda geçerli numarası. Eski numara: `valid_until`'i dönem sonuna eşit ya da sonra olan ilk geçmiş satırı. - **Birleştirme** atomiktir: kaynakların çalışma dönemleri, fişleri ve fiş dilimleri hedefe taşınır; kaynağın numarası hedefin geçmişine, son günü `valid_until` ?? kaynağın fişlerindeki son ayın son günü ?? son çıkış. Hedefin numarası en son kullanılan olmalı (`merge_target_not_latest`). Numara değişikliği yüzünden açılmış "16 + ertesi gün devam" nakil çiftleri tek döneme iner (`collapsed_transfers[]`); sigorta türü değişen, grup nakli ya da kıdem ödemeli çiftler dokunulmaz (`warnings[].transfer_kept`). Kaynak varsayılansa varsayılan hedefe geçer, kaynaklar silinir, `payroll_audit_logs`'a geri alma için tam eşleme yazılır. - **`declaration_check`**: birleştirmede her fişin APHB sicili önce ve sonra çözülür — `changed` > 0 ise `samples[]`'a bakın (ör. işyerisiz eski fişler artık varsayılanın o dönemdeki numarasını alır). - **Tekillik:** bir numara firmada tek yerde durur (güncel ya da geçmiş). Başka işyerinin güncel numarasını geçmişe eklemek `registration_taken` + birleştirme ipucu; eski numarayla `sgk-workplaces.store` yeni işyeri açmaz (`registration_is_former`). `migrate employments` bilinmeyen numara açarken aynı sıra no/il'li işyeri varsa notta birleştirme ipucu verir. - **Panelde:** Bordro Ayarları → SGK İşyerleri: satırda sicil geçmişi, ⋯ menüsünde **Sicil değişti** / **Eski sicil ekle**, kart başında birleştirme önerisi (önizlemeli). ## Puantaj aktarımı, saat bazlı kazançlar, kısmi süreli ve çağrı üzerine çalışma Ayın puantajı (müşavirin ya da PDKS'in Excel'i, ajanınızın ürettiği kayıt) çalışan-ay başına **tek kayıt** olarak saklanır ve bordroda **tek kaynak** olur: prim günü, eksik gün + SGK nedeni, ücret günü ve fazla çalışma / hafta tatili / UBGT / gece saatleri buradan okunur. Puantajı olmayan çalışan-ay bugünkü gibi izin kayıtları ve PDKS'ten hesaplanır. Puantaj uçları bildirim / e-posta göndermez; okumalar yan etkisizdir. Okuma `payroll.view`, yazma `payroll.manage` ister. ```bash # 1) Kodlar ve tercihler empuno reference attendance_codes # Ç, HT, HTÇ, RT/UBGT, Yİ, R, Üİ, D, KS … → kanonik değer + SGK eksik gün nedeni + ücret etkisi empuno reference payroll_options # attendance_days_source, attendance_hours_source, hourly_rate_divisor, rest_day_work_pay, attendance_employee_visibility # 2) Excel'den: oku → (tanınmayan kodu eşle) → dene → aktar — CLI tek komutta empuno attendance import puantaj.xlsx --validate empuno attendance import puantaj.xlsx --period 2026-04 --map "G=worked,X=absent" [--on_existing update] # aynı akış ham komutlarla empuno payroll.attendance.parse --file file=puantaj.xlsx --period 2026-04 --code_map "X=absent" # yazmaz; records[] + unknown_codes[] empuno payroll.attendance.commit --json @kayitlar.json --validate # {"period":"2026-04","on_existing":"update","code_map":{…},"records":[…]} # 3) Oku / düzelt / sil empuno attendance show 2026-04 --conflicts_only 1 # = payroll.attendance.index --period 2026-04 empuno payroll.attendance.show 812 # gün gün + bordro motoru önizlemesi (yazmaz) + uyuşmazlıklar + denetim empuno payroll.attendance.update 812 --overtime_50_hours 12 --conflicts_reviewed true empuno payroll.attendance.destroy 812 # o çalışan-ay izin kayıtları + PDKS'e döner empuno payroll.attendance.export --period 2026-04 --output puantaj.xlsx # geri okunabilir şablon # 4) Hesapla (önce önizle) empuno payroll.calculate 2026-04 --dry_run 1 && empuno payroll.calculate 2026-04 # 5) Saat bazlı kazançlar, çalışma şekli, tercihler empuno payroll-settings.earning-types.hourly-presets --presets overtime_50,overtime_25,weekly_rest,holiday empuno payroll-settings.earning-types.store --name "Nöbet" --calculation_type hourly_multiplier --hours_source manual --multiplier 1.5 --applies_to assigned empuno employees.payroll-items.store 45 --kind earning --type nobet --hours 16 --start_period 2026-11 empuno employees.payroll-profile.update 45 --work_schedule part_time --weekly_hours 24 --effective_from 2026-11-01 empuno payroll-settings.options.update --hourly_rate_divisor contract --rest_day_work_pay parameter_set ``` - **Tek kaynak ve uyuşmazlık:** puantajı olan çalışan-ayda (`attendance_days_source=attendance`, varsayılan) prim günü, eksik gün ve ücret günü puantajdan gelir; izin kayıtları ve devamsızlık kesintisi o ayın hesabına girmez. `attendance_hours_source=attendance` (varsayılan) iken PDKS saatleri de girmez. İzin kayıtları ve PDKS ile farklar **uyuşmazlık** olarak döner (`conflicts`, `conflict_count`; kodlar: `leave_record_not_in_attendance`, `attendance_leave_without_record`, `leave_type_mismatch`, `pdks_presence_on_absence`, `unpaid_days_mismatch`, `sick_days_mismatch`, `overtime_hours_mismatch`), bordroyu otomatik değiştirmez; incelendiğinde `conflicts_reviewed=true`. Kaynağı `leave_records` / `pdks` yaparsanız puantaj yalnız karşılaştırma olur. **Kayıt yalnız taşıdığı bilginin kaynağıdır:** gün alanı olmayan özet (prim günü, eksik gün / kırılım — `missing_days: 0` ya da `missing_breakdown: {}` "eksik gün yok" demektir —, neden, çalışılan gün yok; ör. yalnız FM sütunu) günleri izin kayıtlarından bıraktırır (`days_not_in_entry` uyarısı); saat alanı olmayan kayıt (yalnız kodlu ızgara, yalnız gün sütunlu özet) saatleri PDKS'ten bıraktırır (`hours_not_in_entry`). Puantajdaki "0" esas olsun istiyorsanız saat sütununu 0 olarak gönderin. Hesapta aynı durum `attendance_days_not_in_entry` / `attendance_hours_not_in_entry` uyarısıdır; `preview.days_in_entry` / `hours_in_entry` hangisinin kullanıldığını söyler. - **Kayıt biçimi:** ızgara — `days` {"2026-04-01" ya da "1": "Ç" | "HT" | "Yİ" | "R" | "7,5" | "HT8" | "08:30-17:45" | {c, h, n}}; özet — alanlar (`sgk_days`, `missing_breakdown` {"01": 2, "21": 1}, `missing_day_reason`, `missing_days` + `sick_days` / `unpaid_leave_days` / `absent_days`, `wage_deduction_days`, `worked_days`, `worked_hours`, `paid_rest_hours`, `overtime_50_hours`, `overtime_25_hours`, `weekly_rest_days/hours`, `holiday_days/hours`, `night_hours`, `notes`). `worked_hours` normal iş günü saatidir — FM, HT ve UBGT HARİÇ; `*_days` ile `*_hours` birlikte verilebilir. Izgarada özet alanlar gün kodlarından çalışanın sözleşme saatiyle türetilir (`derived[]`): FM %50 / FS %25 haftalık 45 saat kuralıyla (yalnız tüm normal günlerde saat varsa), saat aralığında md. 68 ara dinlenmesi düşülür (≤4 sa 15 dk, ≤7,5 sa 30 dk, üstü 1 sa), 20:00–06:00 kesişimi gece saatidir. Açık verilen alan türetileni ezer (`explicit_differs` uyarısı). - **Kodlar:** `empuno reference attendance_codes` — her kanonik değerin takma adları, SGK eksik gün nedeni (rapor 01, ücretsiz izin 21, ücretsiz doğum izni 19, yol izni 20, devamsızlık 15, kısa çalışma 18, kısmi süreli çalışılmayan gün 06, disiplin 03 …), ücret etkisi ve saat alıp almadığı. Sayı = çalıştı + saat; "HT8" = hafta tatilinde 8 saat çalıştı. Rapor (R) gününün ücreti firmanın `sick_leave_pay` tercihine göre. "0", "İzin" gibi belirsiz hücre ve tanımadığımız kısaltma **tanınmaz**: parse `unknown_codes[{raw, count, sample_rows}]` döner, commit o satırı `failed` (`unknown_codes` + hint) yapar → `code_map` ({"X": "absent"} ya da "X=absent,Y=worked") ile yeniden okuyun. - **Dosya okuma:** başlık satırı ilk satırlarda aranır (Ad Soyad / TC Kimlik No / empuno Sicil No; gün sütunları 1..31, "1 Pzt", "01.04.2026"); ay sırasıyla istekteki `period` > tarih başlıkları > başlık üstündeki "Nisan 2026" > sayfa adı > dosya adı (`period_source`). "Toplam" satırı atlanır. Özet sütunu (ör. "Fazla Mesai %50") ızgaradan türetilenle çelişirse açık değer kazanır, `warnings[]`'te yazar. 26–25 puantaj düzeni desteklenmez (uyarı; takvim ayı beklenir). Yönetici aynı akışı Bordro → Puantaj → **Puantaj Excel'ini yükle** ya da Veri Göçü → Dosyadan Aktar → "Puantaj (aylık)" ile yapar. - **Eksik gün ve prim günü (SGK 2020/20):** prim günü = ayın takvim günü − eksik gün; 31 çeken ayda 3 eksik gün → 28 (ücret 30 − ücretsiz gün). Kırılım `missing_breakdown`; birden çok neden → 12, kırılımla karşılanmayan eksik gün → 13 (kısmi süreli 06, çalışma şekli girilmemiş saatlik 07). 02 kullanılmaz: gelen satır `invalid_missing_day_reason` ile düşer, ipucu 21 / 19 / 20. Izgarada kırılım gün kodlarından gelir; kırılım alanları (`missing_breakdown`, `sick_days` …) yok sayılır ve `grid_field_ignored` uyarısı döner (PATCH dahil) — günün kodunu değiştirin. Özette `sgk_days` verilirse kazanır (`sgk_days_differs` uyarısı). Fişte `day_source` (attendance | records) ve `hour_source` (attendance | pdks) hangi kaynağın kullanıldığını söyler. - **Kilit, tekrar, yeniden hesap:** ayın bordrosu onaylı / kesinleşmiş / ödenmiş / hesaplanıyor ya da aktarılmışsa satır `failed` (`code: period_locked`, hint `payroll.reopen …`); gelecek ay `period_in_future`, çalışanın istihdamda olmadığı ay `outside_employment`. Aynı içerik tekrar gelirse `skipped` (`duplicate: true`); `on_existing=update` yalnız gönderilen alanları yazar (`days` tümüyle değişir); silinmiş kayıt yeniden aktarılınca geri gelir (`restored`). Hesaplanmış dönem yazılır ama yeniden hesaplanmaz: `periods[].recalculate_required` → `payroll.calculate`. Yanıt: `{created, updated, skipped, failed, results[{index, action, id, employee_id, period, warnings[], derived[], conflicts, reason?, code?, hint?}], periods[]}`; `dry_run`'da id'ler null. - **Fazla mesai fiyatı:** saat ücreti = aylık brüt / bölen (`hourly_rate_divisor`: 225 varsayılan = 7,5 × 30 | 240 | contract = profildeki haftalık saat × 5); saatlik ücretlide profildeki saat ücreti. Yerleşik çarpanlar parametre setinden (FM 1,5, FS 1,25). Hafta tatili / UBGT çalışması `rest_day_work_pay`: `statutory_additional` (varsayılan, 9 Kas 2026'dan beri: 1,5 / 1,0 ilave — 4857 md. 46–47; aylık ücret tatil yevmiyesini zaten içerir) | `parameter_set` (2,0 / 2,5 ilave — TİS / işveren tercihi, eski varsayılan). Çarpanlar aylık ücrete **ilavedir**. Gece çalışmasına kanunda zam yoktur: yerleşik ödenmez, gece çarpanlı saat bazlı tür tanımlayın (yoksa `night_hours_unpaid` uyarısı). Yıllık 270 saat aşımı `annual_overtime_limit` uyarısı. - **Saat bazlı kazanç türü ve tek ödeyici:** `calculation_type=hourly_multiplier` + `hours_source` (overtime_50 | overtime_25 | weekly_rest | holiday | night | manual) + `multiplier` (0 < x ≤ 10). Tutar = saat × saat ücreti × çarpan (+ gün × günlük ücret × çarpan). Bir kovayı tür ödüyorsa yerleşik fazla mesai o kovayı **ödemez**; aynı kovaya ikinci tür 0 öder (`bucket_multiple_payers` uyarısı). `manual` kaynaklı türde saat çalışan kaleminden (`hours`; `payroll-items.bulk` `records[].hours`). Serbest zaman kullanan çalışanda FM ödenmez. `hourly-presets` kanuni şablonları ekler (kod `hourly_`, tekrar güvenli: var olan `skipped`); gece için `--multipliers.night` zorunlu. Ödeyici ve tutar: `payroll.attendance.show` → `preview.priced_buckets[]`. Kova listesi: `empuno reference hour_sources`. - **Saatlik ücretli** (profil `salary_type=hourly`): brüt = saat ücreti × taban saat (toplam saat − fazla mesai; HT/UBGT çalışma saati tabanda 1× + kova ilavesi). Ücretli hafta tatili / genel tatil saati `paid_rest_hours` (ızgarada HT/RT günü × haftalık saat / 6; saat PDKS'ten gelse de puantajdan eklenir). Puantajda normal saat yoksa (`worked_hours` boş, yalnız kodlu ızgara) ücret PDKS saatinden; PDKS de boşsa çalışılan gün × günlük saat (haftalık sözleşme saati / 6, vars. 7,5) + ücretli tatil saati — `hourly_hours_from_days` uyarısı (aktarımda `hourly_hours_missing`). Prim günü olup hiç saat yoksa fiş üretilmez (hesap hatası: saat yok). HT/UBGT çalışma saati tabanda 1× + kova ilavesi olduğundan varsayılan `statutory_additional`'da toplam kanuni 2,5× / 2,0×; `rest_day_work_pay=parameter_set`'te 3,0× / 3,5× olur → `hourly_rest_day_stacking` uyarısı. Çalışma şekli girilmemiş saatlikte prim günü = ⌈saat / 7,5⌉ ≤ 30, eksik gün nedeni 07 (bugünkü kural); şekil girilmişse günler takvimden. - **Kısmi süreli / çağrı üzerine** (profil `work_schedule`: full_time | part_time | on_call + `weekly_hours`; `empuno reference work_schedules`; boş = bugünkü hesap): prim günü = ⌈ay içi ücretli saat / 7,5⌉, en çok 30 ve takvim günü; eksik gün nedeni 06; saat önceliği puantaj → PDKS → sözleşme (haftalık saat × gün / 7); aylık ücretli kısmi sürelide PDKS sözleşme saatinin altındaysa (eksik okutma) prim günü sözleşmeden — `part_time_hours_below_contract` uyarısı (saatlikte ücret de PDKS'ten olduğundan yalnız uyarı); daha az çalıştıysa puantaj (`worked_hours`) yükleyin. Çağrı üzerine çalışmada sözleşmedeki haftalık saat (boşsa 20) çalışılmasa da ücretlendirilir (4857 md. 14; iz adımında `on_call_floor_hours`). Kısmi süreliye fazla çalışma yaptırılamaz → `part_time_overtime` uyarısı (FÇY md. 7); haftalık 30 saat ve üstü kısmi süreli sayılmaz (`part_time_threshold`). Asgari ücret GV/DV istisnası `mw_exemption_partial_month` tercihine göre (varsayılan tam ay — GVGT 319). 30 günden eksik bildirimde çalışanın GSS tamamlaması hesaplanmaz. - **Doğrulama:** `payroll.simulate` `attendance.{sgk_days, missing_breakdown, missing_day_reason, worked_hours, paid_rest_hours}`, `profile.{work_schedule, weekly_hours}` ve `overtime.{overtime_50_hours, overtime_25_hours, weekly_rest_hours, weekly_rest_days, holiday_hours, holiday_days, night_hours}` alır; `payroll.employee-slip <çalışan> --explain 1` iz adımları `days.attendance`, `days.schedule`, `salary.hours`, `overtime.rate`, `overtime.bucket_*`, `overtime.rd_excluded`; motor uyarıları iz bayrağı `attendance.` ve fiş detayında `attendance.warnings[]` (hesaplamanın `attention[]` satırlarında `code`). Simülasyon tercihleri (`options.attendance_days_source`, `attendance_hours_source`, `hourly_rate_divisor`, `rest_day_work_pay`) doğrulanır — geçersiz değer 422. - **Panelde aynı uçlar:** Bordro → **Puantaj** sekmesi (Bordro · Puantaj · Mutabakat; ay seçimi, kaynak rozetleri, uyuşmazlık filtresi, kayıt penceresi: gün gün takvim, özet, saatler ve ödeyici, İncelendi), dönem ekranında puantaj özeti ve fişte "P" rozeti, fiş detayında **Puantaj ve saatler** kartı, Bordro Ayarları → Kazanç türleri "Saat × saat ücreti × çarpan" + **Yasal şablonları ekle**, Hesaplama tercihleri → "Puantaj ve saatlik ücret", çalışan bordro profilinde **Çalışma şekli** + haftalık saat, çalışan kaleminde Saat. Çalışan web ve mobil **Puantajım** ekranında "Bordro puantajı" kartı (`attendance_employee_visibility`: dönem onayından sonra | hemen | gizli; not ve uyuşmazlık gösterilmez). ## Bordro ek kazanç ve kesintileri (prim, ikramiye, yan hak, aidat) Ek kazanç ve kesinti **türleri** firma bazında tanımlanır (vergi/prim bayrakları, hesap şekli, kapsam). Kapsam `all` olan tür her ay tüm çalışanlara varsayılan tutarla girer; `assigned` tür çalışana **kalem** atanınca. Kalem süreli (`start_period`..`end_period`) ya da tek seferlik olur. Tutarlar SGK, gelir vergisi, damga vergisi ve nete doğru yansır; GV matrahından düşen kesintiler (GVK 63) türün oran sınırıyla uygulanır. Profildeki yemek/yol yardımı tür tanımı gerekmeden ödenir (gün sayısı: `allowance_day_basis` tercihi). ```bash empuno payroll-settings.earning-types.store --name "Satış Primi" --category premium --calculation_type manual empuno payroll-settings.deduction-types.store --name "Özel Sağlık Sigortası" --category insurance --reduces_tax_base true --applies_to all --default_amount 400 empuno reference earning_types # Tek çalışana tek seferlik kalem empuno employees.payroll-items.store 45 --kind earning --type satis_primi --amount 12500 --start_period 2026-11 # Toplu (bu ayın primleri) — JSON ya da Excel/CSV empuno payroll-items.bulk --json @primler.json # records[]: identity_number|employee_name, type, amount, period, end_period empuno data-migration.files.parse --kind payroll_items --file file=primler.xlsx ``` Kalem eklendikten sonra hesaplanmış dönemi yeniden hesaplayın (`payroll.calculate`). Kullanılmış tür silinmez, pasife alınır. Saate bağlı kazançlar (fazla mesai, hafta tatili, UBGT, gece zammı, nöbet) için `calculation_type=hourly_multiplier` türü + kalemde `hours` — bkz. "Puantaj" bölümü. ```bash # Sendika aidatı (GVK 63: matrahtan düşer) — yalnız üyelere; aylık tutar = bir günlük ücret (brüt / 30), tutarı ajan hesaplar empuno payroll-settings.deduction-types.store --name "Sendika Aidatı" --category union --reduces_tax_base true --applies_to assigned empuno payroll-items.bulk --json @aidatlar.json # records[]: identity_number, type: sendika_aidati, kind: deduction, amount, period, end_period # TİS ikramiyesi: brütün yüzdesi; dönem kalemi amount=100 → 1 brüt maaş (50 → yarım) empuno payroll-settings.earning-types.store --name "TİS İkramiyesi" --category bonus --calculation_type percentage_of_gross empuno employees.payroll-items.store 45 --kind earning --type tis_ikramiyesi --amount 100 --start_period 2026-12 # TİS'li işyerinde asgari ücret desteği sınırı (günlük PEK 2.600 TL) empuno payroll-settings.options.update --minimum_wage_support auto --minimum_wage_support_limit collective_agreement ``` **BES kesintisini kesinti türüyle tanımlamayın:** BES otomatik katılım planı (`pension.*`) kesintiyi PEK × oran olarak kendisi yapar; elle tanımlı `pension` kategorili tür varsa kesinti iki kez yapılır (`pension.index` bunu `warnings[]`'te bildirir). ## İş avansı (195), fişli masraf ve cepten harcamanın iadesi **İş avansı** çalışana şirket harcaması için önceden verilen paradır; maaştan kesilmez, **masraflarla kapanır** (maaş avansı 196 ayrıdır, bordrodan taksitle düşer). Çalışan kendi cebinden harcadıysa masraf `funding=out_of_pocket` olur ve onaydan sonra kendisine iade edilir (`expenses.mark-paid` ile iade yöntemi/ref). Bakiye: verilen − onaylı masraf − iade + şirketin ödediği fark ± düzeltme; 0 olunca avans kapanır. ```bash empuno work-advances.store --employee_id 45 --amount 5000 --purpose "Saha turu" --due_on 2026-11-30 # Yönetici çalışan adına fişli masraf: tür/tarih/tutar/KDV AI ile fişten çıkar (Ürün Kuralı #1) empuno expenses.store --employee_id 45 --file receipt=fis.jpg --funding work_advance # Mevcut masrafı avansa bağla / bağı kaldır empuno expenses.work-advance 812 --work_advance_id 7 # Kalan iade edildi (refund) | harcama aştı, fark ödendi (payout) | düzeltme (adjustment, gerekçe zorunlu) empuno work-advances.record-movement 7 --type refund --amount 350 --method bank --reference "EFT 1234" empuno work-advances.show 7 # bakiye, bağlı masraflar, hareketler empuno data-migration.work-advances.commit --json @acik_avanslar.json # geçişte açık bakiyeler ``` - **Kim ödedi** (`funding`): `out_of_pocket` (çalışan — iade edilir, muhasebede 335), `work_advance` (iş avansından — iade yok, 195 kapanır), `company_card`. Vermezseniz kart eşleştiyse kart, değilse cepten sayılır; `work_advance_id` vermeden `work_advance` seçilirse en eski açık avansa bağlanır. - **Muhasebe Excel'i** (masraf raporu paketi): Kim Ödedi, Karşı Hesap (195/335), Kapanış sütunları ve "Finansman Bazında" sayfası. - **Çıkışta** açık iş avansı çıkış ödemesi önizlemesinde not olarak görünür; kalan tahsil edilmeli ya da belgeyle kapatılmalı (vazgeçilen tutar ücret sayılabilir). - **Maaş avansı taksit geçmişi:** `advance-payments.show` → `history[]` (bordro kesintileri dönem dönem + bordro dışı ödemeler; `counted=false` = dönem henüz ödenmedi). Geçmiş taksitleri aktarırken `data-migration.advances.commit` satırında `installments[]` (`period`, `amount`, `source`). ## YK üyesi huzur hakkı, Ar-Ge / teknokent teşviki, SGK meslek kodu Bunlar çalışanın **bordro profilinde** (`employees.payroll-profile.update`) ayarlanır; motor her ay buna göre hesaplar. Profil komutu **kısmi**dir: `effective_from` zorunlu, gönderilmeyen her alan güncel sürümden taşınır (daha sonraki tarih yeni sürüm açar, aynı/önceki tarih düzeltir; açık `null`/`false` temizler). Profili hiç olmayan çalışanda `salary_type`, ücret ve `insurance_group` da zorunludur. Geçmiş sürümler: `employees.payroll-profile.edit` → `history[]`. ```bash # Sigortasız YK üyesi (huzur hakkı): SGK yok, GV kümülatif + DV; başka yerde asgari ücret istisnası kullanıyorsa kapatın empuno employees.payroll-profile.update 45 --insurance_group none --tax_payment_type 014 --mw_exemption_applies false --gross_salary 40000 --effective_from 2026-11-01 # 5746 Ar-Ge merkezi (%80/90/95 GV terkini) — kapsam ay içinde başlıyorsa tarih verin empuno employees.payroll-profile.update 46 --rd_incentive 5746 --rd_tax_exemption_rate 95 --rd_incentive_start 2026-11-16 --gross_salary 120000 --effective_from 2026-11-01 # 4691 teknokent (%100) empuno employees.payroll-profile.update 47 --rd_incentive 4691 --gross_salary 90000 --effective_from 2026-11-01 # Ar-Ge personel türü: destek personeli Ar-Ge + tasarım personelinin %10'u ile sınırlı (tercih rd_support_personnel_ratio 20) empuno employees.payroll-profile.update 48 --rd_personnel_type support --effective_from 2026-11-01 # Ar-Ge GV terkini + DV istisnası işverende kalsın (net teşviksiz hesaplanır, fişte "işverene kalan" kesintisi) empuno payroll-settings.options.update --rd_tax_benefit employer # Yalnız GV terkini işverende (DV istisnası çalışanın netinde) — müşavirin "Ar-Ge GV istisnası, işverene kalır" satırı empuno payroll-settings.options.update --rd_tax_benefit employer_income_tax # APHB meslek kodu empuno employees.update 45 --sgk_occupation_code 2512.01 ``` - **Ar-Ge hesabı:** asgari ücret istisnasından sonra kalan GV × terkin oranı terkin edilir; fazla mesai hariç, brüt asgari ücretin 40 katını aşan kısım teşviksiz. DV aynı payda istisna. SGK: 5510 indiriminden sonra kalan işveren hissesinin (işsizlik hariç) yarısı Hazine desteği. Kapsam ay içinde başlar/biterse teşvikler gün oranında uygulanır ve SGK satırı 05746 + 05510 diye bölünür. - **Ödeme türü** (`tax_payment_type`): boşsa otomatik — asgari ücretliye 011, diğerlerine 012; huzur hakkı 014. Kıdem (013) ve ihbar (015) çıkış ödemelerinden otomatik ayrılır. - **Destek personeli sınırı:** `rd_personnel_type=support` olanlar dönem hesabında işe giriş sırasıyla Ar-Ge + tasarım personeli sayısının %10'u (yukarı yuvarlanır; tercih `rd_support_personnel_ratio` 20) kadar Ar-Ge teşviki alır; sınır dışındaki çalışanın fişinde uyarı vardır ve teşviksiz hesaplanır. Tür boşsa eski davranış (sınır yok). - Henüz desteklenmeyen: uzaktan çalışma oranı sınırı (CBK 10766) — kapsam tarihleriyle yönetin. ## SGK teşvikleri: ön uygunluk, atama, en avantajlı kanun, asgari ücret desteği empuno teşvik **kataloğu** (`empuno reference incentive_codes`: 6111, 14857, 5746, 3294, 2828, 15921, 7103 … — durum, dayanak, yürürlük / işe alım / yararlanma son günü, belge türü, formül, süre kuralı, gereken bilgiler, kaynaklar) ve çalışanın verisiyle (yaş, cinsiyet, işe giriş, engellilik, önceki 6 ayın fişleri) her çalışan için kanun bazlı **ön uygunluk** çıkarır. Türetilemeyen bilgiler (işe girişten önceki 6 ay sigortasız mı, İŞKUR kaydı, mesleki belge, sosyal yardım, işsizlik ödeneği kalan gün) **teşvik bilgisi** olarak bir kez girilir. Dönem hesabında motor çalışanın **aktif** atamaları arasından TL olarak en avantajlı TEK kanunu uygular (5510 puanı birleşebilen kanunlarda dahil); seçilen kanun fişe ve APHB'ye yazılır, `incentive_breakdown` formülü, bileşenleri ve alternatifleri taşır. ```bash empuno reference incentive_codes # katalog; atanabilenler assignable=true empuno payroll-settings.incentives.index --status needs_confirmation --per_page 100 # satır: options[{law_no, status applied|eligible|needs_confirmation|ineligible|expired, reasons[], missing_facts[], # window{start,end,months_total,months_left}, estimated_monthly, gain_monthly}], recommendation, data_gaps[] empuno reference incentive_fact_keys # bilgi anahtarları, türleri, hangi kanunlar kullanıyor empuno employees.incentive-facts.update 45 --uninsured_6_months_before_hire true --iskur_registered_unemployed true empuno payroll-settings.incentives.apply --json @oneriler.json --dry_run true # rows[]{employee_id, law_no?, start_date?, status?} empuno payroll-settings.incentives.apply --all_recommended true # önerisi olan herkes → proposed empuno employees.incentives.update 45 812 --status active # e-SGK tanımlamasından sonra uygula empuno employees.incentives.store 46 --law_no 14857 # elle atama (vars. active, başlangıç işe giriş, süre katalogdan) empuno payroll-settings.options.update --minimum_wage_support auto ``` - **Öneri ≠ uygulama:** `apply` varsayılan olarak `proposed` yazar; motor yalnız `active` atamayı uygular. Teyit gerektiren kanunlar (02828, 26322, 55225/25225, 16322/25510) otomatik önerilmez, aktif atamada `incentive_confirm_required` uyarısı döner. Ön uygunlukta uygun olmayan satır `force=true` olmadan `failed` (`incentive_ineligible` / `incentive_window_ended`). - **Ret kodları** (422, `flash.rule` / satırda `code`): `incentive_unknown_law` (hint: `empuno reference incentive_codes`), `incentive_expired` (`expired: benefit_until …`), `incentive_not_assignable` (05510/00000 firma ayarı `payroll-settings.update --auto_apply_incentive`, 05746 bordro profili), `incentive_dates_invalid`, `incentive_fact_invalid`. - **Süre:** verilmezse katalogdan — 6111'de kadın ve 18–28 yaş erkek: MYK belgesi 48, mesleki-teknik eğitim / İŞKUR kursu 36, diğer 24 ay (+6 İŞKUR kayıtlı); 29+ erkek: belge 24 (+6), belgesiz İŞKUR 6 ay. Bilgi eksikse en kısa süre + uyarı. Atama başlangıç ayı dahil `duration_months` ay uygulanır, süresi dolan fişte `incentive_duration_ended` uyarısı. - **Hesap:** 6111 işveren hissesinin tamamı (PEK üzerinden), 14857 / 3294 asgari ücret tabanı üzerinden işveren hissesi + 5510 puanı, 5746 Ar-Ge kalan işveren hissesinin yarısı (motorun Ar-Ge hesabı), 2828 / 26322 tüm hisseler taban üzerinden, 15921 işsizlik ödeneği süresince. SGDP ve sigortasızda teşvik 0. `payroll-settings.update --auto_apply_incentive false` firmada 5510'u kapatır (kanun 00000). `payroll-settings.update` kısmidir: gönderilmeyen alan (5510 dahil) korunur; 5510 ya da sektör değişirse yanıtta `effects` + `recalculate_required`. - **İlave istihdam (6111, 3294):** şart her ay aranır — dönemde bildirilen sigortalı sayısı çalışanın işe girişinden önceki 6 ayın ortalamasını aşmıyorsa dönem hesabı `incentive_additional_employment_not_met` uyarısı verir (tutar değişmez; müşavirle teyit edin). - **Bordro profilindeki eski alan** `active_incentive_code` normalize edilir (6111 → 06111), katalogda yoksa 422; atanabilir kanun çalışanın atamalarına `legacy_profile` kaynağıyla yansır ve yansıma TEK KAYNAKTIR: satırı reddetmek / silmek / sonlandırmak teşviki durdurur (fişte `legacy_incentive_closed` uyarısı), kodu değiştirmeden profili kaydetmek satırı yeniden açmaz. Yeniden uygulamak: `employees.incentives.update … --status active`. Yeni kayıt için `employees.incentives.store` kullanın. - **Asgari ücret desteği** (`reference minimum_wage_support`): tercih `minimum_wage_support` off (vars.) | auto (önceki yılın aynı ayında düşük PEK'li gün sayısı kadar; 2026: 42,33 TL/gün, günlük PEK sınırı 1.300 — TİS 2.600, yeraltı 3.467: `minimum_wage_support_limit`) | all_days. Destek dönem sonunda **SGK işyeri (sicil) bazında** hesaplanır (her işyerinin tavanı kendi önceki yıl bildiriminden, kalan primle sınırlı; nakil ayında kişinin günü işyerlerine bölünür — beyanla aynı işyeri önceliği; işyeri tanımı yoksa tek grup), fişlere gün oranıyla dağıtılır ve izleyen ay primlerinden mahsup edilir; işveren maliyetinden düşer, net ve SGK primini değiştirmez. Aktarılmış fişler desteğe katılmaz ve değiştirilmez. Kırılım `summary.employer_supports.minimum_wage_support.by_workplace` (+ `--sgk_workplace_id` filtresinde o işyerinin payı). - **Beyan ve özet:** `payroll.declaration` → `summary.employer_supports` (kanun bazında kişi + tutar, Ar-Ge SGK desteği, asgari ücret desteği, işverene kalan Ar-Ge vergi teşviki, BES, işveren maliyeti); `payroll.show` → `employer_supports`; Excel Özet sayfası "İşveren desteği" satırları. - **Simülasyon:** `payroll.simulate` `incentives[]{law_no, start_date, duration_months}`, `apply_5510`, `options.minimum_wage_support` alır; ay satırında `employer_supports` (seçilen kanun, BES, asgari ücret desteği tahmini). - **Geçiş:** `empuno migrate incentive-facts tesvik.csv` (TC + bilgi sütunları + Kanun No + Başlangıç). - **Panelde aynı uçlar:** Bordro Ayarları → **Teşvikler** sekmesi (uygunluk tablosu, öneri, uygula), çalışan bordro profili → Teşvikler kartı ve teşvik bilgileri. Teşvik bilgileri KVKK hassas: yalnız bordro yetkisiyle görünür, çalışan ve mobil uçlarına girmez. ## BES otomatik katılım: plan, katılımcılar, cayma, kurum aktarımı Firma emeklilik şirketi sözleşmesini **plan** olarak ekler (`pension.plans.store`: şirket, sözleşme no, başlangıç, varsayılan oran %3, isteğe bağlı işveren katkısı). Plan başlangıcından SONRA işe giren, 45 yaşını doldurmamış Türk vatandaşı çalışan (sigorta grubu normal / SGDP) dönem hesabında otomatik dahil edilir; öncekiler `pension.sync` ile (önce `--validate`). Kesinti her ay PEK × oran'dır: netten düşer, GV matrahından indirilmez; fişte BES satırı ve `pension_employee_contribution`. 45+ yalnız talebiyle (`voluntary=true`), doğum tarihi boş olan "teyit gerekli" (otomatik dahil edilmez; plan sonrası işe girdiyse dönem hesabı `pension_enrollment_needs_birth_date` uyarısı verir — doğum tarihini girip yeniden hesaplayın ya da `employees.pension.store`), yabancı uyruklu kapsam dışıdır. ```bash empuno pension.plans.store --provider_name "Örnek Emeklilik" --contract_no GRP-123 --starts_on 2026-01-01 [--employer_contribution_type fixed --employer_contribution_value 250] empuno pension.sync --validate # kimler dahil olur (45+, yabancı, doğum tarihi boş, plan öncesi giriş nedenleriyle) empuno pension.sync --include_existing_hires true # plan öncesi işe girenleri de dahil et empuno pension.index --status active --per_page 100 # katılımcılar + istatistik + son 20 hareket empuno employees.pension.show 45 # kayıt, kapsam, yapılabilir işlemler (can{}), hareketler, kesinti geçmişi empuno employees.pension.action 45 301 --action opt_out # cayma: bildirimden 2 ay içinde empuno employees.pension.action 45 301 --action pause --until 2027-03-31 empuno employees.pension.action 45 301 --action rate_change --rate 5 empuno employees.pension.update 45 301 --certificate_no SRT-123 --notified_at 2026-10-15 empuno payroll.pension-transfer 2026-10 # kurum aktarım listesi (TCKN maskeli), son gün, durum empuno payroll.pension-transfer-export 2026-10 --plan_id 2 --output bes-2026-10.xlsx empuno payroll.pension-transfer-mark 2026-10 --plan_id 2 --reference "DEKONT-55" # tekrar güvenli empuno migrate pension bes.csv --validate # önceki sistemin katılımcı listesi ``` - **Kurallar** (4632 ek md. 2; Yönetmelik 22/E–22/I, `reference pension_actions`): cayma yalnız plana dahil olduğunun bildirildiği tarihten (yoksa dahil olma) itibaren 2 ay içinde — sonrası 422 `pension_opt_out_deadline_passed` (hint: `leave_system` ya da `pause`); başlangıç döneminde ayrılma/ara verme yerine cayma (`pension_use_opt_out`); oran %3'ün altına inemez (`pension_rate_below_legal`). Cayma iadesini emeklilik şirketi 10 iş günü içinde yapar — **bordrodan iade yapılmaz**. İşlemler hemen uygulanır, sonraki hesapta kesinti buna göre yapılır/durur; her işlem hareket olarak yazılır. - **Çalışan talebi** (web Bordrom → BES kartı, mobil `/api/v1/pension`): cayma, ayrılma, ara verme, devam, oran, katılım — yönetici onayı beklemez; `payroll.manage` yetkilileri uygulama içi bildirim alır, e-posta gitmez. Aynı talep tekrarlanırsa yazılmaz. - **İşveren katkısı:** tercih `bes_employer_contribution` wage (vars.; brüte kazanç olarak eklenir — SGK'da asgari ücretin %30'una kadar istisna, GV/DV'ye tabi — ve aynı tutarda karşı kesintiyle şirkete aktarılır, net değişmez) | expense_only (yalnız işveren maliyeti). Brüt yüzdesi (`percent_of_gross`) KAZANILAN ücret üzerinden — ay içinde giren / çıkan çalışanda kıst; sabit tutar aylıktır. Kesinti sırası: `bes_deduction_order` before_garnishment (vars.; icra matrahından önce) | after_garnishment. - **Kurum aktarımı:** son gün ücret ödeme gününü izleyen ilk iş günü (dönem `paid_at`); `overdue` bayrağı. Excel plan başına sayfa + "Kesinti Yok" (caydı / ara veriyor / ayrıldı). "Aktarıldı" işareti dönem + plan başına tektir. - **Kaynak sözleşmesi** (`reference payroll_line_sources`): çalışan kesintisi `source_type=App\Models\EmployeePensionEnrollment`, işveren katkısı kazancı `bes_employer_contribution` + karşı kesinti `pension_employer_passthrough`, işverene kalan Ar-Ge vergi teşviki `rd_employer_benefit`. - **Panelde aynı uçlar:** Bordro Ayarları → **BES** sekmesi (planlar, katılımcılar, toplu dahil et, hareketler), çalışan bordro profili → BES kartı, dönem ekranı → Çıktılar → BES Aktarım Listesi. ## SGK (APHB) + MUHSGK mutabakatı Hesaplanmış ya da aktarılmış her dönem için müşavirin beyannameyle satır satır karşılaştıracağı veri: SGK satırları (belge türü, kanun no, prim günü, hak edilen ücret + prim/ikramiye, eksik gün sayısı ve nedeni, giriş/çıkış + çıkış kodu, meslek kodu, işyeri sicil no, işçi/işveren payları, teşvik, Ar-Ge desteği), vergi satırları (ödeme türü başına GV matrahı, hesaplanan GV, asgari ücret istisnası, Ar-Ge terkini, GV/DV kesintisi), bordro detayı ve özet. Toplamlar fişlerle kuruşu kuruşuna tutar. Yan etkisizdir (GET). ```bash empuno payroll.declaration 2026-04 # JSON: sgk_rows[], tax_rows[], detail_rows[], summary, warnings[], attributes{} empuno payroll.declaration-export 2026-04 --output mutabakat.xlsx # Özet · SGK (APHB) · Vergi (MUHSGK) · Bordro Detayı · Uyarılar (+ işyeri sayfaları) empuno payroll.declaration 2026-04 --sgk_workplace_id 2 # yalnız bir SGK işyeri (MUHSGK her sicil için ayrı) # Tek fişi düzelt (yalnız gönderilen alanlar; null siler; denetim kaydı tutulur) empuno payroll.declaration.update 2026-04 101 --insurance_group none --tax_payment_type 014 --reason "YK huzur hakkı" empuno payroll.declaration.update 2026-04 107 --missing_day_count 1 --missing_day_reason 15 empuno payroll.declaration.update 2026-04 103 --rd_law 5746 --rd_rate 95 --rd_income_tax_exemption 12450.30 --rd_sgk_support 4120.55 # Toplu (aktarılmış aylar): yalnız beyan alanları empuno migrate payroll beyan.csv --on_existing update --update_fields declaration --validate ``` - **Kaynak kuralı:** fişteki açık değer (aktarım ya da elle düzeltme) > türetme > varsayılan. Aktarılmış fişte çalışanın BUGÜNKÜ bordro profili okunmaz (geçmiş ay bugünkü ayarla yeniden yorumlanmaz). Her SGK/vergi satırında `sources{}` alanın nereden geldiğini söyler: `import` (aktarım), `manual` (elle düzeltildi), `derived` (türetildi), `profile` (bordro profili), `employee` (çalışan kartı), `auto` (asgari ücretten), `engine` (empuno hesapladı), `none`; açıklaması `notes{}`. - **Türetme:** kanun no aktarılmış fişte `employer_incentive_code`'dan (5510 → 05510; listede olmayan 5 haneli kod "Kanun XXXXX" ile aynen girer), empuno fişinde teşvik tutarı > 0 → 05510. Belge türü işçi payı %7,5 ve işsizlik 0 ise 02 (SGDP), değilse 01. İşçi SGK = işçi prim toplamı − işsizlik payı. Ödeme türü: aktarılmış fişte sigortasız (`insurance_group=none` ya da PEK = 0 kuralı) → 014 (huzur hakkı); dönemin parametre seti varsa (2021–2026 hepsinde var; 2022 öncesi her zaman 012) ücret ≤ brüt asgari ücret → 011, değilse 012 — çıplak ücret aktarılmamışsa toplam brüt − ek kazanç − fazla mesai; fişteki vergi kesintisi bununla çelişirse (asgari ücretli ama GV/DV kesilmiş, ya da asgari ücretin üstünde ama GV = DV = 0) tür yine ücretten gelir, `info` satırı `payment_type_tax_mismatch` müşavirin beyanını kontrol etmenizi söyler; set yoksa GV ve DV 0 ise 011. Farklıysa `tax_payment_type` verin. Kanun no 05746 iken Ar-Ge günü boşsa tüm prim günü Ar-Ge sayılır; eski veride açık 0 varsa yine tüm gün sayılır ve `rd_days_conflict` uyarısı döner. - **PEK = 0 kuralı:** brüt ödemesi olup SGK matrahı ve primi 0 olan kişi sigortasız sayılır, APHB'ye girmez (bilgi `treated_as_uninsured`) ve MUHSGK ana satırı 014 (huzur hakkı) türetilir; `insurance_group=none` her durumda APHB dışıdır, yalnız vergi satırı alır. Brütü 0 olan ya da eksik gün nedeni verilmiş 0 PEK'li sigortalı APHB'de 0 günlük satır olarak kalır — `missing_day_count` + `missing_day_reason` ekleyin. - **Kıdem / ihbar dağıtımı (MUHSGK):** kalemin vergisi aktarımda verilmişse (`earnings[].income_tax` / `stamp_tax`) 013/015 satırı aynen alır. Verilmemişse kalem DV = kalem tutarı × binde 7,59, GV kalem matrahı oranında (artan oranlı tarifede yaklaşık — kesin değer için kalem vergisini gönderin). Asgari ücret ve Ar-Ge istisnaları önce ücrete, artarsa ihbara, sonra kıdeme; ücret satırı kalanı alır, toplamlar fişle tutar. Hesaplanan GV = kesilen + AÜ istisnası + Ar-Ge terkini. - **Uyarılar:** `warnings[].level` = `warning` (beyandan önce tamamlanmalı: eksik TC, Ar-Ge tutarı yok, kanun no 05746 ama Ar-Ge günü 0 (`rd_days_conflict`), eksik gün nedeni yok…) | `info` (türetme açıklaması: sigortasız sayıldı, SGDP türetildi, işsizlik payı yok, ödeme türü türetildi, ödeme türü vergi kesintisiyle çelişiyor — `payment_type_tax_mismatch`). Aktarılmış dönemde `summary.source_coverage` hangi beyan alanının kaynaktan geldiğini, hangisinin türetildiğini sayar. - **Düzeltme:** `payroll.declaration.update <çalışan>` — aktarılmış fişte tüm beyan alanları (kırılım değişince yalnız türevler yeniden kurulur: hesaplanan GV/DV, işveren SGK − teşvik − Ar-Ge desteği); empuno'nun hesapladığı fişte yalnız tutarı etkilemeyenler (eksik gün nedeni, meslek kodu, işyeri sicil no, ödeme türü) — belge türü, kanun no ve sigorta türü 422 döner; prim günü temizlenemez (boş/null 422): bordro profili / çalışan kartı düzeltilip dönem yeniden hesaplanır (kesinleşmişse önce `payroll.reopen`). Elle düzeltme yeniden hesaplamada korunur. Yanıt `updated {type: payroll_slip, id, fields}`; değişiklik yoksa `fields` boş. Fiş detayı (`payroll.employee-slip`) aynı değerleri `declaration` altında okur. - **Eksik gün nedeni** empuno'nun hesapladığı fişe hesap anında yazılır: 01 istirahat, 21 diğer ücretsiz izin, 15 devamsızlık, 06 kısmi süreli çalışma, 07 puantaj (çalışma şekli girilmemiş saatlik), 13 diğer (kırılımla karşılanmayan eksik gün), 12 birden fazla, 25 kanun bölünmesi; puantajı olan çalışan-ayda neden puantajın `missing_breakdown`'ından (gün kodlarının SGK karşılığı: 19, 20, 18, 03 …) gelir — bkz. "Puantaj" bölümü. Bu özellikten önce hesaplanmış empuno fişinde neden boştur (uyarı döner) — dönemi yeniden hesaplayın. Aktarılmış dönem yeniden hesaplanmaz: nedeni `payroll.declaration.update` ya da `--update_fields declaration` ile gönderin; neden verilip sayı verilmezse eksik gün = 30 − prim günü sayılır. - **SGK işyeri:** her satırda `sgk_workplace_id`, `workplace_name`, `workplace_registration_no(_formatted)` ve `workplace_source` (segments | slip | registration_no | registration_no_unmatched | timeline | default | none). Nakil ayında kişi işyeri başına satır alır; `--sgk_workplace_id` filtresi ve `summary.by_workplace` için bkz. "Çalışma dönemleri" bölümü. Firmada SGK işyeri tanımı yoksa çıktı işyerisiz eski hâliyle aynıdır. - Excel'de kod sütunları metindir (05510, 01 baştaki sıfırla kalır); SGK sayfasında İşyeri Sicil No ve Kaynak (işyeri tanımlıysa İşyeri), Uyarılar sayfasında Düzey sütunu; birden çok işyeri varsa İşyerleri + "APHB – " sayfaları. GİB/SGK XML'i üretilmez (şema kamuya açık değil); dosya mutabakat ve beyan girişi içindir. ## Raporlar: bordro dökümü, icmal, GV listesi, personel listeleri, ücret hesap pusulası Luca "Raporlar" menüsünün karşılıkları. Hepsi yan etkisiz GET; aynı komut `--format json` (vars.) | `xlsx` | `pdf` verir (dosyada `--output`). Kaynak kayıtlı fişler ve çalışma dönemleri; iptal edilmiş / silinmiş dönem hiçbir rapora girmez. Bordro raporları ve pusula `payroll.view`, personel raporları `employees.view` ister (ücret sütunu ayrıca `payroll.view`). Rapor adları: `empuno reference payroll_reports` / `personnel_reports`. ```bash empuno reports.payroll --report register --period 2026-10 # bordro dökümü: kişi başına tüm kazanç/kesinti/matrah/vergi + TOPLAM empuno reports.payroll --report icmal --period 2026-10 --format pdf --output icmal.pdf # işyeri/bölüm kırılımlı icmal + kanun kırılımı empuno reports.payroll --report yearly --year 2025 # kişi başına yıl toplamı + yıl sonu kümülatif GV matrahı empuno reports.payroll --report income_tax --year 2025 --format xlsx --output gv.xlsx # kişi × ay GV matrahı ve GV empuno reports.payroll --report salary_summary --period 2026-10 # net, kesinti, banka (IBAN maskeli) empuno reports.payroll --report rd --period 2026-10 # Ar-Ge / Ar-Ge dışı (istisnalar, SGK desteği) empuno reports.payroll --report employee_info --period 2026-10 --sgk_workplace_id 8 empuno reports.personnel --report list --as_of 2026-11-11 --include_leavers 1 --show_salary 1 --show_bank 1 empuno reports.personnel --report registry --as_of 2023-06-30 # o tarihteki işyeri sicili (sicil geçmişinden) empuno reports.personnel --report exits --from 2026-01-01 --to 2026-10-31 # SGK + İŞKUR çıkış nedeni, nakil işaretli empuno reports.payslips --period 2026-10 --output pusulalar.pdf # ücret hesap pusulası (4857 md. 37), dönemin tümü empuno reports.payslips --period 2026-10 --employee_ids 45 --format json # tek kişi, belge verisi empuno payroll-settings.update --payslip_note "Ücretiniz her ayın 5'inde yatırılır." # pusulanın altına basılır ``` Aktarılmış (müşavir) fişlerde SGK işçi payı bileşenlere ayrılmadan geldiyse rapor `SGK toplamı − işsizlik işçi payı` gösterir; fişte işyeri yoksa dönem sonundaki çalışma dönemi işyeri (sigortasız dönemde boş) kullanılır. Çalışan kendi pusulasını panelde Bordrolarım → PDF ile indirir. ## Zorunlu personel evrakı ve eksik evrak listesi Kurulum gerekmez: varsayılan liste işe girişte iş sözleşmesi, SGK işe giriş bildirgesi, KVKK aydınlatması, işe giriş sağlık raporu (İSG) ve kimlik belgesi (kimlik kartı / pasaport / diğer — biri yeterli); işten çıkışta SGK işten ayrılış bildirgesi ve istifa dilekçesi / fesih bildirimi / devir protokolünden biri. Firma kalemleri açar/kapatır (diploma, ikametgâh, nüfus kaydı, adli sicil, askerlik — yalnız erkek, NDA, ibraname, kıdem/ihbar hesabı). Kalemler: `empuno reference document_requirements`. Okuma `documents.view`, liste değişikliği `documents.manage`. ```bash empuno documents.missing # aktif çalışanlarda eksik zorunlu evrak (yalnız eksiği olanlar) empuno documents.missing --status terminated --requirement termination_basis # ayrılanlarda istifa/fesih belgesi eksik olanlar empuno documents.missing --employee_id 45 # tek çalışan (eksiksizse missing_count 0) empuno documents.requirements # firmanın listesi (source: default | company) + tüm kalemler empuno documents.requirements.update --json '{"required":{"onboarding":["is_sozlesmesi","sgk_ise_giris","kvkk","isg","identity","diploma"]}}' ``` **Kimlik belgesi (AI):** `employees.identity-documents.store <çalışan> --file file=./kimlik.pdf` (PDF, ilk 3 sayfa) ya da `--file images[]=./on.jpg --file images[]=./arka.jpg` — yapay zekâ türü (kimlik / pasaport / ehliyet) ve alanları (ad, soyad, TC, doğum tarihi, cinsiyet, uyruk) okur, belge saklanır; `apply=missing` (vars.) çalışanın yalnız BOŞ alanlarını doldurur, dolu alanın üzerine yazmaz; `apply=none` yalnız `field_diff` döner. Yanıt `data.document`, `extracted`, `field_diff[]`, `applied{}`, `skipped{}`, `credits_consumed` (sayfa başına 1 AI kredisi; yetersizse 402 `insufficient_credits`). Üzerine yazmak için `employees.identity-documents.apply <çalışan> --json '{"fields":{"first_name":"Ayşe"}}'`; liste `employees.identity-documents.index <çalışan>`. Yetki `identity_documents.view|manage`; belge çalışana gösterilmez (KVKK), bildirim yok, deneme (`--validate`) desteklenmez (AI + dosya). Yanıt: `summary` (employees_checked, employees_with_missing, missing_total, `by_requirement` kalem başına eksik çalışan sayısı) ve sayfalı `rows` (çalışan + `missing[]`: key, stage, label, types). İşe giriş aşaması her çalışana, çıkış aşaması yalnız ayrılana uygulanır; kalemin türlerinden biri yüklüyse tamamdır. `documents.requirements.update` aşamanın listesinin tamamını alır, gönderilmeyen aşama aynen kalır; boş liste o aşamada hiçbir evrakı zorunlu tutmaz. Eksik evrakı `employees.documents.store` (kimlik için `employees.identity-documents.store`) ya da toplu `migrate documents` ile tamamlayın. ## Luca Köprüsü: gelen zarflar ve Luca bordrosu ↔ kayıtlı fişler Firma bir Luca şirketine eşliyse (eşleme empuno ekibinde; eşli değilse 404) Luca'dan gelen zarfları ve her zarf türünün empuno'da neye yansıdığını görürsünüz. Yetki `luca_bridge.view`; başarısız zarfı yeniden işletmek `luca_bridge.manage`; bordro karşılaştırması ayrıca `payroll.view` ister. Luca verisi canlı kayıtlara doğrudan yazılmaz: personel kartı ve bordro geçmişi yalnız önizleme + onaylı aktarımla güncellenir. ```bash empuno luca-bridge.index # özet: zarflar, yansımalar, son personel / bordro aktarımı empuno luca-bridge.envelopes --status failed [--type export.bundle] [--year 2026] empuno luca-bridge.envelopes.reprocess 01M71C… # başarısızı sunucuda yeniden işlet empuno luca-bridge.payroll-compare --status issues # yalnız farklı / eksik kişi-aylar empuno luca-bridge.payroll-compare --year 2023 --per_page 100 # Luca'ya geri aktarım (Luca yazma servisi yok, bordroyu kendisi hesaplar; yükleme Luca ekranından) empuno luca-bridge.export.timesheet --period 2026-10 --sgk_workplace_id 8 --output puantaj.zip # CSV + manifest.json empuno luca-bridge.export.personnel --period 2026-10 --mode new --output personel.zip # LUCA Personel Giriş Şablonu empuno luca-bridge.export.timesheet --period 2026-10 --format manifest # yalnız manifest (JSON) empuno luca-bridge.export.index --period 2026-10 --format xlsx --output kontrol.xlsx # mali müşavir kontrol listesi # Luca'dan empuno'ya: Luca'nın kendi dosyaları olduğu gibi okunur (önce parse, sonra ilgili commit) empuno payroll.attendance.parse --file file=./puantaj_2026_11_ALSANCAK.csv # Luca puantaj CSV / XLS / detaylı XLS empuno data-migration.files.parse --kind employees --file file=./personel_rapor.xls # Luca personel Excel'i empuno data-migration.files.parse --kind payroll --file file=./bordro_2026_11.xlsx # Luca "Bordro" Excel'i ``` **Luca'ya aktarım:** `luca-bridge.export.timesheet` Luca'nın puantaj CSV'sini üretir (işyeri × ay; ISO-8859-9, `;`, her alan tırnaklı; gün kodları N normal, H hafta tatili, T resmi tatil, S yıllık izin, R rapor, E eksik gün, İ diğer izin; eksik gün nedeni SGK kodu). Ay içinde giren/çıkan kişiye Luca toplu puantaj uygulamaz → dosyada değil `manifest.manual[]`'da (gün kodlarıyla); sigortasız ve Luca'da kartı olmayanlar `excluded[]`. `luca-bridge.export.personnel` Luca'nın boş "LUCA Personel Giriş Şablonu"nu doldurur (`--mode new` Luca'da kartı olmayanlar, `update` işyerinin tüm personeli; güncellemede empuno'da boş alan Luca kartındaki değerle). Varsayılan çıktı zip (dosya + `manifest.json`: sha256, satır, `expected` = empuno fişlerinden kişi sayısı, brüt, net, SGK işçi, işsizlik, GV, DV — Luca hesapladıktan sonra karşılaştırma için); `--format file` | `manifest`. Yan etkisiz; Luca eşlemesi şart değil. Yetki `luca_export.view` (mali müşavirlerde varsayılan `luca_export.manage`) + `employees.view` (personelde ve kontrol ekranında + `payroll.view`). Yüklemeyi mali müşavir yapar: önce `luca-bridge.export.index` (puantaj, elle girilecek / dosyada olmayan kişiler, kart eksikleri, empuno bordrosu; `--format xlsx` kontrol listesi) ile inceler. **Yükleme izi:** `luca-bridge.export.packages.store --period 2026-10 --kind timesheet|personnel_update|personnel_new --status reviewed|uploaded --content_sha256 ` kim / ne zaman kaydı tutar; dosya indirildikten sonra veri değiştiyse `rule=content_changed`, aynı ay × işyeri × tür zaten yüklendiyse `rule=already_uploaded` (önce `luca-bridge.export.packages.destroy --reason …` ya da `--force true --notes …`); aynı içerikle tekrar no-op. Liste `luca-bridge.export.packages` (`changed_since`: yüklendikten sonra veri değişti mi). **Luca'dan empuno'ya dosya (aynı biçimler, ters yön):** mali müşavirin Luca'dan indirdiği dosyalar dönüştürülmeden okunur; yanıtta `source_format` hangi Luca düzeninin tanındığını söyler. Puantaj (`payroll.attendance.parse`, `luca_csv` | `luca_xls` | `luca_xls_detailed`): Luca gün kodları yalnız Luca dosyasında uygulanır (N/G/O çalıştı, H hafta tatili, T resmi tatil, S yıllık izin, R rapor, İ ücretli izin; E eksik gün nedenine göre — 21 ücretsiz izin, 15 devamsızlık …; Y/K/C yarım gün `unknown_codes`), dönem AY+YIL ya da başlıktan, detaylı XLS'te Fazla Mesai / Gece Mesaisi saatleri puantaja girer, NET tutar kolonları `luca_extras[]`'ta listelenir (yazılmaz); kayıtlar `payroll.attendance.commit`'e. Personel (`data-migration.files.parse --kind employees`, `luca_personnel`): Luca'nın 40 kolonlu şablonu / "Rapor" çıktısı, kredisiz; NET ücret kart maaşına yazılmaz (not), kanun no / SGK grubu / net-brüt `luca{}` ipucu; kayıtlar `data-migration.employees.commit`'e (`--on_existing update` kart alanlarını Luca'ya göre günceller; yalnız harf büyüklüğü farklı ad ezilmez). Bordro (`data-migration.files.parse --kind payroll`, `luca_payroll`): Luca "Bordro" Excel'i → `data-migration.payroll.commit` (kayıtlı fiş varsa varsayılan skip); Luca kuralları: kesilen GV = Gel.Ver. − 5746 GV İst., SSK Teşviki 5746 Ar-Ge SGK desteğini de içerir (ayrım dosyada yok, satıra not), Net Kazanç özel kesintiden sonraki ele geçendir. Forwardie'nin 67 aylık Luca Bordro dosyası kayıtlı 1.700 fişle 20.400 alanda farksız. `payroll-compare` yan etkisizdir: `summary.statuses` (match, diff, no_slip, no_period, no_employee, not_in_luca), `summary.fields` (alan başına fark sayısı), `months[]` ve sayfalı `rows` (her satırda `diffs.{alan}: {luca, empuno, delta}`). Luca nakil ayında aynı kişi için birden çok bordro gönderirse kişi-ayda toplanır; kümülatif GV matrahı ayın son değeridir. `not_in_luca`: empuno'da fiş var, Luca'da o kişi-ay bordrosu yok. ## Bordro çıktıları: muhasebe fişi ve banka maaş dosyası Hesaplanmış ya da aktarılmış her dönem için iki dosya: **muhasebe fişi** (yevmiye: ücret gideri, SGK işveren payı, 335 net ödeme, 360 GV + DV, 361 SGK, kesintiler ve destekler; borç = alacak kuruşu kuruşuna, fişlerle mutabakat) ve **banka maaş ödeme dosyası** (IBAN + tutar listesi; bankanın internet şubesine yüklenir). Önizlemeler yan etkisizdir (GET). Hiçbir dosya muhasebe programına ya da bankaya otomatik GÖNDERİLMEZ. ```bash # Muhasebe fişi empuno payroll.accounting-voucher 2026-10 # JSON: lines[], totals.balanced, accounts[], reconciliation, warnings[], mapping.defaults_used empuno payroll.accounting-voucher 2026-10 --format luca --output fis.xlsx # Luca fiş aktarımı (400 satırda kişi sınırından bölünür) empuno payroll.accounting-voucher 2026-10 --format csv --detail per_employee # kişi bazında; ; ayraç, ondalık virgül, UTF-8 BOM empuno payroll.accounting-voucher 2026-10 --kind payment --format empuno_xlsx # ödeme fişi: 335 borç / 102 alacak empuno payroll.accounting-postings.store 2026-10 --voucher_no 2026100001 # muhasebeleştirildi işareti (kesinleşmiş/ödenmiş dönem) empuno payroll.accounting-voucher 2026-10 --kind correction # dönem sonradan değiştiyse fark fişi empuno payroll.accounting-postings.store 2026-10 --kind correction # Hesap planı eşlemesi (varsayılan Tekdüzen hesapları; firma planınıza göre bir kez) empuno reference payroll_account_lines # kalemler, varsayılan hesap, yedek zinciri, firma eşlemesi empuno payroll-settings.accounting.suggest --file file=./mizan.xlsx --apply true --validate # hesap planından öneri (AI yok) empuno payroll-settings.accounting.mappings.update --json '{"mappings":[{"line_key":"net_pay","account_code":"335.01"},{"line_key":"wage","account_code":"{root}.01"},{"line_key":"expense_root","scope_type":"department","scope_id":7,"account_code":"760"}]}' empuno payroll-settings.accounting.options.update --voucher_detail per_employee --employer_support_treatment other_income # Banka maaş ödeme dosyası empuno reference bank_file_presets # önayarlar + doğrulama durumu (documented | partial | unverified) empuno payroll.bank-file 2026-10 --template preset:halkbank_dto_iban --params.customer_no 01234567 --params.debit_iban TR… empuno payroll.bank-file.generate 2026-10 --template preset:halkbank_dto_iban --payment_date 2026-11-05 --confirm_total 1234567.89 --output maas.xlsx empuno payroll.bank-file.request-iban 2026-10 --validate # IBAN'ı eksik/geçersiz olanlar (push + e-posta; 24 saatte bir) # Bankanın / programın kendi şablonu empuno payroll-settings.export-templates.detect --kind bank --file file=./garanti_ornek.xlsx --store true --name "Garanti maaş" empuno payroll-settings.export-templates.store --kind bank --preset ziraat_maas_liste --params.customer_no 12345 --is_default true empuno payroll-settings.export-templates.update 3 --params.debit_iban TR… # yalnız gönderilen alanlar; params. null → siler empuno payroll-settings.export-templates.preview --kind bank --template template:3 --period 2026-10 # son onaylı dönemden ilk 3 satır (maskeli; dosya üretmez) empuno payroll-settings.export-templates.preview --kind voucher --template luca --json '{"definition":{"columns":[{"field":"account_code","title":"Hesap"},{"field":"department","title":"Departman"},{"field":"debit","title":"Borç"}]}}' ``` - **Varsayılan hesaplar (Tekdüzen):** ücret ve SGK işveren payı gideri `{root}` (departman/şube gider kökü; vars. 770 Genel Yönetim), net ücret 335, GV ve DV 360, SGK (işçi + işveren + işsizlik) 361, avans mahsubu 196, icra/nafaka/sendika/BES/diğer kesinti 336, teşvik ve Ar-Ge desteği (tercihe göre giderden indirilir ya da 602), asgari ücret desteği alacağı 136, kuruş farkı 649/659, banka 102. Firmanın eşlemesi yoksa fiş yine dengelidir; `mapping.defaults_used` hangi kalemin varsayılanla yazıldığını söyler. - **Bütünlük:** fiş başına 1,00 ₺'yi aşan iç fark kuruş farkı değildir — askı satırına (399 / 199) yazılır ve yanıtın `integrity` bloğunda listelenir: `ok`, `blockers[]` (`slip_inconsistency`, `employer_cost_gap`), `inconsistent_slips`, `inconsistent_total`, `slips[]` (slip_id, employee_id, amount, `findings[]`: `net_mismatch` | `deduction_rows_missing` | `earnings_exceed_gross` | `employer_side`). `ok=false` iken `can_post=false`; `payroll.accounting-postings.store` 422 `voucher_integrity` döner, bilerek işaretlemek için `--accept_integrity_issues true`. Kaynağı düzeltin: aktarılan fişte her ek kesinti `deductions[]` satırıyla, işverende kalan Ar-Ge terkini `type: rd_retained` ile gönderilir. - **Eşleme çözüm sırası:** çalışan → departman → şube → firma geneli → varsayılan; bulunamazsa yedek zincir (ör. `deduction:` → `deduction_category:` → `deduction_other`). Gider kalemlerinde `{root}` yer tutucusu departman/şube gider köküne (`line_key=expense_root`, scope_type department | branch) çözülür: `wage` → `{root}.01` ile her masraf merkezi kendi 7xx hesabına yazar. account_code=null eşlemeyi siler (varsayılana döner); her satırda account_code anahtarı ZORUNLU, account_name/cost_center gönderilmezse korunur. - **Aktarılan kesintiler:** önceki sistemden tipli gelen kesinti (`import:`) türünden eşlenir; yalnız adıyla gelen eski kesinti adına göre sınıflanır (avans → 196, icra/haciz, nafaka, sendika, BES → 336, Ar-Ge) ve `import_deduction_classified` uyarısı döner — yanlışsa `import_deduction:` satırını (reference payroll_account_lines) doğru hesaba eşleyin. - **Fiş türleri:** tahakkuk (accrual), ödeme (payment: 335 / 102), düzeltme (correction = güncel tahakkuk − muhasebeleştirilmiş kayıtlar; yalnız fark satırları). Muhasebeleştirme işareti yalnız kesinleşmiş/ödenmiş dönemde; aynı özet tekrar gönderilirse yeni kayıt açılmaz. Tahakkuk sonrası dönem düzeltildiyse (payroll.reopen) `payroll.show` → `outputs.changed_after_posting=true` ve tahakkuk tekrarı 422 `already_posted`. `outputs.change_kind`: `amounts` (bordro tutarı değişti) | `reclassification` (tutarlar aynı; hesap/masraf merkezi eşlemesi ya da fiş tercihi değişti — düzeltme fişi yalnız hesaplar/masraf merkezleri arası aktarım satırı içerir). - **Masraf merkezi:** satırda `cost_center` görünen ad, `cost_center_key` kararlı kimliktir (`department:` | `branch:` | `code:`); toplama, muhasebeleştirme özeti ve düzeltme kimliğe bakar — departmanı yeniden adlandırmak muhasebeleştirilmiş dönemi değiştirmez. Boyut kaynağı `cost_dimensions {basis, snapshot, frozen, current}`: fişin hesap anındaki departmanı/şubesi (snapshot) > muhasebeleştirmede dondurulan (frozen; aktarılan/eski fişler) > çalışanın bugünkü departmanı (current, `cost_dimension_current` uyarısı). Muhasebeleştirince current fişler dondurulur: sonradan başka departmana taşınan çalışan geçmiş ayın gider dağılımını kaydırmaz; işaret geri alınırsa dondurma kalkar. Satırda `department` / `branch`: satır tek departmana/şubeye aitse adı (kişi bazında her satırda) — fiş dosyasının Departman/Şube sütunları buradan dolar. - **Biçimler:** `empuno_xlsx` (Fiş · Hesap Özeti · Eşleme · Mutabakat · Uyarılar sayfaları), `csv`, `luca` (kısmen doğrulandı: fiş başına en çok 400 satır, dosya başına 50 fiş — kişi bazında fiş kişi sınırından dengeli parçalara bölünür, özet fiş bölünmez + `voucher_too_long`), `merkezihesap` (doğrulanmadı) ya da firma şablonu (`template:`). Dosyada hesap kodları ve TCKN metin hücresidir (335.01, 05510 bozulmaz). - **Banka dosyası:** ödenecek tutar fişin net ödemesidir (avans, icra ve diğer kesintiler düşülmüş; kırılım `deductions{}`). Dışarıda kalanlar `excluded[].reason`: iban_missing, iban_invalid (mod-97), iban_foreign, iban_duplicate (aynı IBAN birden çok kişide → hepsi), non_positive_net. Banka önayarında `same_bank_only` açıksa başka bankadakiler `other_bank[]`'a ayrılır (`--include_other_banks true` ya da genel şablon). source=revision + revision_id: düzeltme turunun yalnız ek ödeme farkları. - **Şablon önizlemesi** (`payroll-settings.export-templates.preview`): kaydetmeden, son onaylı dönemin (fişte yoksa son hesaplanmış; `--period` ile seçilir) ilk satırlarını şablona göre biçimlenmiş döndürür — başlık, üst bilgi, `rows[[…]]`, csv/txt için dosya metni `text`; IBAN, hesap no ve TCKN uzunluk korunarak `*` ile maskeli. `--template` taban, `--definition` / `--params` üstüne yazılır (editördeki taslak). Yan etkisiz; bilinmeyen alan `unknown_field` uyarısı. - **Önayarların doğruluğu:** `halkbank_dto_iban` resmî kılavuzla birebir (documented: A1–A8 üst bilgi, 11. satır başlık, 12. satırdan kayıt; müşteri no + borçlu IBAN zorunlu parametre); diğer banka önayarları genel liste biçimidir (unverified) — ilk dosyayı bankanın ekranında karşılaştırın ya da bankanızın örnek dosyasını `export-templates.detect` ile şablona çevirin. - **Üretim kuralları:** önizleme her hesaplanmış dönemde; dosya yalnız onaylanmış/kesinleşmiş/ödenmiş dönemde (422 `not_approved`). Önce `payroll.bank-file` ile `totals.amount`'ı okuyup `--confirm_total` gönderin (değiştiyse 422 `total_changed`). Aynı içerik 10 dakika içinde tekrar üretilirse aynı kayıt döner (X-Empuno-Duplicate: 1). Meta başlıklarda: X-Empuno-Rows, X-Empuno-Total, X-Empuno-Excluded, X-Empuno-Payment-File-Id. Üretim denetim kaydına yazılır; IBAN ve dosya içeriği SAKLANMAZ. Denemede (`--validate`) çalışmaz — önizleme zaten yan etkisiz. - **IBAN isteme** (`payroll.bank-file.request-iban`): IBAN'ı eksik ya da geçersiz olan ve aktif hesabı bulunan çalışana push + e-posta (IBAN/tutar yok); çalışan başına 24 saatte bir. Bildirime dokunan çalışan mobilde profil tamamlamanın Banka / IBAN adımına, web'de profil düzenlemeye gider; Bordrom ekranındaki "Maaş hesabı" kartı da durumu gösterir. IBAN her yerde mod-97 ile doğrulanır. - **Panelde aynı uçlar:** dönem ekranı → Çıktılar → Muhasebe Fişi / Banka Ödeme Dosyası; Bordro Ayarları → Hesap Planı Eşleme ve Dosya Şablonları. ## Bordro dönemleri: listeleme, ay ile adresleme, iptal ve silme Bordro komutlarındaki `` hem dönem **id**'si hem **ay etiketi** (`YYYY-AA`, ör. `2026-04`) olabilir. Etiket, o ayın tek iptal edilmemiş dönemini seçer; yalnız iptal edilmiş dönemi olan ayda o seçilir. Aynı ayın birden çok iptal edilmemiş dönemi varsa `409 ambiguous_period` + `candidates[]` döner (id, durum, aktarılmış mı, fiş sayısı, silinmiş mi) ve `hint` o komutun id'li hâlini söyler — id ile tekrar çağırın. Dönem yoksa 404 ve `payroll.store` ipucu. **Silme ve geri almada** (`payroll.destroy`, `payroll.restore`) etiket yalnız o ayın silinmişler dahil **tek** dönemi varsa çözülür; aksi 409 — böylece tekrar çağrı başka bir dönemi silmez (aynı dönemi bulur, yan etkisiz). Çalışan web/mobil bordro uçları id ile kalır. ```bash empuno payroll.index --year 2026 # varsayılan: iptal edilmişler gizli (counts.cancelled kaç tane gizlendiğini söyler), sayfa başına 100 (pagination) empuno payroll.index --year 2026 --status all # iptal dahil hepsi; --status cancelled | paid,draft | … empuno payroll.index --archived 1 # silinmiş dönemler (kim, ne zaman, gerekçe) empuno payroll.show 2026-04 # ay ile; aynı ayın diğer dönemleri period.same_month[] empuno payroll.declaration 2026-04 empuno payroll.cancel 7 --reason "Yanlış hesap" empuno payroll.destroy 7 --reason "Test hesaplaması" empuno payroll.bulk-destroy --json '{"all_cancelled":true,"year":2026,"dry_run":true}' # önce ne silineceğini görün empuno payroll.bulk-destroy --json '{"all_cancelled":true,"year":2026,"reason":"Önceki sistemden aktarıldı — mükerrer"}' empuno payroll.restore 7 # geri al (ay etiketi yalnız o ayın tek dönemiyse: empuno payroll.restore 2026-04) ``` | Durum | İptal (payroll.cancel) | Silme (payroll.destroy) | Çalışan görür | | --- | --- | --- | --- | | Taslak / Hesaplandı | Evet | Evet (doğrudan) | Hayır | | Onaylandı | Evet | Önce iptal | Evet | | Kesinleştirildi / Ödendi | Hayır — düzeltme için `payroll.reopen` | Hayır (resmî bordro, VUK md. 253) | Evet | | İptal edildi | — (tekrar çağrı yan etkisiz) | Evet | Hayır | | Aktarıldı (önceki sistemden) | Hayır | Hayır | Statüsüne göre | | Düzeltmeye açılmış (revision_count > 0) | Hayır — yeniden hesaplayıp kesinleştirin | Hayır | Hayır | - **İptal edilmiş ve silinmiş dönem hiçbir hesaba girmez:** kümülatif GV matrahı, yıllık 270 saat fazla mesai toplamı, avans/haciz bakiyesi ve geçmişi, icra kapasite tahmini, çıkış ödemesi, SGK/MUHSGK beyanı, mali müşavir kesinti raporu, çalışan web/mobil bordro, yıllık işveren maliyeti rozeti, belgesiz rapor onayındaki ay kilidi. - **Silme = arşiv:** dönem, fişleri ve alt kayıtları birlikte soft-delete edilir; kim/ne zaman/gerekçe dönemde ve bordro denetim günlüğünde kalır. `reason` zorunlu (3–500). Zaten silinmişse yan etkisiz başarı (`flash.deleted.already: true`). - Silinemeyen dönemde 422 `rejected` + `errors.period`; makine kodu `payroll.show` / `payroll.index` satırında `deletion_blocker.code`: `imported` | `locked` | `revised`. - **Toplu silme** satır bazlı `results[]` döner (`deleted` | `skipped` + engel metni | `failed`); `dry_run: true` hiçbir şey yazmaz. Her dönem ayrı işlenir. - Hesaplanmış bir dönemi iptal etmek, silmek ya da geri almak, **sonraki ayların** kümülatif GV matrahını bayatlatır: yanıtta `warnings[{code: later_periods_affected, periods[{id, label, status, action, next_step}]}]`. Yol duruma göre: `recalculate` (hesaplanmış → `payroll.calculate`), `cancel_and_recreate` (onaylanmış dönem yeniden hesaplanamaz → `payroll.cancel`, `payroll.store`, `payroll.calculate`), `reopen` (kesinleşmiş/ödenmiş → `payroll.reopen`, hesapla, onayla, kesinleştir; fark raporu). `next_step` komutu hazır verir. - `payroll.index` varsayılan olarak **sayfa başına 100** dönem döner (`pagination.total`, `--per_page` ≤100, `--page`); hepsini okuyan betik sayfaları gezmeli. - İptal edilmiş dönemin mutabakatı (`payroll.declaration `) satır üretmez; tek uyarı `period_cancelled` — beyana esas alınamaz. - Geri alma yalnız dönemle aynı anda silinen fişleri geri getirir. İptal edilmiş dönem her zaman geri alınır; taslak/hesaplanmış dönem, o ayın iptal edilmemiş başka dönemi varken alınamaz (`month_taken`). - Yalnız iptal edilmiş dönemi olan ayda `payroll.store` yeni dönem açar. Durum değerleri: `empuno reference payroll_period_statuses`. ## Kesinleşmiş / ödenmiş bordro döneminin düzeltilmesi İki yol vardır. **(A) Fark bordrosu:** dönem kilitli kalır, fark cari aya bordro kalemi olarak girilir (`payroll-items.bulk`) — prim/ikramiye gibi ödendiği ayda vergilenen farklar için. **(B) Dönemi düzeltmeye aç:** hatalı hesaplanmış ayı yeniden hesaplamak için. ```bash empuno payroll.reopen 145 --reason "Fazla mesai eksik girilmiş" # düzeltmeyi yapın (puantaj, profil, kalem…), sonra olağan akış: empuno payroll.calculate 145 && empuno payroll.approve 145 && empuno payroll.finalize 145 empuno payroll.show 145 # revisions[]: snapshot + fark (diff.employees[], totals, actions, affected_later_periods) ``` - Açılışta fişler **snapshot** olarak saklanır (eski hâl silinmez). Dönem ödenmişse ödemede avans/hacze işlenen tahsilatlar geri alınır; yeniden `payroll.pay` ile güncel tutarlarla işlenir. - Kesinleştirmede kişi bazında **net fark** (`net_difference` > 0 çalışana ek ödeme, < 0 alacak), `sgk_changed` (APHB ek/iptal belge), `tax_changed` (MUHSGK düzeltme beyannamesi) ve kümülatif GV matrahı değiştiyse yeniden hesaplanması gereken **sonraki dönemler** döner. - Kümülatif GV matrahı her zaman önceki ayların fişlerinden türetilir; önceki ayı düzelttiyseniz sonraki ayları sırayla yeniden hesaplayın (kesinleşmişse onları da düzeltmeye açın). - Aktarılan (önceki sistemden) dönem yeniden açılamaz; düzeltmeyi içe aktarımı yeniden yaparak girin. ## Bordro doğrulama: simülasyon, kaydetmeden önizleme, hesap izi, yasal parametreler Gerçek hesapla **aynı motor** (toplayıcı → hesaplayıcı) yazıcı çağrılmadan koşar: hiçbir kayıt oluşmaz, değişmez; bildirim, e-posta, AI kredisi yok (her çağrı geri alınan bir transaction içinde; yazma girişimi engellenir). Sonuçlar gerçek `payroll.calculate` ile kuruşu kuruşuna aynıdır. Yetki: `payroll.view` (önizleme `payroll.calculate` üzerinden olduğu için `payroll.manage`). ```bash # 1) Çalışan simülasyonu: verilmeyen her alan gerçek veriden (profil, izin/yoklama günleri, kalemler, haciz/avans, kümülatif matrah) empuno payroll.simulate --json '{"period":"2026-04","employee_id":118,"options":{"sick_leave_pay":"unpaid"}}' # 2) Serbest profil (çalışan yok): brüt/net/saat ücreti + istenen olgular empuno payroll.simulate --json '{"period":"2023-07","profile":{"gross_salary":45000,"insurance_group":"none","mw_exemption_applies":false},"cumulative_tax_base_before":250000}' # 3) AGİ yılı (2021): aile durumu empuno payroll.simulate --json '{"period":"2021-03","profile":{"gross_salary":6291.05},"agi":{"marital_status":"married","spouse_works":false,"children":2}}' # 4) 12 ay zincir (kümülatif matrah aydan aya, Ocak sıfırlanır; dilim geçişi results[].flags) empuno payroll.simulate --json '{"period":"2026-01","months":12,"employee_id":118,"trace":"none"}' # 5) Dönemi kaydetmeden önizle: bugünkü veriyle (live) ya da her fişin kendi girdisiyle (slips) empuno payroll.calculate 2026-04 --dry_run 1 empuno payroll.calculate 2023-07 --dry_run 1 --basis slips # aktarılmış dönem: müşavir değeri ↔ motor + ipuçları # 6) Fişin hesap izi (neden bu rakam) empuno payroll.employee-slip 2026-04 118 --explain 1 empuno payroll.employee-slip 2022-03 118 --explain 1 --recompute 1 # aktarılmış / eski fiş: motorla yeniden hesap + fark # 7) Yürürlük tarihli yasal parametreler (2021–) empuno reference payroll_parameters --date 2023-07-15 empuno reference payroll_parameters --year 2022 # yılın setleri + 12 aylık AÜ istisnası ``` - **Simülasyon** (`payroll.simulate`, POST): zorunlu yalnız `period` (YYYY-AA, 2021-01 … bugün+12 ay) + `employee_id` YA DA `profile.gross_salary | net_salary | hourly_rate`. İstekteki alanlar yalnız "değiştir"dir: `profile.*`, `days.{sgk_days|missing_days, missing_reason, pay_days, allowance_days, rd_days}`, `overtime.{overtime_50_hours, overtime_25_hours, weekly_rest_hours, weekly_rest_days, holiday_hours, holiday_days, night_hours}` (gerçek hesapla aynı fiyat: saat ücreti × çarpan, saat bazlı tür o kovayı ödüyorsa türün çarpanı; gece yalnız gece türüyle ödenir, yoksa `night_hours_unpaid` uyarısı), `attendance.{sgk_days, missing_breakdown, missing_day_reason, worked_hours, paid_rest_hours}` (puantaj özeti), `profile.{work_schedule, weekly_hours}` (kısmi süreli / çağrı üzerine), `earnings[]` / `deductions[]` (gerçek kalemlere EKLENİR; `include_live_items: false` gerçekleri çıkarır), `cumulative_tax_base_before`, `exit.*`, `options.*` (yalnız bu istekte; firmanın tercihi değişmez). Alanların tam listesi: `empuno describe payroll.simulate`. - **Yanıt:** `slip` (payroll_slips kolon adları), `summary`, `earnings[]`, `deductions[]`, `trace{phases, steps[{phase, key, label, value, inputs, formula, basis, flags, note}], flags[]}`, `input` + `input_sources` (hangi alan istekten), `comparison{current, simulated, diff}` (dönemde fişi varsa), `would_write[]` (gerçek hesapta yazılacaklar: profil açma, çıkış ödemesi kaydı, sistem kazanç türü — simülasyon yazmaz), `warnings[]`, `results[]` (months > 1). - **Önizleme** (`payroll.calculate --dry_run 1`): dönem durumu, fişler, çıkış ödemeleri ve profiller değişmez; iptal hariç her durumda çalışır (onaylı/kesin dönemde "düzeltmeye açsam ne değişir"). `basis=live`: `results[].action` would_create | would_update | would_delete | error + `diff` + `hints`. `basis=slips`: hesap izi olan fiş birebir yeniden oynatılır; izi olmayan eski fiş ve aktarılmış fiş kolonlarından kurulur (`source` stored | reconstructed | imported). `employee_ids[]` alt küme, `tolerance` (TL, vars. 0,05). Not: CLI'nin genel `--dry-run` bayrağı isteği yerelde basar; sunucu alanı `dry_run` (alt çizgi) — `--dry_run 1` ya da `--validate` kullanın. - **Aktarılmış (müşavir) fişlerin geri testi:** set fişin bağından değil **dönem tarihinden** seçilir. Fişte yazılı olgular girdi olur (ücret, prim günü, SGK/GV/DV matrahlarından istisnalı kısım, kümülatif matrah, sigorta türü SGK tutarlarından). AGİ yılında müşavirin uyguladığı AGİ, motor vergisi − fiş vergisi farkından aile durumuyla eşlenir (aynı tutarı veren durumlar listelenir; çalışan kartı seçer). Kırılımı yazılmamış AÜ istisnası / 5510 teşviki, nihai tutar aynıysa fark sayılmaz (`inferred[]` notu). Ar-Ge kanunu ve terkini yazılı ama oranı (`rd_rate`) olmayan fişte oran — gün de yoksa gün — fişteki terkinden yasal oranlara (%100/95/90/80) oturtularak türetilir (`inferred[]`: `profile.rd_tax_exemption_rate`, `days.rd_days`; aynı tutarı veren iki çözümde firmanın oran yazılı fişlerindeki en sık oran); oturmazsa ipucu. Firma tercihi `rd_tax_benefit = employer` iken fişteki "Ar-Ge … işverene kalır" kesinti satırı (`deductions[].type=rd_retained` ya da adı Ar-Ge geçen, tutarı terkine eşit) girdiden çıkarılır — motor bu kesintiyi kendisi üretir. Kalan farklar `hints[]` ile açıklanır: AÜ istisnası uygulanmamış (yalnız fişin GV'si motorunkinden yüksekse), Ar-Ge alanları eksik (kanun 05746, terkin yok), Ar-Ge terkini / SGK desteği farkı, işsizlik payı aktarılmamış olabilir, SGK tabanı/tavanı, işçi payı tutarsız, işveren maliyeti farkı yönüyle (müşavir yüksekse fişte uygulanmamış teşvik/destek, düşükse motorun uygulamadığı destek). - **Hesap izi:** empuno'nun hesapladığı her fişte hesap anında saklanır (girdi + adımlar + motor sürümü + parametre seti); `--explain 1` bunu ve tutarlılık kontrolünü (`consistency.matches`) döner. Zorunlu adımlar: SGK matrahı (taban/tavan bayrağı, 5510 md. 82), kümülatif matrah ve kaynak aylar, dilim dağılımı + `bracket_crossed`, AÜ istisnası (asgari ücretlinin matrahı, ay vergisi, uygulanan), Ar-Ge, eksik gün + neden, parametre seti ve tarihli satırlar (kıdem tavanı, SGK yemek istisnası). Çalışan web/mobil bordroda `explain_summary` (≤4 sade cümle) görür. - **Yasal parametreler** (`reference payroll_parameters`, `payroll.parameters` aynı veri): asgari ücret, SGK oranları (normal + SGDP) / taban / tavan, GV dilimleri (alt sınırdaki vergi dahil), DV oranı + kâğıt başı azami tutar, AÜ istisnası (ay tablosu — yıl başından beri çalışan için; yıl içinde girende kümülatif giriş ayından başlar, `mw_exemption_cumulative_start`), AGİ (yalnız ≤2021), yemek/yol/SGK yemek istisnası, engellilik indirimleri, kıdem tavanı, fazla mesai çarpanları, kaynaklar, `minimum_wage_support` (yürürlükteki günlük tutar + PEK sınırları; firma tercihi `minimum_wage_support` ile dönem hesabında uygulanır) `statutory.items[]` (kanunla değişen oran/eşikler — Ar-Ge ücret sınırı katı, teknokent GV oranı, Ar-Ge SGK desteği, 5746 personel oranları, BES SGK istisna payı: `key`, `label`, `unit`, `basis`, tarihte geçerli `value` ve yıl içi değişen değerde `schedule[]` — ör. 2025'te 40 kat sınırı 01.08'den), `labor_law` (haftalık azami 45 / günlük 7,5 saat — fazla mesai ve kısmi gün çevirisi buna dayanır) ve `not_modeled[]` (bölgesel ilave puan, kısmi sigorta alt grupları); kanun bazlı teşvikler `reference incentive_codes`. Tüm bordro tutarları kuruş kesindir: her yasal kesinti (SGK işçi/işveren bileşenleri, GV, DV, istisna) ayrı ayrı kuruşa yarım-yukarı yuvarlanır ve bileşenler toplamı birebir tutar; net anlaşmada brüt, tam neti veren en küçük kuruş ücrettir. Set yoksa 404 `parameters_missing` (en erken 2021-01-01); simülasyon ve önizlemede aynı kod 422. - **Panelde aynı uçlar:** Bordro → **Bordro Simülatörü** (Simülasyon + Yasal Parametreler sekmeleri; "CLI komutunu kopyala" buradaki `payroll.simulate` komutunu verir), dönem sayfasında **Önizle (kaydetmeden)** / **Motorla karşılaştır** (`payroll.calculate --dry_run 1`), fiş detayında **Hesap İzi** kartı (`--explain 1`, aktarılmışta "empuno ile yeniden hesapla" = `--recompute 1`). Yönetici ekranda gördüğünü ajanınız aynı sonuçla çalıştırır. - **AGİ yılları (2021 ve öncesi)** için bordro dönemi açılmaz (`payroll.store` 422): geçmişi `data-migration.payroll.commit` ile aktarın, doğrulamayı `payroll.simulate` ve `payroll.calculate --dry_run 1 --basis slips` ile yapın. AGİ yılı simülasyonunda aile durumu istekte yoksa çalışan kartından alınır; kartta boş olan bileşen en düşük AGİ ile varsayılır (bekâr / eş çalışıyor / 0 çocuk) ve `warnings[]`'te `agi_status_assumed` döner — gerçeğini `agi.*` ile verin. - **Ret nedenleri** (422 `{error: "rejected", reason}`): `salary_missing` (çalışanın bordro profilinde/kartında ücret yok — gerçek hesap da bu çalışanı atlar; simülasyon için `profile.gross_salary` verin, kalıcı düzeltme `employees.payroll-profile.update`), `simulation_salary_missing` (serbest modda ücret alanı yok), `calculation_failed` (girdi hesaplanamadı, mesajda neden), `period_cancelled`, `preview_too_large` (tek önizleme en çok 300 çalışan/fiş — `employee_ids` ile parçalara bölün). - **Elle düzeltilmiş beyan alanları** (Mutabakat → Düzelt / `payroll.declaration.update`, ör. eksik gün nedeni) motor çıktısı değildir: tutarlılık kontrolü, `--basis slips` önizlemesi ve geri test bunları fark saymaz; `--explain 1` yanıtında `overrides[{field, label, value, engine_value}]` olarak listelenir (iz motorun türettiğini gösterir, beyan ve yeniden hesap düzeltmeyi kullanır). ## Talepler: geliştirme isteği, hata, eleştiri, soru Ajanınız bir işlemi yapamadığında, bir hata gördüğünde ya da sistemi geliştirmek için önerisi olduğunda empuno ekibine **talep** açar. Talep çok mesajlı bir yazışmadır: ekibimiz (insan ya da bizim ajanımız) yanıtlar, ek bilgi ister, kapatır; ajanınız yanıtı bir sonraki kontrolde okunmamış olarak görür. ```bash empuno tickets open "Toplu izin onayı" --kind feature --body "Bekleyen izinleri tek komutla onaylamak istiyoruz." --command leave-requests.approve empuno tickets --unread # yanıtı gelen talepler empuno tickets show TK-7Q3M9X # yazışmayı oku (okundu sayılır) empuno tickets reply TK-7Q3M9X "Her ay sonu gerekiyor." empuno tickets close TK-7Q3M9X --note "Çözüldü, teşekkürler" empuno tickets kinds # tür listesi ``` | Tür (`kind`) | Ne zaman | | --- | --- | | `feature` | Yeni özellik / geliştirme isteği | | `bug` | Beklenmeyen davranış, yanlış sonuç, 500 hatası | | `criticism` | Eleştiri, kullanılabilirlik, genel geri bildirim | | `question` | Nasıl yapılır / kural sorusu | | `missing_command` | Ajanın yapması gereken işlem katalogda yok (`unknown_command` yanıtındaki `hint` bunu önerir) | | `docs` | Dokümantasyon eksik ya da yanlış | Mükerrer koruması: aynı başlıkta açık talep varsa (ya da aynı `Idempotency-Key` gönderilirse) yeni talep açılmaz, mevcut talep `duplicate: true` ile döner — ek bilgiyi `reply` ile ekleyin. CLI anahtarı içerikten kendisi üretir; betiğin yeniden denemesi güvenlidir. Durumlar: `open` (ekipten yanıt bekliyor) → `answered` (ekip yanıtladı) → … → `closed`. Ajanınızın her mesajı talebi yeniden `open` yapar; kapalı talebe yazılamaz (409), yeni talep açıp eski numarayı belirtin. Her anahtar türü (salt-okuma dahil) talep açabilir; talepler firma düzeyinde görünür. Yazma sınırı anahtar başına dakikada 6, saatte 40. Taleplere kişisel veri (kimlik no, maaş, sağlık) yazmayın. HTTP uçları: `/api/company/v1/tickets` (ayrıntı: /api-docs). ## Yanıt biçimi | Durum | Yanıt | | --- | --- | | Okuma (GET) | `{"ok": true, "page": "Manager/LeaveRequests/Index", "data": {…}}` — `data`, panel ekranının gösterdiği verinin tamamı | | Yazma başarılı | `{"ok": true, "message": "İzin talebi onaylandı!", "data": {…}, "meta": {…}, "redirect": {"command": "leave-requests.index", "params": {}}}` — `message`, `flash` ve `redirect` eskisi gibi durur; sonucu `data`dan okuyun | | `data` (yazma) | `{"action": "created", "type": "advance_payment", "id": 812, "ids": [812], "created": 1, "updated": null, "deleted": null, "skipped": null, "failed": null, "partial": false, "results": [{"index": 0, "action": "created", "type": "advance_payment", "id": 812}], "warnings": [], "changed_fields": []}` — tüm yazma komutlarında aynı biçim. Kaynak sırası: komutun açık beyanı (`flash.created` / `updated` / `deleted`) → komutun JSON sayaçları → gözlenen kayıt (`inferred: true`). Belirlenemeyen sayaç `0` değil `null`; `changed_fields` yalnız alan ADLARI. Toplu komutlarda `results[]` satır bazlıdır (`created` / `updated` / `skipped` / `failed` + `reason`) | | `meta` | `{"company_id": 12, "company_slug": "acme", "command": "advance-payments.store", "dry_run": false, "idempotent_replay": false}` — her nesne yanıtında (okuma dahil); başlıkta da `X-Empuno-Command`, `X-Empuno-Company-Id`. Liste (dizi) dönen JSON'a dokunulmaz | | Deneme (dry_run) | `{"ok": true, "dry_run": true, "message": "Deneme (kaydedilmedi): …", "data": {"id": null, …}, "dry_run_report": {"rolled_back": true, "changes": {"inserts": {"departments": 1}, "updates": {}, "deletes": {}}, "side_effects": {"mail": [], "notifications": [], "jobs": [], "storage": []}, "blocked": []}}` — oluşacak kayıtların kimliği `null`; başlık `X-Empuno-Dry-Run: 1` | | Tekrar (Idempotency-Key) | İlk yanıtın aynısı + `"idempotent_replay": true` ve `Idempotent-Replayed: true` başlığı; işlem ikinci kez YAPILMAZ | | Doğrulama / iş kuralı | `422 {"ok": false, "message": "…", "errors": {"alan": ["…"]}}` | | Dosya | İkili içerik (PDF, Excel). CLI kaydeder: `--output ./klasor` | | Bazı uçlar | Panel bileşenlerinin kullandığı uçlar zaten JSON döner; olduğu gibi iletilir. | ## Yetki ve güvenlik modeli - **Kimin adına:** Ajan anahtarı, onu oluşturan kişi adına çalışır. Yapılan işlem panelde o kişi yapmış gibi kaydedilir (ör. izni onaylayan). - **Etkin yetki = anahtarın kapsamı ∩ o kişinin güncel yetkisi.** Kapsamı anahtarı oluştururken modül modül (Görüntüle / Yönet) seçersiniz; sizde olmayan yetkiyi veremezsiniz. Kişinin yetkisi azalırsa anahtar da daralır, kişi pasifleşirse anahtar çalışmaz. - **Yönetici-özel işlemler** (yetki devri, mali müşavir yönetimi) ayrı `company_admin` kapsamı ister; varsayılan kapalıdır. - **Grup anahtarı:** birden çok grup şirketinde çalışan anahtar her istekte hedef firmayı (`X-Empuno-Company` / `--company`) ister ve o firmada, kişinin oradaki hesabı adına çalışır; etkin yetki her firmada ayrı kesişir. Ayrıntı: [Grup anahtarı](#grup-anahtari). - **Hiçbir kapsamla açılmayanlar:** API anahtarı üretme/iptal, abonelik ve ödeme işlemleri, kişisel profil (ad, e-posta, şifre). - **İşlem günlüğü:** Her yazma isteği (komut, yol, durum kodu, süre) anahtarın günlüğüne düşer: Firma Ayarları → API. Denemeler (`Deneme`) ve tekrarlar (`Tekrar`) da ayrı rozetle görünür; panelde Hatalar / Denemeler / Tekrarlar diye süzülür. İstek/yanıt içeriği saklanmaz. - **Tekrar anahtarı zorunluluğu:** Anahtar ayarlarında "Her yazmada tekrar anahtarı (Idempotency-Key) zorunlu" açılırsa anahtarsız yazma `400 idempotency_key_required` alır (deneme ve okumalar muaf). Kataloğun `conventions.idempotency.required_for_this_key` alanı bunu söyler. - **Süre ve iptal:** 7 / 30 / 90 / 180 / 365 gün veya süresiz; panelden anında iptal. Ham anahtar yalnız oluşturulurken bir kez gösterilir, sunucuda yalnız özeti (sha256) tutulur. - **Hız sınırı:** anahtar başına 240 istek/dakika, 6000 istek/saat (aşılırsa `429` + `Retry-After`). - **Gerçek etki:** İşlemler canlı veride çalışır ve panelle aynı yan etkileri doğurur (ör. aday/çalışana e-posta gider, AI kredisi harcanır). Komutun yan etkileri `empuno describe` özetinde yazar; kapatılabilenler parametreyle kapatılır. Örnek: personel evrakı varsayılan olarak yalnız yöneticilere görünür ve çalışana bildirim gitmez; `--visible_to_employee true` ile çalışanın Evraklarım bölümüne açılır (bildirim gider, toplu aktarımda `--notify_employee false` ile susturulur). - **Geçmiş veri aktarımı:** `data-migration.*` komutları davet, e-posta ya da bildirim GÖNDERMEZ ve lisans tüketmez. `data-migration.employees.commit` ayrılmış çalışanları çıkış bilgisiyle alır, TC ile eşler (`--on_existing update`) ve satır bazlı `results` döner; tekrar çalıştırmak güvenlidir. ## Grup anahtarı ve firma seçimi (grup şirketleri) Birden çok şirketi olan gruplar (holding, kardeş şirketler) firmalarını panelde **Grup Şirketleri** ekranından bağlar (`group.*` komutları). Aynı kişi grup firmalarında aynı e-posta ve şifreyle hesaba sahipse, anahtar oluştururken **Firmalar** bölümünden diğer grup firmalarını seçerek tek bir **grup anahtarı** oluşturur. Seçilebilen firma: aynı grupta, aktif ve kişinin orada API anahtarı yönetme yetkisi var. ```bash empuno companies # id, slug, durum, ev/üye, etkin kapsam empuno --company forwardie-lojistik-as employees.index # firma id ya da slug export EMPUNO_COMPANY=3 # ya da profil varsayılanı: empuno login --company 3 empuno --company 3 payroll.show 2026-10 # ay etiketi de o firmanın dönemine çözülür empuno --company 3 group.index # grup üyeleri, davet kodları, etkinlik empuno reference group_companies # aynı liste (referans olarak) # HTTP curl -H "Authorization: Bearer $EMPUNO_API_KEY" https://empuno.com/api/company/v1/companies curl -H "Authorization: Bearer $EMPUNO_API_KEY" -H "X-Empuno-Company: 3" https://empuno.com/manager/employees ``` - **Firma her istekte zorunlu (okuma dahil).** Başlıksız panel komutu `400 company_required` alır (yanıtta erişilebilir `companies[]`). Gerekçe: okumada sessizce ev firmasına düşmek, ajanın yanlış firmanın verisini görüp yanlış firmaya yazmasının ilk adımıdır. Başlıksız serbest uçlar: `/api/company/v1/me`, `/catalog` (ev firmasına göre `allowed` + `requires_company: true`), `/companies`, `/tickets` (talepler her zaman anahtarın ev firmasınındır) ve firmaya bağlı olmayan referanslar; firmaya bağlı referanslar (`departments`, `branches`, `leave_types`, `sgk_workplaces`, `payroll_options`, `earning_types`, `pension_plans` …) başlık ister. - **Komut hedef firmada, kişinin oradaki hesabı adına koşar:** yapılan işlem o firmada o kullanıcı yapmış gibi kaydedilir; günlük satırı (company_api_key_logs) hedef firma ve o kullanıcıyla yazılır; tekrar anahtarı (Idempotency-Key) kapsamı da hedef firmadır — aynı anahtar iki firmada iki ayrı işlemdir. - **Etkin yetki = anahtar kapsamı ∩ o firmadaki hesabın güncel yetkisi.** B'de yönetici değil de yalnız izin görüntüleme yetkiniz varsa, aynı anahtar B'de yalnız onu yapar. `empuno companies` her firmanın `effective_scopes` listesini verir. - **Her yanıt firmasını söyler:** `meta.company_id`, `meta.company_slug` ve `X-Empuno-Company-Id` / `X-Empuno-Company-Slug` başlıkları (dosya indirmede yalnız başlık). Yazmadan önce doğrulayın. - **Tek firmalı anahtar:** başlık gerekmez; verilirse anahtarın firmasıyla (id ya da slug) eşleşmelidir, yoksa `403 company_mismatch` + `key_company` (profili karışan ajanı korur). - **CLI sürümü:** `--company`, `EMPUNO_COMPANY`, `empuno login --company` ve `empuno companies` CLI 1.6.0 ile gelir (`npm i -g empuno@latest`; `empuno version`). 1.5.0 `--company` değerini göndermez — grup anahtarıyla eski CLI her panel komutunda `company_required` alır. - **İptal kuralları (her istekte denetlenir):** anahtar iptal/süresi dolmuş → `401` (her firmada). Hedef firma askıda → `403 company_inactive` (yalnız o firma; diğerleri çalışır). Listede olmayan ya da var olmayan firma → aynı gövdeyle `403 company_not_in_key`. Erişim kalktıysa `403 company_access_revoked` + `reason`: `detached_by_member` (o firmanın yöneticisi "Bu firmadan kaldır" dedi), `left_group` (firma gruptan ayrıldı/çıkarıldı), `removed_by_owner`, `group_dissolved`, `account_unavailable` (kişinin oradaki hesabı pasif, silinmiş ya da şifresi artık aynı değil). - **Yönetim:** firma listesini yalnız anahtarı oluşturan kişi değiştirir; anahtarın tamamını yalnız ev firması iptal eder; üye firmanın yöneticisi anahtarı Firma Ayarları → API & Ajan'da salt okuma görür, yalnız kendi firmasındaki işlemleri günlükte izler ve "Bu firmadan kaldır" ile o firmadaki erişimi kapatır. Firmaların birbirine bağlanması (grup) tek başına hiçbir veriyi açmaz; firmalar arası her işlem açık rıza (grup üyeliği) + aynı kişi kuralıyla yapılır. - **Grup komutları:** `group.index` (üyeler, davet kodları, etkinlik — `group.view`), `group.store` / `group.update` / `group.companies.store --target_company ` (aynı yöneticinin firmasını ekle; `--company` çalışılan firmadır, eklenecek firma değil — eski alan adı `company` yalnız `--json` gövdesinde kabul edilir) / `group.invites.store` (tek kullanımlık kod, yalnız bir kez döner) / `group.invites.destroy` / `group.join --code` / `group.leave` — üyelik değişiklikleri `company_admin` kapsamı ister. ## Grup işlemleri: ayar kopyalama ve grup özeti Aynı gruptaki firmalar arasında yapılandırma tek seferde kopyalanır ve firmaların maliyet / avans / izin durumu tek raporda okunur. Her iki işlem de firmalar arası erişim kuralına tabidir: kaynak/okunan firma aynı grupta olmalı, kişinin orada aynı e-posta + şifreyle hesabı olmalı, ajan isteğinde firma anahtarın listesinde olmalı (tek firmalı anahtar → `403 company_not_in_key`). ```bash empuno reference clone_sections # bölümler, gereken yetkiler, eşleme anahtarı, kopyalanmayan alanlar # Önce deneme: ne eklenecek / güncellenecek / atlanacak (satır bazlı results[]) empuno --company 5 company-settings.clone --from 3 --sections payroll_options,payroll_general,earning_types,deduction_types,leave_types,departments --dry-run empuno --company 5 company-settings.clone --from 3 --sections payroll_options,earning_types # uygula (on_existing=skip) empuno --company 5 company-settings.clone --from 3 --sections departments --on_existing update empuno --company 3 group.summary # her firmanın son kapanmış dönemi empuno --company 3 group.summary --period 2026-10 # aynı ay empuno --company 3 group.summary.export --period 2026-10 --output grup-ozeti.xlsx ``` - **Ayar kopyalama (`company-settings.clone`, `group.manage`):** hedef = isteğin firması (`--company`), kaynak = `--from` (id ya da slug). Bölümler: `payroll_options` (yalnız tanımlı ve geçerli tercihler), `payroll_general` (ödeme günü, para birimi, kilit günü, devamsızlık, 5510 otomatik), `meal_transport`, `advance_settings`, `earning_types` / `deduction_types` (kodla), `leave_types` (type_key ya da adla), `leave_settings`, `departments`, `branches`, `shifts`, `expense_categories` (adla; büyük/küçük harf ve boşluk farkı önemsiz), `accounting_options`, `payroll_account_mappings` (yalnız firma geneli, line_key ile), `payroll_export_templates` (tür + adla; parametreler kopyalanmaz). `document_types` platform geneli — her firmada aynı liste, kopyalamaya gerek yok. - **Hiçbir kayıt silinmez.** `--on_existing skip` (varsayılan): eşleşen kayıt ve özelleştirilmiş ayar korunur, yalnız eksikler eklenir; ayar bölümü bu firmada hiç değiştirilmemişse (varsayılan değerlerde) kaynağın değerleri yazılır. `update`: eşleşenler kaynakla eşitlenir; tercihlerde kaynakta tanımsız anahtar burada varsayılana döner. Tekrar çalıştırmak güvenlidir (aynısı → `skipped`). - **Bölüm izni:** kaynakta `{modül}.view`, burada `{modül}.manage` (bordro bölümleri payroll, izin bölümleri leaves, departman/şube company_settings, vardiya shifts, masraf expenses, avans advance_payments). Yoksa bölüm `sections[].status = skipped`, `reason = permission`, `required_permission`, `required_in` (source | target); diğer bölümler yine çalışır. - **Kopyalanmayanlar:** personel verisi, departman/şube yönetici adları, şube telefon/e-posta, PDKS bağlantısı (yeni şubeye yeni bağlantı üretilir), merkez şube bayrağı, sektör/NACE, şablon parametreleri (müşteri/firma kodları), kapsamlı hesap eşlemeleri, SGK işyerleri, BES planları. - **Yan etkiler:** grup etkinliğine `settings_cloned` (iki firmaya; yalnız değişiklik olduysa). E-posta / bildirim yok — vardiya saatleri değişirse ileri tarihli ataması olanlara bildirim gitmez, `warnings[].code = shift_assignments_affected` döner. Diğer uyarılar: `recalculate_required` (hesap tercihi değişti), `apply_5510_enabled|disabled`, `applies_to_all` (tüm çalışanlara uygulanan tür eklendi), `template_params_not_copied`. - **Grup Özeti (`group.summary`, `group.view`):** yalnız sizin `group.view` yetkinizin olduğu grup firmaları gelir; firma başına `headcount` (employees.view), `cost` (payroll.view: son onaylı / kesinleşmiş / ödenmiş dönem ya da `--period` ayı; aktarılmış dönemler dahil — brüt, SGK işçi, gelir + damga, net, SGK işveren, teşvik, toplam işveren maliyeti), `advances` (advance_payments.view: aktif maaş avansı kalanı, bekleyen talepler), `work_advances` (expenses.view: açık iş avansı bakiyesi), `leave` (leaves.view: kalan yıllık izin toplamı, ortalama, tahmini karşılık = gün × brüt/30, en yüksek 5 bakiye). Yetkisiz bölüm `{available: false, required_permission}`; `totals` yalnız erişilebilir bloklardan, `complete=false` ise kısmi. `warnings`: `period_mismatch` (son dönemler farklı ay → `--period` verin), `cost_missing`. GET yan etkisizdir (izin toplamı 10 dk önbelleklenir). `--sections headcount,cost` ile daraltılır; `group.summary.export` aynı veriyi Excel olarak verir (Özet, Maliyet, Avanslar, İzin). ## Grup içi nakil: çalışanı kıdemi ve izniyle başka grup firmasına devretme Aktif bir çalışanın iş sözleşmesi aynı gruptaki başka firmaya tek komutla devredilir (TBK 429: devralan bütün hak ve borçlarla taraf olur, hizmet süresi kesintisiz sayılır). İstek KAYNAK firmada yapılır (`--company` = çalışanın şu anki firması), hedef `--to` ile verilir. Önce önizleyin; ardından `--dry-run` ile deneyin. ```bash empuno reference group_transfer_options # varsayılanlar, çıkış kodları, evrak modları, kopyalanan / sıfırlanan alanlar empuno --company 3 employees.group-transfer.create 812 --to 5 --transfer_date 2026-12-01 # önizleme (yan etkisiz) empuno --company 3 employees.group-transfer.store 812 --to 5 --transfer_date 2026-12-01 --documents employment --dry-run empuno --company 3 employees.group-transfer.store 812 --to 5 --transfer_date 2026-12-01 --documents employment empuno --company 3 group-transfers.index --direction out # giden / gelen nakiller, rıza durumu empuno --company 3 group-transfers.protocol 41 --output devir-41.pdf # imzalatılacak devir protokolü empuno --company 3 group-transfers.consent 41 --document @imzali.pdf # imzalı protokolü yükle (iki firmanın dosyasına) # Geçmişte yapılmış geçişler: sistem bulur, siz onaylarsınız empuno --company 3 group-transfers.candidates empuno --company 3 group-transfers.link-bulk --records '[{"source_employee_id":812,"target_employee_id":95,"to":"b-lojistik"}]' --dry-run # Yanlış nakil: önce koşullar, sonra deneme, sonra geri alma (iki firmada tek işlem) empuno --company 3 group-transfers.show 41 # revert.available + revert.blockers[] empuno --company 3 group-transfers.revert 41 --reason "Yanlış firma seçildi" --dry-run empuno --company 3 group-transfers.revert 41 --reason "Yanlış firma seçildi" ``` - **Yetki:** kaynakta ve hedefte `employees.manage` + `group.manage` (ajan anahtarında kapsam + hedef firma anahtarın listesinde). Bordro profili ve kalemleri yalnız kaynakta `payroll.view` + hedefte `payroll.manage` varsa kopyalanır (yoksa `warnings[].code = payroll_copy_permission`). - **Kaynakta:** çıkış `transfer_date − 1`, SGK kodu varsayılan **22** (16 yalnız iki firmanın vergi numarası aynıysa — grup şirketleri ayrı işverendir); bekleyen izin/avans/masraf talepleri iptal, hesap pasif ve mobil oturumlar kapanır; çıkış ödemesi YAPILMAZ (kayıt `dismissed`, bordro otomatik oluşturmaz) — kıdem, ihbar ve izin hakları devralanda sürer. Aktif avans, açık iş avansı, zimmet ve icra kaynakta kalır (uyarı döner; `--advance_action settle_in_final_payroll` kalan avansı çıkış bordrosunda mahsup eder). - **Hedefte:** yeni çalışan kaydı (sicil numarası hedefin önekiyle; aynı T.C.'li AYRILMIŞ kayıt varsa yeniden kullanılır, AKTİF varsa `422 target_identity_active`), aynı e-posta + aynı şifreyle çalışan hesabı (yönetici rolü / yetki devirleri taşınmaz; KVKK aydınlatması ilk girişte yeniden), kaynaktaki çalışma dönemleri "önceki hizmet" + nakil tarihinde devam eden güncel dönem (kıdem ve izin kıdemi kaynaktaki başlangıçtan), devreden yıllık izin (kalan bakiye; nakil gününe denk gelen yıldönümü dahil), ileri tarihli ONAYLI izinler (hedefte aynı türle; yoksa iptal + uyarı), bordro profili (`effective_from = transfer_date`; teşvik ve Ar-Ge alanları sıfırlanır) ve süreli kalemler (tür KODUYLA; hedefte kod yoksa atlanır — önce `company-settings.clone --sections earning_types,deduction_types`). Kümülatif GV matrahı hedefte sıfırdan başlar (bilgi: `cumulative_tax_base_at_transfer`). - **Kişisel veri (KVKK):** hedefe yalnız izin listesindeki alanlar gider (kimlik, iletişim, adres, banka/IBAN, SGK, eğitim, aile, acil durum; özel nitelikli veriden yalnız engellilik derecesi). Evrak varsayılan `none`; `employment` = iş sözleşmesi, NDA, SGK işe giriş, hizmet dökümü, diploma, devir protokolü; tür listesi de verilebilir — sağlık (isg) ve adli sicil seçilse de kopyalanmaz. Önizlemede T.C. ve IBAN maskeli. - **Rıza (TBK 429):** işçinin yazılı rızası gerekir; sistem ön koşul yapmaz. `group-transfers.protocol` devir protokolünü üretir (T.C. tam yalnız employees.manage'de), imzalı nüsha `group-transfers.consent` ile yüklenir → iki firmanın özlük dosyasına `devir_protokolu`; kayıt `consent_status = received`. - **Yan etkiler:** iki firmanın grup etkinliğine `employee_transferred` / `transfer_linked` / `consent_received`; `documents ≠ none` ise evrak kopyası arka planda (`documents.copied`); `notify_employee` (varsayılan true) çalışana bilgilendirme e-postası (davet değil); taşınan ileri tarihli izin mali müşavire **gönderilmiş** bir dönem raporuna düşüyorsa (geriye tarihli nakil) o dönemin raporu iki firmada yeniden üretilip "Düzeltme: İzin Raporu" maili gider — kaynakta "Rapordan çıkarıldı", hedefte "Rapora eklendi (grup içi nakil)"; önizlemede `leave.accountant_reports[]`, sonuçta `accountant_corrections {planned, sent, failed}`, `--notify_accountants false` kapatır. `--dry-run` hepsini geri alır: id'ler `null`, e-posta, iş ve düzeltme yok (plan yine döner). - **Tekrar güvenli:** aynı çalışanın tamamlanmış nakli varsa yeni nakil yapılmaz, `duplicate: true` ile mevcut kayıt döner. Geçmiş nakil bağlamada aynı çift `skipped`. - **Geçmiş nakiller (`group-transfers.candidates` → `link-bulk`):** aynı T.C.'li "bir firmada ayrılmış + diğerinde çıkıştan sonraki 31 gün içinde girmiş" çiftleri sistem bulur (iki yönde; her satırdaki `record` olduğu gibi gönderilir). Bağlama kayıt oluşturmaz: hedefe kaynak dönemleri (boşluksuzsa devam zinciri, boşluk varsa `link_gap` uyarısı) + devreden izin (kaynakta çıkışta izin ücreti ödenmişse 0, `leave_paid_at_exit`) yazar; hedefte elle girilmiş devreden izin varsa üzerine yazmaz. Satır bazlı `results[]` (`created | skipped | failed` + `rule`). - **Geri alma (`group-transfers.revert`, `--reason` zorunlu, `--dry-run` destekli, tekrar güvenli):** yanlış nakil için iki firmada tek işlemde geri dönüş — kaynakta çıkış geri alınır (çalışan + hesap aktif, son çalışma dönemi açık, çıkışta otomatik iptal edilen bekleyen talepler geri gelir, "ödenmedi" çıkış kaydı silinir), hedefte çalışan kaydı kaldırılır (nakilden önce de var olan ayrılmış kayıt ayrılmış hâline döner), hedef hesap **nakil öncesi hâline** döner (nakilde açılan hesap silinir; önceden var olan İK / mali müşavir / yönetici hesabı önceki aktiflik ve çalışan bağıyla kalır — `summary.target_account`: `deleted` | `unlinked` | `deactivated`), devralınan dönemler, devreden izin, kopyalanan bordro profili/kalemleri silinir; taşınan ileri tarihli izinler hedefte arşivlenir ve kaynakta yeniden onaylı olur — mali müşavire gönderilmiş bir döneme düşüyorsa iki firmada düzeltme raporu gider (`summary.accountant_reports`, `--notify_accountants false` kapatır). Hedef firmadan geri alınıp hedef kayıt silindiyse yanıtta `redirect_to` (Nakiller; çalışan kartı artık açılmaz). Bağlamada (`mode=link`) yalnız dönem bağı, devreden izin ve bağlamanın açtığı çıkış kaydı kaldırılır. Kayıt silinmez (`status=reverted`, `revert_reason`); iki firmaya `transfer_reverted`. **Koşullar** `group-transfers.show` → `revert.blockers[]`: `revert_target_activity` (hedefte nakilden sonra hareket — bordro fişi, izin talebi, PDKS / puantaj, masraf, maaş / iş avansı, zimmet, vardiya ataması, yüklenmiş evrak (kopyalanan evrak ve devir protokolü hariç), teşvik, haciz, BES, yeni bordro profili / kalemi; `activity` sayıları — önce hedefte geri alın: zimmeti iade alın, vardiya atamasını / evrakı silin), `revert_source_payroll_closed` (kaynakta çıkış ayı ve sonrası onaylı/kesinleşmiş/ödenmiş dönem; `periods` — önce `payroll.reopen`), `revert_source_changed`, `revert_target_changed`, `revert_source_license_full`, `revert_manual_required`. Koşul sağlanmıyorsa doğru yol hedefte `employees.terminate` + kaynakta `employees.rehire`. Devredilmiş çalışanı `employees.reactivate` ile geri almak reddedilir (`transferred_out`): kişi iki firmada aktif kalırdı. - **Hata kodları (422 `rejected`, `rule`):** `employee_not_active` (ayrılmış çalışan → link), `self_transfer`, `last_admin`, `transfer_date_invalid` (girişten sonra, en geç bugün), `exit_code_invalid`, `exit_code_16_not_same_employer`, `target_identity_active`, `target_email_taken`, `target_email_deleted`, `target_license_full`, `active_equipment` (`--confirm_active_equipment true`), `target_department_foreign` / `target_branch_foreign`, `transfer_periods_conflict`, `link_*`. Erişim (403): `company_not_in_key`, `company_not_in_group`, `no_account_there`, `permission_there` (+ `required_permission`). ## Hata kodları Her hata gövdesi `{"ok": false, "error": "", "message": "…", "hint": "…"}` biçimindedir. Liste tek kaynaktan gelir; makine okunur hali: `empuno reference agent_errors` (`GET /api/company/v1/reference/agent_errors`). | HTTP | `error` | Anlamı | Ne yapmalı | | --- | --- | --- | --- | | 401 | `unauthenticated` | Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş. | Firma Ayarları → API & Ajan sekmesinden yeni anahtar oluşturun. | | 401 | `key_owner_inactive` | Anahtarı oluşturan kişi artık aktif değil. | Aktif bir yöneticiyle yeni anahtar oluşturun. | | 403 | `read_only_key` | Salt-okuma entegrasyon anahtarı panel komutlarını çalıştıramaz. | "Ajan" türünde anahtar oluşturun. | | 403 | `company_inactive` | Anahtarın bağlı olduğu firma ya da grup anahtarında hedef firma (X-Empuno-Company) pasif (askıda). | Firma yöneticisine bildirin; grup anahtarı diğer firmalarda çalışmaya devam eder. | | 403 | `scope_required` | Komut company_admin kapsamı istiyor (required_scope). | Anahtar sahibi kapsamı panelden genişletir. | | 403 | `forbidden` | Modül yetkisi yok; gereken izin required_permission alanında. | Anahtar kapsamına ve sahibinin yetkisine ilgili izni ekletin. | | 403 | `legal_consent_required` | Anahtar sahibi KVKK ve Kullanım Şartları (yöneticiyse ayrıca Veri İşleme Sözleşmesi) onayını vermemiş; ajan onun adına çalıştığı için panel komutları kapalı. | Ajan bu onayı veremez: anahtar sahibine bildirin, panele giriş yapıp onay ekranını tamamlasın (redirect alanı). Sonra aynı komutu tekrar çalıştırın. | | 403 | `email_verification_required` | Anahtar sahibinin e-posta adresi doğrulanmamış; panel komutları kapalı. | Anahtar sahibine bildirin: panele giriş yapıp e-posta doğrulamasını tamamlasın. Tekrar denemek işe yaramaz. | | 404 | `unknown_command` | Uç bir ajan komutu değil (ya da ajana kapalı). | `empuno commands` ile doğru komutu bulun; yoksa talep açın. | | 404 | `not_found` | Kayıt bulunamadı ya da bu firmaya ait değil. | Kimliği liste komutuyla doğrulayın. | | 404 | `no_receipt` | Masrafın fiş görseli yok (/api/company/v1 masraf fişi indirme). | Masraf kaydı geçerli; görsel yüklenmemiş. Tekrar denemeyin. | | 405 | `method_not_allowed` | Komut bu HTTP metoduyla çağrılamaz. | Katalogdaki method alanını kullanın. | | 409 | `conflict` | İşlem kaydın mevcut durumuyla çelişiyor. | Kaydın güncel durumunu okuyup yeniden deneyin. | | 422 | `validation_failed` | Eksik/yanlış alan; ayrıntı errors alanında. | errors alanındaki alanları düzeltip yeniden gönderin. | | 422 | `rejected` | İş kuralı reddi (message) ya da doğrulama hatası (errors). | Mesajdaki kuralı giderin; deneme için --validate kullanın. | | 429 | `rate_limited` | Hız sınırı aşıldı. | Retry-After saniye bekleyin. | | 429 | `insufficient_ai_credits` | Firmanın AI kredisi bu işlem için yetmiyor (credits.remaining / credits.requested). Hız sınırı DEĞİLDİR; hiçbir şey yapılmadı. | Beklemek ya da tekrar denemek işe yaramaz: yöneticiye AI kredisinin bittiğini bildirin; varsa AI kullanmayan komutu seçin (ör. dosyadan aktarım: empuno migrate …). | | 500 | `server_error` | Sunucu hatası; işlem yapılmış, yarım kalmış ya da hiç yapılmamış olabilir. | Önce durumu okuma komutuyla doğrulayın. Aynı Idempotency-Key ile tekrar göndermek komutu YENİDEN ÇALIŞTIRMAZ (409 idempotency_replay_unavailable döner); işlem yapılmadıysa YENİ anahtarla gönderin. | | 422 | `dry_run_unsupported` | Komut denemede (dry_run) çalıştırılamaz: dış servis/AI çağırır ya da taklit edilemeyen bir kanala gider (reason / blocked). Hiçbir şey kaydedilmedi. | Katalogdaki dry_run alanına bakın; gerekiyorsa denemeden gerçek çalıştırın. | | 500 | `dry_run_failed` | Deneme güvenle tamamlanamadı; hiçbir değişiklik kaydedilmedi. | Talep açın (empuno tickets open … --kind bug); komutu denemesiz çalıştırmadan önce durumu okuyun. | | 400 | `idempotency_key_required` | Bu anahtar için her yazmada Idempotency-Key zorunlu (deneme hariç). | Idempotency-Key başlığı ya da client_request_id alanı ekleyin (CLI: --idempotency-key). | | 400 | `idempotency_key_invalid` | Tekrar anahtarı boş, 120 karakterden uzun ya da başlık ile gövde değeri farklı. | Tek bir geçerli anahtar gönderin. | | 409 | `idempotency_in_progress` | Aynı anahtarla gönderilen ilk istek hâlâ işleniyor (elapsed_seconds). | Retry-After kadar bekleyip AYNI anahtarla tekrar deneyin (CLI: --retry); yeni anahtarla göndermeyin. | | 409 | `idempotency_replay_unavailable` | Bu anahtarla işlem yeniden YAPILMADI ve kayıtlı yanıt verilemiyor. reason: previous_attempt_failed (önceki deneme sunucu hatasıyla bitti, sonuç belirsiz), stale_lock (ilk istek kilit süresinde bitmedi), not_stored (başarılı dosya yanıtı saklanmaz), unreadable. | İşlemin gerçekleşip gerçekleşmediğini okuma komutuyla doğrulayın; yapılmadıysa YENİ anahtarla gönderin. stale_lock'ta ilk istek sonradan biterse aynı anahtar kayıtlı yanıtı döndürür. | | 422 | `idempotency_key_reused` | Anahtar son 24 saatte farklı içerikli bir istekte kullanıldı. | Yeni işlem için yeni anahtar kullanın; aynı işlemse gövde birebir aynı olmalı. | | 409 | `ambiguous_period` | YYYY-AA etiketi birden çok bordro dönemine uyuyor; adaylar candidates[] alanında (id, status, imported, slips_count, deleted, deletable). Silme ve geri almada (payroll.destroy / payroll.restore) etiket yalnız o ayın silinmişler DAHİL tek dönemi varsa çözülür — tekrar çağrı başka dönemi seçmesin diye. | hint alanındaki komutu id ile çağırın (geri almada payroll.restore ; deleted=true aday payroll.show ile açılmaz); iptal edilmiş/test dönemini payroll.destroy --reason "…" ile silin. | | 422 | `parameters_missing` | Tarih için yasal bordro parametre seti yok (empuno 2021-01-01 ve sonrasını destekler). payroll.simulate ve payroll.calculate --dry_run 422; reference payroll_parameters 404 döner (kod aynı; available=false, earliest). | Daha yeni bir dönem seçin; 2021 sonrası bir yılda görülürse hint'teki payroll:parameters-sync komutunu yöneticiye iletin ya da talep açın. | | 422 | `migration_pending` | Özellik için veritabanı güncellemesi henüz uygulanmamış; hiçbir şey yazılmadı (ör. payroll.bulk-destroy). Panel yönlendirmeli komutlarda (payroll.destroy / payroll.restore) aynı durum rejected + errors.period metniyle gelir. | Bir süre sonra aynı komutla tekrar deneyin; sürerse talep açın (empuno tickets open … --kind bug). | | 400 | `company_required` | Grup anahtarı her panel isteğinde (okuma dahil) hedef firmayı ister; başlıksız istek hiçbir firmada çalışmaz. | X-Empuno-Company başlığı gönderin (firma id ya da slug); CLI: --company ya da EMPUNO_COMPANY. Firmalar: `empuno companies` (GET /api/company/v1/companies). | | 403 | `company_mismatch` | Tek firmalı anahtar başka bir firma için kullanıldı: X-Empuno-Company anahtarın firmasıyla uyuşmuyor (key_company). | Başlığı kaldırın ya da o firmanın anahtarını kullanın (CLI: --profile). Birden çok grup firmasında çalışmak için grup anahtarı oluşturun (Firma Ayarları → API & Ajan → Firmalar). | | 403 | `company_access_revoked` | Grup anahtarının bu firmadaki erişimi kalktı (reason: detached_by_member \| left_group \| removed_by_owner \| group_dissolved \| account_unavailable). Diğer firmalarda anahtar çalışmaya devam eder. | Anahtar sahibine bildirin: erişim panelden yeniden eklenir (Firma Ayarları → API & Ajan). account_unavailable: sahibinin o firmadaki hesabı pasif, silinmiş ya da şifresi artık aynı değil. | | 403 | `company_not_in_key` | Firma bu anahtarın izin listesinde değil ya da böyle bir firma yok (tek firmalı anahtar yalnız kendi firmasında çalışır). | `empuno companies` ile erişilebilir firmaları görün; başka firmada çalışmak için grup anahtarı kullanın (Firma Ayarları → API & Ajan → Firmalar). | | 403 | `company_not_in_group` | Hedef firma bu firmanın grubunda değil. | group.index ile grup üyelerini görün; firma gruba group.companies.store ya da davet koduyla (group.join) katılır. | | 403 | `no_account_there` | Hedef firmada aynı e-posta ve aynı şifreyle aktif bir hesabınız yok. | Hedef firmanın yöneticisinden sizi aynı e-postayla eklemesini isteyin. | | 403 | `permission_there` | Hedef firmadaki hesabınızın bu işlem için yetkisi yok (required_permission). | Hedef firmanın yöneticisinden yetkiyi isteyin. | İş kuralı reddinde üst düzey `error` `rejected` (422) olur; makine kodu `flash.rule`, sonraki komut `flash.hint` alanındadır (çalışma dönemi, SGK işyeri, devreden izin). Aynı listede `returned_as: "flash.rule"` ile işaretlidir: | `flash.rule` | Anlamı | Ne yapmalı | | --- | --- | --- | | `overlap` | Dönemler çakışıyor (aynı günler iki dönemde). | Tarihleri düzeltin; employees.employments.index ile mevcut dönemleri okuyun. | | `open_not_last` | Yalnız en son dönem açık (çıkışsız) olabilir. | Önceki dönemin çıkış tarihini girin. | | `continuity_gap` | "Önceki dönemin devamı" işaretli dönem, önceki dönemin çıkışının ertesi günü başlamıyor. | Giriş tarihini önceki çıkış + 1 gün yapın ya da continues_previous=false gönderin. | | `continuity_without_previous` | İlk dönem "önceki dönemin devamı" olamaz. | continues_previous=false gönderin. | | `open_row_terminated` | Ayrılmış çalışanın son dönemi açık kalamaz. | Son döneme çıkış tarihi girin ya da hatalı çıkışı employees.reactivate ile geri alın. | | `active_without_open_row` | Aktif çalışanın son dönemi açık olmalı. | Ayrılmışsa employees.terminate; yeni dönem için employees.rehire. | | `no_employment_row` | Çalışanın "bu firmada" (kind=employment) dönemi kalmıyor. | En az bir employment dönemi bırakın. | | `use_terminate` | Açık (güncel) döneme çıkış bu uçla girilmez. | employees.terminate kullanın (hesap kapatma, bekleyen talepler, çıkış ödemesi). | | `use_reactivate` | Son dönemin çıkışı bu uçla silinemez. | Hatalı çıkış: employees.reactivate; yeni sözleşme: employees.rehire. | | `termination_required` | Son dönemden önceki dönem kapalı olmalı. | termination_date gönderin. | | `contract_start_row` | Güncel sözleşmenin başlangıç dönemi silinemez. | Tarihini employees.employments.update ile düzeltin. | | `open_row` | Açık (güncel) dönem silinemez. | Çıkış: employees.terminate; tarih düzeltme: employees.employments.update. | | `hire_date_required` | Dönemin giriş tarihi zorunlu. | hire_date gönderin (YYYY-AA-GG). | | `hire_in_future` | Giriş tarihi bugünden ileri olamaz. | Bugün ya da geçmiş bir tarih gönderin. | | `exit_in_future` | Çıkış tarihi bugünden ileri olamaz. | Gelecekteki çıkış için tarihi gelince employees.terminate. | | `exit_before_hire` | Çıkış tarihi girişten önce. | Tarihleri düzeltin. | | `invalid_exit_code` | Geçersiz SGK çıkış kodu. | empuno reference sgk_exit_codes. | | `invalid_kind` | Geçersiz dönem türü. | kind: employment \| prior_service (empuno reference employment_kinds). | | `invalid_insurance_group` | Geçersiz sigorta türü. | insurance_group: normal \| sgdp \| none. | | `prior_service_employer_required` | Önceki hizmet (prior_service) için işveren adı zorunlu. | external_employer_name gönderin. | | `prior_service_open` | Önceki hizmet (prior_service) dönemi kapalı olmalı. | termination_date gönderin. | | `hire_date_conflicts_periods` | Çalışan kartındaki işe giriş tarihi (employees.update, mobil, root admin) çalışma dönemleriyle çakışıyor; hiçbir alan yazılmadı. | hint'teki employees.employments.update komutuyla dönemi düzeltin ya da önce önceki dönemi düzenleyin. | | `not_active` | Ayrılmış çalışan nakledilemez / işlem aktif çalışan ister. | Önce employees.rehire. | | `same_workplace` | Çalışan zaten bu işyerinde. | Başka işyeri seçin ya da tarihsiz düzeltme için employees.update --sgk_workplace_id. | | `not_terminated` | Yalnız ayrılmış çalışan yeniden işe alınır. | Aktif çalışan için işlem gerekmez; hatalı çıkış employees.reactivate. | | `rehire_before_exit` | Yeniden giriş tarihi son çıkıştan sonra olmalı. | hire_date'i son çıkış + 1 gün ya da sonrası yapın. | | `license_full` | Lisans dolu; yeniden işe alım yapılamaz. | Lisansı yükseltin ya da başka bir çalışanı pasifleştirin. | | `payroll_permission_required` | Bordro alanı (bordro profili, kıdem ödemesi, kıdeme sayılma kararı) bordro yönetme yetkisi (payroll.manage) ister; hiçbir şey yazılmadı. | Bu alanlar olmadan gönderin; bordro yetkilisi ayrıca girer. | | `workplace_foreign` | SGK işyeri bulunamadı ya da bu firmaya ait değil. | empuno reference sgk_workplaces (id, 26 haneli sicil ya da ad). | | `workplace_closed` | SGK işyeri kapatılmış; dönem/nakil kapalı işyerine yazılamaz. | Açık bir işyeri seçin ya da sgk-workplaces.update --closed_at null. | | `workplace_in_use` | İşyerine bağlı dönem ya da bordro fişi var; silinemez. | sgk-workplaces.update --closed_at ile kapatın. | | `registration_taken` | Bu sicil numarası firmada başka bir işyerinde kayıtlı. | Mevcut işyerini kullanın (empuno reference sgk_workplaces). | | `invalid_registration_no` | SGK işyeri sicil numarası 26 hane değil ya da sayı olarak gönderildi. | Sicili METİN olarak 26 hane gönderin (boşluk/tire serbest). | | `registration_missing` | İşyerinin sicil numarası yok; geçmişe yazılacak ya da birleştirilecek numara yok. | Önce güncel numarayı girin: sgk-workplaces.update --registration_no "…". | | `same_registration` | Yeni numara güncel numarayla aynı. | Farklı bir numara gönderin. | | `date_too_far` | Sicil değişikliği tarihi bir yıldan ileri. | Yeni numaranın ilk gününü verin (en çok bir yıl ileri). | | `registration_date_order` | Değişiklik tarihi son eski numaranın bitişinden önce. | sgk-workplaces.index ile sicil geçmişini okuyun; tarihi sonraya alın. | | `registration_is_current` | Numara işyerinin güncel numarası; geçmişe eklenemez. | Numara değiştiyse sgk-workplaces.change-registration kullanın. | | `registration_range_invalid` | Eski numaranın başlangıcı bitişinden sonra. | valid_from ≤ valid_until gönderin. | | `registration_ranges_overlap` | Sicil geçmişi aralıkları çakışıyor (bir işyerinin aynı anda tek numarası olur). | Tarihleri düzeltin; sgk-workplaces.index ile geçmişi okuyun. | | `merge_self` | Hedef işyeri kaynak listesinde. | Kaynakları (source_ids) hedeften ayrı verin. | | `merge_range_unknown` | Birleştirilen numaranın son geçerli günü bilinmiyor (fiş ve çalışma dönemi yok ya da dönem açık). | valid_until {kaynak_id: YYYY-AA-GG} gönderin. | | `merge_target_not_latest` | Hedef işyerinin numarası en son kullanılan değil. | sgk-workplaces.merge-suggestions önerisindeki hedefi kullanın ya da valid_until ile son günleri verin. | | `name_required` | İşyeri adı ya da sicil numarası gerekli. | name ya da registration_no gönderin. | | `invalid_law_no` | Kanun numarası 4–5 haneli rakam olmalı. | empuno reference incentive_codes. | | `invalid_zone_type` | Geçersiz bölge türü. | zone_type: standard \| technopark \| rd_center. | | `branch_foreign` | Şube bulunamadı (bu firmaya ait değil). | empuno reference branches. | | `as_of_in_future` | Devreden izin tarihi bugünden ileri olamaz. | Bugün ya da geçmiş bir tarih gönderin. | | `as_of_before_contract` | Devreden izin tarihi güncel sözleşme başlangıcından önce. | Önceki dönemin izni yeni bakiyeye taşınmaz; aynı iş ilişkisi sürüyorsa önceki dönemi employees.employments.store ile ekleyin. | | `as_of_after_exit` | Devreden izin tarihi çıkış tarihinden sonra (ayrılmış çalışanın izni çıkışta donar). | as_of_date'i çıkış tarihi ya da öncesi yapın. | | `incentive_unknown_law` | Kanun numarası teşvik kataloğunda yok. | empuno reference incentive_codes ile geçerli kanun numarasını seçin (5 hane; 6111 → 06111 kabul edilir). | | `incentive_not_assignable` | Bu kanun çalışana atanamaz: 05510 ve 00000 firma ayarıyla (5510 uygulansın mı), 05746 bordro profilindeki Ar-Ge alanıyla yönetilir; yalnız referans olan ya da motorun hesaplamadığı kanunlar atanmaz. | Ar-Ge için employees.payroll-profile.update --rd_incentive 5746; 5510 için payroll-settings.update --auto_apply_incentive; atanabilenler reference incentive_codes → assignable=true. | | `incentive_expired` | Kanunun yararlanma süresi bu tarihte dolmuş (expired: benefit_until …). | reference incentive_codes → benefit_until; geçmiş dönem için start_date ve end_date'i yararlanma süresi içinde verin. | | `incentive_dates_invalid` | Tarih geçersiz (bitiş başlangıçtan önce ya da başlangıç işe girişten çok önce). | start_date ≤ end_date olmalı; varsayılan başlangıç işe giriş tarihidir. | | `incentive_employee_terminated` | Ayrılmış çalışana çıkış tarihinden sonra başlayan teşvik atanamaz. | start_date'i çıkış tarihinden önce verin ya da atamayı yapmayın. | | `incentive_fact_invalid` | Teşvik bilgisi anahtarı ya da değeri geçersiz. | empuno reference incentive_fact_keys (anahtar, tür, seçenekler). | | `pension_no_active_plan` | Firmada aktif BES planı yok. | pension.plans.store ile emeklilik şirketi sözleşmesini (şirket + sözleşme no) ekleyin. | | `pension_plan_foreign` | BES planı bulunamadı ya da bu firmaya ait değil. | empuno reference pension_plans. | | `pension_already_enrolled` | Çalışanın güncel bir BES kaydı var. | employees.pension.update ya da employees.pension.action kullanın. | | `pension_terminated` | Ayrılmış çalışan BES planına dahil edilemez. | Yeniden işe alımda (employees.rehire) yeni kayıt açılır. | | `pension_age_45_requires_request` | 45 yaşını doldurmuş çalışan yalnız kendi talebiyle dahil edilir (4632 ek md. 2). | Çalışanın talebi varsa voluntary=true gönderin; çalışan web/mobilden de talep edebilir. | | `pension_foreign_citizen` | Yabancı uyruklu çalışan otomatik katılım kapsamında değil (Türk vatandaşı ya da 5901 md. 28). | 5901 md. 28 kapsamındaysa çalışan kartında vatandaşlığı güncelleyin. | | `pension_insurance_group` | Sigorta grubu otomatik katılım kapsamında değil (sigortasız). | Bordro profilinde sigorta grubunu kontrol edin. | | `pension_opt_out_deadline_passed` | Cayma süresi (plana dahil olduğunun bildirildiği tarihten 2 ay) geçti. | action=leave_system (sistemden ayrılma) ya da action=pause (katkıya ara verme) kullanın. | | `pension_use_opt_out` | Başlangıç döneminde (cayma süresi içinde) sistemden ayrılma / ara verme yerine cayma kullanılır. | action=opt_out gönderin (iade emeklilik şirketince 10 iş günü içinde). | | `pension_invalid_action` | Bu işlem kaydın bugünkü durumunda yapılamaz. | employees.pension.show ile durumu okuyun (reference pension_actions). | | `pension_rate_below_legal` | Katkı oranı yasal oranın (%3) altına inemez. | rate en az 3 olmalı. | | `pension_rate_above_max` | Katkı oranı izin verilen üst sınırı aşıyor. | Daha düşük bir oran gönderin. | | `pension_date_invalid` | Tarih geçersiz (dahil olmadan önce ya da ara verme bitişi başlangıçtan önce). | effective_date / until değerlerini düzeltin. | | `period_not_calculated` | Dönem hesaplanmamış (taslak) ya da iptal edilmiş; fiş ve ödeme dosyası çıkmaz. | Önce payroll.calculate; iptal edilmiş dönemde çıktı yok. | | `period_not_finalized` | Muhasebeleştirme için dönem kesinleşmiş ya da ödenmiş olmalı. | payroll.finalize; taslak fişi payroll.accounting-voucher ile yine indirebilirsiniz. | | `already_posted` | Dönemin tahakkuk fişi zaten muhasebeleştirildi ve dönem o tarihten sonra değişti. | Farkı düzeltme fişiyle işleyin: payroll.accounting-voucher --kind correction, ardından payroll.accounting-postings.store --kind correction. | | `correction_without_posting` | Düzeltme fişi için önce tahakkuk fişi muhasebeleştirilmiş olmalı. | payroll.accounting-postings.store --kind accrual. | | `nothing_to_correct` | Muhasebeleştirilmiş tutarlarla güncel bordro arasında fark yok. | Düzeltme fişi gerekmiyor. | | `empty_voucher` | Fişte satır yok (dönemde fiş ya da ödenecek net yok). | payroll.show ile dönemin fişlerini kontrol edin. | | `voucher_unbalanced` | Fiş dengesiz (borç ≠ alacak); muhasebeleştirilemez. | payroll.accounting-voucher uyarılarını inceleyin. | | `voucher_integrity` | Fişte kuruş farkı olmayan tutarsızlık var: kendi içinde tutmayan bordro fişi (fark askı hesabında) ya da açıklanamayan işveren maliyeti farkı. | payroll.accounting-voucher → integrity.slips[] (fiş, çalışan, tutar, findings[]) ve integrity.employer_cost_gap; kaynak fişleri düzeltin (data-migration.payroll.commit --on_existing update) ya da bilerek muhasebeleştirmek için accept_integrity_issues=true gönderin. | | `template_not_found` | Dosya şablonu ya da önayar bulunamadı. | Önayarlar: empuno reference bank_file_presets / payroll_voucher_formats ("preset:"); firma şablonları payroll-settings.export-templates.index ("template:"). | | `template_name_taken` | Bu adla aynı türde bir şablon zaten var. | payroll-settings.export-templates.update ile güncelleyin ya da başka bir ad verin. | | `unknown_field` | Şablonda alan kataloğunda olmayan bir alan adı var. | empuno reference export_template_fields; sabit değer için const:, parametre için param:, boş sütun için empty. | | `invalid_bank_code` | Banka kodu 5 haneli EFT/ÖHS kodu olmalı. | empuno reference tr_bank_codes. | | `invalid_param_iban` | Şablon parametresindeki IBAN (ör. borçlu firma hesabı) geçersiz (mod-97). | params.debit_iban değerini bankanızdaki IBAN ile düzeltin (TR + 24 hane). | | `detect_failed` | Örnek dosyada başlık satırı bulunamadı (ilk 30 satırda en az 2 tanınan sütun). | Başlıkları IBAN, Tutar, TC Kimlik No, Ad Soyad (fişte Hesap Kodu, Borç, Alacak) gibi tanınır adlarla yazın ya da şablonu elle oluşturun. | | `file_unreadable` | Dosya okunamadı. | xlsx, xls, csv ya da txt yükleyin (en çok 5 MB). | | `not_approved` | Banka ödeme dosyası yalnız onaylanmış, kesinleşmiş ya da ödenmiş dönemde üretilir. | Önce payroll.approve; önizleme (payroll.bank-file) her hesaplanmış dönemde açık. | | `total_changed` | Toplam tutar önizlemede görülenle aynı değil (bordro ya da IBAN'lar değişmiş olabilir). | payroll.bank-file ile yeniden önizleyin ve confirm_total'ı yeni toplamla gönderin. | | `no_payable_rows` | Dosyaya girecek çalışan yok. | Önizlemedeki excluded[] / other_bank[] nedenlerine bakın; eksik IBAN için payroll.bank-file.request-iban, diğer bankalar için include_other_banks=true ya da genel şablon. | | `missing_params` | Şablonun zorunlu parametresi eksik (ör. firma müşteri no, borçlu IBAN). | İsteğe params. ekleyin ya da şablonu payroll-settings.export-templates.update --params ile kalıcı tamamlayın. | | `revision_not_found` | Kapanmış düzeltme turu bulunamadı. | source=revision yalnız düzeltmeye açılıp yeniden kesinleşmiş dönemde; revision_id payroll.show revisions[]'dan. | | `invalid_payment_date` | Ödeme tarihi geçersiz. | payment_date YYYY-AA-GG biçiminde gönderin. | | `already_in_group` | Firma zaten bir grubun üyesi (bir firma en fazla bir gruba üye olabilir). | Önce group.leave ile mevcut gruptan ayrılın; gruplar birleştirilmez. | | `not_in_group` | Firma bir gruba üye değil. | group.index ile grubu ve üyeleri görün; grup yoksa group.store ile oluşturun. | | `not_manager_there` | Eklenmek istenen firmada aynı e-posta ve şifreyle YÖNETİCİ hesabınız yok. | O firmanın yöneticisinden davet kodu isteyin: karşı tarafta group.invites.store, burada değil o firmada group.join --code. | | `invalid_invite` | Davet kodu geçersiz, süresi dolmuş, iptal edilmiş ya da kullanılmış. | Grubun bir üyesinden yeni kod isteyin (group.invites.store; kodlar 7 gün geçerli, tek kullanımlık). | | `invite_foreign` | Davet kodu bu firmanın grubuna ait değil. | group.index invites[] listesindeki kimliği kullanın. | | `group_name_required` | Grup adı gerekli. | name gönderin (en çok 120 karakter). | | `same_company` | Kaynak ve hedef firma aynı. | Başka bir grup firması seçin. | | `company_not_found` | Firma bulunamadı (id ya da slug). | group.index members[] ya da `empuno companies` ile firma kimliğini doğrulayın. | | `employee_not_active` | Yalnız aktif çalışan naklen devredilir; bu çalışan ayrılmış. | Geçmişte yapılmış bir geçişi bağlamak için group-transfers.candidates ve group-transfers.link-bulk kullanın. | | `self_transfer` | Kendi çalışan kaydınızı nakledemezsiniz. | Naklinizi başka bir yönetici yapsın. | | `last_admin` | Firmanın son yöneticisi nakledilemez (en az bir yönetici kalmalı). | Önce başka bir kullanıcıyı yönetici yapın. | | `transfer_date_invalid` | Nakil tarihi geçersiz: işe girişten (ve son çalışma döneminin başlangıcından) sonra ve en geç bugün olmalı. | transfer_date = hedef firmadaki ilk iş günü (YYYY-AA-GG); kaynakta çıkış bir gün öncesine yazılır. İleri tarihli planlı nakil yok: tarihinde yapın. | | `exit_code_invalid` | Geçersiz SGK çıkış kodu. | Boş bırakın (22 — Diğer nedenler) ya da `empuno reference group_transfer_options` (exit_codes). | | `exit_code_16_not_same_employer` | Kod 16 yalnız aynı işverenin (aynı vergi numarası) işyerleri arasında kullanılır; bu iki firmanın vergi numarası farklı. | Kodu boş bırakın (22 — Diğer nedenler). Grup şirketleri ayrı işverendir (SGK duyurusu). | | `target_identity_active` | Hedef firmada aynı T.C. kimlik numaralı AKTİF bir çalışan var (çift kayıt açılmaz). | Kişi hedefte zaten çalışıyorsa geçmiş nakli group-transfers.link-bulk ile bağlayın (önce kaynakta çıkış: employees.terminate). | | `target_email_taken` | Hedef firmada bu e-posta başka bir aktif çalışana bağlı. | Aynı kişiyse geçmiş nakli group-transfers.link-bulk ile bağlayın; değilse kaynak çalışanın e-postasını düzeltin. | | `target_email_deleted` | Hedef firmada bu e-postayla silinmiş bir çalışan kaydı var (e-posta firmada tekildir). | Hedef firmada silinmiş kaydın e-postasını değiştirin ya da destek ekibine yazın (empuno tickets). | | `target_license_full` | Hedef firmanın lisansı dolu. | Hedef firmada lisansı artırın ya da bir aktif çalışanı pasifleştirin. | | `active_equipment` | Çalışanın zimmetli ekipmanı var. | Önce iade alın ya da confirm_active_equipment=true ile devam edin (zimmet kaynak firmada kalır). | | `target_department_foreign` | Departman hedef firmaya ait değil. | Boş bırakın (kaynaktaki departman adıyla eşlenir, yoksa varsayılan) ya da hedef firmanın departman kimliğini verin (`empuno --company departments.index`). | | `target_branch_foreign` | Şube hedef firmaya ait değil. | Boş bırakın (kaynaktaki şube adıyla eşlenir, yoksa merkez şube) ya da hedef firmanın şube kimliğini verin. | | `transfer_periods_conflict` | Devralınan çalışma dönemleri hedefteki mevcut dönemlerle çakışıyor. | Hedef çalışanın dönemlerini düzeltin (employees.employments.*) ya da destek ekibine yazın. | | `link_source_active` | Bağlama yalnız kaynakta AYRILMIŞ çalışan için yapılır; aktif çalışan naklen devredilir. | employees.group-transfer.store ile nakledin. | | `link_identity_mismatch` | İki kaydın T.C. kimlik numarası aynı değil ya da biri boş. | Doğru çifti group-transfers.candidates ile bulun. | | `link_dates_invalid` | Hedefteki işe giriş, kaynaktaki çıkıştan sonra olmalı. | Tarihleri kontrol edin (employees.termination.update / employees.employments.update). | | `link_target_not_active` | Bağlanacak hedef çalışan aktif değil. | Hedefte çalışan ayrıldıysa bağlama anlamsız; tarihleri kontrol edin. | | `transfer_not_completed` | Nakil kaydı tamamlanmış durumda değil (geri alınmış). | group-transfers.index ile güncel kayıtları görün. | | `revert_source_changed` | Kaynak çalışan nakilden sonra değişmiş (artık ayrılmış değil, çıkış tarihi farklı, silinmiş ya da yeniden işe alınmış): otomatik geri alma güvenli değil. | Çalışan kartını kontrol edin; gerekiyorsa hedefte işten çıkış (employees.terminate) + kaynakta yeniden işe alım (employees.rehire) ile elle düzeltin. | | `revert_target_changed` | Hedef çalışan artık aktif değil ya da silinmiş (ayrılmış ya da yeniden nakledilmiş): otomatik geri alma güvenli değil. | Önce sonraki nakli / çıkışı geri alın; değilse kaynakta yeniden işe alım (employees.rehire) ile elle düzeltin. | | `revert_target_activity` | Hedef firmada nakilden sonra bu çalışan için hareket var (bordro fişi, izin talebi, PDKS / puantaj, masraf, avans, zimmet, vardiya ataması, yüklenmiş evrak, teşvik, haciz, BES ya da yeni bordro profili / kalemi): geri alma bu kayıtları sahipsiz bırakırdı. | activity alanı sayıları verir. Hareketleri hedefte geri alın (zimmeti iade alın, vardiya atamasını / evrakı / kaydı silin) ya da nakli geri almak yerine hedefte işten çıkış (employees.terminate) + kaynakta yeniden işe alım (employees.rehire) yapın. | | `revert_source_payroll_closed` | Kaynak firmada çıkış ayı ya da sonrası için onaylanmış / kesinleşmiş / ödenmiş bordro var (çıkış bildirgeye girmiş olabilir). | periods alanındaki dönemleri önce düzeltmeye açın (payroll.reopen) ya da iptal edin (payroll.cancel), sonra yeniden deneyin. | | `revert_source_license_full` | Kaynak firmanın lisansı dolu: çalışan kaynakta yeniden aktif edilemez. | Kaynak firmada lisansı artırın ya da bir aktif çalışanı pasifleştirin. | | `revert_manual_required` | Hedefte yeniden kullanılmış çalışan kaydının nakilden önceki dönemi bulunamadı ya da dönem zinciri geri alınamıyor: kart otomatik olarak eski hâline getirilemez. | Hedefte işten çıkış (employees.terminate) + kaynakta yeniden işe alım (employees.rehire) ile elle düzeltin ya da destek ekibine yazın (empuno tickets). | ## Salt-okuma entegrasyon API'si Yalnızca izin ve masraf verisini kendi ERP/muhasebe sisteminize çekecekseniz sabit şemalı, salt-okuma **Company API** daha uygundur: https://empuno.com/api-docs. Ajan anahtarı o uçları da (`empuno api leaves`) ilgili modülün görüntüleme yetkisiyle çağırabilir. ## Komut kataloğu Biçim: `komut` — YÖNTEM /yol — özet [gereken yetki]. Alanlar (varsa) sunucu doğrulama kurallarıdır (best-effort). Anahtara özel liste: `empuno commands` / GET /api/company/v1/catalog. ### Avans Yönetimi (`advance_payments`) - `advance-payments.approve` — POST /manager/advance-payments/{advancePayment}/approve — Avans talepleri — Onayla [advance_payments.manage] - alanlar: `deduction_period` (required|string|regex:/^\d{4}-\d{2}$/) - `advance-payments.create` — GET /manager/advance-payments/create — Avans talepleri — Oluşturma formu verisi [advance_payments.manage] - `advance-payments.generate-contract` — POST /manager/advance-payments/{advancePayment}/generate-contract — Avans talepleri — generate contract [advance_payments.manage] - alanlar: `employee_tc` (nullable|string|max:11), `employee_position` (nullable|string|max:100), `company_address` (nullable|string|max:500), `amount_text` (nullable|string|max:200), `additional_terms` (nullable|string|max:1000) - `advance-payments.index` — GET /manager/advance-payments — Avans talepleri — Listele [advance_payments.view] - `advance-payments.record-repayment` — POST /manager/advance-payments/{advancePayment}/repayments — Avansa bordro dışı tahsilat kaydeder (banka, nakit, çıkış ödemesinden mahsup, vazgeçme). [advance_payments.manage] - alanlar: `amount` (required|numeric|gt:0), `paid_on` (nullable|date|'before_or_equal:' . $today), `source` (required|string|\Illuminate\Validation\Rule::in(array_keys(EmployeeAdvanceRepayment::SOURCES))), `reference` (nullable|string|max:100), `notes` (nullable|string|max:1000), `period` (nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/) - `advance-payments.reject` — POST /manager/advance-payments/{advancePayment}/reject — Avans talepleri — Reddet [advance_payments.manage] - alanlar: `rejection_reason` (required|string|max:500) - `advance-payments.settings` — GET /manager/advance-payments/settings — Avans talepleri — Ayarlar [advance_payments.manage] - `advance-payments.settings.update` — PUT /manager/advance-payments/settings — Avans ayarları — Güncelle [advance_payments.manage] - alanlar: `advance_enabled` (required|boolean), `advance_max_active_count` (required|integer|min:0|max:10), `advance_limit_type` (required|string|in:percentage,fixed,both), `advance_limit_percentage` (nullable|numeric|min:1|max:100), `advance_limit_amount` (nullable|numeric|min:100), `advance_max_installments` (required|integer|min:1|max:36) - `advance-payments.show` — GET /manager/advance-payments/{advancePayment} — Avans talepleri — Detay [advance_payments.view] - `advance-payments.store` — POST /manager/advance-payments — Yönetici avans kaydı: onay akışına GİRMEZ (doğrudan aktif) ve avans modülü [advance_payments.manage] - alanlar: `employee_id` (required|exists:employees,id), `amount` (required|numeric|min:100), `installment_count` (required|integer|min:1|max:36), `deduction_period` (required|string|regex:/^\d{4}-\d{2}$/), `notes` (nullable|string|max:500), `reason` (nullable|string|max:500), `advance_date` (nullable|date|'before_or_equal:' . $today), `deducted_amount` (nullable|numeric|min:0|lte:amount), `installment_amount` (nullable|numeric|gt:0) - `advance-payments.update` — PATCH /manager/advance-payments/{advancePayment} — Avans kaydını düzeltir; yalnız gönderilen alanlar değişir. [advance_payments.manage] - alanlar: `notes` (nullable|string|max:1000), `reason` (nullable|string|max:500), `deduction_period` (sometimes|required|string|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `installment_amount` (sometimes|required|numeric|gt:0), `installment_count` (sometimes|required|integer|min:1|max:36) ### AI Araçları (CV analizi, belge/e-posta taslağı) (`ai_assistants`) - `ai.chat` — POST /manager/ai/chat — AI Chat [ai_assistants.view] - alanlar: `message` (required|string|max:1000), `context` (nullable|array) - `ai.cv.analyze` — POST /manager/ai/cv-analysis — Analyze CV [ai_assistants.view] - alanlar: `cv_file` (required|file|mimes:pdf,doc,docx|max:10240), `requirements` (nullable|array) - `ai.document.generate` — POST /manager/ai/generate-document — Generate document [ai_assistants.view] - alanlar: `template` (required|string), `data` (required|array) - `ai.email.generate` — POST /manager/ai/generate-email — Generate email draft [ai_assistants.view] - alanlar: `type` (required|string), `data` (required|array) - `ai.generate-description` — POST /manager/ai/generate-description — Generate company description with AI [ai_assistants.view] - alanlar: `company_name` (required|string), `user_input` (required|string|max:2000), `industry` (nullable|string), `address` (nullable|string), `employee_count` (nullable|integer), `founding_year` (nullable|integer), `website` (nullable|string) - `ai.generate-job-posting` — POST /manager/ai/generate-job-posting — Generate job posting with AI [ai_assistants.view] - alanlar: `details` (required|string|max:2000) - `ai.image.analyze` — POST /manager/ai/analyze-image — Analyze image [ai_assistants.view] - alanlar: `image` (required|image|max:10240), `purpose` (required|string|in:id_verification,expense_receipt,document_scan,profile_photo) - `ai.index` — GET /manager/ai — AI Dashboard [ai_assistants.view] - alanlar: `id` ($interaction->id), `type` ($interaction->type), `prompt` ($interaction->prompt), `response` ($interaction->response), `model` ($interaction->model), `cost` ((float) ($interaction->cost ?? 0)), `created_at` ($interaction->created_at->toISOString()), `user` ('id' => $interaction->user->id|'name' => $interaction->user->name|'email' => $interaction->user->email) - `ai.leave.suggest` — POST /manager/ai/leave-suggestion/{leaveRequest} — Suggest leave approval [ai_assistants.view] - `ai.models` — GET /manager/ai/models — Get available AI models [ai_assistants.view] - `ai.performance.insights` — POST /manager/ai/performance-insights/{employee} — Generate performance insights [ai_assistants.view] ### Yönetici-özel (yetki devri, mali müşavirler) (`company_admin`) - `accountants.destroy` — DELETE /manager/accountants/{user} — Mali Müşavirler — Sil [company_admin] - `accountants.detail` — GET /manager/accountants/{user}/detail — Bir mali müşavir için ayrıntılı rapor geçmişi (JSON, detail dialog için). [company_admin] - `accountants.index` — GET /manager/accountants — Mali Müşavirler — Listele [company_admin] - alanlar: `id` ($u->id), `name` ($u->name), `email` ($u->email), `is_active` ((bool) $u->is_active), `first_login_completed` ((bool) $u->first_login_completed), `has_password` (!empty($u->password)), `has_other_role` ($this->hasOtherRole($u)), `other_role_label` ($u->is_manager ? 'Yönetici' : ($u->employee_id ? 'Çalışan' : null)), `created_at` ($u->created_at?->toIso8601String()), `reports_sent_count` ($stats['count']), `last_report_sent_at` ($stats['last_sent_at']), `last_send_error` ($stats['last_error']) - `accountants.invite.cancel` — DELETE /manager/accountants/invitations/{invitation} — Mali müşavir daveti — İptal et [company_admin] - `accountants.invite.resend` — POST /manager/accountants/invitations/{invitation}/resend — Mali müşavir daveti — Yeniden gönder [company_admin] - `accountants.store` — POST /manager/accountants — Mali Müşavirler — Oluştur [company_admin] - alanlar: `email` (required|email|max:255), `first_name` (required|string|max:100), `last_name` (required|string|max:100) - `accountants.toggle-active` — POST /manager/accountants/{user}/toggle-active — Mali Müşavirler — Aktif/pasif yap [company_admin] - `employees.permissions.edit` — GET /manager/employees/{employee}/permissions — Yetki devri — Düzenleme formu verisi [company_admin] - `employees.permissions.update` — PUT /manager/employees/{employee}/permissions — Yetki devri — Güncelle [company_admin] - `group.companies.store` — POST /manager/group/companies — Yöneticisi olduğunuz başka bir firmayı gruba doğrudan ekler (davet kodu gerekmez). [company_admin] - alanlar: `target_company` (required) - `group.invites.destroy` — DELETE /manager/group/invites/{invite} — Kullanılmamış bir davet kodunu iptal eder. [company_admin] - `group.invites.store` — POST /manager/group/invites — Gruba katılım için tek kullanımlık davet kodu üretir (ham kod YALNIZ bu yanıtta döner). [company_admin] - alanlar: `expires_in_days` (nullable|integer|min:1|max:30) - `group.join` — POST /manager/group/join — Davet koduyla bu firmayı bir gruba katar. [company_admin] - alanlar: `code` (required|string|max:40) - `group.leave` — POST /manager/group/leave — Bu firmayı gruptan çıkarır (her zaman serbest). [company_admin] - alanlar: `reason` (nullable|string|max:500) - `group.store` — POST /manager/group — Yeni grup şirketleri grubu oluşturur; bu firma ilk üye olur. [company_admin] - alanlar: `name` (required|string|max:120) - `group.update` — PATCH /manager/group — Grubun adını değiştirir. [company_admin] - alanlar: `name` (required|string|max:120) ### Şirket Kartları (`company_cards`) - `company-cards.destroy` — DELETE /manager/company-cards/{card} — Şirket kartları — Sil [company_cards.manage] - `company-cards.index` — GET /manager/company-cards — Şirket kartları — Listele [company_cards.view] - alanlar: `id` ($card->id), `cardholder_user_id` ($card->cardholder_user_id), `cardholder_name` ($card->cardholder?->name), `cardholder_email` ($card->cardholder?->email), `last_four` ($card->last_four), `card_type` ($card->card_type), `bank_name` ($card->bank_name), `label` ($card->label), `is_active` ($card->is_active), `display_name` ($card->display_name), `created_at` ($card->created_at?->format('Y-m-d H:i:s')) - `company-cards.store` — POST /manager/company-cards — Şirket kartları — Oluştur [company_cards.manage] - alanlar: `cardholder_user_id` (required|integer|Rule::exists('users', 'id')->where('company_id', $companyId)), `last_four` (required|string|size:4|regex:/^[0-9]{4}$/), `card_type` (required|in:credit,debit), `bank_name` (nullable|string|max:100), `label` (nullable|string|max:100), `is_active` (boolean) - `company-cards.toggle` — POST /manager/company-cards/{card}/toggle — Şirket kartları — Aç/kapat [company_cards.manage] - `company-cards.update` — PUT /manager/company-cards/{card} — Şirket kartları — Güncelle [company_cards.manage] - alanlar: `cardholder_user_id` (required|integer|Rule::exists('users', 'id')->where('company_id', $companyId)), `last_four` (required|string|size:4|regex:/^[0-9]{4}$/), `card_type` (required|in:credit,debit), `bank_name` (nullable|string|max:100), `label` (nullable|string|max:100), `is_active` (boolean) ### Firma Ayarları (`company_profile`) - `settings.cities` — GET /manager/settings/cities/{country} — Firma ayarları — cities [company_profile.view] - `settings.delete-logo` — DELETE /manager/settings/logo — Firma ayarları — delete logo [company_profile.manage] - `settings.districts` — GET /manager/settings/districts/{city} — Firma ayarları — districts [company_profile.view] - `settings.generate-with-ai` — POST /manager/settings/generate-with-ai — Firma ayarları — generate with ai [company_profile.manage] - alanlar: `description` (required|string|min:10|max:1000) - `settings.index` — GET /manager/settings — Firma ayarları — Listele [company_profile.view] - `settings.update` — PUT /manager/settings — Firma ayarları — Güncelle [company_profile.manage] - alanlar: `name` (required|string|max:255), `email` (nullable|email|max:255), `phone` (nullable|string|max:20), `address` (nullable|string|max:1000), `country_id` (nullable|exists:countries,id), `city_id` (nullable|exists:cities,id), `district_id` (nullable|exists:districts,id), `neighborhood` (nullable|string|max:100), `street` (nullable|string|max:255), `building_no` (nullable|string|max:50), `postal_code` (nullable|string|max:20), `description` (nullable|string|max:50000), `slogan` (nullable|string|max:255), `value_descriptions` (nullable|array), `value_descriptions.*` (nullable|string|max:1000), `website` (nullable|url|max:255), `linkedin_url` (nullable|url|max:255), `facebook_url` (nullable|url|max:255), `twitter_url` (nullable|url|max:255), `instagram_url` (nullable|url|max:255), `employee_count` (nullable|integer|min:1|max:999999), `founding_year` (nullable|integer|min:1800|max:2026), `industry` (nullable|string|max:255), `company_values` (nullable|array), `company_values.*` (nullable|string|max:500), `tax_number` (nullable|string|max:20), `legal_name` (nullable|string|max:255), `tax_office` (nullable|string|max:150), `billing_address` (nullable|string|max:500), `timezone` (required|string|timezone), `logo` (nullable|image|mimes:jpeg,png,jpg,gif|max:2048), `cover_image` (nullable|image|mimes:jpeg,png,jpg,gif|max:5120) ### Departman & Şube (`company_settings`) - `branches.active` — GET /manager/api/branches/active — Get branches for AJAX (for employee forms) [company_settings.view] - alanlar: `id` ($branch->id), `name` ($branch->display_name), `city` ($branch->city) - `branches.create` — GET /manager/branches/create — Show the form for creating a new resource. [company_settings.manage] - `branches.destroy` — DELETE /manager/branches/{branch} — Remove the specified resource from storage. [company_settings.manage] - `branches.edit` — GET /manager/branches/{branch}/edit — Show the form for editing the specified resource. [company_settings.manage] - `branches.index` — GET /manager/branches — Display a listing of the resource. [company_settings.view] - `branches.show` — GET /manager/branches/{branch} — Display the specified resource. [company_settings.view] - `branches.store` — POST /manager/branches — Store a newly created resource in storage. [company_settings.manage] - alanlar: `name` (required|string|max:255), `code` (nullable|string|max:10|Rule::unique('branches')->where(function ($query) use ($company) { return $query->where('company_id', $company->id); })), `address` (nullable|string|max:500), `city` (nullable|string|max:100), `phone` (nullable|string|max:20), `email` (nullable|email|max:255), `manager_name` (nullable|string|max:255), `is_active` (boolean) - `branches.toggle-status` — POST /manager/branches/{branch}/toggle-status — Toggle branch active status [company_settings.manage] - `branches.update` — PUT /manager/branches/{branch} — Update the specified resource in storage. [company_settings.manage] - alanlar: `name` (required|string|max:255), `code` (nullable|string|max:10|Rule::unique('branches')->where(function ($query) use ($branch) { return $query->where('company_id', $branch->company_id); })->ignore($branch->id)), `address` (nullable|string|max:500), `city` (nullable|string|max:100), `phone` (nullable|string|max:20), `email` (nullable|email|max:255), `manager_name` (nullable|string|max:255), `is_active` (boolean) - `departments.create` — GET /manager/departments/create — Departmanlar — Oluşturma formu verisi [company_settings.manage] - `departments.destroy` — DELETE /manager/departments/{department} — Departmanlar — Sil [company_settings.manage] - `departments.edit` — GET /manager/departments/{department}/edit — Departmanlar — Düzenleme formu verisi [company_settings.manage] - `departments.index` — GET /manager/departments — Departmanlar — Listele [company_settings.view] - `departments.show` — GET /manager/departments/{department} — Departmanlar — Detay [company_settings.view] - `departments.store` — POST /manager/departments — Departmanlar — Oluştur [company_settings.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string), `manager_name` (nullable|string|max:255) - `departments.update` — PUT /manager/departments/{department} — Departmanlar — Güncelle [company_settings.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string), `manager_name` (nullable|string|max:255) ### Kurumsal Evrak Deposu (`corporate_documents`) - `corporate-documents.destroy` — DELETE /manager/corporate-documents/{corporateDocument} — Kurumsal evraklar — Sil [corporate_documents.manage] - `corporate-documents.index` — GET /manager/corporate-documents — Kurumsal evraklar — Listele [corporate_documents.view] - `corporate-documents.show` — GET /manager/corporate-documents/{corporateDocument} — Kurumsal evraklar — Detay [corporate_documents.view] - `corporate-documents.status` — GET /manager/corporate-documents/status — Analizi devam eden kayıtların güncel durumu (liste ekranı yokluyor). [corporate_documents.view] - `corporate-documents.store` — POST /manager/corporate-documents — Yükleme — SADECE dosya. [corporate_documents.manage] - alanlar: `file` (required|file|mimes:pdf|'max:' . (self::MAX_FILE_MB * 1024)|new MaxPdfPages(self::MAX_PAGES, 'Kurumsal evrak')) - `corporate-documents.update` — PUT /manager/corporate-documents/{corporateDocument} — Yapay zekanın çıkardığı künyeyi yönetici düzeltebilir. [corporate_documents.manage] - alanlar: `document_type` (required|string|Rule::in(array_keys(config('corporate_document_types')))), `title` (nullable|string|max:255), `notes` (nullable|string|max:1000), `issued_date` (nullable|date), `expires_at` (nullable|date|after_or_equal:issued_date) ### Yönetim özeti (`dashboard`) - `dashboard` — GET /manager/dashboard — Yönetim özeti (dashboard) ### Veri Göçü (Eski Sistem) (`data_migration`) - `data-migration.advances.commit` — POST /manager/data-migration/advances/commit — Geçmiş maaş avansları ve devreden bakiyeler. records[]: çalışan anahtarı, amount, [data_migration.manage] - alanlar: `records` (required|array|min:1|max:500), `dry_run` (nullable|boolean), `records.*.amount` (required|numeric|gt:0), `records.*.advance_date` (required|date|before_or_equal:today), `records.*.deduction_period` (required|string|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `records.*.installment_count` (nullable|integer|min:1|max:120), `records.*.installment_amount` (nullable|numeric|gt:0), `records.*.deducted_amount` (nullable|numeric|min:0), `records.*.notes` (nullable|string|max:500), `records.*.reason` (nullable|string|max:500), `records.*.payment_reference` (nullable|string|max:100), `records.*.installments` (nullable|array|max:120), `records.*.installments.*.period` (required_with:records.*.installments|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `records.*.installments.*.amount` (required_with:records.*.installments|numeric|gt:0), `records.*.installments.*.source` (nullable|in:payroll,bank,cash,final_payment,write_off,other), `records.*.installments.*.reference` (nullable|string|max:100), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.documents.commit` — POST /manager/data-migration/documents/commit — Toplu personel evrakı (istek başına ≤10 dosya; büyük arşiv için CLI `empuno migrate [data_migration.manage] - alanlar: `manifest` (required|array|min:1|max:10), `files` (required|array|min:1|max:10), `files.*` (file|mimes:pdf,jpg,jpeg,png,webp|max:20480), `dry_run` (nullable|boolean), `manifest.*.file` (required), `manifest.*.document_type` (required|string), `manifest.*.title` (nullable|string|max:255), `manifest.*.document_date` (nullable|date), `manifest.*.period` (nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `manifest.*.visible_to_employee` (nullable|boolean), `manifest.*.notes` (nullable|string|max:1000) - `data-migration.employees` — GET /manager/data-migration/employees — Çalışan aktarım ekranı verisi (AI kredi bakiyesi). Ajan doğrudan data-migration.employees.parse / commit kullanır. [data_migration.manage] - `data-migration.employees.commit` — POST /manager/data-migration/employees/commit — Çalışanları kaydet (parse sonucu ya da ajanın kendi JSON'u). Davet e-postası GÖNDERMEZ, [data_migration.manage] - alanlar: `records` (required|array|min:1|max:500), `on_existing` (nullable|in:skip,update), `dry_run` (nullable|boolean), `records.*.first_name` (nullable|string|max:255), `records.*.last_name` (nullable|string|max:255), `records.*.email` (nullable|email|max:255), `records.*.phone` (nullable|string|max:50), `records.*.position` (nullable|string|max:255), `records.*.hire_date` (nullable|date), `records.*.birth_date` (nullable|date), `records.*.identity_number` (nullable|max:50), `records.*.salary` (nullable|numeric), `records.*.status` (required|in:active,inactive,terminated), `records.*.department_id` (nullable|integer|$sameCompany('departments')), `records.*.branch_id` (nullable|integer|$sameCompany('branches')), `records.*.department` (nullable|string|max:255), `records.*.branch` (nullable|string|max:255), `records.*.gender` (nullable|in:erkek,kadın,diğer), `records.*.iban` (nullable|string|max:34), `records.*.sgk_registration_no` (nullable|string|max:30), `records.*.sgk_start_date` (nullable|date), `records.*.sgk_occupation_code` (nullable|string|regex:/^\d{4}\.\d{2}$/), `records.*.marital_status` (nullable|in:bekar,evli,boşanmış,dul), `records.*.highest_education_level` (nullable|string|max:100), `records.*.disability_degree` (nullable|integer|between:0,3), `records.*.address` (nullable|string|max:500), `records.*.city` (nullable|string|max:100), `records.*.termination_date` (nullable|date), `records.*.termination_reason` (nullable|string|max:500), `records.*.sgk_exit_code` (nullable|string|\App\Support\SgkExitCodes::exitRule(\App\Support\SgkExitCodes::exitRecordCodes())), `records.*.sgk_workplace_id` (nullable|integer|$sameCompany('sgk_workplaces')), `records.*.sgk_workplace` (nullable|string|max:150), `records.*.employments` (nullable|array|max:50), `create_workplaces` (nullable|boolean) - `data-migration.employees.parse` — POST /manager/data-migration/employees/parse — Eski sistemden çalışan listesini AI ile ayrıştır (KAYDETMEZ; sonucu commit'e verin). [data_migration.manage] - `data-migration.employments.commit` — POST /manager/data-migration/employments/commit — Çalışma dönemleri + SGK işyeri aktarımı (giriş-çıkış geçmişi) — çalışan başına satır bazlı; davet/e-posta/push YOK. [data_migration.manage] - alanlar: `records` (required|array|min:1|max:500), `on_existing` (nullable|in:skip,update), `create_workplaces` (nullable|boolean), `dry_run` (nullable|boolean), `records.*.kind` (nullable|in:employment,prior_service), `records.*.hire_date` (required|date|before_or_equal:today), `records.*.termination_date` (nullable|date|before_or_equal:today), `records.*.sgk_exit_code` (nullable|string|Closure), `records.*.iskur_exit_reason` (nullable|string|in:"1","2","26","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25"), `records.*.termination_reason` (nullable|string|max:1000), `records.*.sgk_workplace_id` (nullable|integer), `records.*.sgk_workplace` (nullable|string|max:150), `records.*.insurance_group` (nullable|in:normal,sgdp,none), `records.*.continues_previous` (nullable), `records.*.severance_paid` (nullable), `records.*.severance_paid_amount` (nullable|numeric|min:0), `records.*.severance_paid_at` (nullable|date|before_or_equal:today), `records.*.counts_for_severance` (nullable), `records.*.counts_for_leave` (nullable), `records.*.override_note` (nullable|string|max:500), `records.*.external_employer_name` (nullable|string|max:255), `records.*.external_employer_tax_number` (nullable|digits_between:10,11), `records.*.notes` (nullable|string|max:1000), `records.*.sgk_workplace_registration_no` (nullable|string|max:60), `records.*.insurance_type` (nullable|string|max:60), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.expenses.commit` — POST /manager/data-migration/expenses/commit — Geçmiş (onaylanmış / ödenmiş) masraflar. records[]: çalışan anahtarı, expense_date [data_migration.manage] - alanlar: `records` (required|array|min:1|max:500), `dry_run` (nullable|boolean), `records.*.expense_date` (required|date|before_or_equal:today), `records.*.amount` (required|numeric|gt:0), `records.*.currency` (nullable|in:TRY,USD,EUR,GBP), `records.*.title` (nullable|string|max:255), `records.*.category_id` (nullable|integer), `records.*.category` (nullable|string|max:255), `records.*.description` (nullable|string|max:2000), `records.*.merchant_name` (nullable|string|max:255), `records.*.tax_amount` (nullable|numeric|min:0), `records.*.payment_method` (nullable|Rule::in(array_keys(Expense::PAYMENT_METHOD_LABELS))), `records.*.status` (nullable|in:paid,approved), `records.*.paid_at` (nullable|date|before_or_equal:today), `records.*.payment_reference` (nullable|string|max:100), `records.*.accounting_processed` (nullable|boolean), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.files` — GET /manager/data-migration/files — Dosyadan aktarım ekranı (yönetici): eski sistemin Excel/CSV dışa aktarımı → önizleme → [data_migration.manage] - `data-migration.files.parse` — POST /manager/data-migration/files/parse — Excel/CSV dosyasını aktarım kayıtlarına çevirir (yazmaz): kind = employees | leaves | advances | [data_migration.manage] - alanlar: `kind` (required|Rule::in(array_keys(MigrationFileParser::kinds()))), `file` (required|file|max:10240|mimes:xlsx,xls,csv,txt), `period` (nullable|string|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `code_map` (nullable|array|max:100), `code_map.*` (string|Rule::in(\App\Services\Payroll\Attendance\AttendanceCodes::canonicals())), `format` (nullable|in:auto,grid,summary) - `data-migration.incentive-facts.commit` — POST /manager/data-migration/incentive-facts/commit — Teşvik bilgileri (+ önceki sistemde uygulanan kanun; TK-0UXIAY §4): records[]: çalışan anahtarı, teşvik bilgisi [data_migration.manage, payroll.manage] - alanlar: `records` (required|array|min:1|max:1000), `on_existing` (nullable|in:skip,update), `dry_run` (nullable|boolean), `records.*.law_no` (nullable|string|max:10), `records.*.start_date` (nullable|date), `records.*.end_date` (nullable|date), `records.*.status` (nullable|in:proposed,active,ended), `records.*.certificate_no` (nullable|string|max:60), `records.*.notes` (nullable|string|max:1000), `records.*.disability_rate` (nullable|numeric|min:0|max:100), `records.*.uninsured_6_months_before_hire` (nullable), `records.*.iskur_registered_unemployed` (nullable), `records.*.vocational_certificate` (nullable), `records.*.social_assistance_household` (nullable), `records.*.law_2828_beneficiary` (nullable), `records.*.unemployment_benefit_remaining_days` (nullable), `records.*.abroad_assignment` (nullable), `records.*.investment_certificate` (nullable|array), `records.*.culture_certificate` (nullable|array), `records.*.sgk_definition_done` (nullable|array), `records.*.additional_employment_override` (nullable), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.index` — GET /manager/data-migration — Veri göçü ana ekranı: AI kredi bakiyesi (aktarım türleri ve komutları: rehber #gecis, `empuno migrate `). [data_migration.manage] - `data-migration.leaves` — GET /manager/data-migration/leaves — İzin geçmişi aktarım ekranı verisi (AI kredi bakiyesi). Ajan doğrudan data-migration.leaves.parse / commit kullanır. [data_migration.manage] - `data-migration.leaves.commit` — POST /manager/data-migration/leaves/commit — Geçmiş izinleri kaydet (onaylı, geçmiş tarihli; bakiye hesabına girer). Tek çalışan [data_migration.manage] - alanlar: `employee_id` (nullable|integer), `dry_run` (nullable|boolean), `records` (required|array|min:1|max:1000), `records.*.leave_type_id` (nullable|integer), `records.*.leave_type` (nullable|string|max:100), `records.*.start_date` (required|date), `records.*.end_date` (required|date|after_or_equal:records.*.start_date), `records.*.days` (required|numeric|min:0.01), `records.*.reason` (nullable|string|max:500), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.leaves.parse` — POST /manager/data-migration/leaves/parse — Bir çalışanın eski izin geçmişini AI ile ayrıştır (KAYDETMEZ; sonucu leaves.commit'e verin). [data_migration.manage] - `data-migration.payroll.commit` — POST /manager/data-migration/payroll/commit — Geçmiş bordroları müşavirin hesapladığı tutarlarla aktarır; update_fields=declaration ile yalnız beyan alanlarını (SGK/MUHSGK) günceller. [data_migration.manage, payroll.manage] - alanlar: `records` (required|array|min:1|max:600), `dry_run` (nullable|boolean), `on_existing` (nullable|in:skip,update), `update_fields` (nullable|in:all,declaration), `records.*.period` (required|string|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `records.*.gross_total` (required_unless:update_fields,declaration|nullable|numeric|min:0), `records.*.income_tax_base` (required_unless:update_fields,declaration|nullable|numeric|min:0), `records.*.net_pay` (required_unless:update_fields,declaration|nullable|numeric), `records.*.sgk_days` (nullable|numeric|min:0|max:31), `records.*.paid_at` (nullable|date), `records.*.employer_incentive_code` (nullable|string|max:30), `records.*.notes` (nullable|string|max:1000), `records.*.earnings` (nullable|array|max:30), `records.*.earnings.*.name` (required_with:records.*.earnings|string|max:100), `records.*.earnings.*.amount` (required_with:records.*.earnings|numeric), `records.*.earnings.*.taxable` (nullable|boolean), `records.*.earnings.*.sgk` (nullable|boolean), `records.*.earnings.*.type` (nullable|in:leave_pay,notice,severance,severance_excess), `records.*.earnings.*.days` (nullable|numeric|min:0), `records.*.earnings.*.income_tax` (nullable|numeric|min:0), `records.*.earnings.*.stamp_tax` (nullable|numeric|min:0), `records.*.deductions` (nullable|array|max:30), `records.*.deductions.*.name` (required_with:records.*.deductions|string|max:100), `records.*.deductions.*.amount` (required_with:records.*.deductions|numeric), `records.*.deductions.*.type` (nullable|in:advance,garnishment,alimony,tax_debt,bes,union,penalty,rd_retained,other), `records.*.worked_days` (nullable|numeric), `records.*.unpaid_leave_days` (nullable|numeric), `records.*.paid_leave_days` (nullable|numeric), `records.*.gross_salary` (nullable|numeric), `records.*.overtime_hours` (nullable|numeric), `records.*.overtime_pay` (nullable|numeric), `records.*.sgk_base` (nullable|numeric), `records.*.sgk_employee` (nullable|numeric), `records.*.sgk_employee_pension` (nullable|numeric), `records.*.sgk_employee_health` (nullable|numeric), `records.*.unemployment_employee` (nullable|numeric), `records.*.sgk_employee_total` (nullable|numeric), `records.*.sgk_employer` (nullable|numeric), `records.*.sgk_employer_pension` (nullable|numeric), `records.*.sgk_employer_health` (nullable|numeric), `records.*.sgk_employer_short_term` (nullable|numeric), `records.*.unemployment_employer` (nullable|numeric), `records.*.sgk_employer_total` (nullable|numeric), `records.*.employer_incentive_amount` (nullable|numeric), `records.*.minimum_wage_support` (nullable|numeric), `records.*.cumulative_tax_base` (nullable|numeric), `records.*.income_tax` (nullable|numeric), `records.*.mw_income_tax_exemption` (nullable|numeric), `records.*.income_tax_final` (nullable|numeric), `records.*.stamp_tax_base` (nullable|numeric), `records.*.stamp_tax` (nullable|numeric), `records.*.mw_stamp_exemption` (nullable|numeric), `records.*.stamp_tax_final` (nullable|numeric), `records.*.disability_deduction` (nullable|numeric), `records.*.other_deductions` (nullable|numeric), `records.*.employer_cost` (nullable|numeric), `records.*.sgk_workplace_id` (nullable|integer), `records.*.sgk_workplace` (nullable|string|max:120), `records.*.sgk_entry_date` (nullable|date), `records.*.sgk_exit_date` (nullable|date), `records.*.sgk_exit_code` (nullable|string|max:4), `records.*.missing_day_count` (nullable|numeric|min:0|max:31), `records.*.missing_day_reason` (nullable|string|max:10), `records.*.sgk_document_type` (nullable|string|max:10), `records.*.insurance_group` (nullable|string|max:30), `records.*.sgk_occupation_code` (nullable|string|max:20), `records.*.sgk_workplace_registration_no` (nullable|string|max:60), `records.*.tax_payment_type` (nullable|string|max:10), `records.*.rd_law` (nullable|string|max:10), `records.*.rd_rate` (nullable|numeric|min:0|max:100), `records.*.rd_days` (nullable|numeric|min:0|max:31), `records.*.rd_income_tax_exemption` (nullable|numeric|min:0), `records.*.rd_stamp_exemption` (nullable|numeric|min:0), `records.*.rd_sgk_support` (nullable|numeric|min:0), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.pension-enrollments.commit` — POST /manager/data-migration/pension-enrollments/commit — BES katılım kayıtları (önceki sistemden; TK-0UXIAY §5): records[]: çalışan anahtarı, plan_id | contract_no (vars. [data_migration.manage, payroll.manage] - alanlar: `records` (required|array|min:1|max:1000), `on_existing` (nullable|in:skip,update), `dry_run` (nullable|boolean), `records.*.plan_id` (nullable|integer), `records.*.contract_no` (nullable|string|max:60), `records.*.status` (nullable|in:active,paused,opted_out,left), `records.*.enrolled_on` (required|date), `records.*.rate` (nullable|numeric|min:0|max:100), `records.*.notified_at` (nullable|date), `records.*.opted_out_at` (nullable|date), `records.*.paused_from` (nullable|date), `records.*.paused_until` (nullable|date), `records.*.left_at` (nullable|date), `records.*.certificate_no` (nullable|string|max:60), `records.*.voluntary` (nullable|boolean), `records.*.notes` (nullable|string|max:1000), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `data-migration.work-advances.commit` — POST /manager/data-migration/work-advances/commit — Geçmiş iş avansları (195): records[]: çalışan anahtarı, amount, given_on (≤ bugün), purpose, [data_migration.manage] - alanlar: `records` (required|array|min:1|max:1000), `dry_run` (nullable|boolean), `records.*.amount` (required|numeric|gt:0), `records.*.given_on` (required|date|before_or_equal:today), `records.*.purpose` (nullable|string|max:255), `records.*.payment_reference` (nullable|string|max:100), `records.*.spent_amount` (nullable|numeric|min:0), `records.*.refunded_amount` (nullable|numeric|min:0), `records.*.due_on` (nullable|date), `records.*.notes` (nullable|string|max:1000), `records.*.currency` (nullable|in:TRY,USD,EUR,GBP), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) ### Kesinti Raporları (`deduction_reports`) - `deduction-report-settings.update` — PUT /manager/deduction-report-settings — Kesinti raporu ayarlarını upsert eder (aylık anchor günü + aktiflik). [deduction_reports.manage] - alanlar: `monthly_day` (nullable|integer|min:1|max:28), `is_active` (required|boolean) - `deduction-reports.download` — GET /manager/deduction-reports/{report}/download — PDF'i force-download ile indirir. [deduction_reports.view] - `deduction-reports.download-excel` — GET /manager/deduction-reports/{report}/download-excel — Excel'i force-download ile indirir. [deduction_reports.view] - `deduction-reports.generate-now` — POST /manager/deduction-reports/generate-now — Manuel rapor üretimi. Önceki tam ayı (anchor güne göre) hesaplar ve [deduction_reports.manage] - `deduction-reports.index` — GET /manager/deduction-reports — Geçmiş kesinti raporları + ayar kartı. Tek truth source olarak [deduction_reports.view] - `deduction-reports.preview` — GET /manager/deduction-reports/{report} — PDF'i tarayıcıda inline olarak gösterir (önizleme için). [deduction_reports.view] - `deduction-reports.resend` — POST /manager/deduction-reports/{report}/resend — Mevcut raporu mali müşavirlere yeniden gönderir. [deduction_reports.manage] ### Personel Evrakları (`documents`) - `documents.missing` — GET /manager/documents/missing — Eksik zorunlu evrak listesi: çalışan başına eksik kalemler (status active vars. | terminated | all; employee_id; requirement; per_page ≤100). [documents.view] - alanlar: `status` (nullable|Rule::in(['active', 'terminated', 'all'])), `employee_id` (nullable|integer), `requirement` (nullable|string|max:40), `page` (nullable|integer|min:1) - `documents.requirements` — GET /manager/documents/requirements — Zorunlu evrak politikası: aşama başına zorunlu kalemler (required), kaynak (default | company) ve tüm kalemler (catalog). [documents.view] - `documents.requirements.update` — PUT /manager/documents/requirements — Zorunlu evrak politikasını değiştirir: required.onboarding / required.exit = kalem anahtarları listesi (aşamanın tamamı; gönderilmeyen aşama aynen kalır). [documents.manage] - alanlar: `required` (required|array), `required.onboarding` (sometimes|array), `required.onboarding.*` (string|max:40), `required.exit` (sometimes|array), `required.exit.*` (string|max:40) - `employees.documents.destroy` — DELETE /manager/employees/{employee}/documents/{document} — Çalışan evrağını sil. documents.manage gerektirir. [documents.manage] - `employees.documents.show` — GET /manager/employees/{employee}/documents/{document} — Çalışan evrağını tarayıcıda göster. documents.view yeterli. [documents.view] - `employees.documents.store` — POST /manager/employees/{employee}/documents — Çalışana evrak yükle (file: tek PDF ≤20 MB ya da images[]: taranmış sayfalar). [documents.manage] - alanlar: `document_type` (required|Rule::in(array_keys(config('document_types.employee')))), `title` (nullable|string|max:255), `notify_employee` (nullable|boolean), `file` (required_without:images|file|mimes:pdf|max:20480), `images` ('required_without:file|array|min:1|max:' . DocumentScanService::MAX_PAGES), `images.*` (image|max:10240), `notes` (nullable|string|max:1000), `visible_to_employee` (sometimes|boolean), `document_date` (sometimes|nullable|date), `period` (sometimes|nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/) - `employees.documents.update` — PATCH /manager/employees/{employee}/documents/{document} — Evrak bilgisini düzelt (dosyaya dokunmaz): tür, başlık, görünürlük, belge tarihi, dönem. [documents.manage] - alanlar: `document_type` (sometimes|required|Rule::in(array_keys(config('document_types.employee')))), `title` (sometimes|nullable|string|max:255), `notify_employee` (nullable|boolean), `visible_to_employee` (sometimes|boolean), `document_date` (sometimes|nullable|date), `period` (sometimes|nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/) ### Çalışan Yönetimi (`employees`) - `employees.available` — GET /manager/employees/available — Get available employees for equipment assignment [employees.manage] - alanlar: `id` ($employee->id), `full_name` ($employee->full_name), `department` ($employee->department ? ['name' => $employee->department->name] : null), `branch` ($employee->branch ? ['name' => $employee->branch->name] : null), `equipment_count` ($equipmentCount) - `employees.create` — GET /manager/employees/create — Çalışanlar — Oluşturma formu verisi [employees.manage] - `employees.edit` — GET /manager/employees/{employee}/edit — Düzenleme formu verisi (yalnız aktif/pasif çalışan; ayrılmışta profile yönlendirir). [employees.manage] - `employees.employments.destroy` — DELETE /manager/employees/{employee}/employments/{employment} — Çalışma dönemini siler (geri alınabilir kayıt silme) — dry_run destekler. [employees.manage] - alanlar: `reason` (nullable|string|max:500), `dry_run` (nullable|boolean) - `employees.employments.index` — GET /manager/employees/{employee}/employments — Çalışanın çalışma dönemleri, SGK işyeri ve kıdem/izin/ihbar süresi özeti — yan etkisiz. [employees.view] - `employees.employments.store` — POST /manager/employees/{employee}/employments — Geçmiş çalışma dönemi ya da önceki hizmet (kind=prior_service) ekler — dry_run destekler; e-posta yok. [employees.manage] - alanlar: `kind` (nullable|in:employment,prior_service), `hire_date` (required|date|before_or_equal:today), `termination_date` (nullable|date|before_or_equal:today), `sgk_exit_code` (nullable|string|Closure), `iskur_exit_reason` (nullable|string|in:"1","2","26","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25"), `termination_reason` (nullable|string|max:1000), `sgk_workplace_id` (nullable|integer), `sgk_workplace` (nullable|string|max:150), `insurance_group` (nullable|in:normal,sgdp,none), `continues_previous` (nullable|boolean), `severance_paid` (nullable|boolean), `severance_paid_amount` (nullable|numeric|min:0), `severance_paid_at` (nullable|date|before_or_equal:today), `counts_for_severance` (nullable|boolean), `counts_for_leave` (nullable|boolean), `override_note` (nullable|string|max:500), `external_employer_name` (nullable|string|max:255|required_if:kind,prior_service), `external_employer_tax_number` (nullable|digits_between:10,11), `notes` (nullable|string|max:1000), `external_company_id` (prohibited), `external_employment_id` (prohibited), `transfer_uuid` (prohibited), `dry_run` (nullable|boolean) - `employees.employments.transfer` — POST /manager/employees/{employee}/employments/transfer — Şirket içi SGK işyeri nakli — açık dönem date−1'de 16 koduyla kapanır, date'te yeni işyerinde devam eder. [employees.manage] - alanlar: `date` (required|date|before_or_equal:today), `sgk_workplace_id` (nullable|integer|required_without:sgk_workplace), `sgk_workplace` (nullable|string|max:150), `notes` (nullable|string|max:1000), `dry_run` (nullable|boolean) - `employees.employments.update` — PATCH /manager/employees/{employee}/employments/{employment} — Çalışma dönemini düzeltir — yalnız gönderilen alanlar; dry_run destekler. [employees.manage] - alanlar: `kind` (sometimes|required|in:employment,prior_service), `hire_date` (sometimes|required|date|before_or_equal:today), `termination_date` (nullable|date|before_or_equal:today), `sgk_exit_code` (nullable|string|Closure), `iskur_exit_reason` (nullable|string|in:"1","2","26","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25"), `termination_reason` (nullable|string|max:1000), `sgk_workplace_id` (nullable|integer), `sgk_workplace` (nullable|string|max:150), `insurance_group` (nullable|in:normal,sgdp,none), `continues_previous` (nullable|boolean), `severance_paid` (nullable|boolean), `severance_paid_amount` (nullable|numeric|min:0), `severance_paid_at` (nullable|date|before_or_equal:today), `counts_for_severance` (nullable|boolean), `counts_for_leave` (nullable|boolean), `override_note` (nullable|string|max:500), `external_employer_name` (nullable|string|max:255), `external_employer_tax_number` (nullable|digits_between:10,11), `notes` (nullable|string|max:1000), `external_company_id` (prohibited), `external_employment_id` (prohibited), `transfer_uuid` (prohibited), `dry_run` (nullable|boolean) - `employees.group-transfer.create` — GET /manager/employees/{employee}/group-transfer — Grup şirketine nakil önizlemesi (yan etkisiz): engeller, uyarılar, hedefte departman/şube eşlemesi, kalan izin, [employees.manage, group.manage] - `employees.group-transfer.store` — POST /manager/employees/{employee}/group-transfer — Çalışanı grup şirketine naklen devreder (TBK 429; kıdem ve izin kesintisiz). [employees.manage, group.manage] - `employees.index` — GET /manager/employees — Çalışanları listeler — filtreler: search (ad/e-posta/sicil no), department, status (vars. active,inactive; terminated | all), sgk_workplace_id, per_page. [employees.view] - `employees.leave-balance-detail` — GET /manager/employees/{employee}/leave-balance-detail — Get detailed leave balance for an employee (JSON endpoint for modal) [employees.view] - `employees.leave-balance-export` — GET /manager/employees/{employee}/leave-balance-export — Export employee leave balance report to Excel [employees.view] - `employees.profile` — GET /manager/employees/{employee}/profile — Çalışan detayı — kişisel/iş bilgileri, izin bakiyeleri, zimmet, belgeler; çalışma dönemleri ve SGK işyeri dahil (yan etkisiz). [employees.view] - `employees.reactivate` — POST /manager/employees/{employee}/reactivate — Çalışanlar — Yeniden aktifleştir [employees.manage] - `employees.rehire` — POST /manager/employees/{employee}/rehire — Ayrılmış çalışanı yeniden işe alır — yeni çalışma dönemi açar, eski dönem ve hesapları korunur. [employees.manage] - alanlar: `hire_date` (required|date|before_or_equal:today), `sgk_workplace_id` (nullable|integer), `sgk_workplace` (nullable|string|max:150), `insurance_group` (nullable|in:normal,sgdp,none), `update_payroll_profile` (nullable|boolean), `notes` (nullable|string|max:1000), `dry_run` (nullable|boolean) - `employees.resend-invite` — POST /manager/employees/{employee}/resend-invite — Kabul edilmemiş çalışan davetini yeniden gönderir (token + süre yenilenir). [employees.manage] - `employees.show` — GET /manager/employees/{employee} — Çalışan detayı — kişisel/iş bilgileri, izin bakiyeleri, zimmet, belgeler; çalışma dönemleri ve SGK işyeri dahil (yan etkisiz). [employees.view] - `employees.store` — POST /manager/employees — Çalışan davet et: yalnız e-posta alır, çalışana DAVET E-POSTASI gönderir ve lisans tüketir. [employees.manage] - alanlar: `email` ($invitations->emailRules($company)), `sgk_workplace_id` (nullable|integer|Rule::exists('sgk_workplaces', 'id')->where('company_id', $company->id)) - `employees.terminate` — POST /manager/employees/{employee}/terminate — İşten çıkış: durum "terminated", kullanıcı hesabı pasif, BEKLEYEN izin/avans/masraf talepleri iptal. [employees.manage] - alanlar: `termination_date` ($service->terminationDateRule($employee)), `termination_reason` (nullable|string|max:500), `sgk_exit_code` (nullable|string|\App\Support\SgkExitCodes::exitRule(\App\Support\SgkExitCodes::terminationCodes())), `confirm_active_equipment` (sometimes|boolean), `advance_action` (nullable|in:keep,settle_in_final_payroll), `exit_settlement` (nullable|in:confirm,pending), `exit_leave_days` (nullable|numeric|min:0|max:400), `exit_include_leave_pay` (nullable|boolean), `exit_include_notice` (nullable|boolean), `exit_notice_served` (nullable|boolean), `exit_include_severance` (nullable|boolean) - `employees.termination.update` — PUT /manager/employees/{employee}/termination — Ayrılmış çalışanın çıkış bilgisini düzelt (tarih, gerekçe, SGK çıkış kodu). [employees.manage] - alanlar: `termination_date` ($service->terminationDateRule($employee)), `termination_reason` (nullable|string|max:500), `sgk_exit_code` (nullable|string|\App\Support\SgkExitCodes::exitRule(\App\Support\SgkExitCodes::exitRecordCodes())) - `employees.update` — PUT /manager/employees/{employee} — Çalışan sicilini güncelle — yalnız gönderilen alanlar değişir, gönderilmeyen alan olduğu gibi kalır. [employees.manage] - alanlar: `first_name` (required|string|max:255), `last_name` (required|string|max:255), `email` ($isTerminated ? 'nullable' : 'required'|email|Rule::unique('employees', 'email') ->where('company_id', $employee->company_id) ->ignore($employee->id)), `phone` (nullable|string|max:20), `department_id` (required|exists:departments,id), `branch_id` (nullable|exists:branches,id), `position` (nullable|string|max:255), `salary` (nullable|numeric|min:0), `hire_date` (required|date), `birth_date` (nullable|date), `status` (required|Rule::in($isTerminated ? ['terminated'] : ['active', 'inactive'])), `role` (nullable|in:employee,admin), `sgk_registration_no` (nullable|string|max:30), `sgk_start_date` (nullable|date), `sgk_occupation_code` (nullable|string|regex:/^\d{4}\.\d{2}$/), `sgk_workplace_id` (nullable|integer|Rule::exists('sgk_workplaces', 'id')->where('company_id', $employee->company_id)), `nationality` (nullable|string|max:255), `gender` (nullable|in:erkek,kadın,diğer), `disability_degree` (nullable|string|max:255), `citizenship` (nullable|string|max:255), `identity_number` (nullable|string|max:11), `education_status` (nullable|string|max:255), `highest_education_level` (nullable|string|max:255), `last_education_institution` (nullable|string|max:255), `marital_status` (nullable|in:bekar,evli,boşanmış,dul), `number_of_children` (nullable|integer|min:0), `address` (nullable|string), `address_continued` (nullable|string), `city` (nullable|string|max:255), `country` (nullable|string|max:255), `postal_code` (nullable|string|max:10), `address_phone` (nullable|string|max:20), `bank_name` (nullable|string|max:255), `account_type` (nullable|in:vadesiz,vadeli,tasarruf), `account_number` (nullable|string|max:255), `iban` (nullable|string|max:34|new \App\Rules\Iban('IBAN')), `personal_email` (nullable|email|max:255), `personal_phone` (nullable|string|max:20), `emergency_contact_name` (nullable|string|max:255), `emergency_contact_phone` (nullable|string|max:20), `emergency_contact_relationship` (nullable|string|max:255) - `group-transfers.candidates` — GET /manager/group-transfers/candidates — Olası geçmiş nakiller (sistem bulur): erişilebilir grup firmaları arasında aynı T.C.'li "bir firmada ayrılmış + [employees.view] - `group-transfers.consent` — POST /manager/group-transfers/{transfer}/consent — İmzalı devir protokolünü yükler (PDF / JPG / PNG, en çok 20 MB): bu firmadaki çalışan kaydının özlük dosyasına [employees.manage, group.manage] - alanlar: `document` (required|file|mimes:pdf,jpg,jpeg,png|max:20480) - `group-transfers.index` — GET /manager/group-transfers — Grup içi nakiller (bu firmadan giden ve bu firmaya gelen): yön (direction in | out), durum (completed | [employees.view] - alanlar: `direction` (nullable|in:in,out), `status` (nullable|Rule::in(array_keys(EmployeeGroupTransfer::STATUSES))), `mode` (nullable|Rule::in(array_keys(EmployeeGroupTransfer::MODES))), `consent` (nullable|Rule::in(array_keys(EmployeeGroupTransfer::CONSENT_STATUSES))) - `group-transfers.link-bulk` — POST /manager/group-transfers/link-bulk — Geçmiş nakilleri toplu bağlar (kayıt oluşturmadan): kaynakta ayrılmış + hedefte aynı T.C.'li aktif çalışan. [employees.manage, group.manage] - alanlar: `records` (required|array|min:1|max:200), `records.*.source_employee_id` (required|integer), `records.*.target_employee_id` (required|integer), `records.*.to` (nullable), `records.*.from` (nullable), `records.*.transfer_date` (nullable|date), `dry_run` (nullable|boolean) - `group-transfers.protocol` — GET /manager/group-transfers/{transfer}/protocol — Devir protokolü PDF'i (TBK 429; devreden, devralan ve işçi imzası için). T.C. kimlik no employees.manage [employees.view] - `group-transfers.revert` — POST /manager/group-transfers/{transfer}/revert — Grup içi nakli ya da geçmiş nakil bağlamasını geri alır (yanlış nakil düzeltmesi; koşullu, iki firmada tek işlem). [employees.manage, group.manage] - alanlar: `reason` (required|string|min:5|max:500), `notify_accountants` (nullable|boolean), `dry_run` (nullable|boolean) - `group-transfers.show` — GET /manager/group-transfers/{transfer} — Nakil kaydının ayrıntısı (yalnız bu firmanın kaynak ya da hedef olduğu kayıt; yan etkisiz). `revert` alanı [employees.view] - `reports.personnel` — GET /manager/reports/personnel — Personel raporu (report=list|registry|personal|hires|exits; as_of=YYYY-AA-GG, from/to hareket raporlarında). [employees.view] - alanlar: `report` (required|Rule::in(array_keys(PersonnelReports::REPORTS))), `as_of` (nullable|date_format:Y-m-d), `from` (nullable|date_format:Y-m-d), `to` (nullable|date_format:Y-m-d|after_or_equal:from), `include_leavers` (nullable|boolean), `show_salary` (nullable|boolean), `show_bank` (nullable|boolean), `sgk_workplace_id` (nullable|integer), `department_id` (nullable|integer), `format` (nullable|Rule::in(['json', 'xlsx', 'pdf'])) ### Ekipman Yönetimi (`equipment`) - `equipment-assignments.documents.destroy` — DELETE /manager/equipment-assignments/{equipmentAssignment}/documents/{document} — İmzalı zimmet/iade formunu sil. equipment.manage gerektirir. [equipment.manage] - `equipment-assignments.documents.show` — GET /manager/equipment-assignments/{equipmentAssignment}/documents/{document} — İmzalı zimmet/iade formunu tarayıcıda göster. equipment.view yeterli. [equipment.view] - `equipment-assignments.documents.store` — POST /manager/equipment-assignments/{equipmentAssignment}/documents — İmzalı zimmet/iade formu yükle (PDF veya görsel(ler)). equipment.manage gerektirir. [equipment.manage] - alanlar: `document_type` (sometimes|in:zimmet_signed,iade_signed), `file` (required_without:images|file|mimes:pdf|max:20480), `images` ('required_without:file|array|min:1|max:' . DocumentScanService::MAX_PAGES), `images.*` (image|max:10240), `notes` (nullable|string|max:1000) - `equipment-assignments.index` — GET /manager/equipment-assignments — Zimmetler — Listele [equipment.view] - `equipment-assignments.pdf` — GET /manager/equipment-assignments/{equipmentAssignment}/pdf — Zimmetler — PDF indir [equipment.view] - `equipment-assignments.return-pdf` — GET /manager/equipment-assignments/{assignment}/return-pdf — Generate return receipt PDF for a returned equipment assignment [equipment.view] - `equipment.analyze-photos` — POST /manager/equipment/analyze-photos — Foto'lari S3'e yukle + AI analiz et + sonuclari don. [equipment.manage] - alanlar: `photos` (required|array|min:1|max:5), `photos.*` (required|image|max:8192) - `equipment.assign` — POST /manager/equipment/{equipment}/assign — Ekipmanlar — Ata [equipment.manage] - alanlar: `employee_id` (required|exists:employees,id), `assigned_date` (required|date), `assignment_notes` (nullable|string), `delivery_photo` (nullable|image|max:8192) - `equipment.create` — GET /manager/equipment/create — Ekipmanlar — Oluşturma formu verisi [equipment.manage] - `equipment.destroy` — DELETE /manager/equipment/{equipment} — Ekipmanlar — Sil [equipment.manage] - `equipment.edit` — GET /manager/equipment/{equipment}/edit — Ekipmanlar — Düzenleme formu verisi [equipment.manage] - `equipment.index` — GET /manager/equipment — Ekipmanlar — Listele [equipment.view] - `equipment.invoice.destroy` — DELETE /manager/equipment/{equipment}/invoice — Fatura dosyasını sil. Fatura no + KDV alanları temizlenir; alış fiyatı ve [equipment.manage] - `equipment.invoice.show` — GET /manager/equipment/{equipment}/invoice — Fatura PDF/görselini görüntüle (S3 geçici URL'ine yönlendirir). [equipment.view] - `equipment.invoice.store` — POST /manager/equipment/{equipment}/invoice — Fatura yükle + AI ile fatura bilgilerini (fatura no, tarih, tutar, KDV) [equipment.manage] - alanlar: `invoice` (required|file|mimes:pdf,jpg,jpeg,png|max:10240) - `equipment.label` — GET /manager/equipment/{equipment}/label — Tek ekipman için etiket sayfası — labels route'una redirect. [equipment.manage] - `equipment.labels` — GET /manager/equipment/labels — Birden çok ekipman için A4 yazdırılabilir etiket sayfası. [equipment.manage] - `equipment.maintenance.destroy` — DELETE /manager/equipment/{equipment}/maintenance/{maintenance} — Bakım kaydını sil (varsa fatura dosyasını S3'ten temizle, kaydı soft-delete et). [equipment.manage] - `equipment.maintenance.invoice.show` — GET /manager/equipment/{equipment}/maintenance/{maintenance}/invoice — Bakım faturasını görüntüle (S3 geçici URL'ine yönlendirir). [equipment.view] - `equipment.maintenance.store` — POST /manager/equipment/{equipment}/maintenance — Bakım kaydını elle ekle (fatura/AI olmadan). [equipment.manage] - alanlar: `maintenance_type` ('required|string|in:' . implode(',', array_keys(config('equipment_maintenance.types')))), `vendor_name` (nullable|string|max:255), `description` (nullable|string|max:5000), `maintenance_date` (nullable|date), `amount` (nullable|numeric|min:0|max:999999999), `currency` (nullable|in:TRY,USD,EUR,GBP), `vat_rate` (nullable|numeric|min:0|max:100), `vat_amount` (nullable|numeric|min:0|max:999999999), `invoice_number` (nullable|string|max:255) - `equipment.maintenance.update` — PATCH /manager/equipment/{equipment}/maintenance/{maintenance} — Bakım kaydının alanlarını güncelle (fatura dosyası değişmez). [equipment.manage] - alanlar: `maintenance_type` ('required|string|in:' . implode(',', array_keys(config('equipment_maintenance.types')))), `vendor_name` (nullable|string|max:255), `description` (nullable|string|max:5000), `maintenance_date` (nullable|date), `amount` (nullable|numeric|min:0|max:999999999), `currency` (nullable|in:TRY,USD,EUR,GBP), `vat_rate` (nullable|numeric|min:0|max:100), `vat_amount` (nullable|numeric|min:0|max:999999999), `invoice_number` (nullable|string|max:255) - `equipment.maintenance.upload` — POST /manager/equipment/{equipment}/maintenance/upload — Bakım faturası yükle + AI ile firma adı, tutar, KDV, tarih ve bakım tipini [equipment.manage] - alanlar: `invoice` (required|file|mimes:pdf,jpg,jpeg,png|max:10240) - `equipment.notes.destroy` — DELETE /manager/equipment/{equipment}/notes/{note} — Ekipman notları — Sil [equipment.manage] - `equipment.notes.store` — POST /manager/equipment/{equipment}/notes — Menajer notu ekle. is_visible_to_employee=true ise ekipmanı zimmetinde [equipment.manage] - alanlar: `note` (required|string|max:5000), `is_visible_to_employee` (boolean) - `equipment.notes.update` — PATCH /manager/equipment/{equipment}/notes/{note} — Ekipman notları — Güncelle [equipment.manage] - alanlar: `note` (sometimes|required|string|max:5000), `is_visible_to_employee` (sometimes|boolean) - `equipment.photos.destroy` — DELETE /manager/equipment/{equipment}/photos/{photo} — Ekipman fotoğrafları — Sil [equipment.manage] - `equipment.photos.primary` — PATCH /manager/equipment/{equipment}/photos/{photo}/primary — Ekipman fotoğrafları — primary [equipment.manage] - `equipment.photos.reorder` — PATCH /manager/equipment/{equipment}/photos/reorder — Ekipman fotoğrafları — reorder [equipment.manage] - alanlar: `ids` (required|array|min:1), `ids.*` (integer) - `equipment.photos.store` — POST /manager/equipment/{equipment}/photos — Var olan ekipmana foto ekle. analyze=true ise her foto 1 AI kredisi harcar ve [equipment.manage] - alanlar: `photos` (required|array|max:{$remaining}), `photos.*` (required|image|max:8192), `analyze` (sometimes|boolean) - `equipment.sales-invoice.destroy` — DELETE /manager/equipment/{equipment}/sales-invoice — Satış faturası dosyasını sil. Fatura no + KDV temizlenir; sold_at ve [equipment.manage] - `equipment.sales-invoice.show` — GET /manager/equipment/{equipment}/sales-invoice — Satış faturası PDF/görselini görüntüle (S3 geçici URL'ine yönlendirir). [equipment.view] - `equipment.sales-invoice.store` — POST /manager/equipment/{equipment}/sales-invoice — Satış faturası yükle + AI ile (SATIS_FATURA_ANALIZ_ASISTANI) fatura no, [equipment.manage] - alanlar: `invoice` (required|file|mimes:pdf,jpg,jpeg,png|max:10240) - `equipment.show` — GET /manager/equipment/{equipment} — Ekipmanlar — Detay [equipment.view] - `equipment.store` — POST /manager/equipment — Ekipmanlar — Oluştur [equipment.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string), `serial_number` (nullable|string|max:255), `brand` (nullable|string|max:255), `model` (nullable|string|max:255), `category` ('nullable|string|in:' . implode(',', array_keys(config('equipment.categories')))), `ai_category` ('nullable|string|in:' . implode(',', array_keys(config('equipment.categories')))), `purchase_price` (nullable|numeric|min:0), `currency` (nullable|in:TRY,USD,EUR,GBP), `purchase_date` (nullable|date), `condition` (required|in:excellent,good,fair,poor), `is_active` (boolean), `notes` (nullable|string), `photo_paths` (nullable|array|max:5), `photo_paths.*` (string) - `equipment.unassign` — POST /manager/equipment/{equipment}/unassign — Ekipmanlar — unassign [equipment.manage] - alanlar: `returned_date` (required|date), `return_notes` (nullable|string) - `equipment.update` — PUT /manager/equipment/{equipment} — Ekipmanlar — Güncelle [equipment.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string), `serial_number` (nullable|string|max:255), `brand` (nullable|string|max:255), `model` (nullable|string|max:255), `category` ('nullable|string|in:' . implode(',', array_keys(config('equipment.categories')))), `purchase_price` (nullable|numeric|min:0), `currency` (nullable|in:TRY,USD,EUR,GBP), `purchase_date` (nullable|date), `condition` (required|in:excellent,good,fair,poor), `status` (required|in:available,assigned,inactive), `notes` (nullable|string) - `equipment.update-status` — PATCH /manager/equipment/{equipment}/update-status — Ekipmanlar — update status [equipment.manage] - alanlar: `status` (required|in:available,inactive,sold) ### Masraf Raporları (`expense_reports`) - `expense-reports.download` — GET /manager/expense-reports/{report}/download — PDF'i force-download ile indirir. [expense_reports.view] - `expense-reports.download-excel` — GET /manager/expense-reports/{report}/download-excel — Paketin TEK Excel dosyasını indirir. excel_path paketteki üç satıra da aynı [expense_reports.view] - `expense-reports.index` — GET /manager/expense-reports — Geçmiş raporlar sayfası. Tek truth source: hem manager hem mali müşavir [expense_reports.view] - `expense-reports.preview` — GET /manager/expense-reports/{report} — PDF'i tarayıcıda inline olarak gösterir (önizleme için). [expense_reports.view] - `expense-reports.preview-range` — GET /manager/expense-reports/preview-range — "harcama tarihi" aralığındaki TÜM fişlerden (tek tek seçmeye gerek yok) [expense_reports.view] - alanlar: `date_from` (required|date), `date_to` (required|date), `status` (nullable|string), `employee_id` (nullable|integer), `category_id` (nullable|integer), `report_status` (nullable|in:all,reported,unreported), `accounting_status` (nullable|in:all,processed,unprocessed), `search` (nullable|string|max:255) - `expense-reports.preview-range.count` — GET /manager/expense-reports/preview-range/count — "Fişleri Yazdır" modalında seçili tarih aralığı + filtrelerle KAÇ fişin [expense_reports.view] - alanlar: `date_from` (required|date), `date_to` (required|date), `status` (nullable|string), `employee_id` (nullable|integer), `category_id` (nullable|integer), `report_status` (nullable|in:all,reported,unreported), `accounting_status` (nullable|in:all,processed,unprocessed), `search` (nullable|string|max:255) - `expense-reports.preview-selected` — GET /manager/expense-reports/preview-selected — Seçili fişlerden ephemeral PDF üretir, tarayıcıda inline gösterir. [expense_reports.view] ### Masraf Yönetimi (`expenses`) - `expense-categories.destroy` — DELETE /manager/expense-categories/{category} — Masraf kategorileri — Sil [expenses.manage] - `expense-categories.index` — GET /manager/expense-categories — Masraf kategorileri — Listele [expenses.manage] - `expense-categories.seed-defaults` — POST /manager/expense-categories/seed-defaults — Masraf kategorileri — seed defaults [expenses.manage] - `expense-categories.store` — POST /manager/expense-categories — Masraf kategorileri — Oluştur [expenses.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string|max:500), `max_amount` (nullable|numeric|min:0), `requires_receipt` (boolean) - `expense-categories.update` — PUT /manager/expense-categories/{category} — Masraf kategorileri — Güncelle [expenses.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string|max:500), `max_amount` (nullable|numeric|min:0), `requires_receipt` (boolean), `is_active` (boolean) - `expense-report-settings.update` — PUT /manager/expense-report-settings — Masraf raporu ayarlarını upsert eder. [expenses.manage] - alanlar: `period_type` (required|in:weekly,monthly), `weekly_day` (nullable|integer|min:0|max:6), `monthly_day` (nullable|integer|min:1|max:28), `is_active` (required|boolean) - `expense-reports.generate-now` — POST /manager/expense-reports/generate-now — Manuel rapor üretimi. Body: [expenses.manage] - alanlar: `period_type` (nullable|in:weekly,monthly), `period` (nullable|in:previous,custom), `start_date` (nullable|date), `end_date` (nullable|date|after_or_equal:start_date), `exclude_already_sent` (nullable|boolean) - `expense-reports.resend` — POST /manager/expense-reports/{report}/resend — Mevcut raporu mali müşavirlere yeniden gönderir. [expenses.manage] - `expenses.approve` — POST /manager/expenses/{expense}/approve — Masraflar — Onayla [expenses.manage] - `expenses.bulk-mark-processed` — POST /manager/expenses/bulk-mark-processed — Seçili masrafları toplu olarak muhasebeye işlendi işaretler. [expenses.manage] - alanlar: `ids` (required|array|min:1), `ids.*` (integer) - `expenses.destroy` — DELETE /manager/expenses/{expense} — Masraflar — Sil [expenses.manage] - `expenses.index` — GET /manager/expenses — Masraflar — Listele [expenses.view] - `expenses.mark-paid` — POST /manager/expenses/{expense}/mark-paid — Onaylı masrafı çalışana ödendi (iade edildi) olarak işaretler. İsteğe bağlı: reimbursement_method [expenses.manage] - alanlar: `reimbursement_method` (nullable|\Illuminate\Validation\Rule::in(['bank', 'cash', 'payroll'])), `reimbursement_reference` (nullable|string|max:100), `paid_at` (nullable|date|before_or_equal:today) - `expenses.mark-processed` — POST /manager/expenses/{expense}/mark-processed — Masrafı "Muhasebeye İşlendi" olarak işaretler (tekil). [expenses.process] - `expenses.reject` — POST /manager/expenses/{expense}/reject — Masraflar — Reddet [expenses.manage] - alanlar: `rejected_reason` (required|string|max:500) - `expenses.show` — GET /manager/expenses/{expense} — Masraflar — Detay [expenses.view] - `expenses.store` — POST /manager/expenses — Yönetici/ajan çalışan adına masraf kaydeder — fişi verin, alanları yapay zekâ çıkarır (TK-EKSOR6). [expenses.manage] - alanlar: `receipt` (nullable|file|max:20480|mimes:jpg,jpeg,png,webp,pdf), `receipt_path` (nullable|string|max:500), `title` (nullable|string|max:255), `amount` (nullable|numeric|min:0.01), `expense_date` (nullable|date|\App\Support\ReceiptDate::rule()), `expense_category_id` (nullable|integer|\Illuminate\Validation\Rule::exists('expense_categories', 'id')->where('company_id', $company->id)), `category` (nullable|string|max:255), `merchant_name` (nullable|string|max:255), `tax_amount` (nullable|numeric|min:0), `currency` (nullable|in:TRY,USD,EUR,GBP), `payment_method` (nullable|\Illuminate\Validation\Rule::in(array_keys(Expense::PAYMENT_METHOD_LABELS))), `description` (nullable|string|max:1000), `status` (nullable|in:approved,pending), `notify` (nullable|boolean), `funding` (nullable|in:"out_of_pocket","work_advance","company_card"), `work_advance_id` (nullable|integer) - `expenses.unmark-processed` — POST /manager/expenses/{expense}/unmark-processed — "Muhasebeye İşlendi" işaretini geri alır. [expenses.manage] - `expenses.update` — PUT /manager/expenses/{expense} — Masraf alanlarını düzelt. [expenses.manage] - alanlar: `title` (required|string|max:255), `amount` (required|numeric|min:0.01), `currency` (required|in:TRY,USD,EUR,GBP), `expense_date` (required|date|ReceiptDate::rule()), `expense_category_id` (nullable|Rule::exists('expense_categories', 'id')->where('company_id', $user->company_id)), `employee_id` (required|Rule::exists('employees', 'id')->where('company_id', $user->company_id)), `merchant_name` (nullable|string|max:255), `tax_amount` (nullable|numeric|min:0), `payment_method` (nullable|string|max:50), `company_card_id` (nullable|Rule::exists('company_cards', 'id')->where('company_id', $user->company_id)), `description` (nullable|string|max:1000), `expense_date.before_or_equal` (ReceiptDate::MESSAGE) - `expenses.work-advance` — PUT /manager/expenses/{expense}/work-advance — Masrafı iş avansına bağlar (work_advance_id) ya da bağı kaldırır (null). Bağlı ve onaylı masraf [expenses.manage] - alanlar: `work_advance_id` (nullable|integer) - `work-advances.cancel` — POST /manager/work-advances/{workAdvance}/cancel — İş avansını iptal eder (yanlış açıldıysa; bağlı masraf yoksa). [expenses.manage] - `work-advances.index` — GET /manager/work-advances — İş avansı listesi + bakiyeler. Filtre: status (open | closed | cancelled), employee_id, per_page. [expenses.view] - `work-advances.record-movement` — POST /manager/work-advances/{workAdvance}/movements — Hareket kaydeder: type = refund (çalışan kalanı iade etti) | payout (harcama avansı aştı, şirket [expenses.manage] - alanlar: `type` (required|Rule::in(array_keys(WorkAdvance::MOVEMENT_TYPES))), `amount` (required|numeric|gt:0), `occurred_on` (nullable|date|before_or_equal:today), `method` (nullable|Rule::in(array_keys(WorkAdvance::METHODS))), `reference` (nullable|string|max:100), `notes` (nullable|string|max:1000|Rule::requiredIf($request->input('type') === 'adjustment')) - `work-advances.show` — GET /manager/work-advances/{workAdvance} — İş avansı detayı: bakiye, bağlı masraflar, iade/fark ödemesi hareketleri. [expenses.view] - `work-advances.store` — POST /manager/work-advances — Çalışana iş avansı verir: employee_id, amount, given_on (≤ bugün, vars. bugün), purpose, [expenses.manage] - alanlar: `employee_id` (required|integer|Rule::exists('employees', 'id')->where('company_id', $companyId)), `amount` (required|numeric|gt:0), `currency` (nullable|in:TRY,USD,EUR,GBP), `given_on` (nullable|date|before_or_equal:today), `purpose` (nullable|string|max:255), `payment_method` (nullable|Rule::in(array_keys(WorkAdvance::METHODS))), `payment_reference` (nullable|string|max:100), `due_on` (nullable|date), `notes` (nullable|string|max:1000), `notify` (nullable|boolean) - `work-advances.update` — PATCH /manager/work-advances/{workAdvance} — İş avansını düzeltir (yalnız gönderilen alanlar): purpose, due_on, notes, payment_method, payment_reference, amount. [expenses.manage] - alanlar: `amount` (sometimes|required|numeric|gt:0), `given_on` (sometimes|required|date|before_or_equal:today), `purpose` (sometimes|nullable|string|max:255), `payment_method` (sometimes|nullable|Rule::in(array_keys(WorkAdvance::METHODS))), `payment_reference` (sometimes|nullable|string|max:100), `due_on` (sometimes|nullable|date), `notes` (sometimes|nullable|string|max:1000) ### Personel Kesintileri / İcra (`garnishments`) - `garnishments.analyze-document` — POST /manager/garnishments/analyze-document — İcra/haciz/nafaka belgesini AI ile analiz et ve form alanlarını döndür [garnishments.manage] - alanlar: `document` (required|file|mimes:pdf,jpg,jpeg,png|max:5120), `employee_id` (nullable|integer) - `garnishments.cancel` — POST /manager/garnishments/{garnishment}/cancel — → İptal. [garnishments.manage] - `garnishments.create` — GET /manager/garnishments/create — Yeni haciz/nafaka oluşturma formu. [garnishments.manage] - `garnishments.destroy` — DELETE /manager/garnishments/{garnishment} — Soft delete. [garnishments.manage] - `garnishments.edit` — GET /manager/garnishments/{garnishment}/edit — Haciz/nafaka düzenleme formu. [garnishments.manage] - `garnishments.employee-capacity` — GET /manager/garnishments/employee-capacity — Seçilen çalışanın aylık net ücreti + kesinti tipine göre yasal aylık üst [garnishments.manage] - alanlar: `employee_id` (required|integer) - `garnishments.index` — GET /manager/garnishments — Haciz/icra/nafaka kayıtlarını listele (firma bazlı). [garnishments.view] - `garnishments.resume` — POST /manager/garnishments/{garnishment}/resume — Durduruldu → Aktif. [garnishments.manage] - `garnishments.show` — GET /manager/garnishments/{garnishment} — Haciz/nafaka detayı + geçmiş bordro kesintileri. [garnishments.view] - `garnishments.store` — POST /manager/garnishments — Yeni haciz/nafaka kaydet (onaysız → doğrudan aktif). [garnishments.manage] - alanlar: `employee_id` (required|exists:employees,id), `garnishment_type` (required|in:icra,nafaka,vergi_borcu,other), `case_number` (required|string|max:100), `court_name` (nullable|string|max:200), `priority_order` (required|integer|min:1|max:99), `deduction_type` (required|in:percentage,fixed), `deduction_rate` (required_if:deduction_type,percentage|nullable|numeric|min:0.01|max:100), `deduction_amount` (required_if:deduction_type,fixed|nullable|numeric|min:0), `total_debt_amount` (nullable|numeric|min:0), `start_date` (required|date), `end_date` (nullable|date|after_or_equal:start_date), `notes` (nullable|string|max:1000), `document` (nullable|file|mimes:pdf,jpg,jpeg,png|max:5120) - `garnishments.suspend` — POST /manager/garnishments/{garnishment}/suspend — Aktif → Durduruldu. [garnishments.manage] - `garnishments.update` — PUT /manager/garnishments/{garnishment} — Haciz/nafaka güncelle. [garnishments.manage] - alanlar: `employee_id` (required|exists:employees,id), `garnishment_type` (required|in:icra,nafaka,vergi_borcu,other), `case_number` (required|string|max:100), `court_name` (nullable|string|max:200), `priority_order` (required|integer|min:1|max:99), `deduction_type` (required|in:percentage,fixed), `deduction_rate` (required_if:deduction_type,percentage|nullable|numeric|min:0.01|max:100), `deduction_amount` (required_if:deduction_type,fixed|nullable|numeric|min:0), `total_debt_amount` (nullable|numeric|min:0), `start_date` (required|date), `end_date` (nullable|date|after_or_equal:start_date), `notes` (nullable|string|max:1000), `document` (nullable|file|mimes:pdf,jpg,jpeg,png|max:5120) ### Grup Şirketleri (`group`) - `company-settings.clone` — POST /manager/company-settings/clone — Başka bir grup firmasının ayarlarını bu firmaya kopyalar (yalnız yapılandırma; personel verisi yok). [group.manage] - alanlar: `from` (required), `sections` (required|array|min:1), `sections.*` (string|Rule::in(CompanySettingsCloneService::sectionKeys())), `on_existing` (nullable|Rule::in(CompanySettingsCloneService::ON_EXISTING)), `dry_run` (nullable|boolean) - `group.index` — GET /manager/group — Grubu, üye firmaları, davet kodlarını ve bu firmanın grup olaylarını gösterir. [group.view] - alanlar: `company_id` ((int) $m->company_id), `name` ((string) $m->company?->name), `slug` ($m->company?->slug), `logo_url` ($m->company?->logo ? Storage::url($m->company->logo) : null), `is_active` ((bool) $m->company?->is_active), `is_current` ((int) $m->company_id === (int) $company->id), `joined_at` ($m->created_at?->toIso8601String()), `joined_via` ($m->joined_via), `joined_via_label` ($m->viaLabel()), `my_role` ($row ? ($row->is_manager ? 'Yönetici' : ($row->is_accountant ? 'Mali Müşavir' : 'Çalışan')) : null), `can_switch` ($row !== null && (int) $m->company_id !== (int) $company->id) - `group.summary` — GET /manager/group/summary — Grup firmalarının personel maliyeti, açık avansları ve yıllık izin bakiyelerini firma başına ve toplam olarak gösterir. [group.view] - `group.summary.export` — GET /manager/group/summary/export — Grup Özeti Excel'i (sayfalar: Özet, Maliyet, Avanslar, İzin) — group.summary ile aynı süzgeç ve yetkiler. [group.view] ### Kimlik Belgeleri (`identity_documents`) - `employees.identity-documents.apply` — POST /manager/employees/{employee}/identity-documents/{document}/apply — Kimlik belgesinden çıkarılan alanları çalışana yazar: fields {first_name, last_name, identity_number, birth_date, gender, nationality} — gönderilen değer yazılı [identity_documents.manage] - alanlar: `fields` (required|array|min:1) - `employees.identity-documents.destroy` — DELETE /manager/employees/{employee}/identity-documents/{document} — Kimlik belgesini sil. identity_documents.manage gerektirir. [identity_documents.manage] - `employees.identity-documents.index` — GET /manager/employees/{employee}/identity-documents — Çalışanın kimlik belgeleri: tür, sayfa, yükleyen, AI'nın çıkardığı alanlar (extracted_data). Yan etkisiz. [identity_documents.view] - `employees.identity-documents.show` — GET /manager/employees/{employee}/identity-documents/{document} — Kimlik belgesi PDF'ini tarayıcıda göster. identity_documents.view yeterli. [identity_documents.view] - `employees.identity-documents.store` — POST /manager/employees/{employee}/identity-documents — Kimlik / pasaport / ehliyet yükle: AI türü ve alanları çıkarır, belge saklanır; apply=missing (vars.) çalışanın yalnız boş alanlarını doldurur. [identity_documents.manage] - alanlar: `file` (required_without:images|file|mimes:pdf|max:20480), `images` ('required_without:file|array|min:1|max:' . IdentityScanService::MAX_PAGES), `images.*` (image|max:10240), `apply` (nullable|Rule::in(['missing', 'none'])), `notes` (nullable|string|max:1000) ### İş İlanları (`job_postings`) - `job-postings.analytics` — GET /manager/job-postings/{jobPosting}/analitik — İlan analitiği sekmesi. [job_postings.manage] - `job-postings.application.detail` — GET /manager/job-postings/{jobPosting}/applications/{application} — İş başvurusu — detail [job_postings.manage] - `job-postings.application.resume` — GET /manager/job-postings/{jobPosting}/applications/{application}/cv — Aday CV'sini indirir. [job_postings.manage] - `job-postings.application.update-status` — PUT /manager/job-postings/{jobPosting}/applications/{application}/status — İş başvurusu — update status [job_postings.manage] - alanlar: `status` (required|in:pending,reviewing,shortlisted,rejected,hired), `notes` (nullable|string) - `job-postings.applications` — GET /manager/job-postings/{jobPosting}/applications — İlan başvuru listesi — filtre + sıralama + kolon seçimi. [job_postings.manage] - alanlar: `id` ($application->id), `job_posting_id` ($application->job_posting_id), `first_name` ($application->first_name), `last_name` ($application->last_name), `full_name` ($application->full_name), `email` ($application->email), `phone` ($application->phone), `status` ($application->status), `notes` ($application->notes), `reviewed_at` ($application->reviewed_at?->toISOString()), `created_at` ($application->created_at?->toISOString()), `reviewer` ($application->reviewer ? [ 'id' => $application->reviewer->id, 'name' => $application->reviewer->name, ] : null), `ai_match_score` ($application->ai_match_score), `ai_analyzed_at` ($application->ai_analyzed_at?->toISOString()), `is_test` ((bool) $application->is_test), `sent_mails` ($sentMailTypes[$application->id] ?? []), `answers` ($this->flattenAnswers($application->custom_answers, $answerColumns, $questions) + $this->standardFieldValues($application, $answerColumns, $standardMap, $standardFields)) - `job-postings.applications.bulk-mail` — POST /manager/job-postings/{jobPosting}/applications/bulk-mail — Seçilen başvurulara toplu durum değişikliği + bilgilendirme e-postası. [job_postings.manage] - alanlar: `all` (nullable|boolean), `application_ids` (required_without:all|array|min:1|max:500), `application_ids.*` (integer), `action` (required|Rule::in([ JobPostingMailSend::TYPE_UNDER_REVIEW, JobPostingMailSend::TYPE_NOT_PROCEEDING, ])) - `job-postings.applications.export` — GET /manager/job-postings/{jobPosting}/applications/export — Başvuruların Excel/PDF dışa aktarımı — ekrandaki filtre ve sıralamayı [job_postings.manage] - `job-postings.applications.export-count` — GET /manager/job-postings/{jobPosting}/applications/export-count — "Bu filtrede kaç başvuru var" canlı sayacı — indirme düğmesinin yanında [job_postings.manage] - `job-postings.applications.remind-abandoned` — POST /manager/job-postings/{jobPosting}/applications/remind-abandoned — E-postasını doğrulayıp başvurusunu tamamlamayanlara hatırlatma gönderir. [job_postings.manage] - alanlar: `emails` (nullable|array|max:500), `emails.*` (email) - `job-postings.cities` — GET /manager/job-postings/cities/{country} — İş ilanları — cities [job_postings.manage] - alanlar: `id` ($city->id), `name` ($city->name), `plate_code` ($city->plate_code) - `job-postings.create` — GET /manager/job-postings/create — İş ilanları — Oluşturma formu verisi [job_postings.manage] - alanlar: `id` ($department->id), `name` ($department->name), `code` ($department->code) - `job-postings.destroy` — DELETE /manager/job-postings/{job_posting} — İş ilanları — Sil [job_postings.manage] - `job-postings.edit` — GET /manager/job-postings/{job_posting}/edit — İş ilanları — Düzenleme formu verisi [job_postings.manage] - alanlar: `id` ($department->id), `name` ($department->name), `code` ($department->code) - `job-postings.generate-with-ai` — POST /manager/job-postings/generate-with-ai — İş ilanları — generate with ai [job_postings.manage] - alanlar: `details` (required|string|min:10|max:1000) - `job-postings.index` — GET /manager/job-postings — İş ilanları — Listele [job_postings.manage] - `job-postings.show` — GET /manager/job-postings/{job_posting} — İş ilanları — Detay [job_postings.manage] - `job-postings.store` — POST /manager/job-postings — İş ilanları — Oluştur [job_postings.manage] - `job-postings.test-application` — GET /manager/job-postings/{jobPosting}/test-basvuru — Ilan sahibinin kendi basvuru formunu aday gibi test etmesini saglar. [job_postings.manage] - `job-postings.update` — PUT /manager/job-postings/{job_posting} — İş ilanları — Güncelle [job_postings.manage] ### İzin Raporları (`leave_reports`) - `leave-reports.download` — GET /manager/leave-reports/{report}/download — PDF'i indirir. [leave_reports.view] - `leave-reports.download-excel` — GET /manager/leave-reports/{report}/download-excel — Excel'i indirir. Paket satırlarında excel_path üçüne de aynı yazılır → [leave_reports.view] - `leave-reports.index` — GET /manager/leave-reports — Gönderilmiş izin raporları arşivi (liste ekranı). [leave_reports.view] - `leave-reports.preview` — GET /manager/leave-reports/{report} — PDF'i tarayıcıda inline gösterir. [leave_reports.view] ### İzin Yönetimi (`leaves`) - `employees.leave-opening.destroy` — DELETE /manager/employees/{employee}/leave-opening — Devreden yıllık izin kaydını kaldırır — izin bakiyesi yeniden tüm yıldönümlerinden hesaplanır; dry_run destekler. [leaves.manage] - alanlar: `dry_run` (nullable|boolean) - `employees.leave-opening.update` — PUT /manager/employees/{employee}/leave-opening — Çalışanın devreden yıllık izin bakiyesini yazar (yoksa oluşturur) — dry_run destekler; e-posta yok. [leaves.manage] - alanlar: `as_of_date` (required|date|before_or_equal:today), `annual_days` (required|numeric|between:-100,400), `unpaid_days` (nullable|numeric|min:0|max:3650), `note` (nullable|string|max:500), `dry_run` (nullable|boolean) - `leave-reports.generate-now` — POST /manager/leave-reports/generate-now — Manuel rapor üretimi. Varsayılan: geçen ay (kapanmış son takvim ayı). [leaves.manage] - alanlar: `period` (nullable|in:previous,current,custom), `start_date` (nullable|date), `end_date` (nullable|date|after_or_equal:start_date) - `leave-reports.resend` — POST /manager/leave-reports/{report}/resend — Arşivdeki raporu alıcılara (mali müşavir + yönetici) yeniden gönderir. [leaves.manage] - `leave-requests.approve` — POST /manager/leave-requests/{leaveRequest}/approve — İzin talepleri — Onayla [leaves.manage] - `leave-requests.archive` — DELETE /manager/leave-requests/{leaveRequest} — İzni siler (arşive taşır) — onaylı olsa bile. Satır soft-delete ile korunur [leaves.manage] - alanlar: `reason` (required|string|min:3|max:500), `notify_accountants` (sometimes|boolean) - `leave-requests.archive-impact` — GET /manager/leave-requests/{leaveRequest}/archive-impact — Silme diyaloğu için etki önizlemesi: izin, mali müşavire GÖNDERİLMİŞ hangi [leaves.manage] - `leave-requests.documents.show` — GET /manager/leave-requests/{leaveRequest}/documents/{document} — İzin talebi belgesini tarayıcıda göster. leaves.view yeterli. [leaves.view] - `leave-requests.documents.store` — POST /manager/leave-requests/{leaveRequest}/documents — İzin talebine belge yükle (doğrudan PDF veya görsel(ler)). leaves.manage gerektirir. [leaves.manage] - alanlar: `file` (required_without:images|file|mimes:pdf|max:20480), `images` ('required_without:file|array|min:1|max:' . DocumentScanService::MAX_PAGES), `images.*` (image|max:10240), `notes` (nullable|string|max:1000) - `leave-requests.export` — GET /manager/leave-requests/export — İzin talepleri sayfasındaki "İzinleri İndir" modalından dışa aktarım. [leaves.view] - alanlar: `format` (required|in:excel,pdf), `date_start` (nullable|date), `date_end` (nullable|date), `all_dates` (nullable|boolean), `statuses` (nullable|array), `statuses.*` ('in:' . self::STATUS_KEYS) - `leave-requests.export.preview` — GET /manager/leave-requests/export/preview — "İzinleri İndir" modalında seçili filtrelerle KAÇ kaydın ineceğini gösteren [leaves.view] - alanlar: `date_start` (nullable|date), `date_end` (nullable|date), `all_dates` (nullable|boolean), `statuses` (nullable|array), `statuses.*` ('in:' . self::STATUS_KEYS) - `leave-requests.index` — GET /manager/leave-requests — İzin talepleri — Listele [leaves.view] - alanlar: `id` ($type->id), `name` ($type->name), `color` ($type->color) - `leave-requests.override-document` — POST /manager/leave-requests/{leaveRequest}/override-document — Yöneticinin "yine de kabul et" override'ı: AI tarafından reddedilen/şüpheli [leaves.manage] - `leave-requests.reject` — POST /manager/leave-requests/{leaveRequest}/reject — İzin talepleri — Reddet [leaves.manage] - alanlar: `rejection_reason` (required|string|max:1000) - `leave-requests.restore` — POST /manager/leave-requests/{leaveRequest}/restore — Arşivdeki izni geri alır. [leaves.manage] - `leave-requests.show` — GET /manager/leave-requests/{leaveRequest} — Show leave request details for admin [leaves.view] - `leave-settings.update` — PUT /manager/leave-settings — Firma izin ayarlarını (mod, günlük saat, Cumartesi/Cuma kuralları) güncelle. [leaves.manage] - alanlar: `leave_mode` (required|in:full_day,half_day,hourly), `leave_daily_hours` (required|numeric|min:1|max:24), `saturday_is_rest_day` (boolean), `auto_include_saturday_on_friday_leave` (boolean) - `leave-types.active` — GET /manager/api/leave-types/active — Aktif izin türlerini getir (API - dropdown için) [leaves.view] - `leave-types.create` — GET /manager/leave-types/create — Yeni özel izin türü oluşturma formu [leaves.manage] - `leave-types.destroy` — DELETE /manager/leave-types/{leave_type} — İzin türleri — Sil [leaves.manage] - `leave-types.edit` — GET /manager/leave-types/{leave_type}/edit — İzin türleri — Düzenleme formu verisi [leaves.manage] - `leave-types.index` — GET /manager/leave-types — Firma izin türlerini listele [leaves.manage] - alanlar: `id` ($leaveType->id), `name` ($leaveType->name), `type_key` ($leaveType->type_key), `description` ($leaveType->description), `max_days_per_year` ($leaveType->max_days_per_year), `max_days_per_request` ($leaveType->max_days_per_request), `requires_approval` ($leaveType->requires_approval), `allow_negative_balance` ($leaveType->allow_negative_balance), `affects_annual_balance` ($leaveType->affects_annual_balance), `requires_document` ($leaveType->requires_document), `document_type_key` ($leaveType->document_type_key), `is_active` ($leaveType->is_active), `is_system_type` ($leaveType->isSystemType()), `is_custom_type` (!$leaveType->isSystemType()), `can_reset` ($canReset), `color` ($leaveType->color), `leave_requests_count` ($leaveType->leave_requests_count), `created_at` ($leaveType->created_at->format('Y-m-d H:i:s')) - `leave-types.reset-to-default` — POST /manager/leave-types/{leaveType}/reset-to-default — Sistem izin türünü config varsayılan değerlerine sıfırla [leaves.manage] - `leave-types.rule-flags` — PATCH /manager/leave-types/{leaveType}/rule-flags — Kural bayraklarını (yıllık bakiyeyi etkiler / belge zorunlu) güncelle. [leaves.manage] - alanlar: `affects_annual_balance` (boolean), `requires_document` (boolean), `document_type_key` (nullable|string|in:sick_report,leave_attachment) - `leave-types.show` — GET /manager/leave-types/{leave_type} — İzin türleri — Detay [leaves.manage] - `leave-types.store` — POST /manager/leave-types — Yeni özel izin türü oluştur [leaves.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string|max:1000), `max_days_per_year` (required|integer|min:1|max:365), `max_days_per_request` (nullable|integer|min:1|max:365), `requires_approval` (boolean), `allow_negative_balance` (boolean), `affects_annual_balance` (boolean), `requires_document` (boolean), `document_type_key` (nullable|string|in:sick_report,leave_attachment), `is_active` (boolean) - `leave-types.toggle-status` — POST /manager/leave-types/{leaveType}/toggle-status — İzin türleri — Aktif/pasif yap [leaves.manage] - `leave-types.update` — PUT /manager/leave-types/{leave_type} — İzin türleri — Güncelle [leaves.manage] - alanlar: `name` (required|string|max:255), `description` (nullable|string|max:1000), `max_days_per_year` (required|integer|min:1|max:365), `max_days_per_request` (nullable|integer|min:1|max:365), `requires_approval` (boolean), `is_active` (boolean), `allow_negative_balance` (boolean), `affects_annual_balance` (boolean), `requires_document` (boolean), `document_type_key` (nullable|string|in:sick_report,leave_attachment) ### Luca Köprüsü (`luca_bridge`) - `luca-bridge.envelopes` — GET /manager/luca-bridge/envelopes — Zarf listesi (status=processed|failed, type, report, year; per_page ≤100): durum, hata, neye yansıdığı. [luca_bridge.view] - alanlar: `status` (nullable|Rule::in(['processed', 'failed', 'received'])), `type` (nullable|string|max:40), `report` (nullable|string|max:80), `year` (nullable|integer|between:2000,2100) - `luca-bridge.envelopes.reprocess` — POST /manager/luca-bridge/envelopes/{envelope}/reprocess — Başarısız zarfı sunucuda yeniden işletir (gönderici yeniden göndermeden; aynı işleyici). İşlenmiş zarfa dokunmaz [luca_bridge.manage] - `luca-bridge.envelopes.show` — GET /manager/luca-bridge/envelopes/{envelope} — Tek zarf: durum, hata, işleyici sonucu, artifact listesi (içerik değil). [luca_bridge.view] - `luca-bridge.index` — GET /manager/luca-bridge — Luca Köprüsü özeti: zarf sayıları/durumları, her türün neye yansıdığı, personel aktarımı, parite, ekran kapsamı. [luca_bridge.view] - `luca-bridge.payroll-compare` — GET /manager/luca-bridge/payroll-compare — Kayıtlı bordro fişleri ↔ Luca bordrosu (kişi × ay, alan alan; year, status=match|diff|no_slip|no_period|no_employee|not_in_luca|issues, per_page ≤100). [luca_bridge.view, payroll.view] - alanlar: `year` (nullable|integer|between:2000,2100), `status` (nullable|Rule::in(['match', 'diff', 'no_slip', 'no_period', 'no_employee', 'not_in_luca', 'issues'])), `page` (nullable|integer|min:1) ### Luca'ya Aktarım (`luca_export`) - `luca-bridge.export.index` — GET /manager/luca-bridge/export — Luca'ya aktarım kontrol ekranı (mali müşavir): ay × işyeri için puantaj (gün gün), personel kartı (zorunlu alan eksikleri), empuno bordrosu (kişi başına) ve not [luca_export.view, employees.view, payroll.view] - alanlar: `period` (nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `sgk_workplace_id` (nullable|integer), `format` (nullable|Rule::in(['json', 'xlsx'])) - `luca-bridge.export.packages.destroy` — DELETE /manager/luca-bridge/export/packages/{package} — Yükleme izi kaydını geri al (reason zorunlu): kayıt silinmez, "geri alındı" olur; aynı dosya yeniden işaretlenebilir. Luca'daki veriye dokunmaz. [luca_export.manage] - alanlar: `reason` (required|string|max:500) - `luca-bridge.export.packages.index` — GET /manager/luca-bridge/export/packages — Yükleme izi listesi (mali müşavirin "kontrol edildi" / "Luca'ya yüklendi" kayıtları; period, sgk_workplace_id, kind, status=reviewed|uploaded|voided, per_page ≤ [luca_export.view] - alanlar: `period` (nullable|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `sgk_workplace_id` (nullable|integer), `kind` (nullable|Rule::in(array_keys(LucaExportPackage::KINDS))), `status` (nullable|Rule::in(['reviewed', 'uploaded', 'voided'])) - `luca-bridge.export.packages.store` — POST /manager/luca-bridge/export/packages — Yükleme izi işareti: dosya "kontrol edildi" (status=reviewed) ya da "Luca'ya yüklendi" (status=uploaded); kind=timesheet|personnel_update|personnel_new, period, [luca_export.manage, employees.view] - alanlar: `period` (required|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `sgk_workplace_id` (nullable|integer), `kind` (required|Rule::in(array_keys(LucaExportPackage::KINDS))), `status` (required|Rule::in(array_keys(LucaExportPackage::STATUSES))), `content_sha256` (nullable|string|regex:/^[0-9a-f]{64}$/), `notes` (nullable|string|max:2000), `force` (nullable|boolean) - `luca-bridge.export.personnel` — GET /manager/luca-bridge/export/personnel — Luca personel Excel'i (LUCA Personel Giriş Şablonu): mode=new (Luca'da kartı olmayanlar) | update (işyerinin o ayki tüm personeli); format zip (vars.: .xls + ma [luca_export.view, employees.view, payroll.view] - alanlar: `period` (required|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `sgk_workplace_id` (nullable|integer), `department_id` (nullable|integer), `employee_ids` (nullable|array), `employee_ids.*` (integer), `format` (nullable|Rule::in(['zip', 'file', 'manifest'])) - `luca-bridge.export.timesheet` — GET /manager/luca-bridge/export/timesheet — Luca puantaj CSV'si (işyeri × ay; ISO-8859-9, `;`): gün kodları N/H/T/S/R/E/İ, eksik gün nedeni; ay içinde giren/çıkan manifest manual[]'da. format zip (vars.) [luca_export.view, employees.view] - alanlar: `period` (required|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `sgk_workplace_id` (nullable|integer), `department_id` (nullable|integer), `employee_ids` (nullable|array), `employee_ids.*` (integer), `format` (nullable|Rule::in(['zip', 'file', 'manifest'])) ### Bordro (`payroll`) - `employees.exit-settlement.show` — GET /manager/employees/{employee}/exit-settlement — Çıkış ödemesi önizlemesi + kayıtlı hesap (yan etkisiz). Ayrılmış çalışanda çıkış tarihi ve kodu [payroll.view] - alanlar: `termination_date` (sometimes|date), `sgk_exit_code` (sometimes|nullable|string|\App\Support\SgkExitCodes::exitRule(\App\Support\SgkExitCodes::exitRecordCodes())), `leave_days` (nullable|numeric|min:0|max:400), `include_leave_pay` (nullable|boolean), `include_notice` (nullable|boolean), `notice_served` (nullable|boolean), `include_severance` (nullable|boolean), `monthly_gross` (nullable|numeric|min:0), `monthly_dressed` (nullable|numeric|min:0), `notes` (nullable|string|max:1000), `dismiss` (nullable|boolean), `confirm` (nullable|boolean) - `employees.exit-settlement.update` — PUT /manager/employees/{employee}/exit-settlement — Ayrılmış çalışanın çıkış ödemesini kaydeder / düzeltir ve onaylar (confirm=false: onay bekler). [payroll.manage] - alanlar: `termination_date` (sometimes|date), `sgk_exit_code` (sometimes|nullable|string|\App\Support\SgkExitCodes::exitRule(\App\Support\SgkExitCodes::exitRecordCodes())), `leave_days` (nullable|numeric|min:0|max:400), `include_leave_pay` (nullable|boolean), `include_notice` (nullable|boolean), `notice_served` (nullable|boolean), `include_severance` (nullable|boolean), `monthly_gross` (nullable|numeric|min:0), `monthly_dressed` (nullable|numeric|min:0), `notes` (nullable|string|max:1000), `dismiss` (nullable|boolean), `confirm` (nullable|boolean) - `employees.incentive-facts.update` — PATCH /manager/employees/{employee}/incentive-facts — Çalışanın teşvik bilgilerini günceller — yalnız gönderilen anahtarlar birleşir (null siler); dry_run destekler. [payroll.manage] - alanlar: `facts` (nullable|array), `dry_run` (nullable|boolean) - `employees.incentives.destroy` — DELETE /manager/employees/{employee}/incentives/{incentive} — Teşvik atamasını siler (yumuşak) — kesinleşmiş fişlerin kanun kodu korunur; dry_run destekler. [payroll.manage] - alanlar: `dry_run` (nullable|boolean) - `employees.incentives.index` — GET /manager/employees/{employee}/incentives — Çalışanın teşvik atamaları, ön uygunluğu ve teşvik bilgileri (yan etkisiz). [payroll.view] - `employees.incentives.store` — POST /manager/employees/{employee}/incentives — Çalışana teşvik atar — dry_run destekler; e-posta yok. Yalnız status=active atama dönem hesabına girer. [payroll.manage] - alanlar: `law_no` (required|string|max:10), `status` (nullable|in:proposed,active,ended,rejected), `start_date` (nullable|date), `end_date` (nullable|date), `duration_months` (nullable|integer|min:1|max:120), `certificate_no` (nullable|string|max:60), `notes` (nullable|string|max:1000), `dry_run` (nullable|boolean) - `employees.incentives.update` — PATCH /manager/employees/{employee}/incentives/{incentive} — Teşvik atamasını günceller — yalnız gönderilen alanlar (status, start_date, end_date, duration_months, certificate_no, notes). [payroll.manage] - `employees.payroll-items.destroy` — DELETE /manager/employees/{employee}/payroll-items/{item} — Çalışan kalemini siler (geçmiş bordrolardaki satırlar korunur). [payroll.manage] - `employees.payroll-items.index` — GET /manager/employees/{employee}/payroll-items — Çalışanın ek kazanç/kesinti kalemleri (yan etkisiz) + seçilebilir türler. [payroll.view] - `employees.payroll-items.store` — POST /manager/employees/{employee}/payroll-items — Çalışana kalem ekler: kind (earning | deduction), type (tür id, kodu ya da adı), amount, [payroll.manage] - alanlar: `kind` (required|in:earning,deduction), `type` (required), `amount` (nullable|numeric|gt:0), `hours` (nullable|numeric|gt:0|max:744), `start_period` (required|self::PERIOD), `end_period` (nullable|self::PERIOD), `description` (nullable|string|max:255) - `employees.payroll-items.update` — PATCH /manager/employees/{employee}/payroll-items/{item} — Çalışan kalemini günceller (yalnız gönderilen alanlar: amount, hours, start_period, end_period, description). Saat bazlı kalemde amount yerine hours. [payroll.manage] - alanlar: `amount` (sometimes|required|numeric|gt:0), `hours` (sometimes|required|numeric|gt:0|max:744), `start_period` (sometimes|required|self::PERIOD), `end_period` (sometimes|nullable|self::PERIOD), `description` (sometimes|nullable|string|max:255) - `employees.payroll-profile.edit` — GET /manager/employees/{employee}/payroll-profile — Çalışanın güncel bordro profili + sürüm geçmişi (history[]: effective_from/to, maaş). Yan etkisiz. [payroll.manage] - `employees.payroll-profile.update` — PUT /manager/employees/{employee}/payroll-profile — Çalışanın bordro profilini kaydeder; effective_from mevcut sürümden SONRAysa yeni sürüm açar. [payroll.manage] - alanlar: `salary_type` (required|in:monthly,hourly), `gross_salary` (required_if:is_net_salary,false|numeric|min:0), `is_net_salary` (boolean), `net_salary` (required_if:is_net_salary,true|nullable|numeric|min:0), `insurance_group` (required|in:normal,sgdp,none), `mw_exemption_applies` (sometimes|boolean), `tax_payment_type` (nullable|in:011,012,014), `rd_incentive` (nullable|in:5746,4691), `rd_tax_exemption_rate` (nullable|required_if:rd_incentive,5746|in:80,90,95,100), `rd_incentive_start` (nullable|date), `rd_incentive_end` (nullable|date|after_or_equal:rd_incentive_start), `disability_degree_payroll` (nullable|in:1,2,3), `has_meal_allowance` (boolean), `meal_allowance_daily` (nullable|numeric|min:0|max:9999.99), `has_transport_allowance` (boolean), `transport_allowance_daily` (nullable|numeric|min:0|max:9999.99), `active_incentive_code` (nullable|string|max:30|function (string $attribute, mixed $value, \Closure $fail) use ($sentIncentive) { if ($sentIncentive && filled($value) && ! \App\Services\Payroll\Incentives\IncentiveCatalog::exists((string) $value)) { $fail("Kanun numarası teşvik kataloğunda yok: {$value} (geçerli kodlar: empuno reference incentive_codes; çalışana teşvik atamak için employees.incentives.store)."); } }), `incentive_start_date` (nullable|date), `incentive_end_date` (nullable|date|after_or_equal:incentive_start_date), `rd_personnel_type` (sometimes|nullable|Rule::in(array_keys(EmployeePayrollProfile::RD_PERSONNEL_TYPES))), `effective_from` (required|date), `effective_to` (nullable|date|after_or_equal:effective_from), `work_schedule` (sometimes|nullable|\Illuminate\Validation\Rule::in(array_keys(EmployeePayrollProfile::WORK_SCHEDULES))), `weekly_hours` (sometimes|nullable|numeric|min:1|max:45) - `employees.pension.action` — POST /manager/employees/{employee}/pension/{enrollment}/action — BES kaydında işlem: opt_out | leave_system | pause | resume | rate_change | rejoin | certificate — hemen uygulanır; dry_run destekler. [payroll.manage] - alanlar: `action` (required|Rule::in(array_keys(PensionService::ACTIONS))), `effective_date` (nullable|date), `until` (nullable|date), `rate` (nullable|numeric|min:0|max:100|required_if:action,rate_change), `certificate_no` (nullable|string|max:60|required_if:action,certificate), `source` (nullable|in:manager,pension_company), `note` (nullable|string|max:500), `dry_run` (nullable|boolean) - `employees.pension.show` — GET /manager/employees/{employee}/pension — Çalışanın BES kaydı, kapsam durumu, hareketleri ve kesinti geçmişi (yan etkisiz). [payroll.view] - `employees.pension.store` — POST /manager/employees/{employee}/pension — Çalışanı BES planına elle dahil eder — dry_run destekler; e-posta yok. [payroll.manage] - alanlar: `plan_id` (nullable|integer), `enrolled_on` (nullable|date), `rate` (nullable|numeric|min:0|max:100), `notified_at` (nullable|date), `certificate_no` (nullable|string|max:60), `voluntary` (nullable|boolean), `notes` (nullable|string|max:1000), `dry_run` (nullable|boolean) - `employees.pension.update` — PATCH /manager/employees/{employee}/pension/{enrollment} — BES kaydının alanlarını günceller — yalnız gönderilenler: rate (≥ %3), certificate_no, notified_at (cayma süresi yeniden hesaplanır), notes. [payroll.manage] - `payroll-items.bulk` — POST /manager/payroll-items/bulk — Toplu kalem ekleme (ör. bu ayın primleri, ikramiye, sendika aidatı): records[]: çalışan anahtarı [payroll.manage] - alanlar: `records` (required|array|min:1|max:1000), `dry_run` (nullable|boolean), `records.*.kind` (nullable|in:earning,deduction), `records.*.type` (required), `records.*.amount` (nullable|numeric|gt:0), `records.*.hours` (nullable|numeric|gt:0|max:744), `records.*.period` (required|self::PERIOD), `records.*.end_period` (nullable|string|max:7), `records.*.description` (nullable|string|max:255), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `payroll-profiles.bulk-update` — POST /manager/payroll-profiles/bulk-update — Toplu bordro profili güncelleme. Paylaşılan tek geçerlilik tarihiyle tüm [payroll.manage] - alanlar: `effective_from` (required|date), `rows` (required|array|min:1|max:1000), `rows.*.employee_id` (required|integer), `rows.*.salary_type` (required|in:monthly,hourly), `rows.*.is_net_salary` (boolean), `rows.*.gross_salary` (nullable|numeric|min:0|max:99999999999999.99), `rows.*.net_salary` (nullable|numeric|min:0|max:99999999999999.99), `rows.*.insurance_group` (required|in:normal,sgdp), `rows.*.disability_degree_payroll` (nullable|in:1,2,3), `rows.*.meal_allowance_daily` (nullable|numeric|min:0|max:9999.99), `rows.*.transport_allowance_daily` (nullable|numeric|min:0|max:9999.99), `rows.*.active_incentive_code` (nullable|string|max:30), `rows.*.incentive_start_date` (nullable|date), `rows.*.incentive_end_date` (nullable|date|after_or_equal:rows.*.incentive_start_date), `rows.*.work_schedule` (sometimes|nullable|\Illuminate\Validation\Rule::in(array_keys(EmployeePayrollProfile::WORK_SCHEDULES))), `rows.*.weekly_hours` (sometimes|nullable|numeric|min:1|max:45), `rows.*.rd_personnel_type` (sometimes|nullable|\Illuminate\Validation\Rule::in(array_keys(EmployeePayrollProfile::RD_PERSONNEL_TYPES))) - `payroll-profiles.index` — GET /manager/payroll-profiles — Toplu bordro profili giriş sayfası — tüm aktif çalışanların maaş/yan hak [payroll.manage] - alanlar: `employee_id` ($employee->id), `full_name` (trim($employee->first_name . ' ' . $employee->last_name)), `employee_number` ($employee->employee_number), `department` ($employee->department?->name), `salary_type` ($profile?->salary_type ?? 'monthly'), `is_net_salary` ((bool) ($profile?->is_net_salary ?? false)), `gross_salary` (($profile && $profile->gross_salary !== null) ? (string) $profile->gross_salary : ''), `net_salary` (($profile && $profile->net_salary !== null) ? (string) $profile->net_salary : ''), `insurance_group` ($profile?->insurance_group ?? 'normal'), `disability_degree_payroll` ((string) ($profile?->disability_degree_payroll ?? '')), `meal_allowance_daily` (($profile && $profile->has_meal_allowance && $profile->meal_allowance_daily !== null) ? (string) $profile->meal_allowance_daily : ''), `transport_allowance_daily` (($profile && $profile->has_transport_allowance && $profile->transport_allowance_daily !== null) ? (string) $profile->transport_allowance_daily : ''), `active_incentive_code` ((string) ($profile?->active_incentive_code ?? '')), `incentive_start_date` ($fmtDate($profile?->incentive_start_date)), `incentive_end_date` ($fmtDate($profile?->incentive_end_date)), `effective_from` ($fmtDate($profile?->effective_from)), `work_schedule` ($profile?->work_schedule), `weekly_hours` (($profile && $profile->weekly_hours !== null) ? (string) $profile->weekly_hours : ''), `has_profile` ((bool) $profile) - `payroll-settings.accounting.index` — GET /manager/payroll-settings/accounting — Muhasebe hesap planı eşlemesi: kalemler + varsayılan Tekdüzen hesabı + firma eşlemesi, departman/şube gider kökleri ve önerileri, fiş tercihleri. [payroll.manage] - `payroll-settings.accounting.mappings.update` — PATCH /manager/payroll-settings/accounting/mappings — Hesap eşlemelerini toplu yazar; yalnız gönderilen satırlar, account_code=null varsayılana döndürür; satır bazlı results[]. [payroll.manage] - alanlar: `mappings` (required|array|min:1|max:500), `mappings.*` (array), `mappings.*.line_key` (required|string|max:120), `mappings.*.scope_id` (nullable|integer|min:0), `mappings.*.account_code` (present|nullable|string|max:60), `mappings.*.account_name` (nullable|string|max:150), `mappings.*.cost_center` (nullable|string|max:60), `dry_run` (nullable|boolean) - `payroll-settings.accounting.options.update` — PATCH /manager/payroll-settings/accounting/options — Muhasebe fişi tercihlerini günceller (yalnız gönderilen anahtarlar). [payroll.manage] - `payroll-settings.accounting.suggest` — POST /manager/payroll-settings/accounting/suggest — Hesap planı/mizan dosyasından (xlsx/xls/csv, ≤5 MB) eşleme önerir; apply=true ise yüksek güvenli önerileri yazar. [payroll.manage] - alanlar: `file` (required_without:accounts|file|max:5120|mimes:xlsx,xls,csv,txt), `accounts` (required_without:file|array|max:5000), `accounts.*.code` (required_with:accounts|string|max:30), `accounts.*.name` (required_with:accounts|string|max:150), `apply` (nullable|boolean), `overwrite` (nullable|boolean), `min_confidence` (nullable|in:high,medium), `dry_run` (nullable|boolean) - `payroll-settings.deduction-types.destroy` — DELETE /manager/payroll-settings/deduction-types/{deductionType} — Kesinti türünü kaldırır; kullanıldıysa pasife alınır. [payroll.manage] - `payroll-settings.deduction-types.store` — POST /manager/payroll-settings/deduction-types — Kesinti türü ekler. reduces_tax_base: GV matrahından indirilir (GVK 63 — sendika aidatı, şahıs [payroll.manage] - alanlar: `name` ($creating ? 'required' : 'sometimes'|string|max:100), `code` (nullable|string|max:30|regex:/^[a-z0-9_]+$/), `category` (sometimes|Rule::in(self::DEDUCTION_CATEGORIES)), `reduces_tax_base` (sometimes|boolean), `max_tax_deduction_rate` (sometimes|nullable|numeric|min:0|max:1), `default_amount` (sometimes|nullable|numeric|min:0), `is_recurring` (sometimes|boolean), `applies_to` (sometimes|Rule::in(['all', 'assigned'])), `is_active` (sometimes|boolean) - `payroll-settings.deduction-types.update` — PATCH /manager/payroll-settings/deduction-types/{deductionType} — Kesinti türünü günceller (yalnız gönderilen alanlar). [payroll.manage] - alanlar: `name` ($creating ? 'required' : 'sometimes'|string|max:100), `code` (nullable|string|max:30|regex:/^[a-z0-9_]+$/), `category` (sometimes|Rule::in(self::DEDUCTION_CATEGORIES)), `reduces_tax_base` (sometimes|boolean), `max_tax_deduction_rate` (sometimes|nullable|numeric|min:0|max:1), `default_amount` (sometimes|nullable|numeric|min:0), `is_recurring` (sometimes|boolean), `applies_to` (sometimes|Rule::in(['all', 'assigned'])), `is_active` (sometimes|boolean) - `payroll-settings.earning-types.destroy` — DELETE /manager/payroll-settings/earning-types/{earningType} — Ek kazanç türünü kaldırır; bordroda ya da çalışan kaleminde kullanıldıysa pasife alınır. [payroll.manage] - `payroll-settings.earning-types.hourly-presets` — POST /manager/payroll-settings/earning-types/hourly-presets — Saat bazlı yasal kazanç türlerini şablondan açar: presets[] (overtime_50 | overtime_25 | weekly_rest | holiday | night; [payroll.manage] - alanlar: `presets` (required|array|min:1|max:5), `presets.*` (required|distinct|Rule::in(array_keys(self::HOURLY_PRESETS))), `multipliers` (nullable|array), `multipliers.*` (nullable|numeric|gt:0|max:10), `multiplier` (nullable|numeric|gt:0|max:10), `applies_to` (nullable|Rule::in(['all', 'assigned'])), `is_sgk_applicable` (nullable|boolean) - `payroll-settings.earning-types.store` — POST /manager/payroll-settings/earning-types — Ek kazanç türü ekler. Vergi/prim bayrakları (is_taxable, is_sgk_applicable, is_stamp_tax_applicable), [payroll.manage] - alanlar: `name` ($creating ? 'required' : 'sometimes'|string|max:100), `code` (nullable|string|max:30|regex:/^[a-z0-9_]+$/), `category` (sometimes|Rule::in(self::EARNING_CATEGORIES)), `is_taxable` (sometimes|boolean), `is_sgk_applicable` (sometimes|boolean), `is_stamp_tax_applicable` (sometimes|boolean), `exemption_type` (sometimes|nullable|Rule::in(['meal_exemption_daily', 'transport_exemption_daily'])), `calculation_type` (sometimes|Rule::in(['fixed', 'per_day', 'percentage_of_gross', 'manual', 'hourly_multiplier'])), `hours_source` ($creating ? 'nullable' : 'sometimes'|nullable|required_if:calculation_type,hourly_multiplier|Rule::in(array_keys(CompanyPayrollEarningType::HOUR_SOURCES))), `multiplier` ($creating ? 'nullable' : 'sometimes'|nullable|required_if:calculation_type,hourly_multiplier|numeric|gt:0|max:10), `default_amount` (sometimes|nullable|numeric|min:0), `is_recurring` (sometimes|boolean), `applies_to` (sometimes|Rule::in(['all', 'assigned'])), `is_active` (sometimes|boolean) - `payroll-settings.earning-types.update` — PATCH /manager/payroll-settings/earning-types/{earningType} — Ek kazanç türünü günceller (yalnız gönderilen alanlar). Sistem türlerinde (yemek/yol, çıkış) yalnız ad ve tutar. Saat bazlı türde hours_source ve multiplier. [payroll.manage] - alanlar: `name` ($creating ? 'required' : 'sometimes'|string|max:100), `code` (nullable|string|max:30|regex:/^[a-z0-9_]+$/), `category` (sometimes|Rule::in(self::EARNING_CATEGORIES)), `is_taxable` (sometimes|boolean), `is_sgk_applicable` (sometimes|boolean), `is_stamp_tax_applicable` (sometimes|boolean), `exemption_type` (sometimes|nullable|Rule::in(['meal_exemption_daily', 'transport_exemption_daily'])), `calculation_type` (sometimes|Rule::in(['fixed', 'per_day', 'percentage_of_gross', 'manual', 'hourly_multiplier'])), `hours_source` ($creating ? 'nullable' : 'sometimes'|nullable|required_if:calculation_type,hourly_multiplier|Rule::in(array_keys(CompanyPayrollEarningType::HOUR_SOURCES))), `multiplier` ($creating ? 'nullable' : 'sometimes'|nullable|required_if:calculation_type,hourly_multiplier|numeric|gt:0|max:10), `default_amount` (sometimes|nullable|numeric|min:0), `is_recurring` (sometimes|boolean), `applies_to` (sometimes|Rule::in(['all', 'assigned'])), `is_active` (sometimes|boolean) - `payroll-settings.export-templates.destroy` — DELETE /manager/payroll-settings/export-templates/{template} — Dosya şablonunu siler (geçmiş üretim kayıtları korunur; şablon adı kayıtta saklıdır). [payroll.manage] - `payroll-settings.export-templates.detect` — POST /manager/payroll-settings/export-templates/detect — Bankanın/muhasebe programının örnek dosyasından şablon çıkarır; store=true ve name verilirse kaydeder. [payroll.manage] - alanlar: `file` (required|file|max:5120), `kind` (required|Rule::in(ExportTemplateRepository::KINDS)), `store` (nullable|boolean), `name` (nullable|string|max:100), `is_default` (nullable|boolean), `dry_run` (nullable|boolean) - `payroll-settings.export-templates.index` — GET /manager/payroll-settings/export-templates — Bordro dosya şablonları: önayarlar (banka + muhasebe fişi, doğrulama durumu ve kaynağıyla) ve firmanın şablonları (yan etkisiz). [payroll.manage] - alanlar: `kind` (nullable|Rule::in(ExportTemplateRepository::KINDS)), `q` (nullable|string|max:100), `page` (nullable|integer|min:1) - `payroll-settings.export-templates.preview` — POST /manager/payroll-settings/export-templates/preview — Dosya şablonunun canlı önizlemesi: son onaylı dönemin ilk satırları şablona göre biçimlenmiş; IBAN/TCKN maskeli (yan etkisiz, dosya üretmez). [payroll.manage] - `payroll-settings.export-templates.show` — GET /manager/payroll-settings/export-templates/{template} — Tek dosya şablonu: tam tanım, parametreler (IBAN maskeli), kopyalandığı önayar ve kullanım (yan etkisiz). [payroll.manage] - `payroll-settings.export-templates.store` — POST /manager/payroll-settings/export-templates — Banka/fiş dosya şablonu oluşturur; preset verilirse kopyalar. [payroll.manage] - alanlar: `kind` (required|in:bank,voucher), `name` (nullable|string|max:100), `preset` (nullable|string|max:40), `bank_code` (sometimes|nullable|string|regex:/^\d{5}$/), `params` (sometimes|nullable|array|max:30), `params.*` (nullable|string|max:200), `is_default` (sometimes|boolean), `definition` (array), `definition.format` (sometimes|in:csv,txt_fixed,xlsx), `definition.encoding` (sometimes|in:utf-8,utf-8-bom,windows-1254,iso-8859-9), `definition.delimiter` (sometimes|string|max:3), `definition.quote` (sometimes|nullable|string|max:1), `definition.line_ending` (sometimes|in:crlf,lf), `definition.header_row` (sometimes|boolean), `definition.decimal_separator` (sometimes|in:,,.), `definition.thousands_separator` (sometimes|nullable|string|max:1), `definition.amount_decimals` (sometimes|integer|min:0|max:4), `definition.implied_decimals` (sometimes|boolean), `definition.ascii_only` (sometimes|boolean), `definition.uppercase` (sometimes|boolean), `definition.same_bank_only` (sometimes|boolean), `definition.sheet_name` (sometimes|nullable|string|max:31), `definition.preamble` (sometimes|array|max:20), `definition.preamble.*.row` (required|integer|min:1|max:50), `definition.preamble.*.label` (nullable|string|max:100), `definition.preamble.*.field` (required|string|max:120|regex:/^(const:.*|param:[a-z0-9_]{1,40}|[a-z0-9_]{1,40})$/), `definition.preamble.*.format` (nullable|string|max:20), `definition.detail_start_row` (sometimes|integer|min:1|max:60), `definition.header_record` (sometimes|array|max:40), `definition.header_record.*.field` (required|string|max:120|regex:/^(const:.*|param:[a-z0-9_]{1,40}|[a-z0-9_]{1,40})$/), `definition.footer_record` (sometimes|array|max:40), `definition.footer_record.*.field` (required|string|max:120|regex:/^(const:.*|param:[a-z0-9_]{1,40}|[a-z0-9_]{1,40})$/), `definition.columns` (sometimes|array|min:1|max:60), `definition.columns.*.field` (required|string|max:120|regex:/^(const:.*|param:[a-z0-9_]{1,40}|[a-z0-9_]{1,40})$/), `definition.columns.*.title` (nullable|string|max:100), `definition.columns.*.width` (nullable|integer|min:1|max:500), `definition.columns.*.align` (nullable|in:left,right), `definition.columns.*.pad` (nullable|string|max:1), `definition.columns.*.format` (nullable|string|max:20), `definition.columns.*.value` (nullable|string|max:200), `definition.max_lines_per_voucher` (sometimes|nullable|integer|min:2|max:100000), `definition.max_vouchers_per_file` (sometimes|nullable|integer|min:1|max:10000) - `payroll-settings.export-templates.update` — PATCH /manager/payroll-settings/export-templates/{template} — Dosya şablonunu günceller (yalnız gönderilen alanlar). [payroll.manage] - `payroll-settings.incentives.apply` — POST /manager/payroll-settings/incentives/apply — Önerilen ya da seçilen teşvikleri çalışanlara uygular — satır bazlı sonuç, dry_run, tekrar güvenli; e-posta yok. [payroll.manage] - alanlar: `rows` (required_without:all_recommended|array|max:500), `rows.*.employee_id` (required|integer), `rows.*.law_no` (nullable|string|max:10), `rows.*.start_date` (nullable|date), `rows.*.end_date` (nullable|date), `rows.*.duration_months` (nullable|integer|min:1|max:120), `rows.*.status` (nullable|in:proposed,active), `rows.*.certificate_no` (nullable|string|max:60), `rows.*.notes` (nullable|string|max:1000), `rows.*.facts` (nullable|array), `all_recommended` (nullable|boolean), `status` (nullable|in:proposed,active), `on_existing` (nullable|Rule::in(['skip', 'update'])), `force` (nullable|boolean), `dry_run` (nullable|boolean) - `payroll-settings.incentives.index` — GET /manager/payroll-settings/incentives — Firmadaki çalışanların teşvik ön uygunluğu, en avantajlı öneri ve aylık tahmini kazanç (yan etkisiz). [payroll.view] - alanlar: `status` (nullable|in:applied,eligible,needs_confirmation,ineligible,expired,recommended,data_gap), `law_no` (nullable|string|max:10), `q` (nullable|string|max:100), `as_of` (nullable|string|regex:/^\d{4}-(0[1-9]|1[0-2])(-\d{2})?$/), `page` (nullable|integer|min:1) - `payroll-settings.index` — GET /manager/payroll-settings — Bordro ayarları sayfasını göster. [payroll.manage] - `payroll-settings.options.update` — PATCH /manager/payroll-settings/options — Firma bordro hesaplama tercihlerini günceller (yalnız gönderilen anahtarlar). Seçenekler ve [payroll.manage] - `payroll-settings.update` — PUT /manager/payroll-settings — Bordro ayarlarını güncelle (kısmi: yalnız gönderilen alanlar yazılır; gönderilmeyen evet/hayır alanları korunur). [payroll.manage] - alanlar: `sector_type` (sometimes|required|string|in:manufacturing,service,other), `nace_code` (nullable|string|max:10), `pay_day` (sometimes|required|integer|between:1,28), `currency` (sometimes|required|string|in:TRY,USD,EUR), `include_meal_allowance` (boolean), `default_meal_allowance_daily` (nullable|numeric|min:0|max:9999.99), `include_transport_allowance` (boolean), `default_transport_allowance_daily` (nullable|numeric|min:0|max:9999.99), `auto_apply_incentive` (boolean), `payroll_lock_day` (nullable|integer|between:1,28), `payslip_note` (nullable|string|max:2000) - `payroll.accounting-postings.destroy` — DELETE /manager/payroll/{period}/accounting-postings/{posting} — Muhasebeleştirme işaretini geri alır (muhasebe programındaki fişe dokunmaz). [payroll.manage] - `payroll.accounting-postings.store` — POST /manager/payroll/{period}/accounting-postings — Dönemi muhasebeleştirildi olarak işaretler; fişin hesap özeti saklanır, sonraki düzeltme fişi buna göre çıkar. [payroll.manage] - alanlar: `kind` (nullable|Rule::in(array_keys(PayrollAccountingPosting::KINDS))), `voucher_no` (nullable|string|max:30), `voucher_date` (nullable|date), `notes` (nullable|string|max:500), `accept_integrity_issues` (nullable|boolean) - `payroll.accounting-voucher` — GET /manager/payroll/{period}/accounting-voucher — Bordro döneminin muhasebe fişi: yevmiye satırları, borç = alacak denetimi, mutabakat, uyarılar; format verilirse dosya indirir (yan etkisiz). [payroll.view] - alanlar: `kind` (nullable|Rule::in(AccountingVoucherBuilder::KINDS)), `detail` (nullable|Rule::in(AccountingVoucherBuilder::DETAILS)), `format` (nullable|string|max:80), `voucher_no` (nullable|string|max:30), `voucher_date` (nullable|date), `merge_same_account` (nullable|boolean), `options` (nullable|array) - `payroll.approve` — POST /manager/payroll/{period}/approve — Bordro dönemini onayla. [payroll.manage] - `payroll.attendance.commit` — POST /manager/payroll/attendance/commit — Puantaj kayıtlarını yazar (toplu, satır bazlı sonuç): ızgara (days) ya da özet; çalışan-ay başına tek kayıt, tekrar güvenli. [payroll.manage] - alanlar: `records` (required|array|min:1|max:1000), `period` (nullable|string|self::PERIOD_RULE), `on_existing` (nullable|in:skip,update), `dry_run` (nullable|boolean), `source` (nullable|in:file,api,panel), `code_map` (nullable|array|max:100), `code_map.*` (string|Rule::in(AttendanceCodes::canonicals())), `records.*.period` (nullable|string|self::PERIOD_RULE), `records.*.format` (nullable|in:grid,summary,manual), `records.*.days` (nullable|array|max:31), `records.*.sgk_days` (nullable|integer|min:0|max:30), `records.*.missing_breakdown` (nullable|array|max:30), `records.*.missing_day_reason` (nullable|string|max:60), `records.*.missing_days` (nullable|numeric|min:0|max:31), `records.*.sick_days` (nullable|numeric|min:0|max:31), `records.*.unpaid_leave_days` (nullable|numeric|min:0|max:31), `records.*.absent_days` (nullable|numeric|min:0|max:31), `records.*.wage_deduction_days` (nullable|numeric|min:0|max:31), `records.*.worked_days` (nullable|numeric|min:0|max:31), `records.*.worked_hours` (nullable|numeric|min:0|max:744), `records.*.paid_rest_hours` (nullable|numeric|min:0|max:744), `records.*.overtime_50_hours` (nullable|numeric|min:0|max:744), `records.*.overtime_25_hours` (nullable|numeric|min:0|max:744), `records.*.weekly_rest_days` (nullable|numeric|min:0|max:31), `records.*.weekly_rest_hours` (nullable|numeric|min:0|max:744), `records.*.holiday_days` (nullable|numeric|min:0|max:31), `records.*.holiday_hours` (nullable|numeric|min:0|max:744), `records.*.night_hours` (nullable|numeric|min:0|max:744), `records.*.notes` (nullable|string|max:500), `records.*.derived` (nullable|array), `records.*.employee_id` (nullable|integer), `records.*.employee_number` (nullable|max:30), `records.*.identity_number` (nullable|max:20), `records.*.employee_name` (nullable|string|max:200) - `payroll.attendance.destroy` — DELETE /manager/payroll/attendance/{entry} — Puantaj kaydını siler (yumuşak; aynı ay yeniden aktarılınca geri gelir) — o çalışan-ay yeniden izin kayıtları ve PDKS'ten hesaplanır. [payroll.manage] - `payroll.attendance.export` — GET /manager/payroll/attendance/export — Puantaj Excel'i (Puantaj ızgarası · Özet · Kodlar) — geri okunabilir; puantajı olmayan çalışan PDKS / izin / tatil takviminden ön doldurulur. [payroll.view] - alanlar: `period` (nullable|string|self::PERIOD_RULE), `department_id` (nullable|integer), `prefill` (nullable|boolean) - `payroll.attendance.index` — GET /manager/payroll/attendance — Ayın puantaj listesi: kayıtlar (önizleme + uyuşmazlık sayısı), puantajı olmayan uygun çalışanlar, kaynak tercihleri, dönem kilidi. [payroll.view] - alanlar: `period` (nullable|string|self::PERIOD_RULE), `department_id` (nullable|integer), `q` (nullable|string|max:100), `format` (nullable|in:grid,summary,manual), `conflicts_only` (nullable|boolean) - `payroll.attendance.parse` — POST /manager/payroll/attendance/parse — Puantaj dosyasını (Excel / CSV) okur, yazmaz: ızgara ya da özet, dönem, gün kodları; dönen records[] payroll.attendance.commit'e verilir. [payroll.manage] - alanlar: `file` (required|file|max:10240|mimes:xlsx,xls,csv,txt), `period` (nullable|string|self::PERIOD_RULE), `code_map` (nullable|array|max:100), `code_map.*` (string|Rule::in(AttendanceCodes::canonicals())), `format` (nullable|in:auto,grid,summary) - `payroll.attendance.show` — GET /manager/payroll/attendance/{entry} — Tek puantaj kaydı: alanlar ve gün gün ızgara, bordro motoru önizlemesi (prim günü, ücret, kovaların ödeyicisi ve tutarı), uyuşmazlıklar, izin / PDKS kayıtları, [payroll.view] - `payroll.attendance.update` — PATCH /manager/payroll/attendance/{entry} — Tek puantaj kaydını düzeltir — yalnız gönderilen alanlar; conflicts_reviewed=true uyuşmazlıkları "incelendi" işaretler. [payroll.manage] - alanlar: `conflicts_reviewed` (nullable|boolean), `code_map` (nullable|array|max:100), `code_map.*` (string|Rule::in(AttendanceCodes::canonicals())), `period` (nullable|string|regex:/^\d{4}-(0[1-9]|1[0-2])$/), `format` (nullable|in:grid,summary,manual), `days` (nullable|array|max:31), `sgk_days` (nullable|integer|min:0|max:30), `missing_breakdown` (nullable|array|max:30), `missing_day_reason` (nullable|string|max:60), `notes` (nullable|string|max:500), `wage_deduction_days` (nullable|numeric|min:0|max:31), `worked_days` (nullable|numeric|min:0|max:31), `weekly_rest_days` (nullable|numeric|min:0|max:31), `holiday_days` (nullable|numeric|min:0|max:31), `sick_days` (nullable|numeric|min:0|max:31), `unpaid_leave_days` (nullable|numeric|min:0|max:31), `absent_days` (nullable|numeric|min:0|max:31), `missing_days` (nullable|numeric|min:0|max:31), `worked_hours` (nullable|numeric|min:0|max:744), `paid_rest_hours` (nullable|numeric|min:0|max:744), `overtime_50_hours` (nullable|numeric|min:0|max:744), `overtime_25_hours` (nullable|numeric|min:0|max:744), `weekly_rest_hours` (nullable|numeric|min:0|max:744), `holiday_hours` (nullable|numeric|min:0|max:744), `night_hours` (nullable|numeric|min:0|max:744) - `payroll.bank-file` — GET /manager/payroll/{period}/bank-file — Banka maaş ödeme dosyası önizlemesi: ödenecekler (IBAN maskeli), dışarıda kalanlar ve nedenleri, toplamlar, geçmiş dosyalar. Yan etkisiz. [payroll.manage] - `payroll.bank-file.generate` — POST /manager/payroll/{period}/bank-file — Banka maaş ödeme dosyasını üretip indirir; üretim denetim kaydına yazılır (IBAN saklanmaz). Dönem onaylanmış olmalı; confirm_total verilirse toplam eşleşmeli. [payroll.manage] - alanlar: `confirm_total` (nullable|regex:/^\d{1,13}([.,]\d{1,2})?$/) - `payroll.bank-file.request-iban` — POST /manager/payroll/{period}/bank-file/request-iban — IBAN'ı eksik/geçersiz çalışanlara IBAN girmeleri için push + e-posta gönderir (yan etki; çalışan başına 24 saatte bir). [payroll.manage] - alanlar: `employee_ids` (nullable|array|max:1000), `employee_ids.*` (integer), `channels` (nullable|array), `channels.*` (string|Rule::in(IbanRequestService::CHANNELS)), `dry_run` (nullable|boolean) - `payroll.bulk-destroy` — POST /manager/payroll/bulk-destroy — Bordro dönemlerini toplu siler: ids[] (≤100) YA DA all_cancelled=true (+ year) — iptal edilmiş tüm dönemler. [payroll.manage] - alanlar: `ids` (nullable|array|max:100|Rule::requiredIf(fn () => ! $request->boolean('all_cancelled'))), `ids.*` (integer), `all_cancelled` (nullable|boolean), `year` (nullable|integer|min:2000|max:2100), `reason` (nullable|string|min:3|max:500|Rule::requiredIf(fn () => ! $request->boolean('dry_run'))), `dry_run` (nullable|boolean) - `payroll.calculate` — POST /manager/payroll/{period}/calculate — Bordro dönemini hesaplar (taslak ya da hesaplanmış dönem; yeniden hesaplama fişleri yeniler). [payroll.manage] - alanlar: `dry_run` (nullable|boolean), `basis` (nullable|in:live,slips), `employee_ids` (nullable|array|max:1000), `employee_ids.*` (integer), `tolerance` (nullable|numeric|min:0|max:1000) - `payroll.cancel` — POST /manager/payroll/{period}/cancel — Bordro dönemini iptal eder (isteğe bağlı reason ≤500, denetime yazılır). [payroll.manage] - alanlar: `reason` (nullable|string|max:500) - `payroll.create` — GET /manager/payroll/create — Yeni bordro dönemi oluşturma formu. [payroll.manage] - `payroll.declaration` — GET /manager/payroll/{period}/declaration — Dönemin SGK (APHB) + vergi (MUHSGK) mutabakatı: sgk_rows (belge türü, kanun no, prim günü, PEK, eksik gün nedeni, giriş/çıkış, meslek kodu, işyeri sicil no), ta [payroll.manage] - alanlar: `sgk_workplace_id` (nullable|integer|Rule::exists('sgk_workplaces', 'id')->where('company_id', $period->company_id)) - `payroll.declaration-export` — GET /manager/payroll/{period}/declaration/export — SGK/MUHSGK mutabakat Excel'i (sayfalar: Özet, SGK (APHB), Vergi (MUHSGK), Bordro Detayı, Uyarılar). Firmada birden [payroll.manage] - alanlar: `sgk_workplace_id` (nullable|integer|Rule::exists('sgk_workplaces', 'id')->where('company_id', $period->company_id)) - `payroll.declaration.update` — PATCH /manager/payroll/{period}/employee/{employee}/declaration — Fişin SGK (APHB) / MUHSGK beyan alanlarını düzeltir — yalnız gönderilen alanlar; tutar, net, kümülatif ve dönem kilidi değişmez. [payroll.manage] - alanlar: `sgk_days` (nullable|integer|min:0|max:31), `missing_day_count` (nullable|integer|min:0|max:31), `missing_day_reason` (nullable|string|in:01,03,04,05,06,07,08,09,10,11,12,13,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29), `sgk_document_type` (nullable|string|in:01,02,04,05,06,07,12,13,14,19,20,21,22,23,24,28,29,30,31,32,33,34,35,36,37,39,41,42,43,46,47,48,49,50,51,52,53,54,55,90,91,92), `insurance_group` (nullable|string|in:normal,sgdp,none), `employer_incentive_code` (nullable|string|regex:/^\d{5}$/), `employer_incentive_amount` (nullable|numeric|min:0), `sgk_occupation_code` (nullable|string|regex:/^\d{4}\.\d{2}$/), `sgk_workplace_registration_no` (nullable|string|digits:26), `tax_payment_type` (nullable|string|in:011,012,014), `rd_law` (nullable|string|in:5746,4691), `rd_rate` (nullable|numeric|min:0|max:100), `rd_days` (nullable|integer|min:0|max:31), `rd_income_tax_exemption` (nullable|numeric|min:0), `rd_stamp_exemption` (nullable|numeric|min:0), `rd_sgk_support` (nullable|numeric|min:0), `mw_income_tax_exemption` (nullable|numeric|min:0), `mw_stamp_exemption` (nullable|numeric|min:0), `reason` (nullable|string|max:500) - `payroll.destroy` — DELETE /manager/payroll/{period} — İptal edilmiş ya da hiç onaylanmamış (taslak/hesaplanmış) bordro dönemini fişleriyle birlikte siler (soft delete + denetim kaydı). [payroll.manage] - alanlar: `reason` (required|string|min:3|max:500) - `payroll.employee-slip` — GET /manager/payroll/{period}/employee/{employee} — Çalışanın dönem bordro fişi: kazanç/kesinti kalemleri, SGK ve vergi kırılımı, işveren maliyeti ve SGK/MUHSGK beyan bilgileri. [payroll.manage] - `payroll.finalize` — POST /manager/payroll/{period}/finalize — Bordro dönemini kesinleştir. [payroll.manage] - `payroll.index` — GET /manager/payroll — Bordro dönemlerini listeler (varsayılan: iptal edilmişler gizli). [payroll.view] - alanlar: `status` (nullable|string|max:200|function (string $attribute, mixed $value, \Closure $fail) use ($allowed) { if ($value === 'all') { return; } $bad = array_diff(array_filter(array_map('trim', explode(',', (string) $value))), $allowed); if ($bad !== []) { $fail(sprintf('Geçersiz durum: %s. Geçerli: all, %s.', implode(', ', $bad), implode(', ', $allowed))); } }), `year` (nullable|integer|min:2000|max:2100), `archived` (nullable|boolean), `per_page` (nullable|integer|min:1|max:100), `page` (nullable|integer|min:1) - `payroll.parameters` — GET /manager/payroll/parameters — Yürürlük tarihli yasal bordro parametreleri (date=YYYY-MM-DD ya da year=YYYY): asgari ücret, SGK oran/taban/tavan, GV dilimleri, istisnalar, AGİ/AÜ istisnası. Y [payroll.view] - alanlar: `date` (nullable|date_format:Y-m-d), `year` (nullable|integer|min:2000|max:2100) - `payroll.pay` — POST /manager/payroll/{period}/pay — Bordro dönemini ödenmiş olarak işaretle. [payroll.manage] - `payroll.pension-transfer` — GET /manager/payroll/{period}/pension-transfer — Dönemin BES kurum aktarım listesi — plan bazında çalışan/işveren katkıları, son gün, aktarım durumu (yan etkisiz). [payroll.manage] - alanlar: `plan_id` (nullable|integer) - `payroll.pension-transfer-export` — GET /manager/payroll/{period}/pension-transfer/export — BES kurum aktarım listesini Excel olarak indirir (plan başına sayfa, TCKN tam; ?plan_id ile tek plan) — yan etkisiz. [payroll.manage] - alanlar: `plan_id` (nullable|integer) - `payroll.pension-transfer-mark` — POST /manager/payroll/{period}/pension-transfer/mark — BES aktarımını "aktarıldı" olarak işaretler (dönem + plan; tekrar güvenli — ikinci çağrı tarihi/referansı günceller); dry_run destekler. [payroll.manage] - alanlar: `plan_id` (required|integer), `transferred_at` (nullable|date), `reference` (nullable|string|max:120), `dry_run` (nullable|boolean) - `payroll.reopen` — POST /manager/payroll/{period}/reopen — Kesinleşmiş / ödenmiş dönemi düzeltmeye açar: reason (zorunlu, ör. "Ahmet'in fazla mesaisi eksik girilmiş"). [payroll.manage] - alanlar: `reason` (required|string|min:5|max:1000) - `payroll.restore` — POST /manager/payroll/{period}/restore — Silinmiş bordro dönemini fişleriyle geri alır. [payroll.manage] - `payroll.show` — GET /manager/payroll/{period} — Bordro dönemi detayı: fişler, özet, düzeltme turları. {period} id ya da YYYY-AA (ör. 2026-04; aynı ayın [payroll.manage] - alanlar: `id` ($slip->id), `employee_id` ($slip->employee_id), `employee` ($slip->employee ? [ 'id' => $slip->employee->id, 'first_name' => $slip->employee->first_name, 'last_name' => $slip->employee->last_name, 'full_name' => $slip->employee->first_name . ' ' . $slip->emplo), `gross_salary` ($slip->gross_salary), `gross_total` ($slip->gross_total), `sgk_employee_total` ($slip->sgk_employee_total), `income_tax_final` ($slip->income_tax_final), `stamp_tax_final` ($slip->stamp_tax_final), `total_deductions` ($slip->total_deductions), `net_pay` ($slip->net_pay), `total_employer_cost` ($slip->total_employer_cost), `sgk_employer_total` ($slip->sgk_employer_total), `status` ($slip->status), `worked_days` ($slip->worked_days), `sgk_day_count` ($slip->sgk_day_count), `day_source` ($slip->day_source), `hour_source` ($slip->hour_source) - `payroll.simulate` — POST /manager/payroll/simulate — Yan etkisiz bordro simülasyonu: çalışan ya da serbest profil için fiş + adım adım hesap izi; DB'ye hiçbir şey yazmaz, bildirim/AI kredisi yok. [payroll.view] - alanlar: `period` (required|date_format:Y-m|after_or_equal:2021-01|'before_or_equal:' . now()->addMonths(12)->format('Y-m')), `months` (nullable|integer|min:1|max:12), `employee_id` (required_without:profile|nullable|integer|Rule::exists('employees', 'id')->where('company_id', $companyId)->whereNull('deleted_at')), `profile` (required_without:employee_id|nullable|array), `profile.salary_type` (nullable|in:monthly,hourly), `profile.gross_salary` (nullable|numeric|min:0), `profile.net_salary` (nullable|numeric|min:0), `profile.hourly_rate` (nullable|numeric|min:0), `profile.hours` (nullable|numeric|min:0|max:744), `profile.insurance_group` (nullable|Rule::in(array_keys(SgkDeclarationCodes::INSURANCE_GROUPS))), `profile.mw_exemption_applies` (nullable|boolean), `profile.rd_incentive` (nullable|Rule::in(array_keys(SgkDeclarationCodes::RD_LAWS))), `profile.rd_tax_exemption_rate` (nullable|in:80,90,95,100), `profile.disability_degree` (nullable|integer|in:0,1,2,3), `profile.hire_date` (nullable|date), `profile.is_manufacturing` (nullable|boolean), `profile.work_schedule` (nullable|Rule::in(array_keys(\App\Models\EmployeePayrollProfile::WORK_SCHEDULES))), `profile.weekly_hours` (nullable|numeric|min:1|max:45), `attendance` (nullable|array), `attendance.sgk_days` (nullable|integer|min:0|max:30), `attendance.missing_breakdown` (nullable|array), `attendance.missing_breakdown.*` (numeric|min:0|max:31), `attendance.missing_day_reason` (nullable|Rule::in(array_keys(SgkDeclarationCodes::MISSING_DAY_REASONS))), `attendance.worked_hours` (nullable|numeric|min:0|max:744), `attendance.paid_rest_hours` (nullable|numeric|min:0|max:744), `days` (nullable|array), `days.sgk_days` (nullable|integer|min:0|max:30), `days.missing_days` (nullable|integer|min:0|max:30), `days.missing_reason` (nullable|Rule::in(array_keys(SgkDeclarationCodes::MISSING_DAY_REASONS))), `days.pay_days` (nullable|numeric|min:0|max:30), `days.allowance_days` (nullable|integer|min:0|max:31), `days.rd_days` (nullable|integer|min:0|max:30), `overtime` (nullable|array), `overtime.overtime_50_hours` (nullable|numeric|min:0|max:300), `overtime.overtime_25_hours` (nullable|numeric|min:0|max:300), `overtime.weekly_rest_hours` (nullable|numeric|min:0|max:300), `overtime.weekly_rest_days` (nullable|integer|min:0|max:6), `overtime.holiday_hours` (nullable|numeric|min:0|max:300), `overtime.holiday_days` (nullable|integer|min:0|max:16), `overtime.night_hours` (nullable|numeric|min:0|max:300), `earnings` (nullable|array|max:50), `earnings.*.type_id` (nullable|integer|Rule::exists('company_payroll_earning_types', 'id')->where('company_id', $companyId)), `earnings.*.code` (nullable|Rule::in(SimulationInputBuilder::EARNING_CODES)), `earnings.*.name` (nullable|string|max:120), `earnings.*.amount` (nullable|numeric|min:0), `earnings.*.daily` (nullable|numeric|min:0), `earnings.*.days` (nullable|integer|min:0|max:31), `earnings.*.gv_taxable` (nullable|boolean), `earnings.*.sgk_applicable` (nullable|boolean), `earnings.*.dv_applicable` (nullable|boolean), `earnings.*.net` (nullable|boolean), `deductions` (nullable|array|max:50), `deductions.*.type_id` (nullable|integer|Rule::exists('company_payroll_deduction_types', 'id')->where('company_id', $companyId)), `deductions.*.name` (nullable|string|max:120), `deductions.*.amount` (required|numeric|min:0), `deductions.*.reduces_tax_base` (nullable|boolean), `cumulative_tax_base_before` (nullable|numeric|min:0), `exit` (nullable|array), `exit.leave_pay` (nullable|numeric|min:0), `exit.notice_pay` (nullable|numeric|min:0), `exit.severance` (nullable|numeric|min:0), `exit.severance_excess` (nullable|numeric|min:0), `options` (nullable|array), `incentives` (nullable|array|max:5), `incentives.*.law_no` (required|string|max:5|function (string $attribute, mixed $value, \Closure $fail) { $law = \App\Services\Payroll\Incentives\IncentiveCatalog::normalize($value); if ($law === null || ! \App\Services\Payroll\Incentives\IncentiveCatalog::exists($law)) { $fail("Kanun no '{$value}' katalogda yok — empuno reference incentive_codes."); } }), `incentives.*.start_date` (nullable|date_format:Y-m-d), `incentives.*.duration_months` (nullable|integer|min:1|max:120), `apply_5510` (nullable|boolean), `pension` (nullable|array), `pension.enabled` (nullable|boolean), `pension.employer_contribution_type` (nullable|Rule::in(array_keys(\App\Models\CompanyPensionPlan::EMPLOYER_CONTRIBUTION_TYPES))), `pension.employer_contribution_value` (nullable|numeric|min:0), `segments` (nullable|array|min:2|max:6), `segments.*.from` (required|date_format:Y-m-d), `segments.*.to` (required|date_format:Y-m-d), `segments.*.sgk_workplace_id` (nullable|integer|Rule::exists('sgk_workplaces', 'id')->where('company_id', $companyId)), `segments.*.sick_days` (nullable|integer|min:0|max:31), `segments.*.unpaid_days` (nullable|integer|min:0|max:31), `agi` (nullable|array), `agi.marital_status` (nullable|in:single,married), `agi.spouse_works` (nullable|boolean), `agi.children` (nullable|integer|min:0|max:10), `include_live_items` (nullable|boolean), `compare_with_slip` (nullable|boolean), `trace` (nullable|in:first,all,none) - `payroll.simulator` — GET /manager/payroll/simulator — Bordro simülatörü form verisi: çalışanlar (profil özeti), ek kazanç/kesinti türleri, hesaplama tercihleri, parametre setleri. Yan etkisiz. [payroll.view] - `payroll.store` — POST /manager/payroll — Yeni bordro dönemi açar (year, month). Aynı ayın iptal edilmemiş dönemi varsa reddedilir; yalnız iptal [payroll.manage] - alanlar: `year` (required|integer|min:2022|max:2099), `month` (required|integer|between:1,12) - `pension.index` — GET /manager/pension — BES planları, katılımcılar ve son hareketler (yan etkisiz). [payroll.view] - alanlar: `status` (nullable|in:active,paused,opted_out,left,not_enrolled), `plan_id` (nullable|integer), `q` (nullable|string|max:100), `page` (nullable|integer|min:1) - `pension.plans.destroy` — DELETE /manager/pension/plans/{plan} — BES planını siler — katılımcısı varsa silinmez, pasife alınır (yeni katılım durur, mevcut kesintiler sürer); dry_run destekler. [payroll.manage] - alanlar: `dry_run` (nullable|boolean) - `pension.plans.store` — POST /manager/pension/plans — BES planı ekler (emeklilik şirketi sözleşmesi) — dry_run destekler; e-posta yok. [payroll.manage] - `pension.plans.update` — PATCH /manager/pension/plans/{plan} — BES planını günceller — yalnız gönderilen alanlar; is_active=false ile pasife alma, is_default ile varsayılan seçimi. [payroll.manage] - `pension.sync` — POST /manager/pension/sync — Uygun ve kaydı olmayan çalışanları BES planına dahil eder — dry_run ile önizleme, satır bazlı sonuç; e-posta yok. [payroll.manage] - alanlar: `plan_id` (nullable|integer), `as_of` (nullable|date), `include_existing_hires` (nullable|boolean), `dry_run` (nullable|boolean) - `reports.index` — GET /manager/reports — Rapor merkezi: tüm raporlar, süzgeçleri ve son dönemler (panel ekranı). [payroll.view] - `reports.payroll` — GET /manager/reports/payroll — Bordro raporu (report=register|icmal|yearly|income_tax|salary_summary|rd|employee_info; period=YYYY-AA ya da year=YYYY). [payroll.view] - alanlar: `report` (required|Rule::in(array_keys(PayrollReports::REPORTS))), `period` (nullable|string|max:20), `year` (nullable|integer|between:2000,2100), `sgk_workplace_id` (nullable|integer), `department_id` (nullable|integer), `employee_id` (nullable|integer), `format` (nullable|Rule::in(['json', 'xlsx', 'pdf'])) - `reports.payslips` — GET /manager/reports/payslips — Ücret hesap pusulası (period=YYYY-AA; employee_ids[] boşsa dönemin tümü). format=pdf (vars.) | json. [payroll.view] - alanlar: `period` (required|string|max:20), `employee_ids` (nullable|array|max:500), `employee_ids.*` (integer), `employer` (nullable|boolean), `format` (nullable|Rule::in(['json', 'pdf'])) - `sgk-workplaces.assign` — POST /manager/sgk-workplaces/{sgkWorkplace}/assign — Çalışanları SGK işyerine bağlar — mode=correct (güncel dönemin işyerini düzelt) | transfer (tarihli nakil); satır bazlı results[]. [payroll.manage] - alanlar: `employee_ids` (required|array|min:1|max:500), `employee_ids.*` (integer), `mode` (required|in:correct,transfer), `date` (nullable|date|before_or_equal:today|required_if:mode,transfer), `dry_run` (nullable|boolean) - `sgk-workplaces.change-registration` — POST /manager/sgk-workplaces/{sgkWorkplace}/change-registration — SGK yeni sicil numarası verdi (işkolu / ilçe / ünite değişikliği) — dry_run destekler; e-posta yok. [payroll.manage] - alanlar: `registration_no` (required|string|max:60), `date` (required|date), `note` (nullable|string|max:500), `dry_run` (nullable|boolean) - `sgk-workplaces.destroy` — DELETE /manager/sgk-workplaces/{sgkWorkplace} — SGK işyerini siler — çalışma dönemi ya da bordro fişi bağlıysa reddedilir (closed_at ile kapatın); dry_run destekler. [payroll.manage] - alanlar: `dry_run` (nullable|boolean) - `sgk-workplaces.index` — GET /manager/sgk-workplaces — Firmanın SGK işyerlerini listeler — yan etkisiz; kapatılanlar include_closed=true ile. [payroll.view] - `sgk-workplaces.merge` — POST /manager/sgk-workplaces/{sgkWorkplace}/merge — Ayrı işyeri olarak açılmış eski sicilleri bu işyerine birleştirir (sicil geçmişine katar) — atomik, dry_run destekler. [payroll.manage] - alanlar: `source_ids` (required|array|min:1|max:50), `source_ids.*` (integer), `valid_until` (nullable|array), `valid_until.*` (date), `dry_run` (nullable|boolean) - `sgk-workplaces.merge-suggestions` — GET /manager/sgk-workplaces/merge-suggestions — Birleştirme önerileri — yan etkisiz: aynı sıra no + il + aracı numaralı işyerleri (işkolu / ilçe / ünite değişince [payroll.view] - `sgk-workplaces.registrations.destroy` — DELETE /manager/sgk-workplaces/{sgkWorkplace}/registrations/{registration} — Sicil geçmişinden bir eski numarayı kaldırır (yanlış girilmiş) — dry_run destekler. [payroll.manage] - alanlar: `dry_run` (nullable|boolean) - `sgk-workplaces.registrations.store` — POST /manager/sgk-workplaces/{sgkWorkplace}/registrations — İşyerinin sicil geçmişine eski bir numara ekler (aktarılmış geçmiş dönemler için) — dry_run destekler. [payroll.manage] - alanlar: `registration_no` (required|string|max:60), `valid_until` (required|date), `valid_from` (nullable|date), `note` (nullable|string|max:500), `dry_run` (nullable|boolean) - `sgk-workplaces.store` — POST /manager/sgk-workplaces — SGK işyeri açar — dry_run destekler; e-posta yok. [payroll.manage] - alanlar: `name` (nullable|string|max:150), `registration_no` (nullable|string|max:60), `province` (nullable|string|max:100), `district` (nullable|string|max:100), `branch_id` (nullable|integer), `zone_type` (nullable|in:standard,technopark,rd_center), `default_law_no` (nullable|string|max:6), `is_default` (nullable|boolean), `closed_at` (nullable|date), `notes` (nullable|string|max:500), `dry_run` (nullable|boolean) - `sgk-workplaces.update` — PATCH /manager/sgk-workplaces/{sgkWorkplace} — SGK işyerini günceller — yalnız gönderilen alanlar; closed_at ile kapatma, is_default ile varsayılan seçimi. [payroll.manage] - alanlar: `name` (nullable|string|max:150), `registration_no` (nullable|string|max:60), `province` (nullable|string|max:100), `district` (nullable|string|max:100), `branch_id` (nullable|integer), `zone_type` (nullable|in:standard,technopark,rd_center), `default_law_no` (nullable|string|max:6), `is_default` (nullable|boolean), `closed_at` (nullable|date), `notes` (nullable|string|max:500), `dry_run` (nullable|boolean) ### PDKS Yönetimi (`pdks`) - `pdks.auto-checkout` — POST /manager/pdks/auto-checkout — PDKS (giriş-çıkış) — auto checkout [pdks.manage] - `pdks.calendar` — GET /manager/pdks/calendar — PDKS (giriş-çıkış) — calendar [pdks.view] - alanlar: `id` ($employee->id), `full_name` ($employee->full_name), `employee_id` ($employee->employee_id) - `pdks.calendar.data` — GET /manager/pdks/calendar/data — PDKS takvimi — data [pdks.view] - alanlar: `id` ($session->id), `title` ($title), `start` ($session->date), `allDay` (true), `color` ($color), `extendedProps` ('employee' => $session->employee->full_name|'branch' => $session->branch->name|'check_in' => $session->check_in_time ? $company->convertToLocal($session->check_in_time)->format('H:i') : '-'|'check_out' => $session->check_out_time ? $company->convertToLocal($session->check_out_time)->format('H:i') : '-'|'working_hours' => $session->working_hours|'overtime' => $session->total_minutes_worked > 480 ? sprintf('%d:%02d', floor(($session->total_minutes_worked - 480) / 60), ($session->total_minutes_worked - 480) % 60) : '-'|'overtime_minutes' => (int) ($session->overtime_minutes ?? 0)|'early_leave_minutes' => (int) ($session->early_leave_minutes ?? 0)|'expected_minutes' => (int) ($session->expected_minutes ?? 0)|'is_auto_checkout' => (bool) $session->is_auto_checkout|'status' => $session->status) - `pdks.configure` — GET /manager/pdks/branches/{branch}/configure — PDKS (giriş-çıkış) — configure [pdks.manage] - `pdks.disable` — POST /manager/pdks/branches/{branch}/disable — PDKS (giriş-çıkış) — Devre dışı bırak [pdks.manage] - `pdks.enable` — POST /manager/pdks/branches/{branch}/enable — PDKS (giriş-çıkış) — Etkinleştir [pdks.manage] - `pdks.export` — GET /manager/pdks/export — PDKS (giriş-çıkış) — Dışa aktar [pdks.view] - `pdks.generate-token` — POST /manager/pdks/branches/{branch}/generate-token — PDKS (giriş-çıkış) — generate token [pdks.manage] - `pdks.index` — GET /manager/pdks — PDKS (giriş-çıkış) — Listele [pdks.view] - `pdks.live-attendance` — GET /manager/pdks/live-attendance — PDKS (giriş-çıkış) — live attendance [pdks.view] - `pdks.live-attendance.data` — GET /manager/pdks/live-attendance/data — Canlı yoklama — data [pdks.view] - alanlar: `id` ($session->id), `employee_name` ($session->employee->full_name), `status` ($session->status), `next_action` ($session->next_action), `next_action_label` ($session->next_action_label), `check_in_time` ($session->convertToLocal($session->check_in_time)?->format('H:i')), `check_out_time` ($session->convertToLocal($session->check_out_time)?->format('H:i')), `working_hours` ($session->working_hours), `updated_at` ($session->convertToLocal($session->updated_at)->format('H:i:s')) - `pdks.public-link` — GET /manager/pdks/branches/{branch}/public-link — PDKS (giriş-çıkış) — public link [pdks.view] - `pdks.reports` — GET /manager/pdks/branches/{branch}/reports — PDKS (giriş-çıkış) — reports [pdks.view] - `pdks.settings.update` — PUT /manager/pdks/branches/{branch}/settings — PDKS ayarları — Güncelle [pdks.manage] - alanlar: `work_start_time` (required|date_format:H:i), `work_end_time` (required|date_format:H:i), `lunch_break_enabled` (boolean), `lunch_start_time` (nullable|date_format:H:i), `lunch_end_time` (nullable|date_format:H:i), `overtime_limit` (required|date_format:H:i), `location_check_enabled` (boolean), `latitude` (nullable|numeric|between:-90,90), `longitude` (nullable|numeric|between:-180,180), `location_radius` (required|integer|min:10|max:500), `qr_validity_seconds` (nullable|integer|min:5|max:300), `pdks_max_distance_m` (nullable|integer|min:20|max:100) - `pdks.station-code` — GET /manager/pdks/branches/{branch}/station-code — PDKS İstasyon Kodu sayfası — yöneticinin tablete gireceği 8 haneli dönen kod. [pdks.view] - `pdks.station-code.refresh` — GET /manager/pdks/branches/{branch}/station-code/refresh — İstasyon kodunu JSON olarak döndürür (sayfa client-side auto-refresh için). [pdks.view] ### Web PDKS Entegrasyonu (`pdks_web`) - `pdks-web.branch` — GET /manager/pdks/branches/{branch}/web — Tek şubenin web embed yönetim sayfası. [pdks_web.view] - `pdks-web.disable` — POST /manager/pdks/branches/{branch}/web/disable — Şube için Web PDKS'i kapat. [pdks_web.manage] - `pdks-web.enable` — POST /manager/pdks/branches/{branch}/web/enable — Şube için Web PDKS aktif et — yoksa pinli token oluştur, varsa yeniden etkinleştir. [pdks_web.manage] - `pdks-web.index` — GET /manager/pdks-web — Web PDKS — Listele - `pdks-web.logs` — GET /manager/pdks-web/logs — Web PDKS — logs [pdks_web.view] - `pdks-web.logs.export` — GET /manager/pdks-web/logs/export — Web PDKS kayıtları — Dışa aktar [pdks_web.view] - `pdks-web.rotate` — POST /manager/pdks/branches/{branch}/web/rotate — Token'ı yenile — eski iframe/script kodu çalışmayı durdurur. [pdks_web.manage] - `pdks-web.update` — PUT /manager/pdks/branches/{branch}/web — İzinli origin + konum zorunluluğu güncelle. [pdks_web.manage] - alanlar: `allowed_origins` (array), `allowed_origins.*` (string|max:255|regex:#^https?://[^/\s]+$#i), `location_required` (boolean) ### Vardiya Yönetimi (`shifts`) - `shift-scheduling.approve` — POST /manager/shift-scheduling/approve — Approve and apply the generated schedule [shifts.manage] - `shift-scheduling.create` — GET /manager/shift-scheduling/create — Otomatik vardiya planı — Oluşturma formu verisi [shifts.manage] - alanlar: `id` ($shift->id), `name` ($shift->name), `start_time` ($shift->start_time), `end_time` ($shift->end_time), `working_days` ($shift->working_days_array), `is_active` ($shift->is_active) - `shift-scheduling.generate` — POST /manager/shift-scheduling/generate — Otomatik vardiya planı — Üret [shifts.manage] - alanlar: `start_date` (required|date|after_or_equal:today), `end_date` (required|date|after:start_date), `branch_id` (nullable|exists:branches,id), `employee_ids` (required|array|min:1), `employee_ids.*` (exists:employees,id), `business_type` (required|in:cafe,office), `max_daily_hours` (required|integer|min:4|max:{$maxDailyLimit}), `max_weekly_hours` (required|integer|min:20|max:{$maxWeeklyLimit}), `shift_duration` (required|integer|in:6,8,9), `fair_distribution` (boolean), `business_open_time` (required_if:business_type,cafe|date_format:H:i), `business_close_time` (required_if:business_type,cafe|date_format:H:i), `min_staff` (required_if:business_type,cafe|integer|min:1), `peak_min_staff` (required_if:business_type,cafe|integer|min:1) - `shift-scheduling.index` — GET /manager/shift-scheduling — Otomatik vardiya planı — Listele [shifts.manage] - alanlar: `id` ($shift->id), `name` ($shift->name), `start_time` ($shift->start_time), `end_time` ($shift->end_time), `working_days` ($shift->working_days_array), `is_active` ($shift->is_active) - `shifts.assign` — POST /manager/shifts/assign — Vardiyalar — Ata [shifts.manage] - alanlar: `employee_id` (required|exists:employees,id), `shift_id` (required|exists:shifts,id), `assigned_date` (required|date|after_or_equal:today), `recurring` (boolean) - `shifts.assignments` — GET /manager/shifts/assignments — Vardiyalar — assignments [shifts.view] - `shifts.calendar` — GET /manager/shifts/calendar — Vardiyalar — calendar [shifts.view] - alanlar: `id` ($branch->id), `name` ($branch->name), `address` ($branch->address) - `shifts.calendar-events` — GET /manager/shifts/calendar-events — Vardiyalar — calendar events [shifts.view] - `shifts.create` — GET /manager/shifts/create — Vardiyalar — Oluşturma formu verisi [shifts.manage] - `shifts.destroy` — DELETE /manager/shifts/{shift} — Vardiyalar — Sil [shifts.manage] - `shifts.edit` — GET /manager/shifts/{shift}/edit — Vardiyalar — Düzenleme formu verisi [shifts.manage] - `shifts.index` — GET /manager/shifts — Vardiyalar — Listele [shifts.view] - alanlar: `id` ($shift->id), `name` ($shift->name), `start_time` ($shift->start_time), `end_time` ($shift->end_time), `working_days` ($shift->working_days_array), `break_duration_minutes` ($shift->break_duration_minutes), `is_active` ($shift->is_active), `employees_count` ($shift->employees_count), `created_at` ($shift->created_at?->format('d.m.Y H:i')) - `shifts.store` — POST /manager/shifts — Vardiyalar — Oluştur [shifts.manage] - alanlar: `name` (required|string|max:255), `start_time` (required|date_format:H:i), `end_time` (required|date_format:H:i|after:start_time), `working_days` (required|array|min:1), `working_days.*` (in:monday,tuesday,wednesday,thursday,friday,saturday,sunday), `break_duration_minutes` (nullable|integer|min:0|max:480), `description` (nullable|string) - `shifts.update` — PUT /manager/shifts/{shift} — Vardiyalar — Güncelle [shifts.manage] - alanlar: `name` (required|string|max:255), `start_time` (required|date_format:H:i), `end_time` (required|date_format:H:i|after:start_time), `working_days` (required|array|min:1), `working_days.*` (in:monday,tuesday,wednesday,thursday,friday,saturday,sunday), `break_duration_minutes` (nullable|integer|min:0|max:480), `is_active` (boolean) ### Vize Talepleri (`visa_requests`) - `visa-requests.cancel` — POST /manager/visa-requests/{visaRequest}/cancel — Vize talepleri — İptal et [visa_requests.manage] - `visa-requests.download` — GET /manager/visa-requests/{visaRequest}/download — Vize talepleri — İndir [visa_requests.view] - `visa-requests.generate` — POST /manager/visa-requests/{visaRequest}/generate — Vize talepleri — Üret [visa_requests.manage] - alanlar: `include_salary` (nullable|boolean) - `visa-requests.index` — GET /manager/visa-requests — Vize talepleri — Listele [visa_requests.view] - `visa-requests.share` — POST /manager/visa-requests/{visaRequest}/share — Vize talepleri — Paylaş [visa_requests.manage] HTML: https://empuno.com/api-docs/agent · CLI: https://empuno.com/cli/empuno.mjs · Salt-okuma API: https://empuno.com/api-docs