currencies modülü para birimlerini, dönüştürme ve merkez bankası eşitlemesiyle döviz kurlarını ve ödeme koşullarını sunar. Para birimi yönlendiricisi src/cluster_erp/server/routes/currencies.py içindedir ve bu modül tarafından bağlanır. 20 uç noktanın tamamı /api/v1/currencies altındadır. İş anlamı için Currencies modülü sayfasına bakın.
Grup olguları¶
| Öğe | Değer | Kaynak |
|---|---|---|
| Temel yol | /api/v1/currencies |
src/cluster_erp/core/module_base.py:37-38, src/cluster_erp/modules/currencies/module.py:78 |
| Yönlendiriciler | 3 dosyada 3 yönlendirici nesnesi; Uç nokta özeti bölümünde listelenir | src/cluster_erp/modules/currencies/module.py:64 |
| Uç noktalar | 20; register_routes ile bağlanan yönlendiricilerin yol dekoratörleri ve add_api_route çağrılarından sayıldı |
src/cluster_erp/modules/currencies/exchange_rates/routes.py, src/cluster_erp/modules/currencies/payment_terms/routes.py, src/cluster_erp/server/routes/currencies.py |
| Kimlik doğrulama | Bearer başlığı veya oturum çerezi, get_current_user ile çözülür; bkz. Kimlik doğrulama ve başlıklar |
src/cluster_erp/modules/auth/guards.py:85-167 |
| Yetki koruması | 20 yolun 20 tanesi require_permission bildirir |
src/cluster_erp/modules/auth/guards.py:205-240 |
| Uygulama yetkilendirme kapısı | bağlanan her yönlendiricide require_app("currencies") |
src/cluster_erp/modules/currencies/module.py:82 |
| Hata biçimi | JSON gövdesi {"error": {...}}; bkz. Hatalar |
src/cluster_erp/server/error_handler.py:33-46 |
Uç nokta özeti¶
Alt modül klasörü başına bir satır. Yönlendirici öneki temel yola eklenir.
| Alt modül | Yönlendiriciler | Uç noktalar | Yönlendirici kaynağı |
|---|---|---|---|
currencies |
router |
7 | src/cluster_erp/server/routes/currencies.py:18 |
exchange_rates |
router (/exchange-rates) |
8 | src/cluster_erp/modules/currencies/exchange_rates/routes.py:29 |
payment_terms |
router (/payment-terms) |
5 | src/cluster_erp/modules/currencies/payment_terms/routes.py:21 |
Para birimleri uç noktaları¶
Para birimi kayıtları, internetten güncelleme ve tohumlama eylemi. Yönlendiricinin öneki yoktur; yolları doğrudan modül temel yolunun altındadır.
| Yöntem | Yol | İşleyici | Yetki | İstek | Sorgu | Yanıt | Durum | Kaynak |
|---|---|---|---|---|---|---|---|---|
GET |
/api/v1/currencies/ |
list_currencies |
currency.read |
yok | active_only, search |
list[CurrencyRead] |
200 (varsayılan) | src/cluster_erp/server/routes/currencies.py:21 |
POST |
/api/v1/currencies/update-from-internet |
update_currencies_from_internet |
currency.create |
yok | yok | dict |
200 (varsayılan) | src/cluster_erp/server/routes/currencies.py:33 |
POST |
/api/v1/currencies/ |
create_currency |
currency.create |
CurrencyCreate |
yok | CurrencyRead |
201 |
src/cluster_erp/server/routes/currencies.py:43 |
GET |
/api/v1/currencies/{currency_id} |
get_currency |
currency.read |
yok | yok | CurrencyRead |
200 (varsayılan) | src/cluster_erp/server/routes/currencies.py:54 |
PUT |
/api/v1/currencies/{currency_id} |
update_currency |
currency.update |
CurrencyUpdate |
yok | CurrencyRead |
200 (varsayılan) | src/cluster_erp/server/routes/currencies.py:67 |
DELETE |
/api/v1/currencies/{currency_id} |
delete_currency |
currency.delete |
yok | yok | yok | 204 |
src/cluster_erp/server/routes/currencies.py:81 |
POST |
/api/v1/currencies/seed |
seed_currencies |
currency.seed |
yok | yok | dict |
200 (varsayılan) | src/cluster_erp/server/routes/currencies.py:92 |
Döviz kurları uç noktaları¶
Döviz kuru kayıtları, dönüştürme okuması ve merkez bankası eşitlemesi.
| Yöntem | Yol | İşleyici | Yetki | İstek | Sorgu | Yanıt | Durum | Kaynak |
|---|---|---|---|---|---|---|---|---|
GET |
/api/v1/currencies/exchange-rates/ |
list_exchange_rates |
exchange_rate.read |
yok | base_currency, target_currency, date_from, date_to, search, limit |
list[ExchangeRateRead] |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:32 |
POST |
/api/v1/currencies/exchange-rates/ |
create_exchange_rate |
exchange_rate.create |
ExchangeRateCreate |
yok | ExchangeRateRead |
201 |
src/cluster_erp/modules/currencies/exchange_rates/routes.py:55 |
GET |
/api/v1/currencies/exchange-rates/convert |
convert_currency |
exchange_rate.read |
yok | from_currency, to_currency, amount, rate_date |
ConvertResult |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:66 |
GET |
/api/v1/currencies/exchange-rates/{rate_id} |
get_exchange_rate |
exchange_rate.read |
yok | yok | ExchangeRateRead |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:82 |
PUT |
/api/v1/currencies/exchange-rates/{rate_id} |
update_exchange_rate |
exchange_rate.update |
ExchangeRateUpdate |
yok | ExchangeRateRead |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:95 |
DELETE |
/api/v1/currencies/exchange-rates/{rate_id} |
delete_exchange_rate |
exchange_rate.delete |
yok | yok | yok | 204 |
src/cluster_erp/modules/currencies/exchange_rates/routes.py:109 |
POST |
/api/v1/currencies/exchange-rates/bulk-delete |
bulk_delete_exchange_rates |
exchange_rate.delete |
BulkDeleteRequest |
yok | BulkDeleteResponse |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:120 |
POST |
/api/v1/currencies/exchange-rates/sync-tcmb |
sync_tcmb |
exchange_rate.sync |
yok | yok | dict |
200 (varsayılan) | src/cluster_erp/modules/currencies/exchange_rates/routes.py:131 |
Ödeme koşulları uç noktaları¶
Ödeme koşulu kayıtları.
| Yöntem | Yol | İşleyici | Yetki | İstek | Sorgu | Yanıt | Durum | Kaynak |
|---|---|---|---|---|---|---|---|---|
GET |
/api/v1/currencies/payment-terms/ |
list_payment_terms |
payment_term.read |
yok | active_only, search |
dict |
200 (varsayılan) | src/cluster_erp/modules/currencies/payment_terms/routes.py:24 |
GET |
/api/v1/currencies/payment-terms/{term_id} |
get_payment_term |
payment_term.read |
yok | yok | PaymentTermRead |
200 (varsayılan) | src/cluster_erp/modules/currencies/payment_terms/routes.py:39 |
POST |
/api/v1/currencies/payment-terms/ |
create_payment_term |
payment_term.create |
PaymentTermCreate |
yok | PaymentTermRead |
201 |
src/cluster_erp/modules/currencies/payment_terms/routes.py:54 |
PUT |
/api/v1/currencies/payment-terms/{term_id} |
update_payment_term |
payment_term.update |
PaymentTermUpdate |
yok | PaymentTermRead |
200 (varsayılan) | src/cluster_erp/modules/currencies/payment_terms/routes.py:66 |
DELETE |
/api/v1/currencies/payment-terms/{term_id} |
delete_payment_term |
payment_term.delete |
yok | yok | yok | 204 |
src/cluster_erp/modules/currencies/payment_terms/routes.py:79 |
Hata kodları¶
Tablo, src/cluster_erp/modules/currencies/ altındaki kodun attığı hata kodlarını listeler. Kodlar, AppError(...) çağrıları, src/cluster_erp/core/errors.py içindeki fabrikalar (not_found, conflict, protected, permission_denied, privilege_escalation, check_version) ve HTTPException(...) için yapılan bir sözdizimi ağacı taramasıyla bulundu. 400 durumu AppError varsayılanıdır (src/cluster_erp/core/errors.py:23). Koruma hataları (401, 403), yetkilendirme kodları ve doğrulama hataları (422) her yol için geçerlidir ve Hatalar sayfasında listelenir.
src/cluster_erp/server/routes/currencies.py içindeki para birimi yönlendiricisi taramaya dahildir.
| Kod | HTTP durumu | Atıldığı yer | İlk konum |
|---|---|---|---|
CONCURRENCY_VERSION_CONFLICT |
409 |
payment_terms |
src/cluster_erp/modules/currencies/payment_terms/services.py:480 |
RESOURCE_CONFLICT |
409 |
payment_terms |
src/cluster_erp/modules/currencies/payment_terms/services.py:455 |
RESOURCE_NOT_FOUND |
404 |
`,exchange_rates,payment_terms` |
src/cluster_erp/modules/currencies/exchange_rates/routes.py:78 |
Yayımlanan olaylar¶
Tablo, src/cluster_erp/modules/currencies/ altındaki kodun EventBus.emit çağrısına doğrudan verdiği sözleşme sınıflarını listeler; sözdizimi ağacı taramasıyla bulundu. Önce bir değişkene kurulan olaylar sayılmaz. Sözleşmeler Sözleşmeler başvurusu sayfasında anlatılır.
Tarama bir olay bulmadı.
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.