Sales orders modülü (sales_orders)

src/cluster_erp/modules/sales_orders/ içindeki sales_orders modülü bir müşteri satın alma siparişini (PO) satış siparişine dönüştürür ve teslime kadar izler. Müşteri PO'sunu gönderilmiş teklifle karşılaştırır, her PO revizyonunu dondurur, teklif kalemlerini sipariş kalemlerine kopyalar, tek tek birimleri (varlıklar) izler, bunları paketler ve taşıma verileriyle sevkiyatlarda gönderir; çeki listesini ve sevk irsaliyesini üretir. Bu sayfa genel bakıştır; alt konuların kendi sayfaları vardır.

Bir bakışta¶

Modül ne yapar¶

• Gönderilmiş veya kazanılmış bir teklife başvuran müşteri PO'sundan sipariş oluşturur ve teklifin açık kalemlerini kopyalar (src/cluster_erp/modules/sales_orders/orders/services.py:174-341).
• PO'yu teklifle alan alan karşılaştırır ve her denemeyi kaydeder (src/cluster_erp/modules/sales_orders/orders/services.py:342-463).
• Her PO sürümünü bir anlık görüntü revizyonu olarak dondurur (src/cluster_erp/modules/sales_orders/orders/services.py:871-939).
• Bir sipariş kaleminin tek tek birimlerini müşteri varlık numaraları ve seri numaralarıyla izler (src/cluster_erp/modules/sales_orders/units/models.py:14-40).
• Kalemleri ve birimleri paketler, taşıma verileri, olaylar ve teslim kanıtıyla sevkiyatlarda gönderir; sipariş durumunu sevk edilen miktarlardan toplar (src/cluster_erp/modules/sales_orders/shipments/services.py:1253-1392).
• Çeki listesini ve sevk irsaliyesini dondurulmuş bir anlık görüntüden PDF olarak üretir (src/cluster_erp/modules/sales_orders/trade_documents/services.py:169-278).

Alt modüller¶

Tüm yönlendiriciler modül önekinin altına require_app("sales_orders") ile bağlanır (src/cluster_erp/modules/sales_orders/module.py:64-71).

Veri modeli¶

Alanlar siparişler ve kalemler, sevkiyatlar, ihracat belgeleri ve birimler ve ayarlar sayfalarında listelenir. Sipariş kalemleri part_id, part_model_id ve part_version_id taşır; bir katalog kalemi her zaman modelini ve versiyonunu taşır (src/cluster_erp/modules/sales_orders/order_lines/models.py:22-62). Para Numeric türündedir: sipariş toplamı Numeric(19, 4), kalem fiyatı ve toplamı Numeric(18, 4) (src/cluster_erp/modules/sales_orders/orders/models.py:81-84, src/cluster_erp/modules/sales_orders/order_lines/models.py:71-79).

Ekranlar ve metadata¶

get_metadata şu bölümlerle bir Sipariş Yönetimi (İngilizce Order Management) kenar çubuğu grubu bildirir: Siparişler, Sevkiyatlar, Birimler (Asset), İhracat Belgeleri ve Ayarlar (src/cluster_erp/modules/sales_orders/module.py:321-368). Bkz. genel liste ve aksiyonlar ve aksiyon sayfası.

Durumlar ve aksiyonlar¶

Sipariş durumları ve aksiyonları siparişler ve kalemler, sevkiyat durumları sevkiyatlar sayfasındadır. Diyagram bir müşteri PO'sundan belgelere giden yolu gösterir.

flowchart LR
 Q["Teklif gönderildi"] --> SO["SalesOrder po_received"]
 SO --> CHK["run_po_check: matched veya mismatch"]
 CHK --> ACC["accept: opened"]
 ACC --> SH["SalesOrderShipment planned"]
 SH --> RDY["ready"]
 RDY --> SHIP["ship: shipped"]
 SHIP --> DEL["POD ile deliver: delivered"]
 SH --> TD["generate-documents"]
 TD --> PL["TradeDocument packing_list"]
 TD --> DN["TradeDocument delivery_note"]
 SHIP --> ROLL["siparişte _advance_order_status"]
 DEL --> ROLL

Düz anlatımla: bir PO'dan oluşturulan sipariş po_received olarak başlar (src/cluster_erp/modules/sales_orders/orders/models.py:72-77, src/cluster_erp/modules/sales_orders/orders/services.py:41-55). PO kontrolü matched veya mismatch ayarlar; accept eşleşmiş bir siparişi açar (src/cluster_erp/modules/sales_orders/orders/services.py:342-463, src/cluster_erp/modules/sales_orders/orders/services.py:588-648). Siparişin bir sevkiyatı hazırlanır, sevk edilir ve teslim edilir; her adım siparişi sevk edilen miktarlardan toplar (src/cluster_erp/modules/sales_orders/shipments/services.py:1085-1191, src/cluster_erp/modules/sales_orders/shipments/services.py:1253-1392). Belgeler sevkiyat başına üretilir (src/cluster_erp/modules/sales_orders/trade_documents/routes.py:102).

İş kuralları¶

Her alt konu sayfası kendi kurallarını listeler. Modül genelinde müşteriler, taraflar, ürünler, ölçü birimleri ve ülkeler gibi dış veriler EventBus sorgularıyla okunur; modül başka hiçbir modülü içe aktarmaz (src/cluster_erp/modules/sales_orders/trade_documents/builder.py:1-5).

Olaylar ve sorgular¶

Modül 7 sözleşme tüketir ve 33 sözleşme üretir; sayım parties modülü sayfasındaki gibi yapıldı. Tam liste sözleşmeler başvurusu sayfasındadır.

Yetkiler¶

Modül sales_order.*, po_revision.read, shipment.*, shipment_line.*, shipment_unit.*, shipment_package.*, shipment_event.*, trade_document.*, sales_order_unit.* ve sales_order_settings.* ailelerini denetler. Sipariş kalemi ürün ağacı ucu, CreateBomForProduct.REQUIRED_PERMISSION sözleşmesinin adlandırdığı izni kullanır (src/cluster_erp/modules/sales_orders/order_lines/routes.py:104-114). Her alt konu sayfası uç başına anahtarları listeler.

Gizlilik, saklama ve geçmiş¶

Modülün privacy_handlers.py dosyası yoktur. Kayıtlar yumuşak silinir; düzenlenmiş belgeler kaldırılmaz, yerlerine yenisi geçer (src/cluster_erp/modules/sales_orders/trade_documents/services.py:262-263). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

analytics_facts.py, so_sales_orders üzerinde order_count, total_value, average_value, median_value ve total_quantity ölçülü, sales_order.read ile okunan sales_order olgu kümesini katar (src/cluster_erp/modules/sales_orders/analytics_facts.py:22-126). Bkz. analitik olguları.

Ayarlar ve başvuru verileri¶

Kiracı başına bir ayar satırı iç sipariş numarasını, belge numarası şablonlarını, teslim kanıtı kuralını, sevk kontrol düzeyini, varsayılan birimleri ve paket tipini ve belge dilini yönetir; bkz. birimler ve ayarlar.

Testler¶

tests/ içinde modules.sales_orders için ve web-client/_e2e_*.mjs içinde /sales_orders/ yolu için grep ile bulundu.

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Siparişler ve kalemler
• Sevkiyatlar
• İhracat belgeleri
• Birimler ve ayarlar
• Quotations modülü
• Bu modülün API başvurusu

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