weaver-work-cli 0.1.25 → 0.1.26

package/dist/shortcuts/invoice/manifest.js

@@ -673,6 +673,66 @@ const issuingApplyOutputSchema = objectSchema({
     result: rawObject,
     workflow: workflowSchema,
 }, ['mode', 'ledgerOnly', 'result', 'workflow']);
+const qysOptionValue = {
+    type: ['object', 'null'],
+    additionalProperties: false,
+    properties: { id: { type: 'string' }, name: { type: 'string' } },
+};
+const nullableText = { type: ['string', 'null'] };
+const qysLedgerRowSchema = objectSchema({
+    formDataId: { type: 'string' },
+    title: nullableText,
+    dataStatus: nullableText,
+    contractNo: nullableText,
+    contractFlow: qysOptionValue,
+    invoiceType: qysOptionValue,
+    purchaserName: nullableText,
+    purchaserTaxNo: nullableText,
+    invoiceItemName: nullableText,
+    goodsName: nullableText,
+    revenueCode: nullableText,
+    taxRate: qysOptionValue,
+    quantity: nullableText,
+    unitPrice: nullableText,
+    amount: { ...nullableText, description: '开票金额（不含税）' },
+    invoiceNo: nullableText,
+    invoiceFlow: qysOptionValue,
+    discarded: qysOptionValue,
+}, ['formDataId'], true);
+const qysListOutputSchema = objectSchema({
+    items: arrayOf(objectSchema({
+        issuable: { type: 'boolean' },
+        blockers: arrayOf({ type: 'string' }),
+    }, ['formDataId', 'issuable', 'blockers'], true)),
+    matched: { type: 'integer' },
+    truncated: { type: 'boolean' },
+    scanned: { type: 'integer' },
+    scanComplete: { type: 'boolean' },
+}, ['items', 'matched', 'truncated', 'scanned', 'scanComplete']);
+const qysPreviewSchema = objectSchema({
+    ...makeInvoicePreviewSchema.properties,
+    formDataId: { type: 'string' },
+    contractNo: { type: 'string' },
+    contractFlowName: { type: 'string' },
+    invoiceTypeName: { type: 'string' },
+    goodsName: { type: 'string' },
+    taxRate: { type: 'string' },
+}, [...makeInvoicePreviewSchema.required, 'formDataId', 'goodsName', 'taxRate']);
+const qysPrepareOutputSchema = continuationPreviewOutput(qysPreviewSchema, {
+    warnings: arrayOf({ type: 'string' }),
+    ledgerRow: qysLedgerRowSchema,
+    normalizedPayload: requestPayload,
+});
+const issuingResultOutputSchema = objectSchema({
+    externalDocumentNo: { type: 'string' },
+    state: { type: 'string', enum: ['SUCCESS', 'PENDING', 'FAILED'] },
+    returnCode: { type: 'string' },
+    returnMessage: { type: 'string' },
+    invoiceNo: { type: 'string' },
+    invoiceTime: { type: 'string' },
+    serialNo: { type: 'string' },
+    result: rawObject,
+}, ['externalDocumentNo', 'state', 'returnCode', 'returnMessage', 'invoiceNo', 'result']);
 export const invoiceOperations = [
     {
         name: 'invoice.list',
@@ -1219,6 +1279,57 @@ export const invoiceOperations = [
         },
         outputSchema: issuingApplyOutputSchema,
     },
+    {
+        name: 'invoice.issuing.qys.list',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/eblist/getData', ledger: '契约锁合同商品信息' },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                keyword: { type: 'string', description: '模糊匹配合同号、购买方名称、合同审批流程名称、商品名称或开票名称' },
+                contractNo: { type: 'string', description: '按合同号精确筛选' },
+                includeIssued: { type: 'boolean', default: false, description: '是否包含已开票、开票中或已废弃的行。默认 false 只返回可开票行。' },
+                limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },
+            },
+        },
+        outputSchema: qysListOutputSchema,
+    },
+    {
+        name: 'invoice.issuing.qys.prepare',
+        risk: 'read-before-write',
+        fixed: {
+            path: '/api/ebuilder/form/eblist/getData',
+            externalDocumentNo: 'QYS-{formDataId}',
+            amountBasis: '开票金额为不含税金额，taxSign=0，税额=金额×税率四舍五入到分',
+            applyOperation: 'invoice.issuing.make.apply',
+        },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                formDataId: { type: 'string', pattern: '^\\d+$', description: 'invoice.issuing.qys.list 返回的台账行 formDataId' },
+                mode: { type: 'string', enum: ['issue', 'ledger'] },
+            },
+            required: ['formDataId', 'mode'],
+        },
+        outputSchema: qysPrepareOutputSchema,
+    },
+    {
+        name: 'invoice.issuing.result',
+        risk: 'read',
+        fixed: { path: '/api/inc/book/open/getMakeInvoiceResult', taxNo: '9131000070322836XD' },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                externalDocumentNo: { type: 'string', minLength: 1 },
+                serialNo: { type: 'string' },
+            },
+            required: ['externalDocumentNo'],
+        },
+        outputSchema: issuingResultOutputSchema,
+    },
 ];
 export const invoiceManifest = {
     schemaVersion: 1,

package/dist/shortcuts/invoice/operations/issuing-qys.js

@@ -0,0 +1,361 @@
+import { InvoiceCliError, invoiceValidationError } from '../errors.js';
+import { SELLER_TAX_NO, makeInvoicePreview, normalizeMakeInvoicePayload, normalizeMode, } from './issuing.js';
+import { asNonEmptyString, assertBusinessSuccess, objectFingerprint, workflow } from './shared.js';
+const LEDGER_PATH = '/api/ebuilder/form/eblist/getData';
+const LEDGER_PAGE_ID = '1314988320430981804';
+const LEDGER_APP_ID = '846297243998732291';
+const LEDGER_MENU_ID = '5419015526244625718';
+const LEDGER_PAGE_TITLE = '5aWR57qm6ZSB5ZCI5ZCM5ZWG5ZOB5L h5oGv';
+const LEDGER_PAGE_SIZE = 50;
+const LEDGER_MAX_PAGES = 40;
+const RESULT_PATH = '/api/inc/book/open/getMakeInvoiceResult';
+/** 契约锁合同商品信息表：数据 key → 可读字段。 */
+export const QYS_LEDGER_FIELDS = [
+    { id: '1314988311673275798', key: 'contractNo', label: '合同号', kind: 'text' },
+    { id: '1314988311673275801', key: 'contractFlow', label: '合同审批流程', kind: 'relation' },
+    { id: '1314988311673275775', key: 'contractCategory', label: '合同种类', kind: 'text' },
+    { id: '1314988311673275790', key: 'productType', label: '产品类型', kind: 'option' },
+    { id: '1314988311673275776', key: 'productTypeDetail', label: '产品类型明细', kind: 'text' },
+    { id: '1314988311673275783', key: 'accountingCompany', label: '核算公司', kind: 'option' },
+    { id: '1314988311673275784', key: 'invoiceGroupFlag', label: '开票分组标识', kind: 'number' },
+    { id: '1314988311673275793', key: 'sourceFlag', label: '来源标识', kind: 'text' },
+    { id: '1314988311673275808', key: 'flowDetailId', label: '流程明细的id', kind: 'text' },
+    { id: '1314988311673275781', key: 'invoiceType', label: '发票类型', kind: 'option' },
+    { id: '1314988311673275806', key: 'purchaserName', label: '购买方名称', kind: 'text' },
+    { id: '1314988311673275807', key: 'purchaserTaxNo', label: '购买方税号', kind: 'text' },
+    { id: '1314988311673275809', key: 'purchaserAddress', label: '购买方地址', kind: 'text' },
+    { id: '1314988311673275810', key: 'purchaserTel', label: '购买方电话', kind: 'text' },
+    { id: '1314988311673275811', key: 'purchaserBankName', label: '购买方开户行', kind: 'text' },
+    { id: '1314988311673275802', key: 'purchaserBankAccount', label: '购买方开户行账号', kind: 'text' },
+    { id: '1314988311673275800', key: 'invoiceItemName', label: '开票名称', kind: 'text' },
+    { id: '1314988311673275799', key: 'goodsName', label: '商品名称', kind: 'text' },
+    { id: '1314988311673275803', key: 'revenueCode', label: '商品税收分类编码', kind: 'text' },
+    { id: '1314988311673275804', key: 'taxRate', label: '商品税率', kind: 'relation' },
+    { id: '1314988311673275780', key: 'specification', label: '规格型号', kind: 'text' },
+    { id: '1314988311673275785', key: 'unit', label: '单位', kind: 'text' },
+    { id: '1314988311673275805', key: 'quantity', label: '商品数量', kind: 'number' },
+    { id: '1314988311673275794', key: 'unitPrice', label: '商品单价', kind: 'money' },
+    { id: '1314988311673275795', key: 'amount', label: '开票金额', kind: 'money' },
+    { id: '1314988311673275789', key: 'uninvoicedAmount', label: '未开票金额', kind: 'money' },
+    { id: '1314988311673275787', key: 'invoicedAmount', label: '已开票金额', kind: 'money' },
+    { id: '1314988311673275788', key: 'invoicingAmount', label: '开票中金额', kind: 'money' },
+    { id: '1314988311673275777', key: 'amountDiffers', label: '开票金额存在差异', kind: 'option' },
+    { id: '1314988311673275796', key: 'thirdPartyPurchase', label: '是否三方采购商品', kind: 'option' },
+    { id: '1314988311673275812', key: 'invoiceNo', label: '发票号码', kind: 'text' },
+    { id: '1314988311673275797', key: 'invoiceFlow', label: '开票流程ID', kind: 'relation' },
+    { id: '1314988311673275791', key: 'invoiceDate', label: '开票时间', kind: 'date' },
+    { id: '1314988311673275792', key: 'discarded', label: '是否废弃', kind: 'option' },
+    { id: '1314988311673275778', key: 'discardedDate', label: '废弃时间', kind: 'date' },
+    { id: '1314988311673275779', key: 'contactName', label: '客户联系人', kind: 'text' },
+    { id: '1314988311673275782', key: 'contactPhone', label: '客户联系人电话', kind: 'text' },
+    { id: '1314988311673275786', key: 'contactEmail', label: '客户联系人邮箱', kind: 'text' },
+];
+function textValue(value) {
+    if (value === undefined || value === null)
+        return null;
+    const text = String(value);
+    return text.trim() === '' ? null : text;
+}
+function optionValue(value) {
+    const first = Array.isArray(value) ? value[0] : value;
+    if (!first || typeof first !== 'object')
+        return null;
+    const item = first;
+    const id = textValue(item.id);
+    const name = textValue(item.name);
+    if (id === null && name === null)
+        return null;
+    return { id: id ?? '', name: name ?? '' };
+}
+export function convertQysLedgerRow(raw) {
+    const formDataId = textValue(raw.form_data_id) ?? textValue(raw.id);
+    if (!formDataId)
+        throw invoiceValidationError('ledger_row_invalid', '台账行缺少 form_data_id');
+    const row = {
+        formDataId,
+        title: textValue(raw.name),
+        dataStatus: optionValue(raw.data_status)?.name ?? null,
+    };
+    for (const field of QYS_LEDGER_FIELDS) {
+        const value = raw[field.id];
+        row[field.key] = field.kind === 'option' || field.kind === 'relation' ? optionValue(value) : textValue(value);
+    }
+    return row;
+}
+function toCents(value, name) {
+    if (value === null || !/^\d+(?:\.\d{1,2})?$/u.test(value)) {
+        throw invoiceValidationError('ledger_amount_invalid', `${name} 必须是最多两位小数的非负金额，当前值：${value ?? '空'}`);
+    }
+    const [whole, fraction = ''] = value.split('.');
+    return Number(whole) * 100 + Number(fraction.padEnd(2, '0'));
+}
+function formatCents(cents) {
+    return `${Math.floor(cents / 100)}.${String(cents % 100).padStart(2, '0')}`;
+}
+/** “6.0%” → 600（万分比），只接受开票接口支持的税率。 */
+export function parseTaxRateBasisPoints(name) {
+    const match = typeof name === 'string' ? /^\s*(\d+(?:\.\d+)?)\s*%\s*$/u.exec(name) : null;
+    const basisPoints = match ? Math.round(Number(match[1]) * 100) : Number.NaN;
+    if (![0, 100, 300, 500, 600, 900, 1300].includes(basisPoints)) {
+        throw invoiceValidationError('ledger_tax_rate_invalid', `商品税率无法识别或不在允许范围内：${name ?? '空'}`);
+    }
+    return basisPoints;
+}
+function isPositiveCents(value) {
+    return value !== null && /^\d+(?:\.\d+)?$/u.test(value) && Number(value) > 0;
+}
+/** 已开票、开票中或已废弃的行不能再开票，返回原因；可开票时返回空数组。 */
+export function qysRowBlockers(row) {
+    const blockers = [];
+    if (row.invoiceNo)
+        blockers.push(`已有发票号码 ${row.invoiceNo}`);
+    if (row.invoiceFlow)
+        blockers.push(`已关联开票流程 ${row.invoiceFlow.name || row.invoiceFlow.id}`);
+    if (isPositiveCents(row.invoicingAmount))
+        blockers.push(`开票中金额 ${row.invoicingAmount}`);
+    if (row.discarded?.name === '是' || row.discardedDate)
+        blockers.push('已废弃');
+    return blockers;
+}
+async function fetchLedgerPage(host, pageNo, operation) {
+    const fieldFilter = {
+        cusMenuId: LEDGER_MENU_ID,
+        urlPageTitle: LEDGER_PAGE_TITLE,
+        [`appId_${LEDGER_PAGE_ID}`]: LEDGER_APP_ID,
+        cusview: '0',
+    };
+    const result = await host.invoiceMultipartRequest({
+        path: LEDGER_PATH,
+        headers: { ebbusinessid: LEDGER_PAGE_ID },
+        fields: {
+            ...fieldFilter,
+            filter: '[]',
+            fieldFilter,
+            pageFilter: { filter: {}, filterIsNull: true, esbFilter: [] },
+            pageAppId: LEDGER_APP_ID,
+            compId: 'e00e8244de584b369417a4fea31d7bed',
+            pageId: LEDGER_PAGE_ID,
+            pageNo: String(pageNo),
+            pageSize: String(LEDGER_PAGE_SIZE),
+            tableuid: 'a74d995bddd54a4f831551b468071632',
+            refPluginPackageId: '933846626099339271',
+        },
+        operation,
+    });
+    assertBusinessSuccess(result, 'qys_ledger_query_failed', '契约锁开票台账查询失败');
+    const list = result?.data?.list;
+    if (!Array.isArray(list)) {
+        throw new InvoiceCliError('api', 'qys_ledger_query_failed', '契约锁开票台账返回缺少 data.list', { exitCode: 1 });
+    }
+    return list;
+}
+/** 接口返回的 count 恒为 0，只能按“本页未取满”判断结束。 */
+async function scanLedger(host, operation, visit) {
+    let scanned = 0;
+    for (let pageNo = 1; pageNo <= LEDGER_MAX_PAGES; pageNo += 1) {
+        const page = await fetchLedgerPage(host, pageNo, operation);
+        for (const raw of page) {
+            scanned += 1;
+            if (visit(convertQysLedgerRow(raw)))
+                return { scanned, complete: true };
+        }
+        if (page.length < LEDGER_PAGE_SIZE)
+            return { scanned, complete: true };
+    }
+    return { scanned, complete: false };
+}
+function matchesKeyword(row, keyword) {
+    const haystack = [row.contractNo, row.purchaserName, row.contractFlow?.name, row.goodsName, row.invoiceItemName, row.formDataId];
+    return haystack.some((value) => typeof value === 'string' && value.includes(keyword));
+}
+export class InvoiceIssuingQysListOperation {
+    name = 'invoice.issuing.qys.list';
+    async execute(input, { host }) {
+        const keyword = input.keyword === undefined || input.keyword === '' ? undefined : asNonEmptyString(input.keyword, 'keyword');
+        const contractNo = input.contractNo === undefined || input.contractNo === '' ? undefined : asNonEmptyString(input.contractNo, 'contractNo');
+        const includeIssued = input.includeIssued === true;
+        const limit = input.limit === undefined ? 20 : Number(input.limit);
+        if (!Number.isInteger(limit) || limit < 1 || limit > 100)
+            throw invoiceValidationError('input_invalid', 'limit 必须是 1-100 的整数');
+        const items = [];
+        let matched = 0;
+        const scan = await scanLedger(host, this.name, (row) => {
+            if (contractNo && row.contractNo !== contractNo)
+                return false;
+            if (keyword && !matchesKeyword(row, keyword))
+                return false;
+            const blockers = qysRowBlockers(row);
+            if (!includeIssued && blockers.length)
+                return false;
+            matched += 1;
+            if (items.length < limit)
+                items.push({ ...row, issuable: blockers.length === 0, blockers });
+            return false;
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                items,
+                matched,
+                truncated: matched > items.length,
+                scanned: scan.scanned,
+                scanComplete: scan.complete,
+            },
+        };
+    }
+}
+export function buildQysMakeInvoicePayload(row) {
+    const warnings = [];
+    const invoiceType = row.invoiceType?.id;
+    if (!invoiceType)
+        throw invoiceValidationError('ledger_field_missing', '台账行缺少发票类型');
+    const goodsName = row.invoiceItemName ?? row.goodsName;
+    if (!goodsName)
+        throw invoiceValidationError('ledger_field_missing', '台账行缺少开票名称和商品名称');
+    if (!row.purchaserName)
+        throw invoiceValidationError('ledger_field_missing', '台账行缺少购买方名称');
+    const basisPoints = parseTaxRateBasisPoints(row.taxRate?.name);
+    const amountCents = toCents(row.amount, '开票金额');
+    if (amountCents === 0)
+        throw invoiceValidationError('ledger_amount_invalid', '开票金额必须大于 0');
+    const taxCents = Math.floor((amountCents * basisPoints + 5000) / 10000);
+    const amount = formatCents(amountCents);
+    const taxAmount = formatCents(taxCents);
+    const amountWithTax = formatCents(amountCents + taxCents);
+    if (row.quantity !== null && row.unitPrice !== null) {
+        const expected = Number(row.quantity) * Number(row.unitPrice);
+        if (!Number.isFinite(expected) || Math.abs(expected * 100 - amountCents) > 1) {
+            warnings.push(`商品数量 ${row.quantity} × 商品单价 ${row.unitPrice} 与开票金额 ${row.amount} 不一致`);
+        }
+    }
+    if (row.uninvoicedAmount !== null && row.uninvoicedAmount !== row.amount && Number(row.uninvoicedAmount) !== Number(row.amount)) {
+        warnings.push(`未开票金额 ${row.uninvoicedAmount} 与开票金额 ${row.amount} 不一致，本次按开票金额全额开具`);
+    }
+    if (row.dataStatus && row.dataStatus !== '提交')
+        warnings.push(`台账数据状态为“${row.dataStatus}”`);
+    const detail = {
+        goodsName,
+        taxSign: '0',
+        taxRate: basisPoints / 10000,
+        amount,
+        taxAmount,
+        amountWithTax,
+    };
+    for (const key of ['revenueCode', 'specification', 'unit', 'quantity', 'unitPrice']) {
+        if (row[key] !== null)
+            detail[key] = row[key];
+    }
+    const payload = {
+        invoiceType,
+        externalDocumentNo: `QYS-${row.formDataId}`,
+        purchaserName: row.purchaserName,
+        taxSign: '0',
+        totalAmount: amount,
+        taxAmount,
+        totalAmountWithTax: amountWithTax,
+        details: [detail],
+    };
+    for (const key of ['purchaserTaxNo', 'purchaserAddress', 'purchaserTel', 'purchaserBankName', 'purchaserBankAccount']) {
+        if (row[key] !== null)
+            payload[key] = row[key];
+    }
+    return { payload, warnings };
+}
+export class InvoiceIssuingQysPrepareOperation {
+    name = 'invoice.issuing.qys.prepare';
+    async execute(input, { host, continuation }) {
+        const mode = normalizeMode(input.mode);
+        const formDataId = asNonEmptyString(input.formDataId, 'formDataId');
+        if (!/^\d+$/u.test(formDataId))
+            throw invoiceValidationError('input_invalid', 'formDataId 必须是台账行的数字 ID');
+        let row;
+        const scan = await scanLedger(host, this.name, (candidate) => {
+            if (candidate.formDataId !== formDataId)
+                return false;
+            row = candidate;
+            return true;
+        });
+        if (!row) {
+            throw invoiceValidationError('ledger_row_not_found', `契约锁开票台账中未找到 formDataId=${formDataId} 的行`, {
+                scanned: scan.scanned,
+                scanComplete: scan.complete,
+            });
+        }
+        const blockers = qysRowBlockers(row);
+        if (blockers.length) {
+            throw invoiceValidationError('ledger_row_not_issuable', `该台账行不能开票：${blockers.join('；')}`, { formDataId, blockers });
+        }
+        const { payload, warnings } = buildQysMakeInvoicePayload(row);
+        const normalizedPayload = normalizeMakeInvoicePayload(payload, mode);
+        const preview = {
+            ...makeInvoicePreview(normalizedPayload, mode),
+            formDataId,
+            contractNo: row.contractNo ?? '',
+            contractFlowName: row.contractFlow?.name ?? '',
+            invoiceTypeName: row.invoiceType?.name ?? '',
+            goodsName: normalizedPayload.details[0].goodsName,
+            taxRate: row.taxRate?.name ?? '',
+        };
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.issuing.make.apply',
+            workflow: workflow('invoice.issuing.make', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            mode,
+            fingerprint: objectFingerprint(normalizedPayload),
+            preview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview,
+                warnings,
+                ledgerRow: row,
+                normalizedPayload,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow('invoice.issuing.make', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+function resultState(returnCode) {
+    if (returnCode === '00')
+        return 'SUCCESS';
+    if (returnCode === '01')
+        return 'PENDING';
+    return 'FAILED';
+}
+export class InvoiceIssuingResultOperation {
+    name = 'invoice.issuing.result';
+    async execute(input, { host }) {
+        const externalDocumentNo = asNonEmptyString(input.externalDocumentNo, 'externalDocumentNo');
+        const invoiceReq = { businessNo: externalDocumentNo, taxNo: SELLER_TAX_NO };
+        if (input.serialNo !== undefined && input.serialNo !== '')
+            invoiceReq.serialNo = asNonEmptyString(input.serialNo, 'serialNo');
+        const result = await host.invoiceRequest({
+            path: RESULT_PATH,
+            method: 'POST',
+            body: { invoiceReq },
+            operation: this.name,
+            timeoutMs: 60_000,
+        });
+        assertBusinessSuccess(result, 'issuing_result_failed', '查询开票结果失败');
+        const data = result?.data || {};
+        return {
+            status: 'COMPLETE',
+            data: {
+                externalDocumentNo,
+                state: resultState(data.returnCode),
+                returnCode: data.returnCode ?? '',
+                returnMessage: data.returnMessage ?? '',
+                invoiceNo: data.digitInvoiceNo || data.invoiceNo || '',
+                invoiceTime: data.invoiceTime ?? '',
+                serialNo: data.serialNo ?? '',
+                result,
+            },
+        };
+    }
+}

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

@@ -1,6 +1,6 @@
 import { invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
 import { asNonEmptyString, asObject, assertBusinessSuccess, objectFingerprint, sessionMatches, workflow, } from './shared.js';
-const SELLER_TAX_NO = '9131000070322836XD';
+export const SELLER_TAX_NO = '9131000070322836XD';
 const SELLER_NAME = '上海泛微网络科技股份有限公司';
 const TAX_RATES = new Set([0, 0.01, 0.03, 0.05, 0.06, 0.09, 0.13]);
 function optionalText(value, name) {
@@ -38,7 +38,7 @@ function taxNo(value, name, { required = false } = {}) {
     }
     return text;
 }
-function normalizeMode(value) {
+export function normalizeMode(value) {
     if (value !== 'issue' && value !== 'ledger') {
         throw invoiceValidationError('input_invalid', 'mode 必须是 issue 或 ledger');
     }
@@ -61,7 +61,7 @@ function normalizeDetail(value, index) {
     }
     return detail;
 }
-function normalizeMakeInvoicePayload(rawPayload, mode) {
+export function normalizeMakeInvoicePayload(rawPayload, mode) {
     const payload = structuredClone(asObject(rawPayload, 'payload'));
     const purchaserName = asNonEmptyString(payload.purchaserName, 'payload.purchaserName');
     const invoiceType = asNonEmptyString(payload.invoiceType, 'payload.invoiceType');
@@ -104,7 +104,7 @@ function normalizeMakeInvoicePayload(rawPayload, mode) {
         delete normalized.operateType;
     return normalized;
 }
-function makeInvoicePreview(payload, mode) {
+export function makeInvoicePreview(payload, mode) {
     return {
         mode,
         purchaserName: payload.purchaserName,
@@ -163,7 +163,7 @@ export class InvoiceIssuingMakeApplyOperation {
             throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备开票');
         let result;
         try {
-            result = await host.invoiceRequest({ path: '/api/inc/book/open/makeInvoice', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
+            result = await host.invoiceRequest({ path: '/api/inc/book/open/makeInvoice', method: 'POST', body: { invoiceReq: payload }, operation: this.name, timeoutMs: 90_000 });
         }
         catch (error) {
             if (isInvoiceNetworkError(error)) {

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

@@ -7,6 +7,7 @@ import { InvoiceDownloadOperation } from './download.js';
 import { InvoiceGetOperation } from './get.js';
 import { InvoiceImportApplyOperation, InvoiceImportPrepareOperation } from './import.js';
 import { InvoiceIssuingMakeApplyOperation, InvoiceIssuingMakePrepareOperation } from './issuing.js';
+import { InvoiceIssuingQysListOperation, InvoiceIssuingQysPrepareOperation, InvoiceIssuingResultOperation, } from './issuing-qys.js';
 import { InvoiceListOperation } from './list.js';
 import { InvoiceOcrPreviewOperation } from './ocr-preview.js';
 import { InvoiceReimEmployeeSuperiorsOperation, InvoiceReimFieldSearchOperation, InvoiceReimFileOcrPreviewOperation, InvoiceReimFlowCreateApplyOperation, InvoiceReimFlowCreatePrepareOperation, InvoiceReimFlowUpdateApplyOperation, InvoiceReimFlowUpdatePrepareOperation, InvoiceReimFormStructureOperation, InvoiceReimRequestsListOperation, InvoiceReimRowInfoBatchOperation, InvoiceReimRowInfoOperation, InvoiceReimWorkflowResolveOperation, } from './reim.js';
@@ -52,6 +53,9 @@ function buildRegistry() {
         new InvoiceReimFlowUpdateApplyOperation(),
         new InvoiceIssuingMakePrepareOperation(),
         new InvoiceIssuingMakeApplyOperation(),
+        new InvoiceIssuingQysListOperation(),
+        new InvoiceIssuingQysPrepareOperation(),
+        new InvoiceIssuingResultOperation(),
     ];
     for (const handler of handlers) {
         if (registry.has(handler.name))

package/dist/shortcuts/workflow/endpoints.js

@@ -50,6 +50,11 @@ export const WORKFLOW_ENDPOINTS = {
     /** 我发起总数 / 列表 */
     MINE_TOTAL: '/api/workflow/list/total/getMineListTotal',
     MINE_LIST: '/api/workflow/list/data/getMineListData',
+    /**
+     * 我发起——**工作流树**（`data.data[]` = 流程大类，`children` = 具体工作流，`id` 形如 `wf_<workflowId>`）。
+     * 入参与 `MINE_LIST` 一致、去掉分页参数。发起侧消歧用（2026-10-20）。
+     */
+    MINE_TREE: '/api/workflow/list/tree/getMineListTree',
     /** 全部总数 / 列表 */
     ALL_TOTAL: '/api/workflow/list/total/getAllListTotal',
     ALL_LIST: '/api/workflow/list/data/getAllListData',
@@ -138,6 +143,12 @@ export const FORM_ENDPOINTS = {
     verificationConditionRule: '/api/bs/workflow/pathdef/nodeConformance/verificationConditionRule',
     /** 提交已创建的流程（创建后页面重载拿到 view 页鉴权再提交，与真机同路径） */
     flowSubmit: '/api/workflow/core/flow/submit',
+    /**
+     * 签字意见的默认样式（字体 / 字号 / 是否纯文本输入）。
+     *
+     * 提交前取一次，用来把意见内容包成服务端能正确渲染的富文本形态；取不到就退回原样式。
+     */
+    signInputInfo: '/api/workflow/core/flowPage/loadSignInputInfo',
     /** 租户级文件上传设置（单文件大小上限 + 格式黑白名单） */
     tenantSetting: '/api/file/tenant/setting',
 };

package/dist/shortcuts/workflow/host.js

@@ -150,7 +150,7 @@ export function createWorkflowHost(ctx, dependencies = {}) {
         return sessionContext;
     }
     async function run(request, responseType) {
-        const { method = 'POST', path, query, body, form, formData, operation, timeoutMs = DEFAULT_TIMEOUT_MS, } = request;
+        const { method = 'POST', path, query, headers, body, form, formData, operation, timeoutMs = DEFAULT_TIMEOUT_MS, } = request;
         const runtime = createE10RequestRuntime(ctx, await ensureSession(), {
             interceptors: dependencies.interceptors,
             fetch: dependencies.fetch,
@@ -160,7 +160,7 @@ export function createWorkflowHost(ctx, dependencies = {}) {
         });
         let response;
         try {
-            const base = { method, path, query, body, form, formData, operation, timeoutMs, module: 'workflow' };
+            const base = { method, path, query, headers, body, form, formData, operation, timeoutMs, module: 'workflow' };
             response = responseType === 'binary'
                 ? await runtime.requestBinary(base)
                 : await runtime.requestJson(base);

package/dist/shortcuts/workflow/index.js

@@ -81,47 +81,17 @@ function failureEnvelope(error) {
  */
 export { compactStdoutPaths };
 /**
- * 「stdout 整体直出」的判定 —— 目前**只有小e 环境的 `BROWSER_FILL` 一档**适用。
- *
- * 用户 2026-10-15 裁定：「xiaoe 下应该直接输出 `<browsertool>` 标签」。即该档的 stdout **就是**
- * 那段标签块本身，**不再套** `{schemaVersion, ok, operation, data, warnings}` 信封 —— 于是
- * `workflow-create.md` 里「返回内容以 `<browsertool>` 开头 ⇒ 原样输出」这句是**字面成立**的。
- * 代价（用户已知悉并接受）：这一档模型拿不到 `status` / `contextId`（本档不写服务端、句柄也未消费，
- * 需要重发时由用户重新发起即可）。
- *
- * 两个条件必须同时成立，缺一就退回信封 —— 宁可不直出，也不让调用方拿到半截或空输出：
- * - `data.status === 'BROWSER_FILL'`：小e 专用档，其它状态（含 `NEEDS_INPUT`）一律维持信封；
- * - `data.finalMarkdown` 以 `<browsertool>` 开头：与文档口径同字面，渲染档万一变了也不会直出一个
- *   看起来像标签、实际不是的东西。
- *
- * 必须走 `ctx.output.raw()` 而不是 `write(value, { text })`：后者在**全局 `--json`** 下仍会退化成
- * JSON（`core/output.ts`：`useJson = globalOptions.json || options.json || !options.text`），
- * 而本 skill 的文档一律带 `--json`。
- */
-export function rawStdoutOf(result) {
-    const data = result.data;
-    if (!data || typeof data !== 'object')
-        return undefined;
-    if (data.status !== 'BROWSER_FILL')
-        return undefined;
-    const markdown = data.finalMarkdown;
-    if (typeof markdown !== 'string' || !markdown.startsWith('<browsertool>'))
-        return undefined;
-    return markdown;
-}
-/**
- * 把一次 operation 的结果打到 stdout —— **形态二选一**（判定见 `rawStdoutOf`）。
+ * 把一次 operation 的结果打到 stdout —— **只有一种形态：JSON 信封**。
  *
  * 独立成函数并**导出**，是为了让用例直接锁住这条接线（与 `compactStdoutPaths` 同一理由：
  * 回归要在这里红，而不是等到真机上模型拿到一份"既不是 JSON、也不是标签块"的东西才发现）。
+ *
+ * ★ 2026-10-21 用户裁定（**改口径**）：小e 的 `BROWSER_FILL` 档**不再直出** `<browsertool>` 标签块，
+ * 一律走 JSON 信封 —— 标签块放在 `data.finalMarkdown` 里，与 `createRequestDirect` 统一成一种结构，
+ * 于是 `durationMs` / `apiDurations` / `authMs` 三个耗时键在这一档也可见。
+ * 原来的 `rawStdoutOf()` 直出通道随之删除（它当时只为"stdout 就是标签块"服务）。
  */
 export function printWorkflowResult(ctx, operation, result) {
-    const raw = rawStdoutOf(result);
-    if (raw !== undefined) {
-        // 小e：stdout 就是标签块本身 —— 不套信封、不进 `prepare()` 的超线落盘（这段本来就不长）。
-        ctx.output.raw(raw);
-        return;
-    }
     ctx.output.write(successEnvelope(operation, result), {
         json: true,
         compactPaths: compactStdoutPaths(operation),