Health payments master data configuration details
This document outlines the configuration details for managing payment master data in the HCM module. The configuration enables or restricts payment approval timing and sets the lowest boundary level for payment-related operations, ensuring flexibility and alignment with organisation and campaign requirements.
MDMS (Master Data Management System):
Ensure MDMS is set up and accessible for your environment.
Tenant Hierarchy:
Tenant IDs and boundary types (e.g., DISTRICT, BLOCK, etc.) should be defined and consistent.
Approval Timing Control:
enableApprovalAnyTime flag determines if payment approvals can be performed at any time or only after campaign validation/end date.
true: Approvals allowed at any time.
Configuration File Placement:
Add/update the configuration in the MDMS under the correct tenant and module (typically in the paymentsConfig section).
Version Control:
MDMS Fetch:
The HCM module fetches payment configuration via the MDMS API, filtering by tenantId and moduleName.
Usage Example:
Field Explanations:
tenantId: ID of the tenant (city, state, or organisation).
moduleName: Always set to "HCM" for this configuration.
enableApprovalAnyTime: Boolean to allow payment approval anytime (true) or restrict to campaign end (
HCM Module Integration:
The payments configuration should be referenced by the HCM module for all payment and approval flows.
false: Approvals allowed only after campaign end/validation.
Boundary Level Selection:
lowestLevelBoundary specifies the lowest administrative level (e.g., DISTRICT, BLOCK) available in the boundary dropdown during payment operations, enhancing localisation and control.
Environment Promotion:
Promote the configuration through your standard DevOps process (dev → staging → prod), ensuring all environments are updated.
Validation:
After deployment, validate via the HCM module UI or API that payment approval and boundary dropdowns behave as configured.
When a user initiates a payment approval, the system checks enableApprovalAnyTime and the current campaign status.
The boundary dropdown in payment forms is populated up to the specified lowestLevelBoundary.
falselowestLevelBoundary: Sets the lowest selectable boundary type in the UI (e.g., "DISTRICT", "BLOCK").
HCM
paymentsConfig
UI Configs
HCM
WORKER_RATES
Rate Master Configs
common-masters
MusterRoll
Muster Roll and Attendance Configs
{
"tenantId": "{{tenantId}}",
"moduleName": "HCM",
"paymentsConfig": [
{
"tenantId": "{{tenantId}}",
"enableApprovalAnyTime": "{{boolean}}", // e.g., true - Allows approval at any time. To restrict approval to only validate through the campaign endDate, set to false.
"lowestLevelBoundary": "{{boundaryType}}" // e.g., "DISTRICT" - Specifies the lowest-level dropdown option in boundary selection
}
]
}