SolaCount Finans API
SolaCount Finance API, muhasebe verilerini program aracılığıyla okumanızı ve yazmanızı sağlar: müşteriler, tedarikçiler, müşteriye kesilen faturalar, tedarikçi faturaları, ödemeler, yevmiye kayıtları ve finansal raporlar. Tüm uç noktalar JSON döndürür. API anahtarı oluştur →
Kimlik doğrulama
Korumalı her uç nokta üç başlık gerektirir:
X-API-Key: solabooks_<prefix>.<secret> X-Organization-Id: 1 X-Client-Id: 4
- X-API-Key — oluşturulurken bir kez gösterilen tam anahtar; Ayarlar → API Erişimi bölümünde
- X-Organization-Id — kuruluşunuzun tam sayı kimliği (API Erişimi sayfasında görünür).
- X-Client-Id — istemci kimliğiniz (API Erişimi sayfasında görünür)
GET /api/v1/health uç noktası kimlik doğrulama gerektirmez; bağlantıyı doğrulamak için kullanılabilir.
Yanıt Biçimi
Tüm yanıtlar tutarlı bir JSON zarfı kullanır.
Tek nesne
{
"success": true,
"data": { ... }
}
Sayfalanmış liste
{
"success": true,
"data": [ ... ],
"meta": {
"current_page": 1,
"per_page": 25,
"total": 100,
"last_page": 4
}
}
Hata
{
"success": false,
"error": {
"code": "error_code",
"message": "Human readable message."
}
}
Hızlı test
your_key, 1 ve 4 yerine gerçek API anahtarınızı, kuruluş kimliğinizi ve istemci kimliğinizi yazın.
Sağlık kontrolü (kimlik doğrulama gerekmez)
curl https://solacount.com/api/v1/health
Faturaları listele
curl https://solacount.com/api/v1/invoices \ -H "X-API-Key: your_key" \ -H "X-Organization-Id: 1" \ -H "X-Client-Id: 4"
Müşteri oluşturma
curl -X POST https://solacount.com/api/v1/customers \
-H "X-API-Key: your_key" \
-H "X-Organization-Id: 1" \
-H "X-Client-Id: 4" \
-H "Content-Type: application/json" \
-d '{"name":"Demo Customer","email":"billing@example.com"}'
Yevmiye kaydı oluşturun
curl -X POST https://solacount.com/api/v1/journal-entries \
-H "X-API-Key: your_key" \
-H "X-Organization-Id: 1" \
-H "X-Client-Id: 4" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-06-07",
"reference": "JE-001",
"description": "Manual accrual",
"lines": [
{"account_id": 101, "debit": 1000, "credit": 0},
{"account_id": 202, "debit": 0, "credit": 1000}
]
}'
Tüm uç noktalar
Ayrıntılarını genişletmek için uç noktaya tıklayın. 8 kaynak grubunda toplam 33 uç nokta bulunur.
Sağlık
/api/v1/health
kimlik doğrulama yok
API'nin çevrimiçi olduğunu ve yanıt verdiğini onaylayın. Kimlik doğrulaması gerekmez.
Yanıt HTTP 200
{"success":true,"data":{"service":"finance-api","status":"ok","timestamp":"2026-06-07T12:00:00+00:00"}}
Müşteriler
/api/v1/customers
kapsam: customers.get
Tüm müşterileri listeler. Arama ve sayfalamayı destekler.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
search |
string |
isteğe bağlı | Ada, e-postaya veya telefona göre filtrele (kısmi eşleşme) |
page |
integer |
isteğe bağlı | Sayfa numarası (varsayılan: 1) |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (varsayılan: 25, en fazla: 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":1,"name":"Demo Customer","email":"billing@example.com","phone":"+1-555-0100","is_active":true}],"meta":{"current_page":1,"per_page":25,"total":3,"last_page":1}}
/api/v1/customers/{id}
kapsam: customers.get
ID'ye göre tek bir müşteriyi getirin.
Yanıt HTTP 200
{"success":true,"data":{"id":1,"name":"Demo Customer","email":"billing@example.com","phone":"+1-555-0100","is_active":true}}
/api/v1/customers
kapsam: customers.post
Yeni bir müşteri oluşturun.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
name |
string |
zorunlu | Müşteri adı |
email |
string |
isteğe bağlı | E-posta adresi (geçerli bir e-posta olmalıdır) |
phone |
string |
isteğe bağlı | Telefon numarası (en fazla 50 karakter) |
is_active |
boolean |
isteğe bağlı | Aktif durum (varsayılan: true) |
Yanıt HTTP 201
{"success":true,"data":{"id":42,"name":"Demo Customer","email":"billing@example.com","phone":null,"is_active":true}}
Tedarikçiler
/api/v1/suppliers
kapsam: suppliers.get
Tüm tedarikçileri listeler. Arama ve sayfalamayı destekler.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
search |
string |
isteğe bağlı | Ada göre filtrele (kısmi eşleşme) |
page |
integer |
isteğe bağlı | Sayfa numarası |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (en fazla 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":1,"name":"Demo Supplier","email":"ap@example.com","tax_id":"GB123456789","is_vat_registered":true}],"meta":{"current_page":1,"per_page":25,"total":1,"last_page":1}}
/api/v1/suppliers/{id}
kapsam: suppliers.get
ID'ye göre tek bir tedarikçiyi getirin.
Yanıt HTTP 200
{"success":true,"data":{"id":1,"name":"Demo Supplier","email":"ap@example.com","phone":null,"tax_id":"GB123456789","is_overseas":false,"is_vat_registered":true,"reverse_charge":false}}
/api/v1/suppliers
kapsam: suppliers.post
Yeni bir tedarikçi oluşturun.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
name |
string |
zorunlu | Tedarikçi adı |
email |
string |
isteğe bağlı | E-posta adresi |
phone |
string |
isteğe bağlı | Telefon numarası |
tax_id |
string |
isteğe bağlı | KDV / vergi kayıt numarası |
is_overseas |
boolean |
isteğe bağlı | Tedarikçinin yurt dışında olup olmadığı (varsayılan: hayır) |
is_vat_registered |
boolean |
isteğe bağlı | KDV'ye kayıtlı (varsayılan: doğru) |
reverse_charge |
boolean |
isteğe bağlı | Ters ücret KDV'si uygulanır (varsayılan: false) |
Yanıt HTTP 201
{"success":true,"data":{"id":15,"name":"Demo Supplier","email":"ap@example.com","tax_id":"GB123456789","is_vat_registered":true}}
Faturalar
/api/v1/invoices
kapsam: invoices.get
Müşteri ilişkisiyle tüm faturaları listeler. Durum filtresini ve sayfalamayı destekler.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
status |
string |
isteğe bağlı | Filtre: draft | unpaid | paid | void | overdue
|
page |
integer |
isteğe bağlı | Sayfa numarası |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (en fazla 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":101,"number":"INV-00101","date":"2026-06-01","due_date":"2026-07-01","status":"unpaid","total":5000.00,"customer":{"id":1,"name":"Demo Customer"}}],"meta":{"current_page":1,"per_page":25,"total":48,"last_page":2}}
/api/v1/invoices/{id}
kapsam: invoices.get
Müşteri ve kalem satırlarıyla tek bir faturayı getirin.
Yanıt HTTP 200
{"success":true,"data":{"id":101,"number":"INV-00101","date":"2026-06-01","due_date":"2026-07-01","status":"unpaid","subtotal":4347.83,"tax_total":652.17,"total":5000.00,"customer":{"id":1,"name":"Demo Customer"},"lines":[{"id":1,"description":"Consulting services","qty":10,"unit_price":434.78,"total":4347.83}]}}
/api/v1/invoices
kapsam: invoices.post
Yeni bir fatura oluşturun. status=draft ile ve otomatik üretilen bir numarayla oluşturulur.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
customer_id |
integer |
zorunlu | Mevcut bir müşterinin kimliği |
date |
date |
zorunlu | Fatura tarihi (YYYY-AA-GG) |
due_date |
date |
isteğe bağlı | Ödeme vadesi (YYYY-AA-GG) |
notes |
string |
isteğe bağlı | Dahili veya müşteriye yönelik notlar |
subtotal |
decimal |
isteğe bağlı | Vergi öncesi toplam (varsayılan: 0) |
tax_total |
decimal |
isteğe bağlı | Vergi tutarı (varsayılan: 0) |
discount_total |
decimal |
isteğe bağlı | İndirim tutarı (varsayılan: 0) |
total |
decimal |
isteğe bağlı | Genel toplam (varsayılan: 0) |
Yanıt HTTP 201
{"success":true,"data":{"id":102,"number":"INV-00102","status":"draft","date":"2026-06-07","due_date":"2026-07-07","total":5000.00,"customer_id":1}}
/api/v1/invoices/{id}
kapsam: invoices.update
Mevcut bir taslak faturayı güncelleyin. Tüm alanlar isteğe bağlıdır.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
customer_id |
integer |
isteğe bağlı | Yeni müşteri kimliği |
date |
date |
isteğe bağlı | Fatura tarihi (YYYY-AA-GG) |
due_date |
date |
isteğe bağlı | Ödeme vadesi |
notes |
string |
isteğe bağlı | Notlar |
subtotal |
decimal |
isteğe bağlı | Vergi öncesi toplam |
tax_total |
decimal |
isteğe bağlı | Vergi tutarı |
total |
decimal |
isteğe bağlı | Genel toplam |
Yanıt HTTP 200
{"success":true,"data":{"id":102,"status":"draft","total":6000.00,"customer":{"id":1,"name":"Demo Customer"},"lines":[]}}
/api/v1/invoices/{id}/post
kapsam: invoices.post
Taslak faturayı büyük deftere kesinleştirir. Toplam > 0 ve tarih gerekir. Durumu ödenmedi olarak değiştirir.
Yanıt HTTP 200
{"success":true,"data":{"id":102,"status":"unpaid","posted_at":"2026-06-07T12:00:00Z","total":5000.00}}
Olası hatalar: invoice_already_posted, invoice_total_required, invoice_date_required
/api/v1/invoices/{id}/void
kapsam: invoices.void
Kaydedilmiş bir faturayı iptal et. Tüm defter kayıtlarını geri alır ve faturayı iptal edilmiş olarak işaretler.
Yanıt HTTP 200
{"success":true,"data":{"id":102,"status":"void"}}
/api/v1/invoices/{id}/mark-sent
kapsam: invoices.send
Taslak faturayı müşteriye gönderildi olarak işaretler (durumu taslaktan ödenmediye değiştirir). Tekrarlamak ek etki oluşturmaz.
Yanıt HTTP 200
{"success":true,"data":{"id":102,"status":"unpaid"}}
/api/v1/invoices/{id}
kapsam: invoices.delete
Taslak faturayı tüm satırlarıyla birlikte kalıcı olarak siler. Kesinleştirilmiş veya ödeme tahsisi bulunan faturalar silinemez.
Yanıt HTTP 200
{"success":true,"data":{"message":"Invoice deleted."}}
Olası hatalar:
posted_invoice_not_deletable,
invoice_has_allocations
Faturalar
/api/v1/bills
kapsam: bills.get
Tüm tedarikçi faturalarını listeler. Durum filtresi ve sayfalamayı destekler.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
status |
string |
isteğe bağlı | Filtre: draft | unpaid | paid | void
|
page |
integer |
isteğe bağlı | Sayfa numarası |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (en fazla 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":55,"number":"BILL-00055","date":"2026-06-01","status":"draft","total":2000.00,"supplier":{"id":3,"name":"Demo Supplier"}}],"meta":{"current_page":1,"per_page":25,"total":12,"last_page":1}}
/api/v1/bills/{id}
kapsam: bills.get
Tedarikçi ve kalem satırlarıyla tek bir faturayı getirin.
Yanıt HTTP 200
{"success":true,"data":{"id":55,"number":"BILL-00055","date":"2026-06-01","due_date":"2026-07-01","status":"draft","reference":"PO-001","total":2000.00,"supplier":{"id":3,"name":"Demo Supplier"},"lines":[]}}
/api/v1/bills
kapsam: bills.post
Yeni tedarikçi faturası oluşturur. status=draft ve otomatik oluşturulan BILL-XXXXX numarasıyla kaydedilir.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
supplier_id |
integer |
zorunlu | Mevcut bir tedarikçinin kimliği |
date |
date |
zorunlu | Fatura tarihi (YYYY-MM-DD) |
due_date |
date |
isteğe bağlı | Ödeme vadesi |
reference |
string |
isteğe bağlı | Tedarikçi referansı / sipariş numarası (en fazla 120) |
notes |
string |
isteğe bağlı | Dahili notlar |
subtotal |
decimal |
isteğe bağlı | Vergi öncesi toplam (varsayılan: 0) |
tax_total |
decimal |
isteğe bağlı | Vergi tutarı (varsayılan: 0) |
discount_total |
decimal |
isteğe bağlı | İndirim (varsayılan: 0) |
total |
decimal |
isteğe bağlı | Genel toplam (varsayılan: 0) |
Yanıt HTTP 201
{"success":true,"data":{"id":56,"number":"BILL-00056","status":"draft","date":"2026-06-07","total":2000.00,"supplier_id":3}}
/api/v1/bills/{id}
kapsam: bills.update
Mevcut bir taslak faturayı güncelleyin. Tüm alanlar isteğe bağlıdır.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
supplier_id |
integer |
isteğe bağlı | Yeni tedarikçi kimliği |
date |
date |
isteğe bağlı | Fatura tarihi |
due_date |
date |
isteğe bağlı | Ödeme vadesi |
reference |
string |
isteğe bağlı | Tedarikçi referansı |
total |
decimal |
isteğe bağlı | Genel toplam |
Yanıt HTTP 200
{"success":true,"data":{"id":56,"status":"draft","total":2500.00,"supplier":{"id":3,"name":"Demo Supplier"}}}
/api/v1/bills/{id}/post
kapsam: bills.post
Taslak faturayı genel deftere kaydedin ve ödenecek tutarı kaydedin.
Yanıt HTTP 200
{"success":true,"data":{"id":56,"status":"unpaid","posted_at":"2026-06-07T12:00:00Z"}}
Olası hatalar:
bill_post_failed
/api/v1/bills/{id}
kapsam: bills.delete
Taslak tedarikçi faturasını kalıcı olarak siler. Fatura taslak durumunda olmalı ve ödeme tahsisi bulunmamalıdır.
Yanıt HTTP 200
{"success":true,"data":{"message":"Bill deleted."}}
Olası hatalar:
posted_bill_not_deletable,
bill_has_allocations
Ödemeler
/api/v1/payments
kapsam: payments.get
Tüm ödemeleri listeler (tahsilatlar ve ödemeler).
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
type |
string |
isteğe bağlı | Filtre: receipt | disbursement
|
status |
string |
isteğe bağlı | Filtre: draft | posted
|
page |
integer |
isteğe bağlı | Sayfa numarası |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (en fazla 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":20,"type":"receipt","payment_date":"2026-06-07","amount_total":5000.00,"status":"draft","customer_id":1}],"meta":{"current_page":1,"per_page":25,"total":8,"last_page":1}}
/api/v1/payments
kapsam: payments.post
Tahsilat (müşteri ödedi) veya ödeme (siz tedarikçiye ödediniz) kaydedin. İsteğe bağlı olarak satış veya alış faturasına dağıtın.
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
type |
string |
zorunlu | receipt (müşteri ödemesi) veya disbursement (tedarikçi ödemesi)
|
payment_date |
date |
zorunlu | Ödeme tarihi (YYYY-AA-GG) |
amount_total |
decimal |
zorunlu | Ödenen toplam tutar (0'dan büyük olmalı) |
method |
string |
isteğe bağlı | Ödeme yöntemi, ör. bank_transfer, cash, card |
reference |
string |
isteğe bağlı | Banka referansı veya çek numarası (en fazla 120) |
description |
string |
isteğe bağlı | Açıklama veya not |
customer_id |
integer |
koşul | Tahsilat ödemelerinde zorunlu (document_type=ar_invoice ise faturadan çıkarılır). |
supplier_id |
integer |
koşul | Ödeme çıkışlarında zorunlu (document_type=ap_bill ise tedarikçi faturasından çıkarılır). |
document_type |
string |
isteğe bağlı | "ar_invoice" veya "ap_bill" — otomatik tahsisi tetikler |
document_id |
integer |
isteğe bağlı | Tahsis edilecek satış veya tedarikçi faturasının kimliği (document_type ayarlandığında zorunlu). |
allocated_amount |
decimal |
isteğe bağlı | Dağıtılacak tutar (varsayılan amount_total) |
Yanıt HTTP 201
{"success":true,"data":{"id":21,"type":"receipt","payment_date":"2026-06-07","amount_total":5000.00,"status":"draft","allocations":[{"document_type":"ar_invoice","document_id":101,"allocated_amount":5000.00}]}}
Olası hatalar: document_required, document_type_mismatch, invoice_not_found, bill_not_found, client_required, supplier_required
Yevmiye Kayıtları
/api/v1/journal-entries
kapsam: journal_entries.get
Satırları ve hesapları olan yevmiye kayıtlarını listeler. Tarih aralığı filtrelemeyi destekler.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
status |
string |
isteğe bağlı | Filtre: draft | posted
|
from |
date |
isteğe bağlı | Başlangıç tarihi (YYYY-AA-GG) |
to |
date |
isteğe bağlı | Bitiş tarihi (YYYY-AA-GG) |
page |
integer |
isteğe bağlı | Sayfa numarası |
per_page |
integer |
isteğe bağlı | Sayfa başına sonuç (en fazla 100) |
Yanıt HTTP 200
{"success":true,"data":[{"id":5,"entry_date":"2026-06-07","reference":"JE-001","status":"posted","lines_count":2}],"meta":{"current_page":1,"per_page":25,"total":5,"last_page":1}}
/api/v1/journal-entries
kapsam: journal_entries.post
Dengeli yevmiye kaydı oluşturup hemen kesinleştirir. Toplam borç toplam alacağa eşit olmalıdır (tolerans ±0,01).
İstek gövdesi (JSON)
| Alan | Tür | Açıklama | |
|---|---|---|---|
date |
date |
zorunlu | Giriş tarihi (YYYY-AA-GG) |
reference |
string |
isteğe bağlı | Referans kodu, örn. JE-001 (en fazla 120) |
description |
string |
isteğe bağlı | Not / açıklama (en fazla 2000) |
lines |
array |
zorunlu | En az 2 satır. Her satır: account_id (zorunlu), debit (ondalık), credit (ondalık), description (metin). |
Yanıt HTTP 201
{"success":true,"data":{"id":6,"entry_date":"2026-06-07","reference":"JE-001","status":"posted","posted_at":"2026-06-07T12:00:00Z","lines":[{"account_id":101,"account":{"code":"1100","name":"Cash"},"debit":1000,"credit":0},{"account_id":202,"account":{"code":"3000","name":"Equity"},"debit":0,"credit":1000}]}}
Olası hatalar:
journal_not_balanced
/api/v1/journal-entries/{id}
kapsam: journal_entries.delete
Kesinleştirilmemiş yevmiye kaydını siler. Kesinleştirilmiş kayıtlar API üzerinden silinemez.
Yanıt HTTP 200
{"success":true,"data":{"message":"Journal entry deleted."}}
Olası hatalar:
posted_journal_not_deletable
Raporlar
Tüm rapor uç noktaları ?from=YYYY-MM-DD&to=YYYY-MM-DD kabul eder. Bilanço, mizan ve yaşlandırma raporları ayrıca ?as_of=YYYY-MM-DD kabul eder (to ile eşdeğerdir).
/api/v1/reports/income-statement
kapsam: reports.income_statement
Kâr ve zarar raporu. Belirtilen dönemin gelirini, giderlerini ve net kârını döndürür.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
from |
date |
isteğe bağlı | Dönem başlangıcı (YYYY-AA-GG) |
to |
date |
isteğe bağlı | Dönem sonu (YYYY-AA-GG) |
Yanıt HTTP 200
{"success":true,"data":{"revenue":150000,"expenses":85000,"net_income":65000}}
/api/v1/reports/balance-sheet
kapsam: reports.balance_sheet
Bilanço özeti. Belirtilen tarih itibarıyla varlıkları, yükümlülükleri ve özkaynakları döndürür.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
to |
date |
isteğe bağlı | Geçerlilik tarihi (YYYY-AA-GG). ?as_of= olarak da kabul edilir |
Yanıt HTTP 200
{"success":true,"data":{"assets":{"total":250000},"liabilities":{"total":80000},"equity":{"total":170000}}}
/api/v1/reports/cash-flow
kapsam: reports.cash_flow
Belirtilen dönem için nakit akış tablosu (doğrudan yöntem).
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
from |
date |
isteğe bağlı | Dönem başlangıcı |
to |
date |
isteğe bağlı | Dönem sonu |
Yanıt HTTP 200
{"success":true,"data":{"operating":45000,"investing":-12000,"financing":-8000,"net_change":25000}}
/api/v1/reports/trial-balance
kapsam: reports.trial_balance
Belirli bir tarihteki tüm hesapların borç ve alacak toplamlarını gösteren mizan.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
to |
date |
isteğe bağlı | Geçerlilik tarihi (YYYY-AA-GG) |
Yanıt HTTP 200
{"success":true,"data":[{"account_code":"1100","account_name":"Cash","debit":50000,"credit":0},{"account_code":"2000","account_name":"Accounts Payable","debit":0,"credit":15000}]}
/api/v1/reports/ar-aging
kapsam: reports.ar_aging
Ticari alacak yaşlandırması. Ödenmemiş müşteri faturaları gecikme sürelerine göre aralıklara ayrılır.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
to |
date |
isteğe bağlı | Yaşlandırma tarihi (YYYY-AA-GG) |
Yanıt HTTP 200
{"success":true,"data":{"current":12000,"1_30":3500,"31_60":800,"61_90":0,"over_90":500,"total":16800}}
/api/v1/reports/ap-aging
kapsam: reports.ap_aging
Ticari borç yaşlandırması. Ödenmemiş tedarikçi faturaları gecikme sürelerine göre aralıklara ayrılır.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
to |
date |
isteğe bağlı | Yaşlandırma tarihi (YYYY-AA-GG) |
Yanıt HTTP 200
{"success":true,"data":{"current":8000,"1_30":1200,"31_60":0,"61_90":0,"over_90":0,"total":9200}}
/api/v1/reports/tax
kapsam: reports.tax
KDV / vergi özeti. Dönemde satışlarda tahsil edilen ve satın almalarda ödenen vergiyi döndürür.
Sorgu parametreleri
| Parametre | Tür | Açıklama | |
|---|---|---|---|
from |
date |
isteğe bağlı | Dönem başlangıcı |
to |
date |
isteğe bağlı | Dönem sonu |
Yanıt HTTP 200
{"success":true,"data":{"tax_collected":15000,"tax_paid":4200,"net_vat_payable":10800}}
Hata Referansı
| Hata Kodu | HTTP | Anlamı |
|---|---|---|
invoice_already_posted |
422 | Fatura zaten deftere kaydedildi |
invoice_total_required |
422 | Toplamı sıfır veya negatif olan bir fatura kaydedilemez |
invoice_date_required |
422 | Kaydetmeden önce belge tarihi gereklidir |
posted_invoice_not_deletable |
422 | Silmeden önce faturayı iptal edin veya kaydını kaldırın |
invoice_has_allocations |
422 | Silmeden önce ödeme tahsisatlarını kaldırın |
posted_bill_not_deletable |
422 | Kaydedilmiş veya taslak olmayan bir fatura silinemez |
bill_has_allocations |
422 | Silmeden önce ödeme tahsisatlarını kaldırın |
bill_post_failed |
422 | Fatura dahili kayıt doğrulamasında başarısız oldu |
journal_not_balanced |
422 | Toplam borçlar toplam alacaklara eşit değil |
posted_journal_not_deletable |
422 | Yalnızca taslak (kaydedilmemiş) girişler silinebilir |
document_required |
422 | document_type ayarlandığında document_id zorunludur
|
document_type_mismatch |
422 | ar_invoice, receipt gerektirir; ap_bill, disbursement gerektirir
|
invoice_not_found |
404 | Bu kimliğe sahip fatura mevcut değil |
bill_not_found |
404 | Bu kimliğe sahip fatura mevcut değil |
client_required |
422 | customer_id, receipt ödemeleri için zorunludur
|
supplier_required |
422 | supplier_id, disbursement ödemeleri için zorunludur
|
Sayfalama
Tüm liste uç noktaları sayfalanmış sonuç döndürür. Sorgu parametreleriyle sayfalamayı kontrol edin:
| Parametre | Varsayılan | En fazla | Açıklama |
|---|---|---|---|
page | 1 | — | Alınacak sayfa numarası |
per_page | 25 | 100 | Sayfa başına sonuç sayısı |
Her liste yanıtındaki meta nesnesi current_page, per_page, total ve last_page içerir.