# Esign.Net

**Repository Path**: iStone/esignnet

## Basic Information

- **Project Name**: Esign.Net
- **Description**: e签宝电子签章服务接入类库。
 .Net版本e签宝的公用类库，实现e签宝 SaaS API V3版对接。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-10-16
- **Last Updated**: 2024-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EsignNet

#### 介绍
e签宝电子签章服务接入。.Net版本e签宝的公用类库，实现e签宝 SaaS API V3版对接。

由于e签宝官网没有提供.net版本的对接框架，故自己手写实现了提供基本的e签宝接口请求和验签方式。

主要实现了：创建并发起电子合同流程，获取合同模版，查询合同状态等功能。
本框架是基于.Net 5，如果需要framework版本，可以自己改或联系本作者。

#### 代码示例

```
    //获取合同模版上的控件信息(注意合同模版上的控件都是在e签宝上设置的，按控件名称区分并给于赋值。)
                INPUT.DocTemplates.TemplateInput tmpInput = new INPUT.DocTemplates.TemplateInput();
                tmpInput.DocTemplateId = "";//todo 模版id
                var tmpOutput = tmpInput.Build(tmpInput, _Config).Execute<INPUT.DocTemplates.TemplateInput, OUTPUT.OutputBase<OUTPUT.DocTemplates.TemplateOutput>>(false);
                if (tmpOutput.Code > 0)
                {
                    Log.Error("创建合同异常:" + tmpOutput.Message + " 请求json:" + JsonConvert.SerializeObject(tmpInput));
                    return ResponseOutput.NotOk("创建合同异常2:" + tmpOutput.Message, "", tmpOutput.Code);
                }
```

#### e签宝官方相关文档

参考 ：E签宝电子签名 V1版 参考 https://open.esign.cn/doc/opendoc/saas_api/xuanyuan 
       demo下载 https://open.esign.cn/doc/opendoc/saas_api/xuanyuandemo

组合计费
SaaS API V3 版对接指南：https://open.esign.cn/doc/opendoc/apiv3-guide/tfb6gn 
						https://qianxiaoxia.yuque.com/opendoc/dev-guide3/lbva7leuuze3zwt9?singleDoc# 

电子签名SaaS API V3版对接指南
https://open.esign.cn/doc/opendoc/apiv3-guide/tfb6gn

【常用地址】
开放平台：https://open.esign.cn/

开放平台文档中心：https://open.esign.cn/doc?from=nav

开发者接入助手：https://open.esign.cn/tools/helper

错误码查询：https://open.esign.cn/tools/error-code

API在线调试工具：https://open.esign.cn/tools/api-debug

【获取测试账号】
①注册页面：https://h5.esign.cn/usercenterFront/regist

②企业实名方式四选一：https://open.esign.cn/doc/opendoc/dev-guide3/mg0c7y

③开通沙箱：https://open.esign.cn/doc/detail?id=opendoc%2Fhelper%2Fcan05q&namesp

一、【群内服务人员分工】
交付经理：项目上线前，负责答疑接口开发集成中遇到的技术类问题。
运维经理：项目上线后，负责答疑接口使用和迭代集成中遇到的技术类问题。
客户成功经理：负责协助贵司内部进行电子签名推广与使用；总协调及对接人，有任何问题可以及时联系。
二、【群内咨询服务渠道】
１. 常规技术问题、使用咨询问题，请在对接群内直接沟通，我们会及时响应跟进。
2.“套餐授权”可直接提交工单：https://qfqwbf.aliwork.com/o/csmzz，工作日内我们会在收到工单后30分钟内回复，同时请在提交工单页面中查看处理进度。
3.  群内服务时间：工作日 09:00 ~ 18:30（午休时间12:00-13:30），工作日18:30-21:00 及节假日9:00-21:00均由值班人员进行问题响应，有问题可以直接@假日值班号进行处理。
三、【入门必读】

如何入驻成为e签宝企业开发者（含企业实名步骤），详见：https://open.esign.cn/doc/opendoc/helper/ogfnv9

如何调用e签宝API接口（含沙箱开通步骤），详见：https://open.esign.cn/doc/opendoc/dev-guide3/qwnnsb

如何上线转正式环境，详见：https://open.esign.cn/doc/opendoc/dev-guide3/mezw5n

如何排查接口报错，详见：https://open.esign.cn/tools/error-code

 先根据DocTemplateId获取合同模版，通过填充合同模版信息生成新的文档id(doc FileId)，发起合同签署流程使用的是doc FileId



 ================

https://smlfront.esign.cn:8880/templates 沙箱账号 设置合同模板。 通过项目接口api/Esign/GetTemplateInfo获取模版控件相关信息。
需要复制到正式环境才可以使用 跨环境复制模板操作：https://open.esign.cn/doc/opendoc/helper/nmpwbo
(https://web.esign.cn/templates-manage/manage  正式环境 模版设置)