expense_api.dart 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461
  1. import 'dart:convert';
  2. import 'dart:typed_data';
  3. import 'package:dio/dio.dart';
  4. import 'package:flutter_riverpod/flutter_riverpod.dart';
  5. import '../../core/network/api_client.dart';
  6. import '../../core/network/api_response.dart';
  7. import '../../app.dart';
  8. import '../../shared/models/pagination_model.dart';
  9. import '../../shared/models/bill_attachment.dart';
  10. import '../../core/navigation/host_app_channel.dart';
  11. import '../../core/utils/date_utils.dart' as du;
  12. import 'expense_model.dart';
  13. import 'expense_list_controller.dart';
  14. final expenseApiProvider = Provider<ExpenseApi>(
  15. (ref) => ExpenseApi(ref.read(apiClientProvider)),
  16. );
  17. // ═══ 参考数据模型(API 返回) ═══
  18. class CostTypeItem {
  19. final String typeNo;
  20. final String typeName;
  21. final String accNo;
  22. final String accName;
  23. const CostTypeItem({required this.typeNo, required this.typeName, required this.accNo, required this.accName});
  24. factory CostTypeItem.fromJson(Map<String, dynamic> json) => CostTypeItem(
  25. typeNo: json['typeNo'] as String? ?? '',
  26. typeName: json['typeName'] as String? ?? '',
  27. accNo: json['accNo'] as String? ?? '',
  28. accName: json['accName'] as String? ?? '',
  29. );
  30. }
  31. class ProjectCodeItem {
  32. final String objNo;
  33. final String name;
  34. const ProjectCodeItem({required this.objNo, required this.name});
  35. factory ProjectCodeItem.fromJson(Map<String, dynamic> json) => ProjectCodeItem(
  36. objNo: json['objNo'] as String? ?? '',
  37. name: json['name'] as String? ?? '',
  38. );
  39. }
  40. class DepartmentItem {
  41. final String dep;
  42. final String name;
  43. const DepartmentItem({required this.dep, required this.name});
  44. factory DepartmentItem.fromJson(Map<String, dynamic> json) => DepartmentItem(
  45. dep: json['dep'] as String? ?? '',
  46. name: json['name'] as String? ?? '',
  47. );
  48. }
  49. class CustomerItem {
  50. final String cusNo;
  51. final String name;
  52. const CustomerItem({required this.cusNo, required this.name});
  53. factory CustomerItem.fromJson(Map<String, dynamic> json) => CustomerItem(
  54. cusNo: json['cusNo'] as String? ?? '',
  55. name: json['name'] as String? ?? '',
  56. );
  57. }
  58. class CurrencyItem {
  59. final String curId;
  60. final String name;
  61. const CurrencyItem({required this.curId, required this.name});
  62. factory CurrencyItem.fromJson(Map<String, dynamic> json) => CurrencyItem(
  63. curId: json['curId'] as String? ?? '',
  64. name: json['name'] as String? ?? '',
  65. );
  66. }
  67. class EmployeeItem {
  68. final String salNo;
  69. final String name;
  70. final String dep;
  71. final String tel;
  72. final String email;
  73. final String bnkNo;
  74. final String bnkId;
  75. final String accName;
  76. const EmployeeItem({required this.salNo, required this.name, this.dep = '', this.tel = '', this.email = '', this.bnkNo = '', this.bnkId = '', this.accName = ''});
  77. factory EmployeeItem.fromJson(Map<String, dynamic> json) => EmployeeItem(
  78. salNo: json['salNo'] as String? ?? '',
  79. name: json['name'] as String? ?? '',
  80. dep: json['dep'] as String? ?? '',
  81. tel: json['tel'] as String? ?? '',
  82. email: json['email'] as String? ?? '',
  83. bnkNo: json['bnkNo'] as String? ?? '',
  84. bnkId: json['bnkId'] as String? ?? '',
  85. accName: json['accName'] as String? ?? '',
  86. );
  87. }
  88. class ExpenseApi {
  89. final ApiClient _client;
  90. ExpenseApi(this._client);
  91. /// 费用报销列表(分页)
  92. Future<PaginatedData<ExpenseModel>> fetchList({
  93. String status = '',
  94. String keyword = '',
  95. String startDate = '',
  96. String endDate = '',
  97. String usr = '',
  98. String sortDir = 'DESC',
  99. int page = 1,
  100. int size = 20,
  101. }) async {
  102. final response = await _client.get<Map<String, dynamic>>(
  103. '/OA/GetExpenseReports',
  104. queryParameters: {
  105. 'status': status,
  106. 'keyword': keyword,
  107. 'startDate': startDate,
  108. 'endDate': endDate,
  109. 'usr': usr,
  110. 'sortDir': sortDir,
  111. 'page': page,
  112. 'size': size,
  113. },
  114. );
  115. return PaginatedData.fromJson(response.data!, ExpenseModel.fromJson);
  116. }
  117. /// 费用报销详情(主表+明细)
  118. Future<ExpenseModel> fetchDetail(String billNo) async {
  119. final response = await _client.get<Map<String, dynamic>>(
  120. '/OA/GetExpenseReportDetail',
  121. queryParameters: {'billNo': billNo},
  122. );
  123. return ExpenseModel.fromJson(response.data!);
  124. }
  125. /// 提交审批,返回报销单号(提取失败时返回 null,不影响主流程)
  126. /// BillSave 返回格式: { callok:true, resultData:{ BIL_NO:"BX20267020005", ... } }
  127. Future<String?> submit(Map<String, dynamic> data) async {
  128. final response = await _client.post<Map<String, dynamic>>('/OA/BillSave', data: {
  129. 'erpCategory': 'MasterService',
  130. 'billId': 'BX',
  131. 'procId': '',
  132. 'data': data,
  133. });
  134. final resData = response.data;
  135. if (resData == null) return null;
  136. final resultData = resData['resultData'];
  137. if (resultData is Map<String, dynamic>) {
  138. final bilNo = resultData['BIL_NO'] as String?;
  139. if (bilNo != null && bilNo.isNotEmpty) return bilNo;
  140. }
  141. if (resultData is String && resultData.isNotEmpty) {
  142. try {
  143. final parsed = json.decode(resultData) as Map<String, dynamic>;
  144. final bilNo = parsed['BIL_NO'] as String?;
  145. if (bilNo != null && bilNo.isNotEmpty) return bilNo;
  146. } catch (_) {}
  147. }
  148. final rootBilNo = resData['BIL_NO'] as String?;
  149. if (rootBilNo != null && rootBilNo.isNotEmpty) return rootBilNo;
  150. return null;
  151. }
  152. /// 下载附件文件字节
  153. Future<Uint8List?> downloadAttachment(String id) async {
  154. return await _client.downloadFile('/OA/DownloadAttachment', queryParameters: {'id': id});
  155. }
  156. /// 检测附件服务是否可用
  157. Future<bool> checkAttachHealth() async {
  158. try {
  159. final response = await _client.get<Map<String, dynamic>>('/OA/CheckAttachHealth');
  160. return response.data?['available'] as bool? ?? false;
  161. } catch (_) {
  162. return false;
  163. }
  164. }
  165. /// 财务核销
  166. Future<void> verify(Map<String, dynamic> data) async {
  167. await _client.post('/OA/ExpenseVerify', data: data);
  168. }
  169. /// 费用类别字典
  170. Future<List<CostTypeItem>> getCostTypes({String keyword = '', String accNo = ''}) async {
  171. final response = await _client.get<Map<String, dynamic>>(
  172. '/OA/GetCostTypes',
  173. queryParameters: {'keyword': keyword, 'accNo': accNo, 'page': 1, 'size': 100},
  174. );
  175. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  176. return list.map((e) => CostTypeItem.fromJson(e as Map<String, dynamic>)).toList();
  177. }
  178. /// 项目代号
  179. Future<List<ProjectCodeItem>> getProjectCodes({String keyword = '', String billDate = ''}) async {
  180. final response = await _client.get<Map<String, dynamic>>(
  181. '/OA/GetProjectCodes',
  182. queryParameters: {'keyword': keyword, 'billDate': billDate, 'page': 1, 'size': 100},
  183. );
  184. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  185. return list.map((e) => ProjectCodeItem.fromJson(e as Map<String, dynamic>)).toList();
  186. }
  187. /// 部门
  188. Future<List<DepartmentItem>> getDepartments({String keyword = '', bool onlyActive = true}) async {
  189. final response = await _client.get<Map<String, dynamic>>(
  190. '/OA/GetDepartments',
  191. queryParameters: {'keyword': keyword, 'onlyActive': onlyActive, 'page': 1, 'size': 100},
  192. );
  193. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  194. return list.map((e) => DepartmentItem.fromJson(e as Map<String, dynamic>)).toList();
  195. }
  196. /// 客户/厂商
  197. Future<List<CustomerItem>> getCustomers({String keyword = ''}) async {
  198. final response = await _client.get<Map<String, dynamic>>(
  199. '/OA/GetCustomers',
  200. queryParameters: {'keyword': keyword, 'page': 1, 'size': 100},
  201. );
  202. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  203. return list.map((e) => CustomerItem.fromJson(e as Map<String, dynamic>)).toList();
  204. }
  205. /// 员工查询
  206. Future<List<EmployeeItem>> getEmployees({String keyword = '', String salNo = ''}) async {
  207. final response = await _client.get<Map<String, dynamic>>(
  208. '/OA/GetEmployees',
  209. queryParameters: {'keyword': keyword, 'salNo': salNo, 'page': 1, 'size': 100},
  210. );
  211. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  212. return list.map((e) => EmployeeItem.fromJson(e as Map<String, dynamic>)).toList();
  213. }
  214. /// 可转入报销单的费用申请明细(keyword 模糊匹配单号/事由/部门/申请人/费用类型)
  215. Future<Map<String, dynamic>> getImportableExpenseApplies({
  216. String keyword = '', String startDate = '', String endDate = '', int page = 1, int size = 20, String sortDir = 'DESC',
  217. }) async {
  218. final response = await _client.get<Map<String, dynamic>>(
  219. '/OA/GetImportableExpenseApplies',
  220. queryParameters: {'keyword': keyword, 'startDate': startDate, 'endDate': endDate, 'page': page, 'size': size, 'sortDir': sortDir},
  221. );
  222. return response.data!;
  223. }
  224. /// 币别
  225. Future<List<CurrencyItem>> getCurrencies({String keyword = ''}) async {
  226. final response = await _client.get<Map<String, dynamic>>(
  227. '/OA/GetCurrencies',
  228. queryParameters: {'keyword': keyword, 'page': 1, 'size': 50},
  229. );
  230. final list = (response.data?['list'] as List<dynamic>?) ?? [];
  231. return list.map((e) => CurrencyItem.fromJson(e as Map<String, dynamic>)).toList();
  232. }
  233. /// 币别查询(旧版,保留兼容)
  234. Future<ApiResponse<Map<String, dynamic>>> fetchCurrencies({
  235. String keyword = '',
  236. int page = 1,
  237. int size = 50,
  238. }) async {
  239. return await _client.get('/OA/GetCurrencies',
  240. queryParameters: {'keyword': keyword, 'page': page, 'size': size});
  241. }
  242. /// 审批列表
  243. Future<Map<String, dynamic>> fetchApprovalList({
  244. required String bilId,
  245. required String status,
  246. String erpCategory = 'MasterService',
  247. String keyword = '',
  248. String startDate = '',
  249. String endDate = '',
  250. int page = 1,
  251. int size = 20,
  252. }) async {
  253. final response = await _client.get<Map<String, dynamic>>(
  254. '/OA/GetApprovalList',
  255. queryParameters: {
  256. 'bilId': bilId,
  257. 'status': status,
  258. 'erpCategory': erpCategory,
  259. 'keyword': keyword,
  260. 'startDate': startDate,
  261. 'endDate': endDate,
  262. 'page': page,
  263. 'size': size,
  264. },
  265. );
  266. return response.data!;
  267. }
  268. /// 审批进度
  269. Future<Map<String, dynamic>> fetchApprovalTimeline(String bilId, String bilNo, {int bilItm = 0}) async {
  270. final response = await _client.get<Map<String, dynamic>>(
  271. '/OA/GetApprovalTimeline',
  272. queryParameters: {'bilId': bilId, 'bilNo': bilNo, 'bilItm': bilItm},
  273. );
  274. return response.data!;
  275. }
  276. /// 获取单据附件列表
  277. Future<List<BillAttachment>> getAttachments(String bilId, String bilNo, {int? srcItm}) async {
  278. final params = <String, dynamic>{
  279. 'bilId': bilId,
  280. 'bilNo': bilNo,
  281. };
  282. if (srcItm != null) params['srcItm'] = srcItm;
  283. final response = await _client.get<dynamic>(
  284. '/OA/GetAttachments',
  285. queryParameters: params,
  286. );
  287. final body = response.data;
  288. if (body is! Map) return [];
  289. final result = body['Result'];
  290. if (result is! Map) return [];
  291. final documents = result['documents'];
  292. if (documents is! List) return [];
  293. return documents
  294. .whereType<Map<String, dynamic>>()
  295. .map((e) => BillAttachment.fromJson(e))
  296. .toList();
  297. }
  298. /// 上传附件
  299. /// [metadata] Map: { BIL_ID, BIL_NO, SRCITM, ITM, TAG, EFF_DD, USR, FILENAME, EXT }
  300. Future<Map<String, dynamic>> uploadAttachment(
  301. String filePath,
  302. Map<String, dynamic> metadata,
  303. ) async {
  304. final fileName = (metadata['FILENAME'] as String?) ?? filePath.split('/').last;
  305. final response = await _client.uploadMultipart<Map<String, dynamic>>(
  306. '/OA/UploadAttachment',
  307. files: [await MultipartFile.fromFile(filePath, filename: fileName)],
  308. extraFields: {'metadata': json.encode(metadata)}, // proper JSON encoding
  309. );
  310. return response.data ?? {};
  311. }
  312. /// 审核执行(通过/驳回/反审核)
  313. Future<Map<String, dynamic>> executeApproval({
  314. required String bilId, required String bilNo, int bilItm = 0,
  315. required String action, String rem = '', String effDd = '',
  316. String reason = '', bool isPreToStart = false, int nodeIndex = -1,
  317. String dataBx = '',
  318. }) async {
  319. final response = await _client.post<Map<String, dynamic>>(
  320. '/OA/ExecuteApproval',
  321. data: {
  322. 'bilId': bilId, 'bilNo': bilNo, 'bilItm': bilItm,
  323. 'action': action, 'rem': rem, 'effDd': effDd,
  324. 'reason': reason, 'isPreToStart': isPreToStart,
  325. 'nodeIndex': nodeIndex, 'dataBx': dataBx,
  326. },
  327. );
  328. return response.data!;
  329. }
  330. }
  331. /// 费用报销审批列表项
  332. class ExpenseApprovalListItem {
  333. final String bilId;
  334. final String bilNo;
  335. final String bilDate;
  336. final String applicant;
  337. final String dept;
  338. final double amount;
  339. final String remark;
  340. final String status;
  341. const ExpenseApprovalListItem({
  342. required this.bilId,
  343. required this.bilNo,
  344. required this.bilDate,
  345. required this.applicant,
  346. required this.dept,
  347. required this.amount,
  348. required this.remark,
  349. required this.status,
  350. });
  351. factory ExpenseApprovalListItem.fromJson(Map<String, dynamic> json) =>
  352. ExpenseApprovalListItem(
  353. bilId: json['bilId'] as String? ?? '',
  354. bilNo: json['bilNo'] as String? ?? '',
  355. bilDate: json['bilDate'] as String? ?? '',
  356. applicant: json['applicant'] as String? ?? '',
  357. dept: json['dept'] as String? ?? '',
  358. amount: (json['amount'] as num?)?.toDouble() ?? 0,
  359. remark: json['remark'] as String? ?? '',
  360. status: json['status'] as String? ?? 'pending',
  361. );
  362. ExpenseModel toExpenseModel() => ExpenseModel(
  363. id: bilNo,
  364. expenseNo: bilNo,
  365. expenseDate:
  366. bilDate.isNotEmpty ? DateTime.tryParse(bilDate) : null,
  367. applicantId: applicant,
  368. applicantName: applicant,
  369. deptId: dept,
  370. deptName: dept,
  371. totalAmount: amount,
  372. purpose: remark,
  373. status: status == 'approved' ? 'approved' : 'pending',
  374. paymentStatus: 'unpaid',
  375. createTime: DateTime.now(),
  376. updateTime: DateTime.now(),
  377. );
  378. }
  379. final expenseApprovalListProvider =
  380. FutureProvider.autoDispose.family<List<ExpenseModel>, String>(
  381. (ref, status) async {
  382. ref.watch(expenseRefreshProvider);
  383. ref.watch(expenseDateStartProvider);
  384. ref.watch(expenseDateEndProvider);
  385. ref.watch(expenseKeywordProvider);
  386. final api = ref.read(expenseApiProvider);
  387. final dateStart = ref.read(expenseDateStartProvider);
  388. final dateEnd = ref.read(expenseDateEndProvider);
  389. final keyword = ref.read(expenseKeywordProvider);
  390. final response = await api.fetchApprovalList(
  391. bilId: 'BX',
  392. keyword: keyword,
  393. status: status.isEmpty ? '' : status,
  394. startDate: dateStart != null ? du.DateUtils.formatDate(dateStart) : '',
  395. endDate: dateEnd != null ? du.DateUtils.formatDate(dateEnd) : '',
  396. );
  397. return (response['list'] as List<dynamic>?)?.map((e) => ExpenseApprovalListItem.fromJson(e as Map<String, dynamic>).toExpenseModel()).toList() ?? [];
  398. },
  399. );
  400. /// "我的报销单" 列表(制单人=当前用户,非审批流)
  401. final expenseMyListProvider =
  402. FutureProvider.autoDispose.family<List<ExpenseModel>, String>(
  403. (ref, status) async {
  404. ref.watch(expenseRefreshProvider);
  405. ref.watch(expenseDateStartProvider);
  406. ref.watch(expenseDateEndProvider);
  407. ref.watch(expenseKeywordProvider);
  408. final api = ref.read(expenseApiProvider);
  409. final dateStart = ref.read(expenseDateStartProvider);
  410. final dateEnd = ref.read(expenseDateEndProvider);
  411. final keyword = ref.read(expenseKeywordProvider);
  412. final result = await api.fetchList(
  413. keyword: keyword,
  414. startDate: dateStart != null ? du.DateUtils.formatDate(dateStart) : '',
  415. endDate: dateEnd != null ? du.DateUtils.formatDate(dateEnd) : '',
  416. usr: HostAppChannel.usr,
  417. sortDir: ref.watch(expenseSortDirProvider),
  418. );
  419. return result.list;
  420. },
  421. );