获取userKey

POST/m4/fpzs/getUserKey

获取userKey

请求

billType参数

默认值为""，即默认费用单据

参数值	备注
Tra	智能差旅行程单据
Pur	智能物品采购单据
BizOut	智能对公单据
""	费用单据传空字符串

ticketParam 参数规则顺序

0 不允许 1 允许，默认值为00001

顺序	校验内容	备注
第1位	重复报销	已被单据占用的发票是否允许导入
第2位	购方抬头	发票抬头与企业名称不一致的发票是否允许导入
第3位	购方税号	发票抬头与税号不一致发票是否允许导入
第4位	发票验真	发票查验不通过的发票是否允许导入
第5位	个票	个人发票是否允许导入

返回状态码(errcode)见：《返回状态码》的附录2

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

timestamp

string

时间戳

必需

用于签名验证，从1970年1月1日到当前的毫秒数

<= 13 字符

client_id

string

发票云授权标识

必需

通常随着激活邮件下发

<= 20 字符

eid

string

用户ID

必需

对接系统的用户ID，后续用于发票查询

<= 80 字符

sign

string

签名

必需

签名, 签名规则根据加密方式来定，详情见对接约定中的签名规则部分

<= 100 字符

encType

string

签名类型

可选

签名加密类型 0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密

<= 1 字符

默认值:

billNumber

string

单据编号

必需

用于页面展示，没有实际意义

<= 80 字符

bxd_key

string

单据ID

必需

用于区分单据唯一，可以使用一些唯一算法生成，每个单据务必不重复，重复则视为同一个单据

<= 50 字符

random

string

链接ID

必需

JS建立通道时用来链接的通话ID

<= 35 字符

ticketParam

string

合规性校验设置

必需

格式如：11011

<= 5 字符

默认值:

00001

billType

string

单据类型

可选

默认值为""，即默认费用单据。 Tra 智能差旅行程单据，Pur 智能物品采购单据， BizOut |智能对公单据

branch_id

string

分录ID

可选

指定查看分录的ID，用于分录编辑和查看时必须传入

<= 80 字符

invoiceSerialNos

string

限制发票流水号

可选

再次打开采集界面时，指定只查看单据下的某下发票。默认全查看，传空字符串则都不查看

attachmentSerialNos

string

限制附件流水号

可选

再次打开采集界面时，指定只查看单据下的某下附件。默认全查看，传空字符串则都不查看

tin

string

企业税号

可选

用于后续合规性校验-发票购方税号是否一致

ghf_mc

string

企业名称

可选

用于后续合规性校验-发票购方抬头是否一致

buyerAccount

string

专票开户行账号

可选

用于后续合规性校验-专票开户行账号是否一致

<= 150 字符

buyerAddressPhone

string

专票地址电话

可选

用于后续合规性校验-专票地址电话是否一致

<= 150 字符

salerName

string

销方名称

可选

用于后续合规性校验-销方名称是否一致

<= 100 字符

salerTaxNo

string

销方税号

可选

用于后续合规性校验-销方税号是否一致

<= 20 字符

relevanceExpenseId

string

关联单据ID

可选

一个流程需要多个单据的时候，可能会出现一张发票绑定多个单据无需校验重复报销的场景，这时候可以传关联单据ID

{
  "timestamp": "string",
  "client_id": "string",
  "eid": "string",
  "sign": "string",
  "encType": "0",
  "billNumber": "string",
  "bxd_key": "string",
  "random": "string",
  "ticketParam": "00001",
  "billType": "string",
  "branch_id": "string",
  "invoiceSerialNos": "string",
  "attachmentSerialNos": "string",
  "tin": "string",
  "ghf_mc": "string",
  "buyerAccount": "string",
  "buyerAddressPhone": "string",
  "salerName": "string",
  "salerTaxNo": "string",
  "relevanceExpenseId": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

string

响应码

必需

0000成功，其他失败

description

string

描述

必需

traceId

string

追踪ID

必需

用于出现异常，发票云定位日志使用

data

object

数据

必需

userKey

string

授权key

必需

{
  "errcode": "0000",
  "description": "操作成功",
  "data": {
    "userKey": ""
  },
  "traceId": ""
}

最后修改时间： 5 个月前