Download the PHP package shengya/kingdee without Composer

Shengya Kingdee

shengya/kingdee 是金蝶 K3Cloud WebAPI 的 PHP SDK 与 Laravel 集成包，最低支持 PHP 7.4。

一个 Composer 包同时保留两层职责：

• Shengya\Kingdee\*：不依赖业务框架的金蝶客户端、单据入参、异常和脱敏。
• Shengya\KingdeeLaravel\*：Laravel 服务注册、调用记录、迁移发布和基础资料同步。

功能

• 登录并维护金蝶 Cookie 会话。
• 查询、查看、保存、提交和审核单据。
• 开票明细独立存储，以及按来源明细额度生成递延收益结转单。
• 调用链 trace_id / request_id 与安全重试。
• 递归脱敏请求及响应中的敏感字段。
• Laravel 调用记录与失败日志降级。
• 14 类金蝶基础资料分页、幂等同步。
• 组件迁移只发布给宿主审阅，不自动执行。

环境

• PHP 7.4 或更高版本。
• Laravel 8.75、9、10 或 11（使用 Laravel 集成时）。

安装

Laravel 会通过 Composer 自动发现 KingdeeServiceProvider。

纯 PHP 用法

SDK 不内置账套、账号、密码或业务组织默认值。

Laravel 配置

宿主项目需要提供 config/kingdee.php，主要配置节点为：

配置缺失或为空时组件会抛出 ConfigurationException，不会静默使用账套或业务默认值。

迁移

发布迁移文件：

组件不会自动执行迁移。发布后请先在宿主项目审阅文件，再按项目的发布流程处理。 其中 kd_invoice_applications 和 kd_receipts 保存组件单据；kd_call_records 只保存认证、查询、Save、Submit、Audit 等每次接口执行记录。 开票明细、递延申请和递延额度占用分别保存在组件的 kd_invoice_application_lines、 kd_deferred_income_applications 和 kd_deferred_income_application_lines 中。 递延结转单表头不含税金额通过财务子表 FsubHeadFinc.FNoTaxAmountFor 写入来源开票单全部明细的不含税合计；递延明细和额度控制 则使用本次选择的“不确认收入”明细不含税金额。递延 Save 必须携带来源应收分录内码， 以保证金蝶“关联查询”可以反查来源开票申请单。

基础资料同步

同步全部 14 类资料：

只同步客户：

全量同步会将本批次未返回的历史资料标记为失效，不会删除。

调用方式

安全

• 不要将真实账套、账号、密码或 Cookie 提交到代码仓库。
• 金蝶 FilterString 必须由后端根据可信参数构造，禁止透传浏览器原始字符串。
• 写操作默认不重试，只有业务明确幂等时才可标记为可安全重试。

安全问题请使用代码托管平台的私密漏洞报告功能，不要在公开 Issue 中披露凭证。

版本

包内不声明固定 version，Packagist 从 v0.1.0 这类 Git 标签识别版本。变更记录见 CHANGELOG.md。

许可证

当前为 proprietary，详见 LICENSE。如需改为 MIT 或 Apache-2.0，必须由代码权利人明确确认后再发布。