001package org.kuali.coeus.common.budget.api.personnel;
002
003import org.kuali.coeus.sys.api.model.ScaleTwoDecimal;
004
005public interface BudgetPersonSalaryService {
006
007    /**
008     * Finds the base salary for the first Budget Period.  The Budget Period are retrieved by
009     * budgetId, personId, and budgetPeriod.  The personId can either be a personId or rolodexId.
010     *
011     * @param budgetId The budget Id. cannot be null.
012     * @param personId The personId or rolodexId.  Cannot be blank.
013     * @param budgetPeriod the budget period. Cannot be null.
014     * @return the base salary of null if no matching periods exist.
015     * @throws java.lang.IllegalArgumentException if budgetId is null, if personId is blank, if budgetPeriod is null
016     */
017    ScaleTwoDecimal findBaseSalaryForFirstPeriod(Long budgetId, String personId, Integer budgetPeriod);
018}