Bu sayfa procurement modülünün purchase_contracts alt modülündeki 16 uç noktayı /api/v1/procurement altında listeler. Kapsam: Sözleşme kayıtları, eksiksizlik, etkinleştirme, kapatma, süresini doldurma, iptal, yeniden açma ve sözleşme kalemleri. Modül giriş sayfası Procurement API sayfasıdır.
Grup olguları¶
| Öğe | Değer | Kaynak |
|---|---|---|
| Temel yol | /api/v1/procurement |
src/cluster_erp/core/module_base.py:37-38, src/cluster_erp/modules/procurement/module.py:70 |
| Yönlendiriciler | 1 dosyada 1 yönlendirici nesnesi; Uç noktalar bölümünde listelenir | src/cluster_erp/modules/procurement/module.py:35 |
| Uç noktalar | 16; register_routes ile bağlanan yönlendiricilerin yol dekoratörleri ve add_api_route çağrılarından sayıldı |
src/cluster_erp/modules/procurement/purchase_contracts/routes.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ı | 16 yolun 16 tanesi require_permission bildirir |
src/cluster_erp/modules/auth/guards.py:205-240 |
| Uygulama yetkilendirme kapısı | bağlanan her yönlendiricide require_app("procurement") |
src/cluster_erp/modules/procurement/module.py:82 |
| Hata biçimi | JSON gövdesi {"error": {...}}; bkz. Hatalar |
src/cluster_erp/server/error_handler.py:33-46 |
Uç noktalar¶
| Yöntem | Yol | İşleyici | Yetki | İstek | Sorgu | Yanıt | Durum | Kaynak |
|---|---|---|---|---|---|---|---|---|
GET |
/api/v1/procurement/purchase-contracts/ |
list_contracts |
purchase_contract.read |
yok | search, status, contract_type, limit, offset |
dict |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:55 |
POST |
/api/v1/procurement/purchase-contracts/ |
create_contract |
purchase_contract.create |
PurchaseContractCreate |
yok | PurchaseContractRead |
201 |
src/cluster_erp/modules/procurement/purchase_contracts/routes.py:91 |
GET |
/api/v1/procurement/purchase-contracts/{contract_id} |
get_contract |
purchase_contract.read |
yok | yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:102 |
PUT |
/api/v1/procurement/purchase-contracts/{contract_id} |
update_contract |
purchase_contract.update |
PurchaseContractUpdate |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:115 |
DELETE |
/api/v1/procurement/purchase-contracts/{contract_id} |
delete_contract |
purchase_contract.delete |
yok | yok | yok | 204 |
src/cluster_erp/modules/procurement/purchase_contracts/routes.py:129 |
POST |
/api/v1/procurement/purchase-contracts/bulk-delete |
bulk_delete |
purchase_contract.delete |
BulkDeleteRequest |
yok | BulkDeleteResponse |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:140 |
GET |
/api/v1/procurement/purchase-contracts/{contract_id}/completeness |
get_completeness |
purchase_contract.read |
yok | yok | dict |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:155 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/activate |
activate |
purchase_contract.activate |
PconTransition |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:170 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/close |
close |
purchase_contract.update |
PconTransition |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:184 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/expire |
expire |
purchase_contract.update |
PconTransition |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:196 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/cancel |
cancel |
purchase_contract.cancel |
PconReasonTransition |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:210 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/reopen |
reopen |
purchase_contract.update |
PconTransition |
yok | PurchaseContractRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:227 |
GET |
/api/v1/procurement/purchase-contracts/{contract_id}/items |
list_items |
purchase_contract.read |
yok | search |
list[PurchaseContractItemRead] |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:242 |
POST |
/api/v1/procurement/purchase-contracts/{contract_id}/items |
add_item |
purchase_contract.update |
PurchaseContractItemCreate |
yok | PurchaseContractItemRead |
201 |
src/cluster_erp/modules/procurement/purchase_contracts/routes.py:257 |
PUT |
/api/v1/procurement/purchase-contract-items/{item_id} |
update_item |
purchase_contract.update |
PurchaseContractItemUpdate |
yok | PurchaseContractItemRead |
200 (varsayılan) | src/cluster_erp/modules/procurement/purchase_contracts/routes.py:273 |
DELETE |
/api/v1/procurement/purchase-contract-items/{item_id} |
delete_item |
purchase_contract.update |
yok | yok | yok | 204 |
src/cluster_erp/modules/procurement/purchase_contracts/routes.py:290 |
Hata kodları¶
Tablo, src/cluster_erp/modules/procurement/purchase_contracts/ 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.
| Kod | HTTP durumu | Atıldığı yer | İlk konum |
|---|---|---|---|
CONCURRENCY_VERSION_CONFLICT |
409 |
services |
src/cluster_erp/modules/procurement/purchase_contracts/services.py:175 |
PCON_INCOMPLETE |
409 |
services |
src/cluster_erp/modules/procurement/purchase_contracts/services.py:246 |
PCON_INVALID_STATUS |
409 |
services |
src/cluster_erp/modules/procurement/purchase_contracts/services.py:203 |
RESOURCE_NOT_FOUND |
404 |
routes, services |
src/cluster_erp/modules/procurement/purchase_contracts/routes.py:111 |
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.