weaver-work-cli 0.1.2 → 0.1.5

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

@@ -0,0 +1,401 @@
+import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
+import { asNonEmptyString, asObject, assertBusinessSuccess, normalizeIdList, objectFingerprint, sessionMatches, workflow, } from './shared.js';
+function integerInput(value, name, options = {}) {
+    const min = options.min ?? 1;
+    const max = options.max ?? 200;
+    const defaultValue = options.defaultValue ?? min;
+    const parsed = value === undefined ? defaultValue : Number(value);
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+        throw invoiceValidationError('input_invalid', `${name} 必须是 ${min}-${max} 的整数`);
+    }
+    return parsed;
+}
+function optionalString(value, name) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return asNonEmptyString(value, name);
+}
+function optionalDate(value, name) {
+    const text = optionalString(value, name);
+    if (text === undefined)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}$/u.test(text)) {
+        throw invoiceValidationError('input_invalid', `${name} 必须是 YYYY-MM-DD`);
+    }
+    return text;
+}
+function responseData(value) {
+    return value && typeof value === 'object' && 'data' in value ? value.data : value;
+}
+function resultEnvelope(value, workflowName) {
+    assertBusinessSuccess(value, `${workflowName}_failed`, '接口返回业务失败');
+    return {
+        status: 'COMPLETE',
+        data: {
+            result: value,
+            data: responseData(value),
+            workflow: workflow(workflowName, 'COMPLETE'),
+        },
+    };
+}
+const UNSAFE_JSON_INTEGER_ID = /("id"\s*:\s*)(-?\d{16,})(?=\s*[,}\]])/g;
+function quoteEmployeeIdsInJsonText(text) {
+    return text.replace(UNSAFE_JSON_INTEGER_ID, '$1"$2"');
+}
+function employeeIdString(value) {
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(Math.trunc(value));
+    if (typeof value === 'string')
+        return value;
+    return value;
+}
+function stringifyEmployeeRecordId(employee) {
+    if (!employee || typeof employee !== 'object' || Array.isArray(employee))
+        return employee;
+    const record = employee;
+    if (!('id' in record))
+        return employee;
+    return { ...record, id: employeeIdString(record.id) };
+}
+function stringifyEmployeeSuperiorsPayload(payload) {
+    if ('currentEmployee' in payload) {
+        payload.currentEmployee = stringifyEmployeeRecordId(payload.currentEmployee);
+    }
+    if (Array.isArray(payload.allSuperiors)) {
+        payload.allSuperiors = payload.allSuperiors.map(stringifyEmployeeRecordId);
+    }
+}
+function stringifyEmployeeSuperiorsIds(value) {
+    if (!value || typeof value !== 'object')
+        return value;
+    const cloned = structuredClone(value);
+    stringifyEmployeeSuperiorsPayload(cloned);
+    if (cloned.data && typeof cloned.data === 'object' && !Array.isArray(cloned.data)) {
+        stringifyEmployeeSuperiorsPayload(cloned.data);
+    }
+    return cloned;
+}
+function employeeSuperiorsEnvelope(value) {
+    return resultEnvelope(stringifyEmployeeSuperiorsIds(value), 'invoice.reim.employee-superiors');
+}
+function ensureFlowCreatePayload(payload) {
+    const value = structuredClone(asObject(payload, 'payload'));
+    asNonEmptyString(value.work_flow_id, 'payload.work_flow_id');
+    asNonEmptyString(value.mainFormId, 'payload.mainFormId');
+    asNonEmptyString(value.request_name, 'payload.request_name');
+    if (!Array.isArray(value.main_fields))
+        throw invoiceValidationError('input_invalid', 'payload.main_fields 必须是数组');
+    if (!Array.isArray(value.detail_rows) || value.detail_rows.length === 0) {
+        throw invoiceValidationError('input_invalid', 'payload.detail_rows 必须是非空数组');
+    }
+    return value;
+}
+function ensureFlowUpdatePayload(payload) {
+    const value = structuredClone(asObject(payload, 'payload'));
+    asNonEmptyString(value.requestId, 'payload.requestId');
+    asNonEmptyString(value.mainFormId, 'payload.mainFormId');
+    const hasMain = Array.isArray(value.main_fields) && value.main_fields.length > 0;
+    const hasDetails = Array.isArray(value.detail_rows) && value.detail_rows.length > 0;
+    const hasDeletes = Array.isArray(value.deleteDetailRows) && value.deleteDetailRows.length > 0;
+    if (!hasMain && !hasDetails && !hasDeletes) {
+        throw invoiceValidationError('input_invalid', 'payload 必须包含 main_fields、detail_rows 或 deleteDetailRows 至少一类变更');
+    }
+    return value;
+}
+function flowPreview(payload) {
+    return {
+        requestName: payload.request_name || '',
+        workflowId: payload.work_flow_id || '',
+        mainFormId: payload.mainFormId || '',
+        mainFieldCount: Array.isArray(payload.main_fields) ? payload.main_fields.length : 0,
+        detailRowCount: Array.isArray(payload.detail_rows) ? payload.detail_rows.length : 0,
+    };
+}
+function updatePreview(payload) {
+    return {
+        requestId: String(payload.requestId),
+        mainFormId: payload.mainFormId,
+        mainFieldCount: Array.isArray(payload.main_fields) ? payload.main_fields.length : 0,
+        detailRowCount: Array.isArray(payload.detail_rows) ? payload.detail_rows.length : 0,
+        deleteDetailRowCount: Array.isArray(payload.deleteDetailRows) ? payload.deleteDetailRows.length : 0,
+    };
+}
+export class InvoiceReimFileOcrPreviewOperation {
+    name = 'invoice.reim.file-ocr.preview';
+    async execute(input, { host }) {
+        if (input.fileId !== undefined && input.fileIds !== undefined)
+            throw invoiceValidationError('input_ambiguous', 'fileId 与 fileIds 只能提供一个');
+        const fileIds = input.fileId === undefined
+            ? normalizeIdList(input.fileIds, 'fileIds')
+            : normalizeIdList(input.fileId, 'fileId', { allowCommaString: true });
+        const result = await host.invoiceMultipartRequest({
+            path: '/api/inc/book/fileIdToInvoicesAndOcr',
+            fields: { fileIds },
+            timeoutMs: 90_000,
+            operation: this.name,
+        });
+        assertBusinessSuccess(result, 'reim_file_ocr_failed', '文件 ID 转发票识别失败');
+        const items = Array.isArray(result.data) ? result.data : [];
+        const succeeded = items.filter((item) => item?.status === 'success');
+        const failed = items.filter((item) => item?.status !== 'success');
+        if (!succeeded.length && failed.length) {
+            throw new InvoiceCliError('api', 'reim_file_ocr_all_failed', failed[0]?.errorMsg || '文件 ID 识别没有成功发票', {
+                details: { failed, result },
+                exitCode: 1,
+            });
+        }
+        return {
+            status: failed.length ? 'PARTIAL' : 'COMPLETE',
+            data: { items: succeeded, failed, result, workflow: workflow('invoice.reim.file-ocr', failed.length ? 'PARTIAL' : 'COMPLETE') },
+        };
+    }
+}
+export class InvoiceReimRequestsListOperation {
+    name = 'invoice.reim.requests.list';
+    async execute(input, { host }) {
+        const body = {
+            pageNo: integerInput(input.pageNo, 'pageNo', { min: 1, max: 10000 }),
+            pageSize: integerInput(input.pageSize, 'pageSize', { min: 1, max: 200, defaultValue: 20 }),
+        };
+        for (const [key, value] of Object.entries({
+            requestname: optionalString(input.requestname, 'requestname'),
+            cusCreateDateStart: optionalDate(input.cusCreateDateStart, 'cusCreateDateStart'),
+            cusCreateDateEnd: optionalDate(input.cusCreateDateEnd, 'cusCreateDateEnd'),
+        })) {
+            if (value !== undefined)
+                body[key] = value;
+        }
+        const result = await host.invoiceRequest({ path: '/api/inc/book/getRequestListByTabId', method: 'POST', body, operation: this.name });
+        return resultEnvelope(result, 'invoice.reim.requests.list');
+    }
+}
+export class InvoiceReimWorkflowResolveOperation {
+    name = 'invoice.reim.workflow.resolve';
+    async execute(input, { host }) {
+        let requestIds = [];
+        if (input.requestIds !== undefined) {
+            if (!Array.isArray(input.requestIds))
+                throw invoiceValidationError('input_invalid', 'requestIds 必须是数组');
+            if (input.requestIds.length > 100)
+                throw invoiceValidationError('input_invalid', 'requestIds 最多支持 100 个 ID');
+            requestIds = input.requestIds.map((requestId, index) => asNonEmptyString(requestId, `requestIds[${index}]`));
+        }
+        const result = await host.invoiceRequest({
+            path: '/api/inc/book/getReimburseWorkflowByRequestIds',
+            method: 'POST',
+            body: { requestIds },
+            operation: this.name,
+        });
+        return resultEnvelope(result, 'invoice.reim.workflow.resolve');
+    }
+}
+export class InvoiceReimFormStructureOperation {
+    name = 'invoice.reim.form.structure';
+    async execute(input, { host }) {
+        const result = await host.invoiceRequest({
+            path: '/api/inc/book/getFormStructure',
+            method: 'GET',
+            query: {
+                workflowId: asNonEmptyString(input.workflowId, 'workflowId'),
+                nodeId: optionalString(input.nodeId, 'nodeId') || '1',
+            },
+            operation: this.name,
+        });
+        return resultEnvelope(result, 'invoice.reim.form.structure');
+    }
+}
+export class InvoiceReimRowInfoOperation {
+    name = 'invoice.reim.row-info';
+    async execute(input, { host }) {
+        const session = await host.getSession();
+        const result = await host.invoiceFormRequest({
+            path: '/api/secondev/fna/expense/dataInfo/getRowInfo',
+            method: 'POST',
+            query: { sf_request_type: 'fetch' },
+            fields: {
+                cdzt: optionalString(input.cdzt, 'cdzt') || session.userId,
+                requestid: input.requestid === undefined ? '' : String(input.requestid),
+                invoiceId: asNonEmptyString(input.invoiceId, 'invoiceId'),
+            },
+            operation: this.name,
+        });
+        return resultEnvelope(result, 'invoice.reim.row-info');
+    }
+}
+export class InvoiceReimEmployeeSuperiorsOperation {
+    name = 'invoice.reim.employee-superiors';
+    async execute(_input, { host }) {
+        const result = await host.invoiceRequest({
+            path: '/api/inc/book/getEmployeeSuperiors',
+            method: 'GET',
+            operation: this.name,
+            rewriteJsonText: quoteEmployeeIdsInJsonText,
+        });
+        return employeeSuperiorsEnvelope(result);
+    }
+}
+export class InvoiceReimFieldSearchOperation {
+    name = 'invoice.reim.field.search';
+    async execute(input, { host }) {
+        const result = await host.invoiceRequest({
+            path: '/api/government/formStructure/fieldRelateSearch',
+            method: 'GET',
+            query: {
+                keywords: asNonEmptyString(input.keywords, 'keywords'),
+                fieldId: asNonEmptyString(input.fieldId, 'fieldId'),
+                formModeType: 'wf',
+                workflowId: asNonEmptyString(input.workflowId, 'workflowId'),
+                nodeId: optionalString(input.nodeId, 'nodeId') || '100004140000000271',
+            },
+            operation: this.name,
+        });
+        return resultEnvelope(result, 'invoice.reim.field.search');
+    }
+}
+export class InvoiceReimFlowCreatePrepareOperation {
+    name = 'invoice.reim.flow.create.prepare';
+    async execute(input, { host, continuation }) {
+        const payload = ensureFlowCreatePayload(input.payload);
+        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(payload),
+            preview: flowPreview(payload),
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview: flowPreview(payload),
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow('invoice.reim.flow.create', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class InvoiceReimFlowCreateApplyOperation {
+    name = 'invoice.reim.flow.create.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw invoiceConfirmationError('invoice.reim.flow.create.apply', { hint: '重新调用时传入 confirm=true' });
+        const lease = await continuation.verify(input.continuation, 'invoice.reim.flow.create.apply');
+        const payload = ensureFlowCreatePayload(input.payload);
+        if (typeof lease.fingerprint !== 'string')
+            throw invoiceValidationError('continuation_invalid', '报销单创建 continuation 缺少 payload 指纹');
+        if (objectFingerprint(payload) !== lease.fingerprint)
+            throw invoiceValidationError('target_changed', '报销单载荷与确认时不一致，请重新准备');
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备报销单创建');
+        let result;
+        try {
+            result = await host.invoiceRequest({ path: '/api/inc/book/createFlowNew', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
+        }
+        catch (error) {
+            if (isInvoiceNetworkError(error)) {
+                throw invoicePartialError('报销单创建请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow('invoice.reim.flow.create', 'EXECUTING'),
+                }, { stage: 'reim-flow-create' });
+            }
+            throw error;
+        }
+        assertBusinessSuccess(result, 'reim_flow_create_failed', '报销单创建失败');
+        const requestId = result?.data?.requestId || result?.requestId;
+        if (!requestId) {
+            throw invoicePartialError('报销单创建接口返回成功但缺少 requestId，结果不确定', {
+                preview: lease.preview,
+                result,
+                workflow: workflow('invoice.reim.flow.create', 'VERIFYING'),
+            }, { stage: 'reim-flow-create-response' });
+        }
+        const sessionContext = await host.getSession();
+        return {
+            status: 'COMPLETE',
+            data: {
+                requestId: String(requestId),
+                requestName: payload.request_name,
+                viewUrl: `${sessionContext.baseUrl}/sp/workflow/flowpage/view/${requestId}`,
+                result,
+                workflow: workflow('invoice.reim.flow.create', 'COMPLETE'),
+            },
+        };
+    }
+}
+export class InvoiceReimFlowUpdatePrepareOperation {
+    name = 'invoice.reim.flow.update.prepare';
+    async execute(input, { host, continuation }) {
+        const payload = ensureFlowUpdatePayload(input.payload);
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.reim.flow.update.apply',
+            workflow: workflow('invoice.reim.flow.update', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            fingerprint: objectFingerprint(payload),
+            preview: updatePreview(payload),
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview: updatePreview(payload),
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow('invoice.reim.flow.update', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class InvoiceReimFlowUpdateApplyOperation {
+    name = 'invoice.reim.flow.update.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw invoiceConfirmationError('invoice.reim.flow.update.apply', { hint: '重新调用时传入 confirm=true' });
+        const lease = await continuation.verify(input.continuation, 'invoice.reim.flow.update.apply');
+        const payload = ensureFlowUpdatePayload(input.payload);
+        if (typeof lease.fingerprint !== 'string')
+            throw invoiceValidationError('continuation_invalid', '报销单更新 continuation 缺少 payload 指纹');
+        if (objectFingerprint(payload) !== lease.fingerprint)
+            throw invoiceValidationError('target_changed', '报销单更新载荷与确认时不一致，请重新准备');
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备报销单更新');
+        let result;
+        try {
+            result = await host.invoiceRequest({ path: '/api/inc/book/updateFlow', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
+        }
+        catch (error) {
+            if (isInvoiceNetworkError(error)) {
+                throw invoicePartialError('报销单更新请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow('invoice.reim.flow.update', 'EXECUTING'),
+                }, { stage: 'reim-flow-update' });
+            }
+            throw error;
+        }
+        assertBusinessSuccess(result, 'reim_flow_update_failed', '报销单更新失败');
+        const data = result?.data || {};
+        if (data.deleteDetailSuccess === false || data.updateFormSuccess === false) {
+            throw invoicePartialError('报销单更新返回部分失败，可能已有部分变更生效', {
+                preview: lease.preview,
+                result,
+                workflow: workflow('invoice.reim.flow.update', 'VERIFYING'),
+            }, { stage: 'reim-flow-update-response' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                requestId: String(payload.requestId),
+                result,
+                workflow: workflow('invoice.reim.flow.update', 'COMPLETE'),
+            },
+        };
+    }
+}

package/dist/shortcuts/invoice/operations/shared.js

@@ -80,6 +80,58 @@ const UPDATE_FIELDS = new Map([
     ['currency', 'string'],
     ['currencyName', 'string'],
 ]);
+const BROWSE_TYPE_NAMES = new Map([
+    [1, '增值税专用发票'],
+    [2, '增值税普通发票'],
+    [3, '增值税电子普通发票'],
+    [4, '卷式发票'],
+    [5, '通行费增值税电子普通发票'],
+    [6, '机动车销售统一发票'],
+    [7, '定额发票'],
+    [8, '客运汽车票'],
+    [9, '航空运输电子客票行程单'],
+    [10, '火车票'],
+    [11, '出租车票'],
+    [12, '其他'],
+    [13, '汽车通行费发票'],
+    [14, '船票'],
+    [22, '二手车销售统一发票'],
+    [28, '增值税电子专用发票'],
+    [32, '电子发票（增值税专用发票）'],
+    [33, '电子发票（普通发票）'],
+    [47, '医疗收费票据'],
+    [48, '财政非税收入统一票据'],
+    [49, '海关进口增值税专用缴款书'],
+    [50, '电子发票服务平台纸质普票'],
+    [52, '完税凭证'],
+    [53, '国际小票'],
+    [54, '银行回单'],
+    [56, '代扣代缴税收缴款凭证'],
+]);
+const VALID_STATUS_NAMES = new Map([
+    [0, '未查验'],
+    [1, '有效已查验'],
+    [2, '有效未查验'],
+    [3, '查验失败'],
+    [4, '发票无效'],
+    [5, '票面校验不一致'],
+]);
+const SOURCE_NAMES = new Map([
+    [1, '微信'],
+    [2, '支付宝'],
+    [4, '邮箱'],
+    [5, '拍照'],
+    [6, '扫码'],
+    [7, '手动'],
+    [9, '查验录入'],
+    [10, '企业微信'],
+    [11, '公众号'],
+    [12, '企业台账'],
+    [13, '文件'],
+    [14, 'Excel'],
+    [15, '短信'],
+    [16, '链接录入'],
+]);
 export function asObject(value, name = '业务输入') {
     if (!value || typeof value !== 'object' || Array.isArray(value)) {
         throw invoiceValidationError('input_invalid', `${name}必须是 JSON 对象`);
@@ -92,6 +144,33 @@ export function asPositiveString(value, name) {
     }
     return value;
 }
+export function asNonEmptyString(value, name) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw invoiceValidationError('input_invalid', `${name} 必须是非空字符串`);
+    }
+    return value.trim();
+}
+export function normalizeIdList(value, name, { allowCommaString = false } = {}) {
+    const raw = allowCommaString && typeof value === 'string'
+        ? value.split(',').map((item) => item.trim()).filter(Boolean)
+        : value;
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw invoiceValidationError('input_invalid', `${name} 必须是非空数组`);
+    }
+    if (raw.length > 100)
+        throw invoiceValidationError('input_invalid', `${name} 单次最多支持 100 项`);
+    const ids = raw.map((item, index) => asPositiveString(String(item), `${name}[${index}]`));
+    if (new Set(ids).size !== ids.length)
+        throw invoiceValidationError('input_invalid', `${name} 不能包含重复 ID`);
+    return ids;
+}
+export function normalizeFids(input) {
+    if (input.fid !== undefined && input.fids !== undefined)
+        throw invoiceValidationError('input_ambiguous', 'fid 与 fids 只能提供一个');
+    if (input.fid !== undefined)
+        return [asPositiveString(String(input.fid), 'fid')];
+    return normalizeIdList(input.fids, 'fids');
+}
 export function reqBase({ numericTrace = false } = {}) {
     const trace = Date.now();
     return { trace: numericTrace ? trace : String(trace), dev: 1 };
@@ -226,6 +305,13 @@ export async function getDetail(input, host) {
         body: { ...body, userFlag: '1', isDelFlag: '1', req_base: reqBase() },
     });
 }
+export async function getDetailsByFids(fids, host) {
+    return host.invoiceRequest({
+        path: '/api/inc/get',
+        method: 'POST',
+        body: { ids: fids, mask: 0, userFlag: '1', isDelFlag: '1', req_base: reqBase() },
+    });
+}
 export function preview(info) {
     const p = info.comm_info?.pro || {};
     const price = info.comm_info?.price || {};
@@ -260,6 +346,167 @@ export function validationPreview(info, scope, targetFid) {
 export function workflow(name, state) {
     return { workflow: name, version: 1, state };
 }
+function stringOrEmpty(value) {
+    return value === undefined || value === null ? '' : String(value);
+}
+function numberOrZero(value) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function enumName(names, value) {
+    if (value === undefined || value === null || value === '')
+        return '';
+    return names.get(numberOrZero(value)) || '';
+}
+function parseExt(extRaw) {
+    if (typeof extRaw !== 'string' || !extRaw.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(extRaw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function dateToTimestampMs(date) {
+    if (typeof date !== 'string' || !/^\d{4}-\d{2}-\d{2}$/u.test(date))
+        return 0;
+    const timestamp = Date.parse(`${date}T00:00:00+08:00`);
+    return Number.isFinite(timestamp) ? timestamp : 0;
+}
+function contentFor(typeName, number) {
+    if (typeName && number)
+        return `${typeName}-${number}`;
+    return typeName || number || '';
+}
+function cents(value) {
+    if (value === undefined || value === null || value === '')
+        return 0;
+    const text = String(value);
+    const match = /^(-?\d+)(?:\.(\d{1,2}))?$/u.exec(text);
+    if (!match)
+        return null;
+    const whole = Number(match[1]);
+    const fraction = Number((match[2] || '').padEnd(2, '0'));
+    return whole * 100 + (whole < 0 ? -fraction : fraction);
+}
+function moneyMinus(total, reiming, reimed) {
+    if ((reiming === undefined || reiming === null || reiming === '') && (reimed === undefined || reimed === null || reimed === '')) {
+        return stringOrEmpty(total);
+    }
+    const totalCents = cents(total);
+    const reimingCents = cents(reiming);
+    const reimedCents = cents(reimed);
+    if (totalCents === null || reimingCents === null || reimedCents === null)
+        return stringOrEmpty(total);
+    const value = totalCents - reimingCents - reimedCents;
+    const sign = value < 0 ? '-' : '';
+    const absolute = Math.abs(value);
+    const whole = Math.floor(absolute / 100);
+    const fraction = absolute % 100;
+    return fraction === 0 ? `${sign}${whole}` : `${sign}${whole}.${String(fraction).padStart(2, '0')}`;
+}
+function extProductNames(products) {
+    if (!Array.isArray(products))
+        return '';
+    return products
+        .map((item) => item && typeof item === 'object' ? stringOrEmpty(item.productName || item.name) : '')
+        .filter(Boolean)
+        .join('、');
+}
+export function browseFieldItem(info) {
+    const comm = info.comm_info || {};
+    const pro = comm.pro || {};
+    const price = comm.price || {};
+    const buyer = comm.buyer || {};
+    const payer = comm.payer || {};
+    const modify = info.modify_info || {};
+    const ext = parseExt(info.ext);
+    const products = Array.isArray(ext.products) ? ext.products : [];
+    const fid = stringOrEmpty(info.fid || info.id);
+    const type = numberOrZero(pro.type);
+    const typeName = stringOrEmpty(pro.cname) || BROWSE_TYPE_NAMES.get(type) || '未知票种';
+    const number = stringOrEmpty(info.number);
+    const content = contentFor(typeName, number);
+    const total = stringOrEmpty(price.total);
+    const reimingMoney = typeof price.reimingMoney === 'string' ? price.reimingMoney : '';
+    const reimedMoney = typeof price.reimedMoney === 'string' ? price.reimedMoney : '';
+    const firstProduct = products.find((item) => item && typeof item === 'object');
+    return {
+        optionId: fid,
+        id: fid,
+        fid,
+        type,
+        typeName,
+        number,
+        code: stringOrEmpty(info.code),
+        content,
+        name: content,
+        total,
+        ttax: stringOrEmpty(ext.ttax),
+        seller: stringOrEmpty(payer.company),
+        sellerId: stringOrEmpty(payer.tcode),
+        buyer: stringOrEmpty(buyer.company),
+        buyerId: stringOrEmpty(buyer.tcode),
+        incDate: stringOrEmpty(pro.date),
+        incDateTimestamp: dateToTimestampMs(pro.date),
+        validStatus: enumName(VALID_STATUS_NAMES, pro.valid),
+        source: enumName(SOURCE_NAMES, modify.source),
+        invoiceStatus: numberOrZero(pro.status),
+        del: numberOrZero(modify.del),
+        currency: stringOrEmpty(info.currency) || 'CNY',
+        currencyName: stringOrEmpty(info.currencyName) || '人民币',
+        taxRate: stringOrEmpty(ext.taxRate || ext.trate || firstProduct?.taxRate || firstProduct?.trate),
+        consumeContent: stringOrEmpty(ext.content) || extProductNames(products),
+        fylx: stringOrEmpty(info.fylx) || '0',
+        inputDate: stringOrEmpty(modify.createDate || modify.modifyDate),
+        incTotal: 0,
+        reimingMoney,
+        reimedMoney,
+        notReimMoney: moneyMinus(total, reimingMoney, reimedMoney),
+        reimDate: '',
+        reimProcess: '',
+    };
+}
+export function browseFieldData(response) {
+    const ret = response.res_base?.ret;
+    if (ret !== undefined && ret !== 0) {
+        throw new InvoiceCliError('api', 'detail_failed', response.res_base?.message || '详情接口整体失败', {
+            code: ret,
+            details: { res_base: response.res_base },
+            exitCode: 1,
+        });
+    }
+    const items = [];
+    const errors = [];
+    for (const entry of Array.isArray(response.infos) ? response.infos : []) {
+        const itemRet = entry?.ret?.ret;
+        if (itemRet !== 0) {
+            errors.push({
+                fid: stringOrEmpty(entry?.info?.fid || entry?.info?.id),
+                ret: itemRet,
+                message: entry?.ret?.message || '查询失败',
+            });
+            continue;
+        }
+        if (entry?.info && typeof entry.info === 'object')
+            items.push(browseFieldItem(entry.info));
+    }
+    return { items, errors };
+}
+export function assertBusinessSuccess(value, subtype, fallbackMessage) {
+    const result = value && typeof value === 'object' ? value : {};
+    const code = result.code ?? result.res_base?.ret;
+    const failed = result.fail === true || result.status === false || (code !== undefined && code !== 0 && code !== 200);
+    if (!failed)
+        return;
+    throw new InvoiceCliError('api', subtype, result.message || result.msg || result.res_base?.message || fallbackMessage, {
+        code,
+        details: { result },
+        exitCode: 1,
+    });
+}
 function uploadSource(input) {
     const { file, url } = input;
     if (file !== undefined && url !== undefined)