电子合同生成(SFT0104)

POST

/open/api/gateway.do

合同签署

基于自由职业者ID+服务商编码检查生成合同

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0104

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object

必需

personId

number

自由职业者ID

必需

taxBaseCode

string

服务商编码

必需

genSignUrl

boolean

是否生成签约地址

必需

true:生成，未签约状态才生成

示例

{
    "apiCode": "SFT0104",
    "bizModel": "{\"personId\":1417026895717261314,\"taxBaseCode\":\"2000064001\",\"genSignUrl\":true}",
    "sign": "r5xKPTMNLpbsae2gzY3opGkDFDk1AOXe2T7PQ8al3hY8U1BAyl4pPeqqFOgxEgButjHlmlHHqaQx9m5e6aldtx6NM+qUqvNbFah7udTYotKnHdGHYBto38rv5lSXJjtpAGp26L2ZqAO1mIZECuFOGAl5ni0NpEQyZ+Bl+1GQHec=",
    "requestNo": "3997b7a3-485c-4b2a-bf24-ad069618aa5a",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111112927"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0104",
    "bizModel": "{\"personId\":1417026895717261314,\"taxBaseCode\":\"2000064001\",\"genSignUrl\":true}",
    "sign": "r5xKPTMNLpbsae2gzY3opGkDFDk1AOXe2T7PQ8al3hY8U1BAyl4pPeqqFOgxEgButjHlmlHHqaQx9m5e6aldtx6NM+qUqvNbFah7udTYotKnHdGHYBto38rv5lSXJjtpAGp26L2ZqAO1mIZECuFOGAl5ni0NpEQyZ+Bl+1GQHec=",
    "requestNo": "3997b7a3-485c-4b2a-bf24-ad069618aa5a",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111112927"
}'

返回响应

🟢200OK

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

personId

number

自由职业者ID

必需

contractId

number

合同ID

必需

contractUrl

string

签约h5地址

必需

status

boolean

签约状态

必需

false 待签署 true 已签署

示例

成功示例异常示例

{
    "code": 200,
    "msg": "成功",
    "contractId": "1737745228819439618",
    "personId": "1417026895717261314",
    "contractUrl": "h5.test.mershare.cn/q/Ngc02jF4H6",
    "status": false
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

合同预览(SFT0107)

电子合同授权签约(SFT0105)