{"openapi":"3.0.3","info":{"title":"Vergi Merkezi | Dijital Agentic API","version":"1.3.0","description":"Agent u\u00e7lar\u0131: \u015firket, \u00fcr\u00fcn, sipari\u015f, muhasebe (fatura, tahsilat\/\u00f6deme, kasa\/banka, stok, cari), raporlar ve ekstreler. Kimlik: Bearer (POST \/auth\/login veya profil token). \u0130\u015flemlerde company_id. Bu dosya u\u00e7 nokta ve \u015fema \u00f6zetini i\u00e7erir; ayr\u0131nt\u0131lar s\u00fcr\u00fcmle g\u00fcncellenebilir. v1.3.0"},"servers":[{"url":"https:\/\/efatura.vergimerkezi.com.tr\/api\/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"paths":{"\/auth\/login":{"post":{"summary":"E-posta ve \u015fifre ile API token al","description":"M\u00fc\u015fteri (client) hesab\u0131 i\u00e7in yeni Bearer token \u00fcretir. Ba\u015far\u0131l\u0131 yan\u0131tta d\u00f6nen token, profil sayfas\u0131ndan olu\u015fturulan token ile ayn\u0131 \u015fekilde kullan\u0131l\u0131r. Her ba\u015far\u0131l\u0131 \u00e7a\u011fr\u0131 \u00f6nceki api_token de\u011ferini ge\u00e7ersiz k\u0131lar. S\u00f6zle\u015fme onay\u0131 zorunluysa ve web \u00fczerinden kabul edilmemi\u015fse 403 d\u00f6ner.","security":[],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","format":"email"},"password":{"type":"string"}}}}}},"responses":{"200":{"description":"success, data.token, data.user_id"},"401":{"description":"E-posta veya \u015fifre hatal\u0131"},"403":{"description":"M\u00fc\u015fteri de\u011fil veya s\u00f6zle\u015fme onay\u0131 eksik"},"422":{"description":"Validasyon hatas\u0131"},"429":{"description":"\u00c7ok fazla deneme (throttle)"}},"tags":["Kimlik"],"operationId":"postAuthLogin"}},"\/agent\/companies":{"get":{"summary":"\u015eirket listesi","description":"Oturum a\u00e7an kullan\u0131c\u0131n\u0131n \u015firketleri. Sipari\u015f i\u00e7in company_id kullan\u0131l\u0131r.","responses":{"200":{"description":"companies, currency"}},"tags":["\u015eirket ve \u00fcr\u00fcn"],"operationId":"getAgentCompanies"}},"\/agent\/products":{"get":{"summary":"\u00dcr\u00fcn\/hizmet listesi","description":"Kont\u00f6r ve hizmet fiyatlar\u0131. items (d\u00fcz liste), kontor, services (kategori bazl\u0131).","responses":{"200":{"description":"currency, items (sku, key, category, label, base_price, currency), kontor, services, category_labels"}},"tags":["\u015eirket ve \u00fcr\u00fcn"],"operationId":"getAgentProducts"}},"\/agent\/orders":{"post":{"summary":"Sipari\u015f olu\u015ftur","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id"],"properties":{"company_id":{"type":"integer","description":"\u015eirket ID (GET companies ile al\u0131n\u0131r)"},"pricing_key":{"type":"string","description":"Kont\u00f6r paketi key (tek \u00fcr\u00fcn)"},"pricing_keys":{"type":"array","items":{"type":"string"},"description":"Hizmet key listesi"}}}}}},"responses":{"201":{"description":"order_id, order_no, token, checkout_url, status, status_label, currency"},"422":{"description":"Validasyon hatas\u0131"}},"tags":["Sipari\u015f"],"operationId":"postAgentOrders"}},"\/agent\/orders\/{id}":{"get":{"summary":"Sipari\u015f durumu","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"order_id, order_no, token, status, status_label, checkout_url, grand_total, currency, payment_confirmed_at"},"404":{"description":"Sipari\u015f bulunamad\u0131"}},"tags":["Sipari\u015f"],"operationId":"getAgentOrdersId"}},"\/agent\/formation":{"get":{"summary":"\u015eirket kurulu\u015f ba\u015fvurular\u0131 listesi","responses":{"200":{"description":"applications[]"}},"tags":["Kurulu\u015f"],"operationId":"getAgentFormation"},"post":{"summary":"\u015eirket kurulu\u015f ba\u015fvurusu olu\u015ftur","requestBody":{"content":{"application\/json":{"schema":{"type":"object","required":["company_type","proposed_name","applicant_name","applicant_email","applicant_phone"],"properties":{"company_type":{"type":"string","enum":["sahis_isletme","sahis_serbest","sahis_bilanco","ltd","anonim"]},"proposed_name":{"type":"string"},"capital":{"type":"string"},"partners":{"type":"array"},"applicant_name":{"type":"string"},"applicant_email":{"type":"string"},"applicant_phone":{"type":"string"},"webhook_url":{"type":"string","description":"Stat\u00fc de\u011fi\u015fince POST at\u0131l\u0131r"}}}}}},"responses":{"201":{"description":"application_id, order_id, checkout_url, status; e-posta + webhook ile geri bildirim"}},"tags":["Kurulu\u015f"],"operationId":"postAgentFormation"}},"\/agent\/formation\/{id}":{"get":{"summary":"Tek ba\u015fvuru durumu","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"application_id, status, status_label, message (admin_note)"}},"tags":["Kurulu\u015f"],"operationId":"getAgentFormationId"}},"\/agent\/accounting\/categories":{"get":{"summary":"Gider kategorileri","description":"Fatura kayd\u0131nda category (key) se\u00e7imi i\u00e7in. record-invoice \u00e7a\u011fr\u0131lmadan \u00f6nce iste\u011fe ba\u011fl\u0131.","responses":{"200":{"description":"categories[] (key, name, parent_group)"}},"tags":["Muhasebe"],"operationId":"getAgentAccountingCategories"}},"\/agent\/accounting\/record-invoice":{"post":{"summary":"Faturay\u0131 muhasebeye kaydet","description":"Kullan\u0131c\u0131 \"bu faturay\u0131 muhasebeye kaydet\" dedi\u011finde: evrak (Document) + \u015firket defter tipine g\u00f6re fi\u015f olu\u015fturulur. \u0130\u015fletme\/Serbest: otomatik fi\u015f. Bilan\u00e7o: draft fi\u015f veya sadece evrak.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","type","invoice_date","amount"],"properties":{"company_id":{"type":"integer","description":"\u015eirket ID (GET companies)"},"type":{"type":"string","enum":["gelir","gider"]},"invoice_date":{"type":"string","format":"date","description":"Y-m-d"},"amount":{"type":"number","minimum":0.01},"supplier_name":{"type":"string"},"supplier_tax_id":{"type":"string"},"invoice_no":{"type":"string"},"category":{"type":"string","description":"GET accounting\/categories key"},"description":{"type":"string"},"create_booking":{"type":"boolean","default":true,"description":"Fi\u015f olu\u015fturulsun mu"},"matrah":{"type":"number","description":"Opsiyonel: vergi matrah\u0131"},"kdv_amount":{"type":"number","description":"Opsiyonel: KDV tutar\u0131"},"kdv_rate":{"type":"integer","description":"Opsiyonel: KDV oran\u0131 (0-100)"}}}}}},"responses":{"201":{"description":"document_id, transaction_id?, booking_created, message, create_from_document_url? (bilan\u00e7o)"},"422":{"description":"Validasyon veya d\u00f6nem kapal\u0131 hatas\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordInvoice"}},"\/agent\/accounting\/record-invoice-draft":{"post":{"summary":"Fatura tasla\u011f\u0131 olu\u015ftur","description":"Kullan\u0131c\u0131 onay\u0131 almadan \u00f6nce taslak olu\u015fturur. Yan\u0131tta draft_summary ve confirm_url d\u00f6ner; kullan\u0131c\u0131 onaylad\u0131ktan sonra POST confirm-draft\/{id} ile kesinle\u015ftirin.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","type","invoice_date","amount"],"properties":{"company_id":{"type":"integer"},"type":{"type":"string","enum":["gelir","gider"]},"invoice_date":{"type":"string","format":"date"},"amount":{"type":"number","minimum":0.01},"supplier_name":{"type":"string"},"supplier_tax_id":{"type":"string"},"invoice_no":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"matrah":{"type":"number"},"kdv_amount":{"type":"number"},"kdv_rate":{"type":"integer"}}}}}},"responses":{"201":{"description":"document_id, draft_summary, message, confirm_url, transaction_id? (bilan\u00e7o)"},"422":{"description":"Validasyon veya d\u00f6nem kapal\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordInvoiceDraft"}},"\/agent\/accounting\/confirm-draft\/{id}":{"post":{"summary":"Tasla\u011f\u0131 kesinle\u015ftir","description":"record-invoice-draft ile olu\u015fturulan taslak evrak\u0131 kullan\u0131c\u0131 onay\u0131 sonras\u0131 kesinle\u015ftirir. Bilan\u00e7o: fi\u015f posted olur; i\u015fletme\/serbest: fi\u015f olu\u015fturulur.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","description":"document_id"}}],"responses":{"200":{"description":"document_id, status: completed, message"},"404":{"description":"Evrak bulunamad\u0131 veya yetkisiz"},"422":{"description":"Taslak de\u011fil veya zaten kesinle\u015ftirilmi\u015f"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingConfirmDraftId"}},"\/agent\/reports\/trial-balance":{"get":{"summary":"Mizan","description":"Bilan\u00e7o defteri tutan \u015firketler i\u00e7in mizan. Ajan: \"mizan\u0131m\u0131 getir\" veya \"Haziran mizan\u0131\" gibi sorularda company_id, year, month ile \u00e7a\u011fr\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"supported, rows (account_code, account_name, total_debit, total_credit, balance), totals; supported=false ise message"}},"tags":["Raporlar"],"operationId":"getAgentReportsTrialBalance"}},"\/agent\/reports\/income-statement":{"get":{"summary":"Gelir tablosu \/ K\u00e2r-zarar","description":"Bilan\u00e7o \u015firketleri i\u00e7in y\u0131ll\u0131k gelir-gider ve net k\u00e2r. \"Haziran ay\u0131 k\u00e2r durumum\" i\u00e7in summary raporu kullan\u0131labilir.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"supported, income[], expense[], total_income, total_expense, net_profit"}},"tags":["Raporlar"],"operationId":"getAgentReportsIncomeStatement"}},"\/agent\/reports\/vat":{"get":{"summary":"KDV \u00f6zeti","description":"Evrak bazl\u0131 KDV \u00f6zeti (gelir\/gider matrah ve vergi). T\u00fcm \u015firket tipleri.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"summary (gelir\/gider base,tax), by_rate, document_count"}},"tags":["Raporlar"],"operationId":"getAgentReportsVat"}},"\/agent\/reports\/summary":{"get":{"summary":"Y\u0131ll\u0131k \u00f6zet (ayl\u0131k gelir\/gider\/net)","description":"T\u00fcm \u015firket tipleri i\u00e7in ayl\u0131k gelir, gider ve net. \"Y\u0131ll\u0131k k\u00e2r\u0131m\", \"Haziran ay\u0131 durumu\" gibi sorularda kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"monthly[] (month, income, expense, net), total_income, total_expense, total_net"}},"tags":["Raporlar"],"operationId":"getAgentReportsSummary"}},"\/agent\/reports\/documents":{"get":{"summary":"Evrak listesi","description":"Tarih aral\u0131\u011f\u0131 ve tip filtresi ile evrak listesi. T\u00fcm \u015firket tipleri.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Ba\u015flang\u0131\u00e7 tarihi (Y-m-d)"},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Biti\u015f tarihi (Y-m-d)"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["gelir","gider"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","pending","completed"]}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"documents[], total, per_page, current_page, last_page"}},"tags":["Raporlar"],"operationId":"getAgentReportsDocuments"}},"\/agent\/accounting\/propose-delete\/{id}":{"post":{"summary":"Silme teklifi","description":"Evrak \u00f6zetini ve onay ifadesini (confirm_phrase) d\u00f6ner; hen\u00fcz silmez. Asistan bu yan\u0131t\u0131 kullan\u0131c\u0131ya g\u00f6sterir.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Evrak ID"}],"responses":{"200":{"description":"document_id, summary, warning, confirm_phrase, confirm_url"},"422":{"description":"D\u00f6nem kapal\u0131 veya evrak bulunamad\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingProposeDeleteId"}},"\/agent\/accounting\/confirm-delete\/{id}":{"post":{"summary":"Silmeyi kesinle\u015ftir","description":"propose-delete'den d\u00f6nen confirm_phrase, body'deki confirmation alan\u0131na yaz\u0131l\u0131r. E\u015fle\u015firse evrak ve ba\u011fl\u0131 draft kay\u0131tlar\u0131 silinir.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Evrak ID"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["confirmation"],"properties":{"confirmation":{"type":"string","example":"S\u0130L-42","description":"propose-delete'den d\u00f6nen confirm_phrase"}}}}}},"responses":{"200":{"description":"document_id, status=deleted, message"},"422":{"description":"Onay ifadesi hatal\u0131 veya d\u00f6nem kapal\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingConfirmDeleteId"}},"\/agent\/lookup\/caris":{"get":{"summary":"Cari listesi","description":"M\u00fc\u015fteri ve\/veya tedarik\u00e7i listesi. Fatura\/dekont kayd\u0131nda cari se\u00e7imi i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["customer","supplier","both"]},"description":"Filtreleme: m\u00fc\u015fteri \/ tedarik\u00e7i \/ her ikisi"},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Ad, kod veya vergi numaras\u0131yla arama"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500}},{"name":"has_balance","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: yaln\u0131zca bakiyesi s\u0131f\u0131r olmayan cariler"}],"responses":{"200":{"description":"caris[], total, per_page, current_page, last_page \u2014 Her kay\u0131t: id, code, name, type, tax_id, balance, currency, account_code"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupCaris"},"post":{"summary":"Yeni cari olu\u015ftur","description":"Cari hesap kart\u0131 olu\u015fturur (web formlar\u0131 ile uyumlu kurallar).","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","name","type"],"properties":{"company_id":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["customer","supplier","both"]},"category":{"type":"string","enum":["individual","company"]},"group":{"type":"string"},"tax_id":{"type":"string"},"tax_office":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string","format":"email"},"address":{"type":"string"},"city":{"type":"string"},"currency":{"type":"string"},"account_code":{"type":"string"},"opening_balance":{"type":"number"}}}}}},"responses":{"201":{"description":"cari_id, code, name, type, balance, message"},"422":{"description":"Validasyon hatas\u0131"}},"tags":["Arama ve listeler"],"operationId":"postAgentLookupCaris"}},"\/agent\/lookup\/caris\/{id}":{"get":{"summary":"Tek cari detay\u0131","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Cari alanlar\u0131"},"404":{"description":"Bulunamad\u0131"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupCarisId"}},"\/agent\/lookup\/bank-accounts":{"get":{"summary":"Banka hesaplar\u0131 listesi","description":"\u015eirkete tan\u0131ml\u0131 banka hesaplar\u0131. \u00d6deme\/tahsilat kayd\u0131nda banka se\u00e7imi i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"description":"Para birimi filtresi (\u00f6r. TRY, USD)"},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"bank_accounts[], total \u2014 Her kay\u0131t: id, bank_name, branch (\u015fube), iban, currency, balance, account_code, is_default"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupBankAccounts"}},"\/agent\/lookup\/cash-registers":{"get":{"summary":"Kasa listesi","description":"\u015eirkete tan\u0131ml\u0131 kasalar. Nakit \u00f6deme\/tahsilat kayd\u0131nda kasa se\u00e7imi i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"cash_registers[], total \u2014 Her kay\u0131t: id, name, currency, balance, account_code, is_default"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupCashRegisters"}},"\/agent\/lookup\/items":{"get":{"summary":"Stok kart\u0131 \/ \u00fcr\u00fcn-hizmet listesi","description":"Tan\u0131ml\u0131 stok kartlar\u0131 ve hizmet kalemleri. Fatura sat\u0131r kalemleri i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["product","service","raw_material"]}},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Ad, kod veya barkodla arama"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"items[], total \u2014 Her kay\u0131t: id, code, name, type, unit, purchase_price, sale_price, tax_rate, quantity"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupItems"},"post":{"summary":"Yeni stok \/ hizmet kart\u0131","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","name","type"],"properties":{"company_id":{"type":"integer"},"name":{"type":"string"},"type":{"type":"string","enum":["product","service","raw_material"]},"code":{"type":"string"},"category":{"type":"string"},"unit":{"type":"string"},"purchase_price":{"type":"number","minimum":0},"sale_price":{"type":"number","minimum":0},"tax_rate":{"type":"number","minimum":0,"maximum":100},"quantity":{"type":"number","minimum":0},"description":{"type":"string"},"currency":{"type":"string"},"is_stock_item":{"type":"boolean"},"is_sales_item":{"type":"boolean"},"is_purchase_item":{"type":"boolean"}}}}}},"responses":{"201":{"description":"item_id, code, name, type, quantity, message"},"422":{"description":"Validasyon hatas\u0131"}},"tags":["Arama ve listeler"],"operationId":"postAgentLookupItems"}},"\/agent\/lookup\/chart-of-accounts":{"get":{"summary":"Hesap plan\u0131 (bilan\u00e7o \u015firketleri)","description":"Tek d\u00fczen hesap plan\u0131. Bilan\u00e7o defteri tutan \u015firketlerde muhasebe kayd\u0131 i\u00e7in hesap kodu se\u00e7iminde kullan\u0131l\u0131r.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"account_type","in":"query","required":false,"schema":{"type":"string"},"description":"Hesap tipi filtresi"},{"name":"root_type","in":"query","required":false,"schema":{"type":"string"},"description":"K\u00f6k tip (Asset, Liability, Income, Expense, Equity)"},{"name":"is_group","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: grup hesaplar, false\/varsay\u0131lan: detay hesaplar"},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"accounts[], total \u2014 Her kay\u0131t: id, code, name, account_type, root_type, is_group, level"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupChartOfAccounts"}},"\/agent\/lookup\/vkn-info":{"get":{"summary":"VKN \/ TCKN Sorgulama","description":"Verilen Vergi Kimlik Numaras\u0131 (VKN) veya T.C. Kimlik Numaras\u0131 (TCKN) i\u00e7in m\u00fckellef unvan\u0131, vergi dairesi ve e-Fatura m\u00fckellefiyet durumunu d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"vkn","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Unvan, vergi dairesi, e-fatura durumu"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupVknInfo"}},"\/agent\/accounting\/document\/{id}":{"get":{"summary":"Tek evrak detay\u0131","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Evrak alanlar\u0131"},"404":{"description":"Bulunamad\u0131"}},"tags":["Muhasebe"],"operationId":"getAgentAccountingDocumentId"},"patch":{"summary":"Evrak g\u00fcncelle (draft\/pending)","description":"Yaln\u0131zca draft veya pending stat\u00fcs\u00fcndeki evraklar g\u00fcncellenebilir. completed evraklar reddedilir.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Evrak ID"}],"requestBody":{"required":false,"content":{"application\/json":{"schema":{"type":"object","properties":{"invoice_date":{"type":"string","format":"date"},"amount":{"type":"number"},"supplier_name":{"type":"string"},"supplier_tax_id":{"type":"string"},"invoice_no":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"matrah":{"type":"number"},"kdv_amount":{"type":"number"},"kdv_rate":{"type":"integer"}}}}}},"responses":{"200":{"description":"document_id, status, updated_fields, message, summary"},"422":{"description":"Kesinle\u015fmi\u015f evrak veya d\u00f6nem kapal\u0131"}},"tags":["Muhasebe"],"operationId":"patchAgentAccountingDocumentId"}},"\/agent\/accounting\/document\/{id}\/formalize":{"post":{"summary":"Tasla\u011f\u0131 resmile\u015ftir (e-Fatura g\u00f6nder)","description":"Mevcut bir taslak faturay\u0131 e-Fatura\/e-Ar\u015fiv olarak resmile\u015ftirir ve G\u0130B kuyru\u011funa iletir.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id"],"properties":{"company_id":{"type":"integer"}}}}}},"responses":{"200":{"description":"Resmile\u015ftirildi (ettn, status)"},"403":{"description":"Yetkisiz eri\u015fim"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingDocumentIdFormalize"}},"\/agent\/accounting\/inbox":{"get":{"summary":"Gelen e-Faturalar (Inbox)","description":"\u015eirkete gelen e-Faturalar\u0131 listeler.","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Gelen e-Faturalar\u0131n listesi"}},"tags":["Muhasebe"],"operationId":"getAgentAccountingInbox"}},"\/agent\/accounting\/inbox\/{id}\/respond":{"post":{"summary":"Gelen e-Faturaya yan\u0131t (Kabul\/Ret)","description":"Gelen bir ticari faturay\u0131 kabul eder veya reddeder.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","action"],"properties":{"company_id":{"type":"integer"},"action":{"type":"string","enum":["accept","reject"]},"reason":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Yan\u0131t iletildi"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingInboxIdRespond"}},"\/agent\/accounting\/record-collection":{"post":{"summary":"Tahsilat kayd\u0131","description":"Cari tahsilat\u0131; banka i\u00e7in Transaction, nakit+kasa i\u00e7in CashTransaction; yan\u0131tta document_id, direction. Ayn\u0131 idempotency_key ile tekrar: 200 ve idempotent_replay.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":191},"description":"Body'deki idempotency_key ile ayn\u0131 i\u015flev; biri yeterli"}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","cari_id","amount","collection_date","payment_method"],"properties":{"company_id":{"type":"integer"},"cari_id":{"type":"integer"},"amount":{"type":"number","minimum":0.01},"collection_date":{"type":"string","format":"date"},"payment_method":{"type":"string","enum":["bank","cash","card","check"]},"bank_account_id":{"type":"integer"},"cash_register_id":{"type":"integer"},"document_id":{"type":"integer"},"description":{"type":"string","maxLength":1000},"invoice_no":{"type":"string","maxLength":255},"reference_no":{"type":"string","maxLength":255},"idempotency_key":{"type":"string","maxLength":191},"client_reference":{"type":"string","maxLength":191}}}}}},"responses":{"201":{"description":"document_id, direction, payment_id, cari balance vb."},"200":{"description":"Ayn\u0131 idempotency_key ile \u00f6nceki kay\u0131t (idempotent_replay)"},"422":{"description":"Validasyon veya d\u00f6nem kapal\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordCollection"}},"\/agent\/accounting\/record-payment":{"post":{"summary":"\u00d6deme kayd\u0131 (cariye giden)","description":"Tedarik\u00e7i\/cari \u00f6demesi. Idempotency: header veya body.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":191}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","cari_id","amount","payment_date","payment_method"],"properties":{"company_id":{"type":"integer"},"cari_id":{"type":"integer"},"amount":{"type":"number","minimum":0.01},"payment_date":{"type":"string","format":"date"},"payment_method":{"type":"string","enum":["bank","cash","card","check"]},"bank_account_id":{"type":"integer"},"cash_register_id":{"type":"integer"},"document_id":{"type":"integer"},"description":{"type":"string","maxLength":1000},"invoice_no":{"type":"string","maxLength":255},"reference_no":{"type":"string","maxLength":255},"idempotency_key":{"type":"string","maxLength":191},"client_reference":{"type":"string","maxLength":191}}}}}},"responses":{"201":{"description":"document_id, direction, payment_id vb."},"200":{"description":"Idempotent tekrar"},"422":{"description":"Validasyon veya d\u00f6nem kapal\u0131"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordPayment"}},"\/agent\/accounting\/record-cash-transaction":{"post":{"summary":"Kasa giri\u015f\/\u00e7\u0131k\u0131\u015f","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","cash_register_id","type","amount","transaction_date"],"properties":{"company_id":{"type":"integer"},"cash_register_id":{"type":"integer"},"type":{"type":"string","enum":["in","out"]},"amount":{"type":"number","minimum":0.01},"transaction_date":{"type":"string","format":"date"},"description":{"type":"string","maxLength":1000},"bank_account_id":{"type":"integer"},"cari_id":{"type":"integer"},"reference_no":{"type":"string","maxLength":100}}}}}},"responses":{"201":{"description":"Kasa hareketi olu\u015fturuldu"},"422":{"description":"Validasyon"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordCashTransaction"}},"\/agent\/accounting\/record-bank-transfer":{"post":{"summary":"Banka virman\u0131","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","from_bank_account_id","to_bank_account_id","amount","transfer_date"],"properties":{"company_id":{"type":"integer"},"from_bank_account_id":{"type":"integer"},"to_bank_account_id":{"type":"integer"},"amount":{"type":"number","minimum":0.01},"transfer_date":{"type":"string","format":"date"},"description":{"type":"string","maxLength":500},"fee":{"type":"number","minimum":0}}}}}},"responses":{"201":{"description":"Virman olu\u015fturuldu"},"422":{"description":"Validasyon"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordBankTransfer"}},"\/agent\/accounting\/record-stock-movement":{"post":{"summary":"Stok hareketi","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["company_id","item_id","type","quantity","movement_date"],"properties":{"company_id":{"type":"integer"},"item_id":{"type":"integer"},"type":{"type":"string","enum":["in","out"]},"quantity":{"type":"number","minimum":0.0001},"movement_date":{"type":"string","format":"date"},"unit_price":{"type":"number","minimum":0},"description":{"type":"string","maxLength":500},"document_id":{"type":"integer"}}}}}},"responses":{"201":{"description":"Hareket olu\u015fturuldu"},"422":{"description":"Validasyon"}},"tags":["Muhasebe"],"operationId":"postAgentAccountingRecordStockMovement"}},"\/agent\/lookup\/cari-statement":{"get":{"summary":"Cari ekstre","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"cari_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"transactions[] (sat\u0131rlarda document_id olabilir), sayfalama"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupCariStatement"}},"\/agent\/lookup\/bank-statement":{"get":{"summary":"Banka ekstre","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"bank_account_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"transactions[]"},"404":{"description":"Banka hesab\u0131 yok"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupBankStatement"}},"\/agent\/lookup\/cash-statement":{"get":{"summary":"Kasa ekstre","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"cash_register_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"transactions[]"},"404":{"description":"Kasa yok"}},"tags":["Arama ve listeler"],"operationId":"getAgentLookupCashStatement"}},"\/agent\/reports\/aged-receivables":{"get":{"summary":"Ya\u015fland\u0131r\u0131lm\u0131\u015f alacaklar","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"as_of_date","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"summary, by_cari"}},"tags":["Raporlar"],"operationId":"getAgentReportsAgedReceivables"}},"\/agent\/reports\/aged-payables":{"get":{"summary":"Ya\u015fland\u0131r\u0131lm\u0131\u015f bor\u00e7lar","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"as_of_date","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"summary, by_cari"}},"tags":["Raporlar"],"operationId":"getAgentReportsAgedPayables"}},"\/agent\/reports\/balance-sheet":{"get":{"summary":"Bilan\u00e7o \u00f6zeti","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":2020,"maximum":2100}},{"name":"month","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":12}}],"responses":{"200":{"description":"assets, liabilities"}},"tags":["Raporlar"],"operationId":"getAgentReportsBalanceSheet"}},"\/agent\/reports\/cash-flow":{"get":{"summary":"Nakit ak\u0131\u015f \u00f6zeti","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":2020,"maximum":2100}},{"name":"month","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":12}}],"responses":{"200":{"description":"operating, closing_balance vb."}},"tags":["Raporlar"],"operationId":"getAgentReportsCashFlow"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"POST \/auth\/login yan\u0131t\u0131ndaki token veya profil sayfas\u0131ndan olu\u015fturulan API token"}}},"tags":[{"name":"Kimlik","description":"Bearer token: POST \/auth\/login veya m\u00fc\u015fteri profilinden API token."},{"name":"\u015eirket ve \u00fcr\u00fcn","description":"\u015eirket listesi ve \u00fcr\u00fcn\/kont\u00f6r hizmet bilgisi."},{"name":"Sipari\u015f","description":"Sipari\u015f olu\u015fturma ve durum sorgulama."},{"name":"Kurulu\u015f","description":"\u015eirket kurulu\u015f ba\u015fvurular\u0131."},{"name":"Muhasebe","description":"Fatura, tahsilat\/\u00f6deme, kasa\/banka, stok, evrak."},{"name":"Raporlar","description":"Mizan, gelir tablosu, KDV, ya\u015fland\u0131rma, bilan\u00e7o vb."},{"name":"Arama ve listeler","description":"Cari, banka, kasa, stok, hesap plan\u0131, ekstreler."}]}