Satın alma sözleşmeleri ve info kayıtları

Bu sayfa src/cluster_erp/modules/procurement/ içindeki iki alt modülü anlatır: bir tedarikçiyle bir dönem için yapılan çerçeve anlaşmalar olan purchase_contracts/ ve tedarikçi ile ürün kırılımı başına fiyat ana verisi ile fiyat geçmişini tutan info_records/. Her ikisini besleyen tedarikçi teklifleri purchasing quotations modülü sayfasında anlatılır.

Kapsam ve kaynak¶

• Tanımlandığı yer: purchase_contracts ve info_records alt modüllerinin models.py, services.py, routes.py ve metadata.py dosyaları.
• Sayım: 4 tablo; 16 sözleşme ucu ve 8 info kaydı ucu (@router. dekoratörleri); tamamı sözleşmelerde olan 5 ActionMeta girdisi.

Sözleşme alanları¶

Sözleşme kalemleri (PurchaseContractItem, tablo procurement_purchase_contract_items) line_no, ürün kırılımı, description, target_qty, released_qty, net_unit_price ve unit_id taşır (src/cluster_erp/modules/procurement/purchase_contracts/models.py:83-109).

Sözleşme durumları ve aksiyonları¶

Servis her aksiyonu bir hedef duruma ve izin verilen kaynak durumlara eşler (src/cluster_erp/modules/procurement/purchase_contracts/services.py:39-45).

stateDiagram-v2
 [*] --> draft
 draft --> active: activate
 active --> closed: close
 active --> expired: expire
 draft --> cancelled: cancel
 active --> cancelled: cancel
 cancelled --> draft: reopen

Düz anlatımla: activate eksiksiz bir taslak ister: en az bir kalem, başlangıcı bitişten sonra olmayan bir geçerlilik dönemi ve değer sözleşmesi için bir hedef değer (src/cluster_erp/modules/procurement/purchase_contracts/services.py:234-256, src/cluster_erp/modules/procurement/purchase_contracts/services.py:308-346). Her geçiş eşzamanlı düzenlemelere karşı kayıt sürümünü denetler (src/cluster_erp/modules/procurement/purchase_contracts/services.py:213-232).

Sözleşme uçları¶

Info kaydı alanları¶

Fiyat geçmişi satırları (PurchasingInfoRecordPrice, tablo procurement_info_record_prices) unit_price, currency, valid_from, source, source_ref_code ve recorded_at tutar (src/cluster_erp/modules/procurement/info_records/models.py:94-121).

Info kaydı uçları¶

Kısıtlar ve doğrulama¶

• Bir sözleşme yalnızca draft durumunda değişir; yalnızca draft veya cancelled sözleşmeler silinebilir (src/cluster_erp/modules/procurement/purchase_contracts/services.py:36, src/cluster_erp/modules/procurement/purchase_contracts/services.py:198-210).
• Tedarikçi ve ürün kırılımı başına bir canlı info kaydı bulunur; elle girilen bir kopya reddedilir (src/cluster_erp/modules/procurement/info_records/models.py:33-41, src/cluster_erp/modules/procurement/info_records/services.py:160-173).
• upsert bir kayıt oluşturur veya fiyatı günceller, kaydı yeniden etkinleştirir ve fiyat değiştiyse bir geçmiş satırı ekler (src/cluster_erp/modules/procurement/info_records/services.py:229-292).
• SupplierQuotationAwarded geldiğinde modül, tam kırılım taşıyan her ihale edilmiş kalem için bir info kaydını kendi kayıt noktasında günceller (src/cluster_erp/modules/procurement/module.py:813-862).
• CreateFollowOnFromSupplierQuotation, ihale edilmiş bir tedarikçi teklifinden bir satın alma siparişi veya sözleşme oluşturur; metin kalemleri metin kalemi olur (src/cluster_erp/modules/procurement/module.py:711-810).
• Satın alma siparişi kalemleri varsayılan birim fiyatlarını tam kırılımla lookup_price üzerinden alır (src/cluster_erp/modules/procurement/purchase_orders/services.py:297-303).

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Procurement modülü
• Satın alma siparişleri
• Purchasing quotations modülü

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.