monkeybrain-runtime 1.0.0__py3-none-any.whl

services/suppliers/models/supplier_locations.py

@@ -0,0 +1,70 @@
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class SupplierLocation(BaseModel):
+    supplier_id: str = Field(..., description="Unique identifier for the supplier.")
+    item_id: str = Field(..., description="Unique identifier for the inventory item.")
+    location_id: str = Field(..., description="Unique identifier for the supplier's specific location.")
+    location_name: str = Field(..., description="Name or description of the location, for example Head Office or Manufacturing Plant.")
+    address_line_1: str = Field(..., description="Primary address line for the location.")
+    address_line_2: Optional[str] = Field(None, description="Secondary address line, if applicable.")
+    city: str = Field(..., description="City where the supplier's location is based.")
+    state_province: str = Field(..., description="State or province of the location.")
+    country: str = Field(..., description="Country of the supplier's location.")
+    postal_code: str = Field(..., description="Postal or ZIP code for the location.")
+    contact_number: str = Field(..., description="Phone number for the location.")
+    email_address: str = Field(..., description="Email address for location-specific communication.")
+    facility_type: str = Field(..., description="Type of facility at the location, for example Manufacturing, Warehouse, or Office.")
+    operational_hours: str = Field(..., description="Standard hours of operation for the facility.")
+    primary_function: str = Field(..., description="Main activity performed at the location, for example Assembly or Distribution.")
+    geographical_coordinates: str = Field(..., description="Latitude and longitude for mapping purposes.")
+    annual_production_capacity: Optional[int] = Field(None, description="Maximum production output per year at this location.")
+    employee_count: int = Field(..., description="Total number of employees at the location.")
+    certifications: Optional[list[str]] = Field(None, description="Certifications specific to the location, for example ISO 9001 or OSHA Compliance.")
+    storage_capacity: Optional[float] = Field(None, description="Maximum storage capacity at the location, for example in cubic meters.")
+    key_contact_person: str = Field(..., description="Name of the primary contact person at the location.")
+    key_contact_role: str = Field(..., description="Role of the key contact person, for example Plant Manager or Logistics Coordinator.")
+    remarks: Optional[str] = Field(None, description="Additional notes or observations about the location.")
+
+
+class SupplierLocationCreate(SupplierLocation):
+    pass
+
+
+class SupplierLocationUpdate(BaseModel):
+    supplier_id: Optional[str] = None
+    item_id: Optional[str] = None
+    location_name: Optional[str] = None
+    address_line_1: Optional[str] = None
+    address_line_2: Optional[str] = None
+    city: Optional[str] = None
+    state_province: Optional[str] = None
+    country: Optional[str] = None
+    postal_code: Optional[str] = None
+    contact_number: Optional[str] = None
+    email_address: Optional[str] = None
+    facility_type: Optional[str] = None
+    operational_hours: Optional[str] = None
+    primary_function: Optional[str] = None
+    geographical_coordinates: Optional[str] = None
+    annual_production_capacity: Optional[int] = None
+    employee_count: Optional[int] = None
+    certifications: Optional[list[str]] = None
+    storage_capacity: Optional[float] = None
+    key_contact_person: Optional[str] = None
+    key_contact_role: Optional[str] = None
+    remarks: Optional[str] = None
+
+
+class SupplierLocationResponse(SupplierLocation):
+    class Config:
+        from_attributes = True
+
+
+class PaginatedSupplierLocationResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[SupplierLocationResponse]

services/suppliers/models/supplier_pricing.py

@@ -0,0 +1,74 @@
+from datetime import datetime
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class SupplierPricingModel(BaseModel):
+    supplier_id: str = Field(..., description="Unique identifier for the supplier.")
+    item_id: str = Field(..., description="Unique identifier for the inventory item.")
+    location_id: str = Field(..., description="Unique identifier for the supplier's specific location.")
+    item_name: str = Field(..., description="Name or description of the item.")
+    unit_price: float = Field(..., description="Price per unit of the item.")
+    currency: str = Field(..., description="Currency in which the price is quoted.")
+    pricing_tier: str = Field(..., description="Price category based on order volume, for example Bulk, Standard, or Wholesale.")
+    discount_rate: float = Field(..., description="Discount percentage for bulk purchases or special agreements.")
+    net_unit_price: float = Field(..., description="Final price per unit after applying any discounts.")
+    quantity_range: str = Field(..., description="Range of quantities applicable for the specific pricing tier.")
+    pricing_validity_start: datetime = Field(..., description="Start datetime for the validity of the quoted price.")
+    pricing_validity_end: datetime = Field(..., description="End datetime for the validity of the quoted price.")
+    price_adjustment_terms: str = Field(..., description="Terms for adjusting prices due to inflation, raw material costs, etc.")
+    tax_rate: float = Field(..., description="Applicable tax percentage for the item.")
+    tax_amount: float = Field(..., description="Calculated tax amount per unit.")
+    total_unit_cost: float = Field(..., description="Unit price including taxes.")
+    shipping_cost_per_unit: float = Field(..., description="Estimated or actual shipping cost per unit.")
+    total_landed_cost: float = Field(..., description="Total cost per unit including price, taxes, and shipping.")
+    payment_terms: str = Field(..., description="Terms of payment specific to pricing agreements, for example Net 30 or Advance Payment.")
+    minimum_order_quantity: int = Field(..., description="Minimum quantity required for purchase at the specified price.")
+    price_escalation_clause: Optional[str] = Field(None, description="Conditions under which price increases are allowed.")
+    currency_exchange_rate: Optional[float] = Field(None, description="Exchange rate if pricing is in a foreign currency.")
+    custom_pricing_notes: Optional[str] = Field(None, description="Additional notes or special agreements regarding pricing.")
+
+
+class SupplierPricingCreate(SupplierPricingModel):
+    pass
+
+
+class SupplierPricingUpdate(BaseModel):
+    supplier_id: Optional[str] = None
+    item_id: Optional[str] = None
+    location_id: Optional[str] = None
+    item_name: Optional[str] = None
+    unit_price: Optional[float] = None
+    currency: Optional[str] = None
+    pricing_tier: Optional[str] = None
+    discount_rate: Optional[float] = None
+    net_unit_price: Optional[float] = None
+    quantity_range: Optional[str] = None
+    pricing_validity_start: Optional[datetime] = None
+    pricing_validity_end: Optional[datetime] = None
+    price_adjustment_terms: Optional[str] = None
+    tax_rate: Optional[float] = None
+    tax_amount: Optional[float] = None
+    total_unit_cost: Optional[float] = None
+    shipping_cost_per_unit: Optional[float] = None
+    total_landed_cost: Optional[float] = None
+    payment_terms: Optional[str] = None
+    minimum_order_quantity: Optional[int] = None
+    price_escalation_clause: Optional[str] = None
+    currency_exchange_rate: Optional[float] = None
+    custom_pricing_notes: Optional[str] = None
+
+
+class SupplierPricingResponse(SupplierPricingModel):
+    supplier_pricing_id: str
+
+    class Config:
+        from_attributes = True
+
+
+class PaginatedSupplierPricingResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[SupplierPricingResponse]

services/suppliers/models/supplier_quality.py

@@ -0,0 +1,74 @@
+from datetime import datetime
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class SupplierQualityData(BaseModel):
+    supplier_id: str = Field(..., description="Unique identifier for the supplier.")
+    item_id: str = Field(..., description="Unique identifier for the inventory item.")
+    location_id: str = Field(..., description="Unique identifier for the supplier's specific location.")
+    quality_rating: float = Field(..., description="Overall quality score based on historical performance, for example 1 to 100.")
+    defect_rate: float = Field(..., description="Percentage of defective items in delivered goods.")
+    on_time_delivery_rate: float = Field(..., description="Percentage of orders delivered on or before the agreed-upon date.")
+    return_rate: float = Field(..., description="Percentage of delivered goods returned due to quality issues.")
+    non_conformance_reports: int = Field(..., description="Number of non-conformance reports filed against the supplier.")
+    iso_certifications: list[str] = Field(..., description="List of ISO or equivalent certifications related to quality management.")
+    quality_audit_compliance_rate: float = Field(..., description="Percentage of quality audits passed successfully.")
+    inspection_pass_rate: float = Field(..., description="Percentage of items that pass quality inspection upon delivery.")
+    warranty_claims_rate: float = Field(..., description="Percentage of delivered goods that resulted in warranty claims.")
+    supplier_quality_manager: str = Field(..., description="Name of the person responsible for quality assurance at the supplier.")
+    corrective_action_turnaround_time: int = Field(..., description="Average number of days to resolve quality issues raised by the buyer.")
+    customer_complaint_rate: float = Field(..., description="Percentage of complaints related to supplier's products or services.")
+    continuous_improvement_programs: bool = Field(..., description="Indicates if the supplier has active quality improvement initiatives.")
+    last_quality_audit_date: datetime = Field(..., description="Date of the most recent quality audit conducted.")
+    next_quality_audit_date: datetime = Field(..., description="Scheduled date for the next quality audit.")
+    inspection_process_details: Optional[str] = Field(None, description="Description of the supplier's internal quality inspection processes.")
+    first_pass_yield: float = Field(..., description="Percentage of goods that meet quality standards without rework.")
+    material_traceability: bool = Field(..., description="Indicates whether the supplier provides traceability for materials used.")
+    adherence_to_specifications: float = Field(..., description="Percentage of delivered goods meeting exact design or technical specifications.")
+    remarks: Optional[str] = Field(None, description="Additional notes or observations about the supplier's quality performance.")
+
+
+class SupplierQualityCreate(SupplierQualityData):
+    pass
+
+
+class SupplierQualityUpdate(BaseModel):
+    supplier_id: Optional[str] = None
+    item_id: Optional[str] = None
+    location_id: Optional[str] = None
+    quality_rating: Optional[float] = None
+    defect_rate: Optional[float] = None
+    on_time_delivery_rate: Optional[float] = None
+    return_rate: Optional[float] = None
+    non_conformance_reports: Optional[int] = None
+    iso_certifications: Optional[list[str]] = None
+    quality_audit_compliance_rate: Optional[float] = None
+    inspection_pass_rate: Optional[float] = None
+    warranty_claims_rate: Optional[float] = None
+    supplier_quality_manager: Optional[str] = None
+    corrective_action_turnaround_time: Optional[int] = None
+    customer_complaint_rate: Optional[float] = None
+    continuous_improvement_programs: Optional[bool] = None
+    last_quality_audit_date: Optional[datetime] = None
+    next_quality_audit_date: Optional[datetime] = None
+    inspection_process_details: Optional[str] = None
+    first_pass_yield: Optional[float] = None
+    material_traceability: Optional[bool] = None
+    adherence_to_specifications: Optional[float] = None
+    remarks: Optional[str] = None
+
+
+class SupplierQualityResponse(SupplierQualityData):
+    supplier_quality_id: str
+
+    class Config:
+        from_attributes = True
+
+
+class PaginatedSupplierQualityResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[SupplierQualityResponse]

services/suppliers/models/supplier_shipping.py

@@ -0,0 +1,76 @@
+from datetime import datetime
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class SupplierShippingData(BaseModel):
+    supplier_id: str = Field(..., description="Unique identifier for the supplier.")
+    item_id: str = Field(..., description="Unique identifier for the inventory item.")
+    location_id: str = Field(..., description="Unique identifier for the supplier's specific location.")
+    shipping_method: str = Field(..., description="The mode of transportation used, for example Air, Sea, Rail, Road, or Courier.")
+    shipping_carrier: str = Field(..., description="Name of the logistics provider or shipping company.")
+    shipping_terms: str = Field(..., description="Delivery terms as per the Incoterms, for example FOB, CIF, DDP, or EXW.")
+    origin_address: str = Field(..., description="Address from which the goods will be shipped.")
+    destination_address: str = Field(..., description="Delivery address for the goods.")
+    average_transit_time_days: int = Field(..., description="Average number of days required for shipping to the destination.")
+    shipping_cost: float = Field(..., description="Estimated or actual shipping cost per shipment.")
+    shipping_currency: str = Field(..., description="Currency in which the shipping cost is quoted.")
+    packaging_type: str = Field(..., description="Type of packaging used for shipments, for example Pallet, Crate, or Box.")
+    max_weight_per_shipment: float = Field(..., description="Maximum allowable weight for a single shipment in kg.")
+    max_volume_per_shipment: float = Field(..., description="Maximum allowable volume for a single shipment in cubic meters.")
+    tracking_available: bool = Field(..., description="Indicates if shipment tracking is available.")
+    tracking_url: Optional[str] = Field(None, description="URL for shipment tracking, if applicable.")
+    preferred_delivery_time: str = Field(..., description="Preferred time window for delivery, for example 9 AM - 5 PM.")
+    insurance_provided: bool = Field(..., description="Indicates if the shipment is insured.")
+    insurance_coverage_amount: Optional[float] = Field(None, description="Value covered by shipping insurance.")
+    freight_class: Optional[str] = Field(None, description="Freight classification for the shipment, for example Hazardous or Perishable.")
+    customs_clearance_included: bool = Field(..., description="Indicates if customs clearance is necessary for international shipments.")
+    customs_documentation: list[str] = Field(..., description="List of documents required for customs clearance, for example Invoice or Packing List.")
+    last_shipping_date: Optional[datetime] = Field(None, description="The most recent date a shipment was dispatched by the supplier.")
+    remarks: Optional[str] = Field(None, description="Additional notes or special instructions related to shipping.")
+
+
+class SupplierShippingCreate(SupplierShippingData):
+    pass
+
+
+class SupplierShippingUpdate(BaseModel):
+    supplier_id: Optional[str] = None
+    item_id: Optional[str] = None
+    location_id: Optional[str] = None
+    shipping_method: Optional[str] = None
+    shipping_carrier: Optional[str] = None
+    shipping_terms: Optional[str] = None
+    origin_address: Optional[str] = None
+    destination_address: Optional[str] = None
+    average_transit_time_days: Optional[int] = None
+    shipping_cost: Optional[float] = None
+    shipping_currency: Optional[str] = None
+    packaging_type: Optional[str] = None
+    max_weight_per_shipment: Optional[float] = None
+    max_volume_per_shipment: Optional[float] = None
+    tracking_available: Optional[bool] = None
+    tracking_url: Optional[str] = None
+    preferred_delivery_time: Optional[str] = None
+    insurance_provided: Optional[bool] = None
+    insurance_coverage_amount: Optional[float] = None
+    freight_class: Optional[str] = None
+    customs_clearance_included: Optional[bool] = None
+    customs_documentation: Optional[list[str]] = None
+    last_shipping_date: Optional[datetime] = None
+    remarks: Optional[str] = None
+
+
+class SupplierShippingResponse(SupplierShippingData):
+    supplier_shipping_id: str
+
+    class Config:
+        from_attributes = True
+
+
+class PaginatedSupplierShippingResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[SupplierShippingResponse]

services/suppliers/routers/__init__.py

@@ -0,0 +1,13 @@
+"""suppliers service routers package."""
+
+__all__ = [
+    "supplier_capabilities",
+    "supplier_certifications",
+    "supplier_details",
+    "supplier_financials",
+    "supplier_inventory",
+    "supplier_locations",
+    "supplier_pricing",
+    "supplier_quality",
+    "supplier_shipping",
+]

services/suppliers/routers/supplier_capabilities.py

@@ -0,0 +1,88 @@
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.suppliers.helpers import supplier_capabilities as crud
+from services.common.auth import require_permission
+from services.suppliers.models.supplier_capabilities import (
+    PaginatedSupplierCapabilitiesResponse,
+    SupplierCapabilitiesCreate,
+    SupplierCapabilitiesResponse,
+    SupplierCapabilitiesUpdate,
+)
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedSupplierCapabilitiesResponse)
+async def list_supplier_capabilities(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    records, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedSupplierCapabilitiesResponse(
+        total=total,
+        page=page,
+        page_size=page_size,
+        results=records,
+    )
+
+
+@router.get("/{supplier_id}", response_model=SupplierCapabilitiesResponse)
+async def get_supplier_capabilities(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    record = await crud.get_by_supplier_id(db, supplier_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier capabilities for supplier '{supplier_id}' not found",
+        )
+    return record
+
+
+@router.post("/", response_model=SupplierCapabilitiesResponse, status_code=status.HTTP_201_CREATED)
+async def create_supplier_capabilities(
+    data: SupplierCapabilitiesCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-products")),
+):
+    if await crud.get_by_supplier_id(db, data.supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Supplier capabilities for supplier '{data.supplier_id}' already exist",
+        )
+    return await crud.create(db, data)
+
+
+@router.patch("/{supplier_id}", response_model=SupplierCapabilitiesResponse)
+async def update_supplier_capabilities(
+    supplier_id: str,
+    data: SupplierCapabilitiesUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    updated = await crud.update(db, supplier_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier capabilities for supplier '{supplier_id}' not found",
+        )
+    return updated
+
+
+@router.delete("/{supplier_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_supplier_capabilities(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-products")),
+):
+    if not await crud.delete(db, supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier capabilities for supplier '{supplier_id}' not found",
+        )

services/suppliers/routers/supplier_certifications.py

@@ -0,0 +1,87 @@
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.suppliers.helpers import supplier_certifications as crud
+from services.common.auth import require_permission
+from services.suppliers.models.supplier_certifications import (
+    CertificationCreate,
+    CertificationResponse,
+    CertificationUpdate,
+    PaginatedCertificationResponse,
+)
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedCertificationResponse)
+async def list_supplier_certifications(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    records, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedCertificationResponse(total=total, page=page, page_size=page_size, results=records)
+
+
+@router.get("/by-supplier/{supplier_id}", response_model=list[CertificationResponse])
+async def list_supplier_certifications_by_supplier(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    return await crud.get_by_supplier(db, supplier_id)
+
+
+@router.get("/{certification_id}", response_model=CertificationResponse)
+async def get_supplier_certification(
+    certification_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    record = await crud.get_by_id(db, certification_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier certification '{certification_id}' not found",
+        )
+    return record
+
+
+@router.post("/", response_model=CertificationResponse, status_code=status.HTTP_201_CREATED)
+async def create_supplier_certification(
+    data: CertificationCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-products")),
+):
+    return await crud.create(db, data)
+
+
+@router.patch("/{certification_id}", response_model=CertificationResponse)
+async def update_supplier_certification(
+    certification_id: str,
+    data: CertificationUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    updated = await crud.update(db, certification_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier certification '{certification_id}' not found",
+        )
+    return updated
+
+
+@router.delete("/{certification_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_supplier_certification(
+    certification_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-products")),
+):
+    if not await crud.delete(db, certification_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier certification '{certification_id}' not found",
+        )

services/suppliers/routers/supplier_details.py

@@ -0,0 +1,83 @@
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.suppliers.helpers import supplier_details as crud
+from services.common.auth import require_permission
+from services.suppliers.models.supplier_details import (
+    PaginatedSupplierDetailsResponse,
+    SupplierDetailsCreate,
+    SupplierDetailsResponse,
+    SupplierDetailsUpdate,
+)
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedSupplierDetailsResponse)
+async def list_supplier_details(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    records, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedSupplierDetailsResponse(total=total, page=page, page_size=page_size, results=records)
+
+
+@router.get("/{supplier_id}", response_model=SupplierDetailsResponse)
+async def get_supplier_details(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    record = await crud.get_by_supplier_id(db, supplier_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier details for supplier '{supplier_id}' not found",
+        )
+    return record
+
+
+@router.post("/", response_model=SupplierDetailsResponse, status_code=status.HTTP_201_CREATED)
+async def create_supplier_details(
+    data: SupplierDetailsCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-products")),
+):
+    if await crud.get_by_supplier_id(db, data.supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Supplier details for supplier '{data.supplier_id}' already exist",
+        )
+    return await crud.create(db, data)
+
+
+@router.patch("/{supplier_id}", response_model=SupplierDetailsResponse)
+async def update_supplier_details(
+    supplier_id: str,
+    data: SupplierDetailsUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    updated = await crud.update(db, supplier_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier details for supplier '{supplier_id}' not found",
+        )
+    return updated
+
+
+@router.delete("/{supplier_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_supplier_details(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-products")),
+):
+    if not await crud.delete(db, supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier details for supplier '{supplier_id}' not found",
+        )

services/suppliers/routers/supplier_financials.py

@@ -0,0 +1,83 @@
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.suppliers.helpers import supplier_financials as crud
+from services.common.auth import require_permission
+from services.suppliers.models.supplier_financials import (
+    PaginatedSupplierFinancialsResponse,
+    SupplierFinancialsCreate,
+    SupplierFinancialsResponse,
+    SupplierFinancialsUpdate,
+)
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedSupplierFinancialsResponse)
+async def list_supplier_financials(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    records, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedSupplierFinancialsResponse(total=total, page=page, page_size=page_size, results=records)
+
+
+@router.get("/{supplier_id}", response_model=SupplierFinancialsResponse)
+async def get_supplier_financials(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    record = await crud.get_by_supplier_id(db, supplier_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier financials for supplier '{supplier_id}' not found",
+        )
+    return record
+
+
+@router.post("/", response_model=SupplierFinancialsResponse, status_code=status.HTTP_201_CREATED)
+async def create_supplier_financials(
+    data: SupplierFinancialsCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-products")),
+):
+    if await crud.get_by_supplier_id(db, data.supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Supplier financials for supplier '{data.supplier_id}' already exist",
+        )
+    return await crud.create(db, data)
+
+
+@router.patch("/{supplier_id}", response_model=SupplierFinancialsResponse)
+async def update_supplier_financials(
+    supplier_id: str,
+    data: SupplierFinancialsUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    updated = await crud.update(db, supplier_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier financials for supplier '{supplier_id}' not found",
+        )
+    return updated
+
+
+@router.delete("/{supplier_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_supplier_financials(
+    supplier_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-products")),
+):
+    if not await crud.delete(db, supplier_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Supplier financials for supplier '{supplier_id}' not found",
+        )