package cn.iocoder.yudao.module.finance.api.reimbursement;

import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.finance.api.reimbursement.dto.FinanceReimbursementCreateReqDTO;
import cn.iocoder.yudao.module.finance.api.reimbursement.dto.FinanceReimbursementRespDTO;
import cn.iocoder.yudao.module.finance.api.reimbursement.dto.FinanceReimbursementUpdateReqDTO;

/**
 * 财务报销单 API 接口
 *
 * 供其他模块（如课题管理经费拨付）创建并自动提交报销审批，以及修改后重新发起、删除、查询报销单。
 *
 * @author 超级管理员
 */
public interface FinanceReimbursementApi {

    String PREFIX = "/rpc-api/finance/reimbursement";

    /**
     * 创建报销单并立即提交审批（系统自动生成 1 行明细）
     *
     * @param reqDTO 报销单信息
     * @return 报销单编号
     */
    CommonResult<Long> createReimbursementAndSubmit(FinanceReimbursementCreateReqDTO reqDTO);

    /**
     * 修改报销单并重新提交审批（用于报销被驳回后重新发起）
     *
     * @param reqDTO 报销单信息（含报销单编号）
     * @return 是否成功
     */
    CommonResult<Boolean> updateReimbursementAndResubmit(FinanceReimbursementUpdateReqDTO reqDTO);

    /**
     * 删除报销单（只有草稿或已驳回状态才能删除）
     *
     * @param reimbursementId 报销单编号
     * @return 是否成功
     */
    CommonResult<Boolean> deleteReimbursement(Long reimbursementId);

    /**
     * 获取报销单
     *
     * @param reimbursementId 报销单编号
     * @return 报销单
     */
    CommonResult<FinanceReimbursementRespDTO> getReimbursement(Long reimbursementId);

}