- 整体介绍
- 对接约定
- 授权
- 开票
- 产品介绍
- 开发指南
- 税控&数电同步开票
- 业务场景下接口调用顺序
- 1.01.读取税盘信息(czlx-7)
- 1.02 .读取票种信息(czlx-30)
- 1.03.发票开具(czlx-3)
- 1.04.发票作废(czlx-6)
- 1.05.发票查询(czlx-5)
- 1.06.发票打印(czlx-4)
- 1.07.专用发票申请红字信息表(czlx-20)
- 1.08.查询专用发票申请红字信息表(czlx-18)
- 1.09.批量打印(czlx-32)
- 1.11.机动车销售统一发票开具(czlx-40)
- 1.12.机动车销售统一发票查询(czlx-41)
- 1.13.机动车销售统一发票红冲(czlx-42)
- 1.15.核定票种查询(czlx-51)
- 1.21.二手车-发票开具(czlx-43)
- 1.22.二手车-发票查询(czlx-44)
- 1.23.二手车-发票红冲(czlx-45)
- 1.30 .查询授信额度接口(czlx-122)
- 2.01.电 子发票开具(czlx-110) ，【注】开数电票请对接：1.03.发票开具(czlx-3)
- 2.02.电子发票信息查询(czlx-113)
- 2.03.电子发票红冲 （只支持全额红冲）(czlx-114)
- 2.04.刷新PDF(czlx-115)
- 2.05.查询电子发票余量(czlx-116)
- 3.01.查询税收分类编码信息(czlx-504)
- 3.03.获取打印机列表(czlx-901)
- 数电异步开票
- 扫码开票
- 企业级-发票云销项查询
- 收票
- 查验识别
- 报销
- 影像
- 档案
获取userKey
测试环境(除税控、数电和扫码开票外的接口）
https://api-dev.piaozone.com/test
测试环境(除税控、数电和扫码开票外的接口）
https://api-dev.piaozone.com/test
POST
/m4/fpzs/getUserKey
获取userKey#
请求#
billType参数#
默认值为""，即默认费用单据
| 参数值 | 备注 |
|---|---|
| Tra | 智能差旅行程单据 |
| Pur | 智能物品采购单据 |
| BizOut | 智能对公单据 |
| "" | 费用单据传空字符串 |
ticketParam 参数规则顺序#
0 不允许 1 允许 ，默认值为00001
| 顺序 | 校验内容 | 备注 |
|---|---|---|
| 第1位 | 重复报销 | 已被单据占用的发票是否允许导入 |
| 第2位 | 购方抬头 | 发票抬头与企业名称不一致的发票是否允许导入 |
| 第3位 | 购方税号 | 发票抬头与税号不一致发票是否允许导入 |
| 第4位 | 发票验真 | 发票查验不通过的发票是否允许导入 |
| 第5位 | 个票 | 个人发票是否允许导入 |
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json
timestamp
string
时间戳
<= 13 字符
client_id
string
发票云授权标识
<= 20 字符
eid
string
用户ID
<= 80 字符
sign
string
签名
<= 100 字符
encType
string
签名类型
<= 1 字符
默认值:
0
billNumber
string
单据编号
<= 80 字符
bxd_key
string
单据ID
<= 50 字符
random
string
链接ID
<= 35 字符
ticketParam
string
合规性校验设置
<= 5 字符
默认值:
00001
billType
string
单据类型
<= 16 字符
branch_id
string
分录ID
<= 50 字符
invoiceSerialNos
string
限制发票流水号
attachmentSerialNos
string
限制附件流水号
tin
string
企业税号
<= 20 字符
ghf_mc
string
企业名称
<= 100 字符
buyerAccount
string
专票开户行账号
<= 150 字符
buyerAddressPhone
string
专票地址电话
<= 512 字符
salerName
string
销方名称
<= 100 字符
salerTaxNo
string
销方税号
<= 20 字符
relevanceExpenseId
string
关联单据ID
<= 50 字符
示例
{
"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"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-dev.piaozone.com/test/m4/fpzs/getUserKey' \
--header 'Content-Type: application/json' \
--data-raw '{
"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成功
application/json
Body
errcode
string
响应码
description
string
描述
traceId
string
追踪ID
data
object
数据
userKey
string
授权key
<= 32 字符
示例
{
"errcode": "0000",
"description": "操作成功",
"data": {
"userKey": ""
},
"traceId": ""
}