3.3、新增租户组织下的员工
POST
/trdPlatform/add/employee授权注册接口说明
>发票云关于第三方授权发送与租户注册相关接口说明
一、调用说明
>以下小节对相关业务场景的接口调用数据流与顺序进行简要说明
<a name="app_register"></a>
1.1 线下应用平台注册
>线下平台提供相关的平台信息资料到发票云,由发票云对平台进行注册,并将授权信息通过邮件方式交付都按平台方
本流程暂未有线上流程,申请资料与交付流程均走线下。
平台需提供的字段
字段 | 类型 | 是否必须 | 描述 |
---|---|---|---|
name | string | 是 | 平台简称 |
epName | string | 是 | 平台注册企业名称 |
epTaxno | string | 是 | 平台注册企业税号 |
epAddr | string | 否 | 平台注册企业地址 |
epTelno | string | 否 | 平台注册企业联系电话 |
adminName | string | 否 | 平台方管理员,也作为紧急联系人 |
adminPhone | string | 否 | 平台方管理员手机号 |
adminEmail | string | 否 | 平台方管理员邮箱 |
发票云返回的字段
字段 | 类型 | 描述 |
---|---|---|
clientId | string | 平台clientId |
clientSecret | string | 平台clientSecret |
enckey | string | 平台加密key |
1.2 线下平台新租户注册,订单激活
>第三方平台新用户在使用发票云相关功能模块时,需要先对租户进行注册,订单进行激活,目前采用线下的模式,平台方把租户信息、企业信息、产品信息提供到发票云,线下流程完成后,最终会将租户的appid/appSecret/tenantid/用户访问页面域名,以及企业的组织编号等信息,通过邮件返回给用户;
每个用户的页面访问域名是根据tenantid而不一样,若只有一个租户则是相同的
1.3 全流程图
请求参数
Header 参数
Content-Type
string
必需
Authorization
string
必需
示例值:
SHA256 clientId=i8FvoGVWTIUPWkMGcugY,sign=3c15e7d10888969b1786507e500e168,timestamp=1638520127291
Body 参数application/json
employees
array [object {4}]
员工信息数组
name
string
用户名称
phone
string
可选
用户手机号,和邮箱,两者必传其一
email
string
可选
用户邮箱,和手机号,两者必传其一
orgNumber
array[string]
企业组织编码数组
示例
{
"employees": [
{
"name": "string",
"phone": "string",
"email": "string",
"orgNumber": [
"string"
]
}
]
}
示例代码
返回响应
成功(200)
失败(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
description
string
描述
errcode
string
必需
错误码 0000为成功,其他为失败
示例
{
"errcode": "0000",
"description": "成功"
}
最后修改时间: 1 年前