Factorizer/Cluster ERP WikiCluster ERP English
Ana sayfa / İş modülleri

Referans

Tedarikçiler

Procurement modülünün suppliers alt modülü için başvuru; bir tarafın tedarikçi rolü, alanları, uçları, taraf eşitlemesi ve kuralları.

Bu sayfa src/cluster_erp/modules/procurement/suppliers/ içindeki suppliers alt modülünü anlatır. Bir tedarikçi (Supplier), bir tarafın tedarikçi rol kaydıdır: tarafa satın alma varsayılanları ekler ve taraf kartının bir bölümü olarak gösterilir. Tarafın kendisi taraflar, rol modeli taraf birleştirme sayfasında anlatılır.

Kapsam ve kaynak

  • Tanımlandığı yer: src/cluster_erp/modules/procurement/suppliers/models.py (Supplier), services.py (SupplierService), routes.py, metadata.py ve src/cluster_erp/modules/procurement/module.py:221-276 içindeki taraf işleyicileri.
  • Sayım: 1 tablo, 6 uç (routes.py içindeki @router. dekoratörleri).

Tedarikçi alanları

Ad Anlam Kaynak
code supplier yıllık dizisinden gelen iş anahtarı src/cluster_erp/modules/procurement/suppliers/models.py:40, src/cluster_erp/modules/procurement/suppliers/services.py:130
party_id Tedarikçi rolünü oynayan taraf; taraf başına bir canlı rol src/cluster_erp/modules/procurement/suppliers/models.py:32-36, src/cluster_erp/modules/procurement/suppliers/models.py:42-47
legal_name, tax_no Tarafın görünen adından ve vergi numarasından kopyalanır src/cluster_erp/modules/procurement/suppliers/models.py:41, src/cluster_erp/modules/procurement/suppliers/models.py:48
country_id Ülke başvurusu src/cluster_erp/modules/procurement/suppliers/models.py:49-54
default_incoterm, default_currency, payment_terms Ticari varsayılanlar src/cluster_erp/modules/procurement/suppliers/models.py:55-57
purchasing_contact_email, default_buyer_id İletişim ve sorumlu satın almacı src/cluster_erp/modules/procurement/suppliers/models.py:58-59
vendor_number Şirketin tedarikçi için kullandığı numara; doluysa canlı satırlar arasında benzersiz src/cluster_erp/modules/procurement/suppliers/models.py:26-31, src/cluster_erp/modules/procurement/suppliers/models.py:60
is_preferred Tercih edilen tedarikçi bayrağı src/cluster_erp/modules/procurement/suppliers/models.py:61-67
is_active, extra Etkinlik bayrağı ve kiracı tanımlı alan değerleri src/cluster_erp/modules/procurement/suppliers/models.py:21, src/cluster_erp/modules/procurement/suppliers/models.py:68

Tedarikçi uçları

Yöntem ve yol İzin Kaynak
GET /suppliers/ supplier.read src/cluster_erp/modules/procurement/suppliers/routes.py:37
POST /suppliers/ supplier.create src/cluster_erp/modules/procurement/suppliers/routes.py:73
GET /suppliers/{supplier_id} supplier.read src/cluster_erp/modules/procurement/suppliers/routes.py:92
PUT /suppliers/{supplier_id} supplier.update src/cluster_erp/modules/procurement/suppliers/routes.py:113
DELETE /suppliers/{supplier_id} supplier.delete src/cluster_erp/modules/procurement/suppliers/routes.py:135
POST /suppliers/bulk-delete supplier.bulk_delete src/cluster_erp/modules/procurement/suppliers/routes.py:147

Yollar /api/v1/procurement altındadır. Taraf kartı da supplier rolünü bildiren bileşik taraf formuyla tedarikçi rolleri oluşturur (src/cluster_erp/modules/parties/parties/metadata.py:323).

Taraf eşitlemesi

Diyagram rolün tarafını nasıl izlediğini gösterir.

flowchart LR
 C["SupplierService.create"] --> GP["GetPartyById"]
 GP --> F["taraftan legal_name ve tax_no"]
 C --> RS["PartyRoleSet rol supplier active true"]
 PU["PartyUpdated"] --> U["legal_name veya tax_no güncellenir"]
 PD["PartyDeleted"] --> D["canlı rollerde is_active false"]
 X["SupplierService.delete"] --> RS2["PartyRoleSet rol supplier active false"]

Düz anlatımla: oluşturmada servis tarafı GetPartyById ile okur, görünen adını ve vergi numarasını kopyalar; bilinmeyen taraf 422 hatasıyla reddedilir (src/cluster_erp/modules/procurement/suppliers/services.py:80-128). Ardından active=True ile PartyRoleSet yayar (src/cluster_erp/modules/procurement/suppliers/services.py:135-145). Rolün tarafı varsa güncelleme legal_name ve tax_no alanlarını yükten çıkarır (src/cluster_erp/modules/procurement/suppliers/services.py:158-162). PartyUpdated yalnızca değişen alanları canlı rollere kopyalar (src/cluster_erp/modules/procurement/module.py:221-246). PartyDeleted, o tarafın canlı rollerinde is_active değerini false yapar (src/cluster_erp/modules/procurement/module.py:248-273). Silme ve toplu silme deleted_at alanını doldurur ve active=False ile PartyRoleSet yayar (src/cluster_erp/modules/procurement/suppliers/services.py:185-241).

Kısıtlar ve doğrulama

  • vendor_number ve party_id doluysa her biri canlı satırlar arasında benzersizdir (src/cluster_erp/modules/procurement/suppliers/models.py:24-38).
  • party_id ve country_id, parties_parties ve parties_countries tablolarına veritabanı yabancı anahtarlarıdır (src/cluster_erp/modules/procurement/suppliers/models.py:42-54).
  • Bireysel bir tarafın rolündeki kişisel değerler privacy_handlers.py tarafından toplanır ve anonimleştirilir (src/cluster_erp/modules/procurement/privacy_handlers.py:1-11).

Tanıtılan terimler

Terim Kod tanımlayıcısı Tanım Türkçe terim Kaynak
vendor number vendor_number Şirketin bir tedarikçi için kullandığı, canlı tedarikçiler arasında benzersiz numara. Tedarikçi numarası src/cluster_erp/modules/procurement/suppliers/models.py:60
preferred vendor is_preferred Satın almacının tedarik için tercih ettiği tedarikçi. Tercih edilen tedarikçi src/cluster_erp/modules/procurement/suppliers/models.py:61-67

İlgili sayfalar


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

Doğrulanan commit 92f8051 · 2026-11-13