# kingdee.toqys

**Repository Path**: dihl/kingdee.toqys

## Basic Information

- **Project Name**: kingdee.toqys
- **Description**: 金蝶K3 Cloud与契约锁电子签约平台集成的**参考示例**，展示如何从金蝶业务系统创建契约锁电子合同。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kingdee K3 Cloud 契约锁集成示例

金蝶K3 Cloud与契约锁电子签约平台集成的**参考示例**，展示如何从金蝶业务系统创建契约锁电子合同。

> ⚠️ **注意**：本项目为参考示例，不是可直接使用的生产级类库。如需实际使用，请根据您的业务需求进行修改和适配。

## 示例内容

本示例展示了以下实现思路：

- 如何从金蝶配置单和业务数据构建契约锁合同请求
- 如何实现三方签署流程（甲方审核 → 乙方签署 → 甲方盖章）
- 如何配置骑缝章、企业公章、关键字定位
- 如何处理组织ID映射、签署节点配置
- 如何实现日志记录和错误处理

## 参考使用

### 1. 环境要求

- 金蝶K3 Cloud
- .NET Framework 4.8
- 契约锁服务

### 2. 核心代码参考

```csharp
using QysContractSender;

// 配置契约锁
var config = new QiyuesuoConfig
{
    Url = "http://your-qiyuesuo-server:9182",
    AppToken = "YourAppToken",
    AppSecret = "YourAppSecret",
    OrgIdMapping = new Dictionary<long, long>
    {
        { 100410, 3131883843112477293L }  // 金蝶组织ID → 契约锁组织ID
    }
};

// 创建合同
var service = new ContractCreateService(config);
var result = service.Send(ctx, configBill, supplier, documentRows);

if (result.Success)
    Console.WriteLine($"创建成功，合同ID: {result.QysContractId}");
```

完整示例见 [UsageExample.cs](code/QysContractSender/UsageExample.cs)

### 3. 根据需求修改

本示例基于特定业务场景（运输合同），您需要根据实际需求修改：

- **ContractCreateService.cs**：调整合同创建逻辑、签署流程、文档参数
- **SignatoryActionBuilder.cs**：修改签署节点配置
- **数据字段映射**：根据您的金蝶单据字段调整字段名称

关键修改点：
- 表体字段名称（FDest、FCapacity等）
- 签署关键字（甲方（盖章）、乙方（盖章））
- 签署流程节点
- 文档模板参数

## 项目结构

```
code/
├── QysContractSender/         # 主项目
│   ├── ContractCreateService.cs    # 核心服务
│   ├── QiyuesuoConfig.cs           # 配置类
│   └── UsageExample.cs             # 使用示例
└── QysContractSender.Tests/   # 测试项目
lib/                           # 依赖库
└── README.md                  # 依赖说明
```


**注意**：使用契约锁SDK和金蝶K3 Cloud需遵守相应许可协议。