灵工SAAS平台OpenAPI2.0文档
  1. 电子合同
灵工SAAS平台OpenAPI2.0文档
  • 灵活用工
    • 前言
    • 流程说明
    • 对接说明
    • 通知说明
    • 示例代码
    • 自由职业者
      • 实名认证(SFT0101)
      • 实名认证+合同综合接口(SFT0109)
      • 身份证照片上传(SFT0102)
      • 自由职业者信息查询(SFT0103)
      • 银行卡bin查询(SFT0202)
      • 银行卡列表(SFT0201)
      • 银行卡绑定(SFT0203)
      • 银行卡解绑(SFT0204)
      • 自由职业者身份证图片获取(SFT0110)
    • 电子合同
      • 合同预览(SFT0107)
        POST
      • 电子合同生成(SFT0104)
        POST
      • 电子合同授权签约(SFT0105)
        POST
      • 电子合同信息查询(SFT0106)
        POST
      • 电子合同上传(待开发)
        POST
      • 自由职业者电子合同查询(SFT0111)
        POST
    • 存管账户
      • 服务商列表(SFT0301)
      • 账户列表查询(SFT0302)
      • 账户余额查询(SFT0303)
      • 充值账户查询(SFT0304)
      • 企业银行账户列表(SFT0310)
      • 企业银行账户绑定(SFT0311)
      • 企业银行账户解绑(SFT0312)
      • 账户变动明细(SFT0305)
    • 充值
      • 充值记录查询(SFT0401)
      • 充值申请(待开发)
      • 充值订单查询(SFT0403)
      • 充值数据同步(SFT0404)
    • 用工企业提现
      • 提现订单列表(SFT0411)
      • 提现申请(SFT0412)
      • 提现订单详情(SFT0413)
    • 自由职业者佣金结算
      • 佣金结算服务费预计算(SFT0501)
      • 佣金结算(SFT0502)
      • 佣金结算批次查询(SFT0503)
      • 佣金结算批次订单查询(SFT0504)
      • 佣金结算订单查询(SFT0505)
      • 电子回单查询(SFT0506)
      • 佣金结算数据同步(SFT0510)
    • 退款
      • 退款订单查询(SFT0801)
      • 退款订单明细(SFT0802)
    • 开票
      • 开票类目查询(SFT0601)
      • 开票类型列表(SFT0602)
      • 可开票批次查询(SFT0603)
      • 开票申请(SFT0605)
      • 开票申请列表(SFT0606)
      • 开票申请详情(SFT0607)
      • 开票申请关联订单列表(SFT0608)
      • 开票额度账户列表(SFT0609)
      • 开票额度账户详情(SFT0610)
      • 开票申请撤销(SFT0611)
    • 项目
      • 项目列表(SFT0701)
      • 项目详情(SFT0702)
      • 项目新增(SFT0703)
      • 项目删除(SFT0704)
      • 项目确认单(SFT0705)
    • 完税凭证
      • 完税凭证记录(SFT1001)
    • 通知
      • 充值通知(1001)
      • 提现通知(2001)
      • 佣金结算通知(3001)
      • 佣金结算退票通知(5001)
      • 电子合同签约完成通知(8001)
      • 开票结果通知(9001)
    • 企业信息
      • 企业信息查询(SFT0901)
  • 营销金结算
    • 营销活动
      • 营销活动创建(SFT1101)
    • 结算
      • 营销金结算付款(SFT0502)
      • 营销金结算批次查询(SFT0503)
      • 营销金结算批次订单查询(SFT0504)
      • 营销金结算订单同步(SFT0510)
  1. 电子合同

电子合同信息查询(SFT0106)

POST
/open/api/gateway.do
合同签署
查询电子合同详情

请求参数

Body 参数application/json
apiCode
string 
接口编码:SFT0106
必需
merchantNo
string 
商户号
必需
requestNo
string 
请求流水
必需
timestamp
string 
时间戳
必需
version
string 
版本号,固定2.0
必需
sign
string 
签名
必需
bizModel
object (PersonContractDetailModel) 
必需
contractId
number 
合同ID
必需
示例
{
    "apiCode": "SFT0106",
    "bizModel": "{\"contractId\":1736681040034496513}",
    "sign": "b33lTh2n0wiVMzH/N+SEepvCXFASyeCVgmLBsE/AS+p+IxAn89DahgOwrT6/utFBmr3eMN+rd05YtdYjiPLTOyu9R8HtuTXfBAMw+Kqb6gPsNcYmU6XFUgqwxa1jBl+5V/2NTVAUf7y8DWNRpUMjF5P+RHcFJw4jl4PTl6RtKHg=",
    "requestNo": "cbbcb27f-41c2-4504-85e7-c3b686b2f412",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240110193131"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0106",
    "bizModel": "{\"contractId\":1736681040034496513}",
    "sign": "b33lTh2n0wiVMzH/N+SEepvCXFASyeCVgmLBsE/AS+p+IxAn89DahgOwrT6/utFBmr3eMN+rd05YtdYjiPLTOyu9R8HtuTXfBAMw+Kqb6gPsNcYmU6XFUgqwxa1jBl+5V/2NTVAUf7y8DWNRpUMjF5P+RHcFJw4jl4PTl6RtKHg=",
    "requestNo": "cbbcb27f-41c2-4504-85e7-c3b686b2f412",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240110193131"
}'

返回响应

🟢200OK
application/json
Body
code
integer 
响应码,200:成功
必需
msg
string 
响应消息
必需
contractId
number 
合同ID
必需
contractNo
string 
合同编号
必需
contractName
string 
合同名称
必需
signTime
string <date-time>
签约完成时间
必需
contractUrl
string 
合同URL
必需
status
string 
合同状态
必需
WAIT_SIGN: 待签署,REFUSE:拒签 SIGNING:签署中 SUCCESS:签署成功
partyList
object (ContractPartyModel) 
签约方
必需
role
string 
签约方
必需
partyName
string 
签约方名称
必需
partyCertType
string 
签约方证件类型
必需
1:身份证号 2:统一信用代码
partyCertNo
string 
签约方证件号
必需
partyMobileNo
string 
签约方手机号
必需
signTime
string 
签约时间
必需
status
string 
签约状态
必需
WAIT_SIGN: 待签署 REFUSE:拒签 SUCCESS:签署成功
示例
{
    "code": 200,
    "msg": "成功",
    "contractId": "1736681040034496513",
    "contractNo": "X2023121800002",
    "contractName": "个人承揽协议",
    "status": "SUCCESS",
    "contractUrl": "https://tax-plan-prod.oss-cn-shenzhen.aliyuncs.com/file/contract/20231218/5C12B46EEC5A4DEAABD11FE9D5FAA514_SIGN_1736681040034496513.pdf?Expires=1704886637&OSSAccessKeyId=LTAI4G58o74d1xEBcb1Ct2Pm&Signature=cI%2FqEQrIMxL7A2B%2FDX24cqYYrGY%3D",
    "signTime": "2023-12-18 10:31:03",
    "partyList": [
        {
            "role": "甲方",
            "roleType": "TAX",
            "partyName": "九江万柳科技有限公司",
            "partyCertType": "2",
            "partyCertNo": "91360430MA39ABJKX1",
            "partyMobileNo": "13270880058",
            "signTime": "2023-12-18 09:33:22",
            "status": "SUCCESS"
        },
        {
            "role": "乙方",
            "roleType": "PERSON",
            "partyName": "叶利杰",
            "partyCertType": "1",
            "partyCertNo": "441621199704023031",
            "partyMobileNo": "18813957473",
            "signTime": "2023-12-18 10:31:03",
            "status": "SUCCESS"
        }
    ]
}
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
上一页
电子合同授权签约(SFT0105)
下一页
电子合同上传(待开发)
Built with