weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/invoice/operations/reim-auto.js

@@ -0,0 +1,719 @@
+import { invoiceValidationError } from '../errors.js';
+import { quoteEmployeeIdsInJsonText } from './reim.js';
+import { asNonEmptyString, assertBusinessSuccess, objectFingerprint, optionalEpochSeconds, reqBase, workflow, } from './shared.js';
+/** 总部费用报销流程（实测 2026-09-14/09-21 两次 apply 成功的固化映射）。 */
+export const REIM_TEMPLATE_WORKFLOW_ID = '100003460000000060';
+/** 上述流程的显示名，用于预览时把工作流 ID 渲染成「中文(id)」。 */
+export const REIM_TEMPLATE_WORKFLOW_NAME = '总部费用报销';
+/** 费用类型（科目）默认值：日常消费。 */
+const DEFAULT_SUBJECT_ID = '1256664958132969489';
+/** 币种：人民币。 */
+const CNY_ID = '100001050000000001';
+/** 报销方式选项：银行（个人报销）。 */
+const BANK_OPTION_VALUE = '7';
+/** 明细表「相关发票」字段，用作费用明细子表的结构签名。 */
+const DETAIL_INVOICE_FIELD_ID = '100003720000077896';
+/** 明细表「费用类型（科目）」「币种」字段 ID，用于给明细行渲染中文名。 */
+const DETAIL_SUBJECT_FIELD_ID = '100003720000000360';
+const DETAIL_CURRENCY_FIELD_ID = '100003720000052200';
+/** 主表「报销方式」「相关客户」「合同号」字段 ID。 */
+const MAIN_METHOD_FIELD_ID = '100003720000000084';
+const MAIN_CUSTOMER_FIELD_ID = '100003720000000687';
+const MAIN_CONTRACT_FIELD_ID = '100003720000001376';
+/**
+ * 模板固化映射自带的字典值兜底显示名。
+ * `row-info`/`superiors` 等实时接口取到名字时优先用实时值，这里只兜实时值缺失的情况。
+ * 这些值与 `REIM_TEMPLATE_WORKFLOW_ID` 一样是「总部费用报销」模板的固化口径，不是通用字典。
+ */
+const TEMPLATE_SELECT_OPTIONS = {
+    [MAIN_METHOD_FIELD_ID]: {
+        '7': '银行（个人报销）',
+        '4': '冲销借款',
+        '6': '银行（付公司）',
+    },
+};
+const TEMPLATE_SUBJECT_NAMES = { [DEFAULT_SUBJECT_ID]: '日常消费' };
+const TEMPLATE_CURRENCY_NAMES = { [CNY_ID]: '人民币' };
+/** 非出差场景固定使用的相关客户（见 skill 文档 Step 4.5），仅作名称兜底。 */
+const TEMPLATE_CUSTOMER_NAMES = { '100504500000311504': '泛微上海' };
+const MONEY_PATTERN = /^-?\d+(?:\.\d{1,2})?$/u;
+function boundedInteger(value, name, options) {
+    const parsed = value === undefined ? options.defaultValue : Number(value);
+    if (!Number.isInteger(parsed) || parsed < options.min || parsed > options.max) {
+        throw invoiceValidationError('input_invalid', `${name} 必须是 ${options.min}-${options.max} 的整数`);
+    }
+    return parsed;
+}
+function optionalString(value, name, maxLength = 500) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const text = asNonEmptyString(value, name);
+    if (text.length > maxLength)
+        throw invoiceValidationError('input_invalid', `${name} 长度不能超过 ${maxLength}`);
+    return text;
+}
+function toCents(value) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    const match = MONEY_PATTERN.exec(String(value));
+    if (!match)
+        return null;
+    const negative = match[0].startsWith('-');
+    const [whole, fraction = ''] = match[0].replace('-', '').split('.');
+    return (Number(whole) * 100 + Number(fraction.padEnd(2, '0'))) * (negative ? -1 : 1);
+}
+function centsToMoney(cents) {
+    const sign = cents < 0 ? '-' : '';
+    const absolute = Math.abs(cents);
+    const whole = Math.floor(absolute / 100);
+    const fraction = absolute % 100;
+    return `${sign}${whole}.${String(fraction).padStart(2, '0')}`;
+}
+function sumMoney(values) {
+    let sum = 0;
+    let invalid = 0;
+    for (const value of values) {
+        const cents = toCents(value);
+        if (cents === null) {
+            invalid += 1;
+            continue;
+        }
+        sum += cents;
+    }
+    return { amount: centsToMoney(sum), invalid };
+}
+function todayInShanghai() {
+    return new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai' }).format(new Date());
+}
+function invoiceRecordId(info) {
+    const raw = info.fid ?? info.id;
+    return raw === undefined || raw === null ? '' : String(raw);
+}
+function cleanFysm(value) {
+    return String(value ?? '').replace(/\*/g, '').trim();
+}
+function reimRequestNames(info) {
+    const entries = info?.oreim?.list_reim;
+    if (!Array.isArray(entries))
+        return [];
+    return entries
+        .map((entry) => (typeof entry?.name === 'string' ? entry.name : ''))
+        .filter((name) => name.trim());
+}
+function candidateItem(info) {
+    const pro = info?.comm_info?.pro || {};
+    const price = info?.comm_info?.price || {};
+    return {
+        fid: invoiceRecordId(info),
+        number: String(info.number ?? ''),
+        date: String(pro.date ?? ''),
+        total: String(price.total ?? ''),
+        buyer: String(info?.comm_info?.buyer?.company ?? ''),
+        payer: String(info?.comm_info?.payer?.company ?? ''),
+        typeName: String(pro.cname ?? ''),
+        status: typeof pro.status === 'number' ? pro.status : Number(pro.status ?? 0),
+        valid: typeof pro.valid === 'number' ? pro.valid : Number(pro.valid ?? 0),
+        reimRequests: reimRequestNames(info),
+    };
+}
+/** 全额红冲发票的票面状态值。 */
+const RED_REVERSED_STATUS = 8;
+/** 判断发票是否为全额红冲（`comm_info.pro.status === 8`）。 */
+function isRedReversedInvoice(info) {
+    const raw = info?.comm_info?.pro?.status;
+    const status = typeof raw === 'number' ? raw : Number(raw ?? 0);
+    return status === RED_REVERSED_STATUS;
+}
+async function mapWithConcurrency(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (cursor < items.length) {
+            const index = cursor;
+            cursor += 1;
+            results[index] = await fn(items[index], index);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+function optionalName(value) {
+    const text = value === undefined || value === null ? '' : String(value).trim();
+    return text || undefined;
+}
+async function fetchSuperiors(host, warnings) {
+    const value = await host.invoiceRequest({
+        path: '/api/inc/book/getEmployeeSuperiors',
+        method: 'GET',
+        rewriteJsonText: quoteEmployeeIdsInJsonText,
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'reim_superiors_failed', '获取人员上级失败');
+    const data = (value?.data && typeof value.data === 'object' ? value.data : value);
+    const currentEmployeeId = String(data?.currentEmployee?.id ?? '');
+    if (!currentEmployeeId)
+        throw invoiceValidationError('superiors_invalid', '未取得当前人员 ID，无法组装报销单');
+    const directId = data?.directSuperior?.id === undefined || data?.directSuperior?.id === null ? undefined : String(data.directSuperior.id);
+    if (!directId)
+        warnings.push('接口未返回 directSuperior（直属上级），报销人上级/承担人直接上级字段留空，需在确认时补充');
+    const allSuperiorIds = Array.isArray(data?.allSuperiors)
+        ? data.allSuperiors.map((item) => String(item?.id ?? '')).filter((id) => id)
+        : [];
+    if (!allSuperiorIds.length)
+        warnings.push('接口未返回 allSuperiors，承担人所有上级字段留空');
+    const allSuperiorNames = Array.isArray(data?.allSuperiors)
+        ? data.allSuperiors.map((item) => optionalName(item?.name) ?? '').filter((name) => name)
+        : [];
+    return {
+        currentEmployeeId,
+        currentEmployeeName: optionalName(data?.currentEmployee?.name),
+        directSuperiorId: directId,
+        directSuperiorName: optionalName(data?.directSuperior?.name),
+        allSuperiorIds,
+        allSuperiorNames,
+    };
+}
+async function resolveWorkflowId(host, input) {
+    if (input.workflowId !== undefined) {
+        const id = asNonEmptyString(input.workflowId, 'workflowId');
+        return { id, name: id === REIM_TEMPLATE_WORKFLOW_ID ? REIM_TEMPLATE_WORKFLOW_NAME : undefined };
+    }
+    const value = await host.invoiceRequest({
+        path: '/api/inc/book/getReimburseWorkflowByRequestIds',
+        method: 'POST',
+        body: { requestIds: [] },
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'reim_workflow_resolve_failed', '解析候选报销流程失败');
+    const data = (value?.data && typeof value.data === 'object' ? value.data : value);
+    const candidates = Array.isArray(data?.candidateWorkflows) ? data.candidateWorkflows : [];
+    if (candidates.length === 0)
+        throw invoiceValidationError('workflow_unresolved', '没有可用的候选报销流程');
+    if (candidates.length > 1) {
+        const names = candidates.map((item) => `${item?.workFlowName ?? ''}(${item?.workFlowId ?? ''})`).join('、');
+        throw invoiceValidationError('input_ambiguous', `候选报销流程多于一个，请显式传入 workflowId：${names}`);
+    }
+    const id = String(candidates[0].workFlowId);
+    const name = optionalName(candidates[0].workFlowName)
+        ?? (id === REIM_TEMPLATE_WORKFLOW_ID ? REIM_TEMPLATE_WORKFLOW_NAME : undefined);
+    return { id, name };
+}
+/** 按名称在指定字段的可选项里反查 ID（`fieldRelateSearch` 只支持名称模糊匹配，不支持按 ID 反查）。 */
+async function searchFieldOptionId(host, workflowId, fieldId, name) {
+    const value = await host.invoiceRequest({
+        path: '/api/government/formStructure/fieldRelateSearch',
+        method: 'GET',
+        query: { keywords: name, fieldId, formModeType: 'wf', workflowId, nodeId: '100004140000000271' },
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'reim_field_search_failed', `按名称「${name}」搜索字段可选项失败`);
+    const items = Array.isArray(value?.data) ? value.data : [];
+    const ids = Array.from(new Set(items.map((item) => String(item?.id ?? '')).filter((id) => Boolean(id))));
+    if (!ids.length)
+        throw invoiceValidationError('related_customer_unresolved', `按名称「${name}」没有搜索到相关客户，请改用 relatedCustomerId`);
+    if (ids.length > 1) {
+        const names = items.map((item) => `${item?.name ?? ''}(${item?.id ?? ''})`).join('、');
+        throw invoiceValidationError('input_ambiguous', `名称「${name}」匹配到多个相关客户，请改用 relatedCustomerId：${names}`);
+    }
+    return ids[0];
+}
+function collectSelectOptions(raw) {
+    const collected = {};
+    const fields = Array.isArray(raw) ? raw : [];
+    for (const field of fields) {
+        const fieldId = String(field?.fieldId ?? '');
+        const options = field?.options;
+        if (!fieldId || !Array.isArray(options) || !options.length)
+            continue;
+        const map = {};
+        for (const option of options) {
+            const optionValue = option?.optionValue === undefined || option?.optionValue === null ? '' : String(option.optionValue);
+            const optionName = optionalName(option?.optionName);
+            if (optionValue && optionName)
+                map[optionValue] = optionName;
+        }
+        if (Object.keys(map).length)
+            collected[fieldId] = map;
+    }
+    return collected;
+}
+async function fetchStructure(host, workflowId) {
+    const value = await host.invoiceRequest({
+        path: '/api/inc/book/getFormStructure',
+        method: 'GET',
+        query: { workflowId, nodeId: '1' },
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'reim_structure_failed', '获取报销表单结构失败');
+    const data = (value?.data && typeof value.data === 'object' ? value.data : value);
+    const mainFormId = String(data?.mainFormId ?? '');
+    if (!mainFormId)
+        throw invoiceValidationError('structure_invalid', '表单结构缺少 mainFormId');
+    const subTables = Array.isArray(data?.subTables) ? data.subTables : [];
+    const byName = subTables.find((table) => String(table?.subFormName ?? '').includes('费用明细'));
+    const bySignature = subTables.find((table) => Array.isArray(table?.subFields)
+        && table.subFields.some((field) => String(field?.fieldId ?? '') === DETAIL_INVOICE_FIELD_ID));
+    const target = byName || bySignature;
+    if (!target) {
+        const names = subTables.map((table) => String(table?.subFormName ?? '')).filter(Boolean).join('、');
+        throw invoiceValidationError('structure_invalid', `表单结构中没有可识别的费用明细子表（现有子表：${names || '无'}）`);
+    }
+    const selectOptions = {
+        ...TEMPLATE_SELECT_OPTIONS,
+        ...collectSelectOptions(data?.mainFields),
+    };
+    for (const table of subTables) {
+        Object.assign(selectOptions, collectSelectOptions(table?.subFields));
+    }
+    return {
+        mainFormId,
+        detailSubFormId: String(target.subFormId),
+        detailSubFormName: String(target.subFormName ?? ''),
+        selectOptions,
+    };
+}
+async function fetchInvoiceInfos(host, invoiceIds) {
+    const value = await host.invoiceRequest({
+        path: '/api/inc/get',
+        method: 'POST',
+        body: { ids: invoiceIds, mask: 0, userFlag: '1', isDelFlag: '1', req_base: reqBase() },
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'invoice_detail_failed', '获取发票详情失败');
+    const infos = Array.isArray(value?.infos) ? value.infos : [];
+    const byId = new Map();
+    for (const entry of infos) {
+        if (entry?.ret?.ret !== 0 || !entry.info)
+            continue;
+        byId.set(invoiceRecordId(entry.info), entry.info);
+    }
+    const missing = invoiceIds.filter((id) => !byId.has(id));
+    if (missing.length) {
+        throw invoiceValidationError('invoice_not_found', `以下发票未找到或无权查看：${missing.join('、')}`);
+    }
+    return byId;
+}
+async function fetchRowInfo(host, userId, invoiceId) {
+    const value = await host.invoiceFormRequest({
+        path: '/api/secondev/fna/expense/dataInfo/getRowInfo',
+        method: 'POST',
+        query: { sf_request_type: 'fetch' },
+        fields: { cdzt: userId, requestid: '', invoiceId },
+        operation: 'invoice.reim.template.build',
+    });
+    assertBusinessSuccess(value, 'reim_row_info_failed', `获取发票 ${invoiceId} 行预填失败`);
+    return (value?.data && typeof value.data === 'object' ? value.data : value);
+}
+function detailField(fieldId, fieldName, value) {
+    return { fieldId, fieldName, value };
+}
+function mainField(fieldId, fieldName, value, optionValue) {
+    return optionValue !== undefined
+        ? { fieldId, fieldName, optionValue }
+        : { fieldId, fieldName, value };
+}
+/** 把单个 ID 渲染成「中文(id)」；没有中文名时原样返回 ID，绝不编造。 */
+function renderIdWithName(id, names) {
+    const text = id === undefined || id === null ? '' : String(id).trim();
+    if (!text)
+        return '';
+    const name = names[text];
+    return name ? `${name}(${text})` : text;
+}
+/** 渲染逗号分隔的 ID 串（如「承担人所有上级」），逐项带中文名。 */
+function renderIdList(value, names) {
+    const text = value === undefined || value === null ? '' : String(value);
+    if (!text)
+        return '';
+    const parts = text.split(',').map((part) => part.trim()).filter(Boolean);
+    if (parts.length <= 1)
+        return renderIdWithName(text, names);
+    return parts.map((part) => renderIdWithName(part, names)).join(', ');
+}
+/** 生成主表字段的可读文本，供预览直接展示，避免调用方看到裸 ID。 */
+function renderMainFieldView(field, dictionaries) {
+    if (field.optionValue !== undefined) {
+        const optionValue = String(field.optionValue);
+        const optionName = dictionaries.selectOptions[field.fieldId]?.[optionValue];
+        return {
+            fieldId: field.fieldId,
+            fieldName: field.fieldName,
+            optionValue,
+            text: optionName ? `${optionName}(optionValue=${optionValue})` : `optionValue=${optionValue}`,
+        };
+    }
+    const value = field.value === undefined || field.value === null ? '' : String(field.value);
+    if (dictionaries.employees[value]) {
+        return { fieldId: field.fieldId, fieldName: field.fieldName, value, text: `${dictionaries.employees[value]}(${value})` };
+    }
+    if (dictionaries.customers[value]) {
+        return { fieldId: field.fieldId, fieldName: field.fieldName, value, text: `${dictionaries.customers[value]}(${value})` };
+    }
+    if (value.includes(',') && value.split(',').every((part) => dictionaries.employees[part.trim()])) {
+        return { fieldId: field.fieldId, fieldName: field.fieldName, value, text: renderIdList(value, dictionaries.employees) };
+    }
+    return { fieldId: field.fieldId, fieldName: field.fieldName, value, text: value };
+}
+export async function buildReimCreatePayload(input, host, operationName) {
+    const invoiceIdsRaw = input.invoiceIds;
+    if (invoiceIdsRaw === undefined && input.invoiceId !== undefined) {
+        input.invoiceIds = [input.invoiceId];
+    }
+    if (!Array.isArray(input.invoiceIds) || input.invoiceIds.length === 0) {
+        throw invoiceValidationError('input_invalid', 'invoiceIds 必须是非空数组');
+    }
+    if (input.invoiceIds.length > 100)
+        throw invoiceValidationError('input_invalid', 'invoiceIds 单次最多 100 张');
+    const invoiceIds = input.invoiceIds.map((id, index) => {
+        const text = String(id ?? '').trim();
+        if (!/^[1-9]\d*$/.test(text))
+            throw invoiceValidationError('input_invalid', `invoiceIds[${index}] 必须是正整数 ID`);
+        return text;
+    });
+    if (new Set(invoiceIds).size !== invoiceIds.length) {
+        throw invoiceValidationError('input_invalid', 'invoiceIds 不能包含重复 ID');
+    }
+    const requestName = optionalString(input.requestName, 'requestName', 100);
+    if (!requestName)
+        throw invoiceValidationError('input_invalid', 'requestName 必填');
+    const reason = optionalString(input.reason, 'reason');
+    let relatedCustomerId = optionalString(input.relatedCustomerId, 'relatedCustomerId', 32);
+    const relatedCustomerNameInput = optionalString(input.relatedCustomerName, 'relatedCustomerName', 200);
+    const contractNoInput = optionalString(input.contractNo, 'contractNo', 100);
+    const contractNo = contractNoInput ?? '20260999';
+    const warnings = [];
+    const session = await host.getSession();
+    const superiors = await fetchSuperiors(host, warnings);
+    const workflowRef = await resolveWorkflowId(host, input);
+    const workflowId = workflowRef.id;
+    const structure = await fetchStructure(host, workflowId);
+    const invoices = await fetchInvoiceInfos(host, invoiceIds);
+    // 相关客户：只给名称时反查 ID；ID 与名称都给时不额外调接口。
+    if (!relatedCustomerId && relatedCustomerNameInput) {
+        relatedCustomerId = await searchFieldOptionId(host, workflowId, MAIN_CUSTOMER_FIELD_ID, relatedCustomerNameInput);
+    }
+    for (const id of invoiceIds) {
+        const info = invoices.get(id);
+        const number = String(info.number ?? id);
+        const status = Number(info?.comm_info?.pro?.status ?? 0);
+        if (status === 8) {
+            throw invoiceValidationError('invoice_not_reimbursable', `发票 ${number} 已全额红冲（status=8），不能用于报销`);
+        }
+        const assigned = reimRequestNames(info);
+        if (assigned.length) {
+            warnings.push(`发票 ${number} 已挂在报销单：${assigned.join('、')}，继续组装存在重复报销风险`);
+        }
+        if (!MONEY_PATTERN.test(String(info?.comm_info?.price?.total ?? ''))) {
+            throw invoiceValidationError('invoice_total_invalid', `发票 ${number} 的票面金额缺失或格式异常`);
+        }
+    }
+    const rowInfos = await mapWithConcurrency(invoiceIds, 4, async (id, index) => {
+        try {
+            return await fetchRowInfo(host, session.userId, id);
+        }
+        catch (error) {
+            warnings.push(`发票 ${String(invoices.get(id)?.number ?? id)} 行预填获取失败（第 ${index + 1} 行按票面兜底）`);
+            return {};
+        }
+    });
+    // 每行的字典值（费用科目 / 币种 / 说明）来自 row-info 实时返回；取不到中文名时退回模板固化值。
+    const rowMeta = invoiceIds.map((id, index) => {
+        const info = invoices.get(id);
+        const rowInfo = rowInfos[index] || {};
+        const subjectId = String(rowInfo.subjectId || DEFAULT_SUBJECT_ID);
+        const currencyEntry = Array.isArray(rowInfo.bz) ? rowInfo.bz[0] : undefined;
+        const currencyId = String(currencyEntry?.id ?? CNY_ID);
+        return {
+            invoiceId: id,
+            invoiceNumber: String(info?.number ?? ''),
+            subjectId,
+            subjectName: optionalName(rowInfo.subjectName) ?? TEMPLATE_SUBJECT_NAMES[subjectId],
+            currencyId,
+            currencyName: optionalName(currencyEntry?.name) ?? TEMPLATE_CURRENCY_NAMES[currencyId],
+            expenseNote: cleanFysm(rowInfo.fysm),
+        };
+    });
+    const detailRows = invoiceIds.map((id, index) => {
+        const info = invoices.get(id);
+        const rowInfo = rowInfos[index] || {};
+        const pro = info?.comm_info?.pro || {};
+        const total = String(info?.comm_info?.price?.total ?? '');
+        return {
+            dataIndex: index + 1,
+            subFormId: structure.detailSubFormId,
+            invoiceId: id,
+            fields: [
+                detailField('100003720000000419', '费用日期', String(rowInfo.date || pro.date || '')),
+                detailField('100003720000000228', '实报金额', total),
+                detailField('100003720000016373', '申请金额', total),
+                detailField('1211391578999111696', '人民币金额', total),
+                detailField(DETAIL_SUBJECT_FIELD_ID, '费用类型（科目）', rowMeta[index].subjectId),
+                detailField('100003720000000361', '费用说明', cleanFysm(rowInfo.fysm)),
+                detailField('100003720000000362', '附件数', '1'),
+                detailField(DETAIL_CURRENCY_FIELD_ID, '币种', CNY_ID),
+                detailField(DETAIL_INVOICE_FIELD_ID, '相关发票', id),
+            ],
+        };
+    });
+    const { amount: totalAmount } = sumMoney(detailRows.map((row) => row.fields.find((field) => field.fieldId === '100003720000000228')?.value));
+    if (!totalAmount || toCents(totalAmount) === 0) {
+        throw invoiceValidationError('invoice_total_invalid', '发票金额合计为 0 或无法解析，拒绝组装报销单');
+    }
+    const today = todayInShanghai();
+    const mainFields = [
+        mainField('100003720000000073', '申请人', superiors.currentEmployeeId),
+        mainField('100003720000000075', '报销日期', today),
+        mainField('100003720000000088', '报销事由', reason || requestName),
+        mainField('100003720000000084', '报销方式', undefined, BANK_OPTION_VALUE),
+    ];
+    if (relatedCustomerId)
+        mainFields.push(mainField(MAIN_CUSTOMER_FIELD_ID, '相关客户', relatedCustomerId));
+    else
+        warnings.push('未提供 relatedCustomerId，相关客户字段留空');
+    mainFields.push(mainField('100003720000001375', '人员ID', superiors.currentEmployeeId));
+    if (!contractNoInput) {
+        warnings.push('contractNo 未传入，已使用默认合同号 "20260999"');
+    }
+    if (contractNo)
+        mainFields.push(mainField(MAIN_CONTRACT_FIELD_ID, '合同号', contractNo));
+    mainFields.push(mainField('100003720000008409', '承担主体', superiors.currentEmployeeId), mainField('100003720000012512', '提单人员', superiors.currentEmployeeId), mainField('100003720000012513', '提单人员ID', superiors.currentEmployeeId), mainField('100003720000012514', '申请日期', today));
+    if (superiors.directSuperiorId) {
+        mainFields.push(mainField('100003720000013859', '报销人上级', superiors.directSuperiorId), mainField('100003720000029984', '承担人直接上级', superiors.directSuperiorId));
+    }
+    if (superiors.allSuperiorIds.length) {
+        mainFields.push(mainField('1159505470551416896', '承担人所有上级', superiors.allSuperiorIds.join(',')));
+    }
+    mainFields.push(mainField('100003720000000080', '报销总金额', totalAmount), mainField('100003720000012506', '报销合计（小写）', totalAmount), mainField('100003720000013853', '实际报销金额new', totalAmount), mainField('1211462428610863218', '人民币金额合计', totalAmount), mainField('100003720000000081', '附件总数', String(detailRows.length)));
+    const payload = {
+        work_flow_id: workflowId,
+        mainFormId: structure.mainFormId,
+        request_name: requestName,
+        main_fields: mainFields,
+        detail_rows: detailRows,
+        need_user_confirm: [],
+        unable_to_fill: [],
+    };
+    // 字典类 ID → 中文名。实时接口取到的名字优先，模板固化值兜底；都取不到就如实记进 unresolved。
+    const unresolved = [];
+    const employeeNames = {};
+    if (superiors.currentEmployeeName)
+        employeeNames[superiors.currentEmployeeId] = superiors.currentEmployeeName;
+    if (superiors.directSuperiorId && superiors.directSuperiorName) {
+        employeeNames[superiors.directSuperiorId] = superiors.directSuperiorName;
+    }
+    superiors.allSuperiorIds.forEach((id, index) => {
+        const name = superiors.allSuperiorNames[index];
+        if (name)
+            employeeNames[id] = name;
+        else
+            unresolved.push(`人员 ${id}`);
+    });
+    const subjectNames = { ...TEMPLATE_SUBJECT_NAMES };
+    const currencyNames = { ...TEMPLATE_CURRENCY_NAMES };
+    for (const meta of rowMeta) {
+        if (meta.subjectName)
+            subjectNames[meta.subjectId] = meta.subjectName;
+        else
+            unresolved.push(`费用科目 ${meta.subjectId}`);
+        if (meta.currencyName)
+            currencyNames[meta.currencyId] = meta.currencyName;
+        else
+            unresolved.push(`币种 ${meta.currencyId}`);
+    }
+    const customerNames = {};
+    if (relatedCustomerId) {
+        const name = relatedCustomerNameInput ?? TEMPLATE_CUSTOMER_NAMES[relatedCustomerId];
+        if (name)
+            customerNames[relatedCustomerId] = name;
+        else {
+            unresolved.push(`相关客户 ${relatedCustomerId}`);
+            warnings.push(`相关客户 ${relatedCustomerId} 无法自动取到中文名（字段可选项目只支持按名称搜索，不支持按 ID 反查）；如需展示中文名请传入 relatedCustomerName`);
+        }
+    }
+    const labels = {
+        workflow: { id: workflowId, name: workflowRef.name ?? '' },
+        mainFormId: structure.mainFormId,
+        detailSubForm: { id: structure.detailSubFormId, name: structure.detailSubFormName },
+        employees: employeeNames,
+        subjects: subjectNames,
+        currencies: currencyNames,
+        customers: customerNames,
+        selectOptions: structure.selectOptions,
+        customer: relatedCustomerId ? { id: relatedCustomerId, name: customerNames[relatedCustomerId] ?? null } : null,
+        unresolved: Array.from(new Set(unresolved)),
+    };
+    const dictionaries = {
+        employees: employeeNames,
+        customers: customerNames,
+        selectOptions: structure.selectOptions,
+    };
+    const preview = {
+        requestName,
+        workflowId,
+        mainFormId: structure.mainFormId,
+        mainFieldCount: mainFields.length,
+        detailRowCount: detailRows.length,
+        totalAmount,
+        invoiceCount: invoiceIds.length,
+        // 以下三项已把字典类 ID 渲染成「中文(id)」，调用方可直接展示，无需额外查询。
+        mainFields: mainFields.map((field) => renderMainFieldView(field, dictionaries)),
+        detailRows: rowMeta.map((meta, index) => ({
+            dataIndex: index + 1,
+            invoiceId: meta.invoiceId,
+            invoiceNumber: meta.invoiceNumber,
+            amount: String(detailRows[index].fields.find((field) => field.fieldId === '100003720000000228')?.value ?? ''),
+            expenseNote: meta.expenseNote,
+            subject: renderIdWithName(meta.subjectId, subjectNames),
+            currency: renderIdWithName(meta.currencyId, currencyNames),
+        })),
+        unresolvedLabels: labels.unresolved,
+    };
+    return { payload, preview, labels, warnings, workflowId };
+}
+function templateEnvelope(result, operationName) {
+    return {
+        status: 'COMPLETE',
+        data: {
+            payload: result.payload,
+            preview: result.preview,
+            labels: result.labels,
+            warnings: result.warnings,
+            workflow: workflow(operationName, 'COMPLETE'),
+        },
+    };
+}
+/** 票夹候选分类：自动翻页拉取未报销发票，按已挂单/全额红冲/可报三分类输出。 */
+export class InvoiceReimCandidatesListOperation {
+    name = 'invoice.reim.candidates.list';
+    async execute(input, { host }) {
+        const pageSize = boundedInteger(input.page_size, 'page_size', { min: 10, max: 200, defaultValue: 50 });
+        const maxItems = boundedInteger(input.max_items, 'max_items', { min: 1, max: 500, defaultValue: 200 });
+        // 报销场景默认剔除全额红冲发票：红冲票不可报销，混进候选会让调用方多一道人工剔除。
+        const includeRedReversed = input.include_red_reversed === true;
+        const dateBegin = optionalEpochSeconds(input.date_begin, 'date_begin');
+        const dateEnd = optionalEpochSeconds(input.date_end, 'date_end');
+        if (dateBegin !== undefined && dateEnd !== undefined && dateBegin > dateEnd) {
+            throw invoiceValidationError('input_invalid', 'date_begin 不能晚于 date_end');
+        }
+        const warnings = [];
+        const kept = [];
+        let total = 0;
+        let hasMore = false;
+        let startPos = 0;
+        let skippedRedReversed = 0;
+        let pulled = 0;
+        do {
+            const body = {
+                flag: 0,
+                page_size: pageSize,
+                start_pos: startPos,
+                req_type: 1,
+                sreim: '3',
+                bill_type: 0,
+                req_base: reqBase(),
+            };
+            if (dateBegin !== undefined)
+                body.date_begin = dateBegin;
+            if (dateEnd !== undefined)
+                body.date_end = dateEnd;
+            const result = await host.invoiceRequest({ path: '/api/inc/sync', method: 'POST', body, operation: this.name });
+            total = Number(result?.total ?? 0);
+            const infos = Array.isArray(result?.infos) ? result.infos : [];
+            for (const info of infos) {
+                pulled += 1;
+                if (!includeRedReversed && isRedReversedInvoice(info)) {
+                    skippedRedReversed += 1;
+                    continue;
+                }
+                kept.push(info);
+            }
+            startPos += infos.length;
+            hasMore = result?.end_flag === 1;
+            // 空页但 end_flag 未置位时直接收手，避免接口异常导致空转。
+            if (infos.length === 0)
+                break;
+        } while (kept.length < maxItems && pulled < total && hasMore);
+        const capped = kept.slice(0, maxItems);
+        if (kept.length > maxItems) {
+            warnings.push(`符合条件发票共 ${kept.length} 张，已按 max_items=${maxItems} 截断，可调大 max_items 或缩小日期范围`);
+        }
+        const available = [];
+        const assigned = [];
+        const redReversed = [];
+        for (const info of capped) {
+            const item = candidateItem(info);
+            if (item.status === RED_REVERSED_STATUS)
+                redReversed.push(item);
+            else if (item.reimRequests.length)
+                assigned.push(item);
+            else
+                available.push(item);
+        }
+        const summarize = (items) => {
+            const { amount, invalid } = sumMoney(items.map((item) => item.total));
+            if (invalid)
+                warnings.push(`${invalid} 张发票金额无法解析，未计入合计`);
+            return amount;
+        };
+        const summary = {
+            availableCount: available.length,
+            assignedCount: assigned.length,
+            redReversedCount: redReversed.length,
+            availableAmount: summarize(available),
+            assignedAmount: summarize(assigned),
+            redReversedAmount: summarize(redReversed),
+            filteredRedReversedCount: skippedRedReversed,
+        };
+        return {
+            status: 'COMPLETE',
+            data: {
+                total,
+                fetched: capped.length,
+                hasMore: pulled < total,
+                available,
+                assigned,
+                redReversed,
+                summary,
+                warnings,
+                workflow: workflow(this.name, 'COMPLETE'),
+            },
+        };
+    }
+}
+/** 报销单模板组装：固化「总部费用报销」字段映射，从发票 ID 直接产出可提交 payload（只读）。 */
+export class InvoiceReimTemplateBuildOperation {
+    name = 'invoice.reim.template.build';
+    async execute(input, { host }) {
+        const result = await buildReimCreatePayload(input, host, this.name);
+        return templateEnvelope(result, this.name);
+    }
+}
+/** 一站式 prepare：模板组装 + 签发 flow.create.apply continuation，停在 AWAITING_CONFIRMATION。 */
+export class InvoiceReimFlowCreateAutoPrepareOperation {
+    name = 'invoice.reim.flow.create.auto-prepare';
+    async execute(input, { host, continuation }) {
+        const result = await buildReimCreatePayload(input, host, this.name);
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.reim.flow.create.apply',
+            workflow: workflow('invoice.reim.flow.create', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            fingerprint: objectFingerprint(result.payload),
+            preview: result.preview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview: result.preview,
+                payload: result.payload,
+                labels: result.labels,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                warnings: result.warnings,
+                workflow: workflow('invoice.reim.flow.create', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}