weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/fna/manifest.js

@@ -0,0 +1,41 @@
+import { fnaOperationDefinitions } from './operations/registry.js';
+/**
+ * FNA 费控中心（齐业成）模块禁用/暂缓边界。
+ * 11 个源接口全部落地；以下几类能力不在本 CLI，写入 manifest 供 Agent 判断，
+ * 不得编造 operation 或绕过 CLI 直连接口：
+ * - 姓名/流程名 → employeeId/workflowId 的人员与流程解析不在本模块；
+ * - 借款「确认已还 confirmRepay」、核销明细等页面按钮能力未随源资料提供接口，未实现。
+ */
+const FNA_WITHHELD = [
+    {
+        name: 'fna.loan.confirm.repay',
+        reason: '借款管理菜单提供「确认已还 confirmRepay」按钮，但源资料未提供其接口路径、请求方法、关键字段与确认条件，未实现；不得猜测接口。',
+    },
+    {
+        name: 'fna.resolve.person.workflow',
+        reason: '姓名→employeeId、流程名→workflowId 的解析依赖人员/流程基表接口，源资料未提供；需要时请使用已提供的 ID 或由用户在对话中提供。',
+    },
+];
+function buildOperations() {
+    return fnaOperationDefinitions().map((definition) => ({
+        name: definition.name,
+        resource: definition.resource,
+        summary: definition.summary,
+        ...(definition.capability ? { capability: definition.capability } : {}),
+        risk: definition.risk,
+        ...(definition.requiresConfirmation ? { requiresConfirmation: true } : {}),
+        inputSchema: definition.inputSchema,
+    }));
+}
+export const fnaManifest = {
+    schemaVersion: 1,
+    name: 'fna',
+    title: '泛微E10齐业成费控中心（预算查询/费用中心/借款管理/发票核销）',
+    version: '0.1.0',
+    host: 'e10-fna',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-qiyecheng',
+    capabilities: ['budget', 'expense', 'loan', 'invoice-writeoff'],
+    operations: buildOperations(),
+    withheldOperations: FNA_WITHHELD,
+};

package/dist/shortcuts/fna/operations/budget.js

@@ -0,0 +1,124 @@
+import { fnaValidationError } from '../errors.js';
+import { fnaSuccess, READ, schemaOf, SCHEMA_ID, SCHEMA_INTEGER_POSITIVE } from './types.js';
+import { numericId, toPositiveInt, unwrapData } from './shared.js';
+/**
+ * 预算：事前申请单预算详情。
+ * GET /api/fna/expense/preApplication/getApplicationDetail?requestId=<id>（公开只读）。
+ * 归一化 WeaForm：申请名称/创建人/发起时间 + budgetInfo.otherParams 的预算口径。
+ */
+const fnaBudgetApplicationDetail = {
+    name: 'fna.budget.application.detail',
+    resource: 'budget',
+    method: 'budget.application.detail',
+    action: 'fna.budget.application.detail',
+    summary: '事前申请单预算详情：按 requestId 返回申请名称、创建人、发起时间与预算口径（总额/已报销/报销中/剩余可用/已释放），并附原始表单 items',
+    capability: 'budget',
+    risk: READ,
+    inputSchema: schemaOf({ requestId: { ...SCHEMA_ID, description: '事前申请单 ID（必填）' } }, { required: ['requestId'], description: '预算：事前申请单预算详情' }),
+    handler: async (args, { host }) => {
+        const requestId = numericId(args.requestId, 'requestId');
+        if (requestId === undefined) {
+            throw fnaValidationError('request_id_required', 'requestId 必填（事前申请单 ID）');
+        }
+        const response = await host.request({
+            method: 'GET',
+            path: '/api/fna/expense/preApplication/getApplicationDetail',
+            query: { requestId },
+        });
+        const form = unwrapData(response);
+        const items = form?.items ?? {};
+        const budgetInfo = items.budgetInfo?.otherParams ?? {};
+        const budget = {
+            totalAmount: budgetInfo.budgeteTotalAmount ?? 0,
+            reimbursedFee: budgetInfo.reimbursedFee ?? 0,
+            reimbursingFee: budgetInfo.reimburserFee ?? 0,
+            remainingBudget: budgetInfo.remainingBudgete ?? 0,
+            releasedBudgetAmount: budgetInfo.releasedBudgetAmount ?? 0,
+            isDisplay: budgetInfo.isDisplay ?? false,
+        };
+        const detail = {
+            requestId: String(requestId),
+            requestName: items.requestName?.value ?? '',
+            createPerson: items.createPerson?.value ?? '',
+            createPersonUserId: items.createPerson?.otherParams?.userId ?? '',
+            createTime: items.createTime?.value ?? '',
+            budget,
+            consistencyHint: '预算总额 = 已报销 + 报销中 + 剩余可用 + 已释放；若不等，数据可能未刷新或存在并发在途变更',
+        };
+        return fnaSuccess('fna.budget.application.detail', detail, { rawForm: form });
+    },
+};
+/**
+ * 预算：预算执行报表查询。
+ * POST /api/fna/execute/getExecuteListByAi（公开只读）。返回 WeaTable 分页表 + 合计。
+ */
+const fnaBudgetExecuteList = {
+    name: 'fna.budget.execute.list',
+    resource: 'budget',
+    method: 'budget.execute.list',
+    action: 'fna.budget.execute.list',
+    summary: '预算执行报表：按预算模板 + 维度/期间筛选，返回分页明细行与 customParameters 合计（budget_sumAmount 前缀），仅列明当前模板可用的维度 key',
+    capability: 'budget',
+    risk: READ,
+    inputSchema: schemaOf({
+        current: { ...SCHEMA_INTEGER_POSITIVE, description: '当前页码（必填，从 1 开始）' },
+        pageSize: { ...SCHEMA_INTEGER_POSITIVE, description: '每页条数（必填）' },
+        templateId: { ...SCHEMA_ID, description: '预算模板 ID；为空只返回表头' },
+        formDatas: {
+            type: 'object',
+            description: '维度/期间筛选，value 为「单元素数组包裹同名 key 数组」的二层嵌套；periodName 传金额列名 budget_amount1~12，dimenMem1 等维度 key 由模板 corrColumn 决定',
+        },
+        type: { type: 'string', enum: ['and', 'or'], description: '筛选关联方式' },
+        departmentFlag: { type: 'string', description: '部门标识' },
+        exportType: { type: 'string', description: '导出类型' },
+        ignoreReportPower: { type: 'boolean', description: '是否忽略报表权限校验（仅内部/管理员）' },
+    }, {
+        required: ['current', 'pageSize'],
+        description: '预算：预算执行报表查询（模板 + 维度 + 期间）',
+    }),
+    handler: async (args, { host }) => {
+        const current = toPositiveInt(args.current, 'current');
+        const pageSize = toPositiveInt(args.pageSize, 'pageSize');
+        if (current === undefined)
+            throw fnaValidationError('current_required', 'current 必填（正整数页码）');
+        if (pageSize === undefined)
+            throw fnaValidationError('page_size_required', 'pageSize 必填（正整数每页条数）');
+        const body = { current, pageSize };
+        if (args.templateId !== undefined)
+            body.templateId = numericId(args.templateId, 'templateId');
+        if (args.formDatas !== undefined)
+            body.formDatas = args.formDatas;
+        if (args.type !== undefined)
+            body.type = args.type;
+        if (args.departmentFlag !== undefined)
+            body.departmentFlag = args.departmentFlag;
+        if (args.exportType !== undefined)
+            body.exportType = args.exportType;
+        if (args.ignoreReportPower !== undefined)
+            body.ignoreReportPower = args.ignoreReportPower;
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/fna/execute/getExecuteListByAi',
+            body,
+        });
+        const table = unwrapData(response);
+        const result = {
+            pageUid: table?.pageUid ?? 'FnaBudgetExecuteList',
+            total: table?.total ?? 0,
+            current: table?.current ?? current,
+            pageSize: table?.pageSize ?? pageSize,
+            hasMore: table?.hasMore ?? false,
+            periodFlag: table?.periodFlag ?? false,
+            columns: table?.columns ?? [],
+            rows: Array.isArray(table?.data) ? table.data : [],
+            totals: table?.customParameters ?? {},
+        };
+        return fnaSuccess('fna.budget.execute.list', result, {
+            hint: 'templateId 为空时仅返回表头列定义（正常行为）；汇总问题优先读 totals 中 budget_sumAmount 前缀字段；金额/比率为字符串需转数值并去 %',
+        });
+    },
+};
+export const budgetOperations = [
+    fnaBudgetApplicationDetail,
+    fnaBudgetExecuteList,
+];

package/dist/shortcuts/fna/operations/expense-center.js

@@ -0,0 +1,148 @@
+import { fnaSuccess, READ, schemaOf, SCHEMA_DATE, SCHEMA_ID } from './types.js';
+import { assertDateRange, numericId } from './shared.js';
+/** SumAmountByAiVo 共用字段（body 可为空，默认当前登录人）。 */
+const SUM_AMOUNT_PROPERTIES = {
+    employeeId: { ...SCHEMA_ID, description: '员工 ID（数字）；为空默认当前登录人' },
+    startDate: { ...SCHEMA_DATE, description: '开始日期 YYYY-MM-DD（闭区间）' },
+    endDate: { ...SCHEMA_DATE, description: '结束日期 YYYY-MM-DD（闭区间）' },
+    workflowId: { ...SCHEMA_ID, description: '流程类型 ID（数字）' },
+    requestId: { ...SCHEMA_ID, description: '流程实例 ID（数字）' },
+};
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * 归一化 SumAmountByAiVo 输入：日期成对校验；ID 类字段数字优先（借款接口只认数字，
+ * 传字符串会静默返回空 data）；仅输出已提供的字段。
+ */
+function sumAmountBody(args) {
+    const range = assertDateRange(args, 'startDate', 'endDate');
+    const body = {};
+    const employeeId = numericId(args.employeeId, 'employeeId');
+    const workflowId = numericId(args.workflowId, 'workflowId');
+    const requestId = numericId(args.requestId, 'requestId');
+    if (employeeId !== undefined)
+        body.employeeId = employeeId;
+    if (range.start !== undefined)
+        body.startDate = range.start;
+    if (range.end !== undefined)
+        body.endDate = range.end;
+    if (workflowId !== undefined)
+        body.workflowId = workflowId;
+    if (requestId !== undefined)
+        body.requestId = requestId;
+    return body;
+}
+/** 判断响应对象是否真的带 data 键（用于区分「无记录 data:null」与「瞬时空响应缺 data」）。 */
+function hasDataKey(value) {
+    return Boolean(value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, 'data'));
+}
+/**
+ * 费用中心：报销金额合计（只读）。
+ * POST /api/fna/expense/center/getSumReimbursedAmountByAi
+ * 口径：明细状态 status=1（审批完成）的 reimburse_amount 合计 = 已报销金额；无数据返回 0.0。
+ */
+const fnaExpenseReimbursedSum = {
+    name: 'fna.expense.reimbursed.sum',
+    resource: 'expense',
+    method: 'expense.reimbursed.sum',
+    action: 'fna.expense.reimbursed.sum',
+    summary: '报销金额合计（已报销口径，审批完成明细合计）：按员工/日期/流程过滤，返回金额（元）与口径说明',
+    capability: 'expense',
+    risk: READ,
+    inputSchema: schemaOf(SUM_AMOUNT_PROPERTIES, { description: '费用中心：报销金额合计（body 可为空，默认当前登录人）' }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/fna/expense/center/getSumReimbursedAmountByAi',
+            body: sumAmountBody(args),
+        });
+        const amount = response?.data ?? 0.0;
+        return fnaSuccess('fna.expense.reimbursed.sum', {
+            amount,
+            currency: 'CNY',
+            note: '已报销口径：审批完成（明细状态 status=1）明细的 reimburse_amount 合计；无匹配数据返回 0.0',
+        });
+    },
+};
+/**
+ * 费用中心：借款金额分段汇总（只读）。
+ * POST /api/fna/expense/center/getSumLoanAmountByAi
+ * ⚠️ 服务端实现缺陷：只统计首条借款记录；且首次/冷启动可能瞬时返回缺 data 的空响应（自动重试最多 2 次）。
+ */
+const fnaExpenseLoanSum = {
+    name: 'fna.expense.loan.sum',
+    resource: 'expense',
+    method: 'expense.loan.sum',
+    action: 'fna.expense.loan.sum',
+    summary: '借款金额分段汇总（待还款 dhk/还款中 hkz/已还款 yhk/借款总额 jk，含笔数）：注意服务端只统计首条借款记录的已知缺陷',
+    capability: 'expense',
+    risk: READ,
+    inputSchema: schemaOf(SUM_AMOUNT_PROPERTIES, { description: '费用中心：借款金额分段汇总（body 可为空，默认当前登录人）' }),
+    handler: async (args, { host }) => {
+        const body = sumAmountBody(args);
+        let response;
+        let attempts = 0;
+        // 借款接口存在冷启动/缓存导致 data 键缺省的空响应：先重试 2 次再下结论。
+        for (;;) {
+            response = await host.request({
+                method: 'POST',
+                path: '/api/fna/expense/center/getSumLoanAmountByAi',
+                body,
+            });
+            if (hasDataKey(response) || attempts >= 2)
+                break;
+            attempts += 1;
+            await sleep(150);
+        }
+        if (!hasDataKey(response)) {
+            return fnaSuccess('fna.expense.loan.sum', { segments: null }, {
+                note: '连续 3 次请求均未返回 data，按「暂无借款记录」处理；若确有借款，可稍后重试',
+            });
+        }
+        const segments = response.data;
+        return fnaSuccess('fna.expense.loan.sum', {
+            segments,
+            note: '该借款接口仅统计首条借款记录（for 循环内 return），金额/笔数可能不全，待开发修复；展示与回传以 key（dhk/hkz/yhk/jk）为准，不依赖 costType 文案',
+        });
+    },
+};
+/**
+ * 费用中心：预付核销金额（只读）。
+ * POST /api/fna/expense/center/selectPrepayWriteOffAmountBySkill
+ * data: payment_amount(预付金额)/writeOffing(核销中)/writeOffed(已核销)/noArrivedAmount(未到账)，无数据兜底 0。
+ */
+const fnaExpensePrepayWriteOffSum = {
+    name: 'fna.expense.prepay.writeoff.sum',
+    resource: 'expense',
+    method: 'expense.prepay.writeoff.sum',
+    action: 'fna.expense.prepay.writeoff.sum',
+    summary: '预付核销金额汇总（对公支付预付单）：预付金额/核销中/已核销/未到账合计，按创建人/日期/流程过滤',
+    capability: 'expense',
+    risk: READ,
+    inputSchema: schemaOf(SUM_AMOUNT_PROPERTIES, { description: '费用中心：预付核销金额汇总（body 可为空，默认当前登录人）' }),
+    handler: async (args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/fna/expense/center/selectPrepayWriteOffAmountBySkill',
+            body: sumAmountBody(args),
+        });
+        const value = response?.data ?? {};
+        const result = {
+            paymentAmount: value.payment_amount ?? 0,
+            writeOffing: value.writeOffing ?? 0,
+            writeOffed: value.writeOffed ?? 0,
+            noArrivedAmount: value.noArrivedAmount ?? 0,
+            note: '口径：employeeId 匹配预付单创建人；日期按核销记录创建时间过滤；未到账 = 预付金额 − 已到账 − 已核销；无匹配数据兜底 0',
+        };
+        return fnaSuccess('fna.expense.prepay.writeoff.sum', result);
+    },
+};
+export const expenseCenterOperations = [
+    fnaExpenseReimbursedSum,
+    fnaExpenseLoanSum,
+    fnaExpensePrepayWriteOffSum,
+];
+export { sumAmountBody, hasDataKey };

package/dist/shortcuts/fna/operations/invoice-writeoff.js

@@ -0,0 +1,212 @@
+import { fnaPartialError, fnaValidationError, isFnaNetworkError } from '../errors.js';
+import { fnaSuccess, READ, schemaOf, SCHEMA_INTEGER_POSITIVE, WRITE } from './types.js';
+import { compact, fingerprint, normalizeWeaTable, requireConfirm, requireRequestIds, toPositiveInt, unwrapData, verifyLease } from './shared.js';
+const CONTINUATION_TTL_SECONDS = 600;
+/** 发票核销公开字段（InvWriteOffSearchVo 非分页部分）。 */
+const WRITE_OFF_FILTER_FIELDS = {
+    invoiceStatus: {
+        type: 'string',
+        enum: ['unWritten', 'unarrivedTicket', 'dealing', 'callTicket'],
+        description: '发票状态过滤：unWritten 未核销 / unarrivedTicket 未到票 / dealing 核销中 / callTicket 催票',
+    },
+    type: { type: 'string', description: '类型，默认 1' },
+    departmentId: { type: 'string', description: '部门 ID，为空查全部' },
+    menuCode: { type: 'string', description: '菜单编码，如 inv_write_off_financial（与环境核对）' },
+    permissionSetCode: { type: 'string', description: '权限集编码，如 inv_write_off_financial.default（与环境核对）' },
+    dataSource: { type: 'string', description: '数据来源' },
+    cfgType: { type: 'string', description: '配置类型' },
+    dataStatisticCfgId: { type: 'string', description: '数据统计配置 ID' },
+    requestId: { type: 'string', description: '流程请求 ID' },
+};
+/**
+ * 发票核销：金额 tab 汇总（财务/管理员，只读，公开权限）。
+ * POST /api/fna/expense/inv/financial/writeOffPageTab
+ * data: whx 未核销 / hxz 核销中 / bfhx 部分核销 / wqhx 完全核销（amount 格式化字符串 + count）。
+ */
+const fnaInvoiceWriteOffTab = {
+    name: 'fna.invoice.writeoff.summary',
+    resource: 'invoice-writeoff',
+    method: 'invoice.writeoff.summary',
+    action: 'fna.invoice.writeoff.summary',
+    summary: '发票核销金额 tab 汇总（未核销/核销中/部分核销/完全核销的金额与笔数，财务/管理员）',
+    capability: 'invoice-writeoff',
+    risk: READ,
+    inputSchema: schemaOf(WRITE_OFF_FILTER_FIELDS, { description: '发票核销：金额 tab 汇总（可传 invoiceStatus 过滤，不分页）' }),
+    handler: async (args, { host }) => {
+        const body = compact({
+            invoiceStatus: args.invoiceStatus,
+            type: args.type,
+            departmentId: args.departmentId,
+            menuCode: args.menuCode,
+            permissionSetCode: args.permissionSetCode,
+            dataSource: args.dataSource,
+            cfgType: args.cfgType,
+            dataStatisticCfgId: args.dataStatisticCfgId,
+            requestId: args.requestId,
+        });
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/fna/expense/inv/financial/writeOffPageTab',
+            body,
+        });
+        const data = unwrapData(response);
+        return fnaSuccess('fna.invoice.writeoff.summary', {
+            whx: data?.whx ?? null,
+            hxz: data?.hxz ?? null,
+            bfhx: data?.bfhx ?? null,
+            wqhx: data?.wqhx ?? null,
+            note: 'amount 为格式化字符串（元）；menuCode/permissionSetCode 环境相关，示例值需与环境核对',
+        });
+    },
+};
+/**
+ * 发票核销：核销列表（财务/管理员，只读）。
+ * POST /api/fna/expense/inv/financial/writeOffList
+ * 必填 current/pageSize；催票用返回行的 requestId 组装 fna.invoice.writeoff.callticket.prepare。
+ */
+const fnaInvoiceWriteOffList = {
+    name: 'fna.invoice.writeoff.list',
+    resource: 'invoice-writeoff',
+    method: 'invoice.writeoff.list',
+    action: 'fna.invoice.writeoff.list',
+    summary: '发票核销列表（分页，财务/管理员）：返回核销单行（requestId/id 可用于催票）',
+    capability: 'invoice-writeoff',
+    risk: READ,
+    inputSchema: schemaOf({
+        current: { ...SCHEMA_INTEGER_POSITIVE, description: '当前页码（必填）' },
+        pageSize: { ...SCHEMA_INTEGER_POSITIVE, description: '每页条数（必填）' },
+        ...WRITE_OFF_FILTER_FIELDS,
+        quickSearchDatas: { type: 'object', description: '快捷搜索数据' },
+        formDatas: { type: 'object', description: '表单搜索数据' },
+    }, { required: ['current', 'pageSize'], description: '发票核销：核销列表' }),
+    handler: async (args, { host }) => {
+        const current = toPositiveInt(args.current, 'current');
+        const pageSize = toPositiveInt(args.pageSize, 'pageSize');
+        if (current === undefined)
+            throw fnaValidationError('current_required', 'current 必填（正整数页码）');
+        if (pageSize === undefined)
+            throw fnaValidationError('page_size_required', 'pageSize 必填（正整数每页条数）');
+        const body = compact({
+            current,
+            pageSize,
+            invoiceStatus: args.invoiceStatus,
+            type: args.type,
+            departmentId: args.departmentId,
+            menuCode: args.menuCode,
+            permissionSetCode: args.permissionSetCode,
+            dataSource: args.dataSource,
+            quickSearchDatas: args.quickSearchDatas,
+            formDatas: args.formDatas,
+            cfgType: args.cfgType,
+            dataStatisticCfgId: args.dataStatisticCfgId,
+            requestId: args.requestId,
+        });
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/fna/expense/inv/financial/writeOffList',
+            body,
+        });
+        const table = normalizeWeaTable(unwrapData(response), { current, pageSize });
+        return fnaSuccess('fna.invoice.writeoff.list', table, {
+            hint: '催票请取 rows 行的 requestId（或 id）组装 requestids 传给 fna.invoice.writeoff.callticket.prepare；金额字段为格式化字符串（元）',
+        });
+    },
+};
+/**
+ * 发票核销：催票 prepare（写操作）。
+ * 本地校验 requestids 并生成预览（条数 + 前若干 ID）与 continuation，不发送催票。
+ */
+const fnaInvoiceCallTicketPrepare = {
+    name: 'fna.invoice.writeoff.callticket.prepare',
+    resource: 'invoice-writeoff',
+    method: 'invoice.writeoff.callticket.prepare',
+    action: 'fna.invoice.writeoff.callticket.prepare',
+    summary: '催票（准备）：传入 writeOffList 行的 requestId 列表，校验并生成预览与 continuation，不发送催票',
+    capability: 'invoice-writeoff',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        requestids: {
+            type: 'array',
+            items: { type: 'string', pattern: '^\\d+$' },
+            minItems: 1,
+            description: '流程请求 ID 列表（writeOffList 返回行的 requestId / id，最多 200 条）',
+        },
+    }, { required: ['requestids'], description: '发票核销：催票（准备）' }),
+    handler: async (args, { host, continuation }) => {
+        const requestids = requireRequestIds(args.requestids);
+        const session = await host.getSession();
+        const token = await continuation.issue({
+            operation: 'fna.invoice.writeoff.callticket.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            fingerprint: fingerprint(requestids),
+            count: requestids.length,
+        }, CONTINUATION_TTL_SECONDS * 1000);
+        return fnaSuccess('fna.invoice.writeoff.callticket.prepare', {
+            status: 'AWAITING_CONFIRMATION',
+            preview: {
+                count: requestids.length,
+                ids: requestids.slice(0, 20),
+                action: '对以上预付流程发送催票通知',
+                hint: '向用户展示条数与目标流程（建议同时用 fna.invoice.writeoff.list 的行展示申请名称/未核销金额），获得明确确认后再调用 fna.invoice.writeoff.callticket.apply',
+            },
+            continuation: token,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
+        });
+    },
+};
+/**
+ * 发票核销：催票 apply（写操作，需用户明确确认）。
+ * 校验 confirm=true 与 continuation；requestids 指纹须与 prepare 一致。
+ */
+const fnaInvoiceCallTicketApply = {
+    name: 'fna.invoice.writeoff.callticket.apply',
+    resource: 'invoice-writeoff',
+    method: 'invoice.writeoff.callticket.apply',
+    action: 'fna.invoice.writeoff.callticket.apply',
+    summary: '催票（执行）：需 confirm=true 与 prepare 返回的 continuation，requestids 与 prepare 一致才会发送催票',
+    capability: 'invoice-writeoff',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        requestids: { type: 'array', items: { type: 'string', pattern: '^\\d+$' }, minItems: 1 },
+        confirm: { const: true },
+        continuation: { type: 'string', minLength: 1 },
+    }, { required: ['requestids', 'confirm', 'continuation'], description: '发票核销：催票（执行）' }),
+    handler: async (args, env) => {
+        requireConfirm(args, 'fna.invoice.writeoff.callticket.apply');
+        const requestids = requireRequestIds(args.requestids);
+        const lease = await verifyLease(args, 'fna.invoice.writeoff.callticket.apply', env);
+        if (fingerprint(requestids) !== lease.fingerprint || requestids.length !== lease.count) {
+            throw fnaValidationError('target_changed', '催票目标与 prepare 时的快照不一致，请重新执行 prepare');
+        }
+        let response;
+        try {
+            response = await env.host.request({
+                method: 'POST',
+                path: '/api/fna/expense/inv/financial/callTicket',
+                body: { requestids },
+            });
+        }
+        catch (error) {
+            if (isFnaNetworkError(error)) {
+                throw fnaPartialError('催票请求发送后连接中断，是否已发送不确定，禁止自动重试；可通过 fna.invoice.writeoff.list 回查或重新 prepare 确认', { attempted: { count: requestids.length } }, { stage: 'invoice.writeoff.callTicket' });
+            }
+            throw error;
+        }
+        const message = response?.data?.msg ?? '催票消息发送成功';
+        return fnaSuccess('fna.invoice.writeoff.callticket.apply', {
+            msg: message,
+            calledCount: requestids.length,
+            note: '本接口只发送催票通知，不改变核销金额状态',
+        });
+    },
+};
+export const invoiceWriteOffOperations = [
+    fnaInvoiceWriteOffTab,
+    fnaInvoiceWriteOffList,
+    fnaInvoiceCallTicketPrepare,
+    fnaInvoiceCallTicketApply,
+];