Skip to main content

SUPPLIER

🏭 Technical Specification: Supplier Setup


📋 Feature Overview

Attribute Detail
Module 📂 Directory (SUPPLIER)
Feature Name Supplier Profile Management
Description Manages supplier profiles including general details, contact information, address logic (Country/State/District), and associated pickup addresses.
Page & Detail
1. Listing Page: /listing-supplier-profile
Displays grid of suppliers, filters, and delete actions.
2. Add/Edit Page: /add-supplier-profile-manage
Form for creating new suppliers or updating profile/address details.
User Guide 📄 [Ekajaya Admin User Guide - Directory Module, Section 6]

🛠️ Technical Implementation

A. Permissions & Access Control

Note: Access is controlled via PermissionGuard and template checks.
Scope Permission Code Description & Page Usage
Menu Visibility SUPPLIER.MENU

Sidebar menu visibility.

\listing-supplier-profile

\add-supplier-profile-manage

Page Routing SUPPLIER.LISTING Access to listing route.
\listing-supplier-profile
Page Routing SUPPLIER.VIEW

Access to add route.

\add-supplier-profile-manage

Create Action SUPPLIER.CREATE Visibility of the + Add button.
\listing-supplier-profile
View Access SUPPLIER.VIEW Controls visibility of action buttons (Edit).
\listing-supplier-profile
Delete Action SUPPLIER.DELETE Visibility of the Delete 🗑️ icon.
\listing-supplier-profile
Update Action SUPPLIER.UPDATE Ability to save changes on Edit screen.
\add-supplier-profile-manage

B. API Interaction

Base URL: ${environment.baseApiUrl}
1. Listing Supplier Profile \listing-supplier-profile
/suppliers/getQuery
POST
Filter: supplierCode, supplierName, registrationNumber, isDeleted=0
/supplier/delete
POST
Purpose: Delete Supplier
2. Add Supplier Profile Manage \add-supplier-profile-manage
/countries/getQuery
POST
Purpose: Populate countryDataSource
/states/getQuery
POST
Filter: countryId
/districts/getQuery
POST
Filter: stateId
/suppliers/getQuery
POST
Filter: id (Fetch specific record)
/suppliers/getQuery
POST
Filter: supplierCode (Uniqueness Check)
/suppliers/mdCreate
POST
Purpose: Master-Detail Create
/suppliers/mdUpdate
POST
Purpose: Master-Detail Update