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

import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.erp.api.finance.dto.ErpFinanceMonthlyStatisticsRespDTO;

import java.time.LocalDateTime;
import java.util.List;

/**
 * ERP 财务统计 API 接口
 *
 * 供财务模块（yudao-module-finance）的财务报表 / 会计核算看板取数使用，
 * 避免跨模块直接查 erp 的库表
 *
 * @author 超级管理员
 */
public interface ErpFinanceStatisticsApi {

    /**
     * 按月统计 ERP 的收款、付款、销售订单、采购订单金额
     *
     * 统计口径：只统计已审核（status = 20）的单据，已作废、审批中、草稿的单据不计入
     *
     * @param startTime 开始时间（含）
     * @param endTime   结束时间（不含）
     * @return 按月统计结果，按月份升序；没有数据的月份不会返回
     */
    CommonResult<List<ErpFinanceMonthlyStatisticsRespDTO>> getMonthlyStatistics(LocalDateTime startTime,
                                                                               LocalDateTime endTime);

}