- 整体介绍
- 快速开始
- 加解密
- 文件预览/文件上传/文件下载
- 发票数据结构
- 错误码
- 场景指引
- 授权
- 开票
- 单据开票接口(税控+数电)
- 单据开票对接指引
- 开票申请单错误码列表
- 1.1.01 开票申请单生成及开票(支持拆分合并后,再开票)POST
- 1.1.02 开票申请单撤回(对接方主动撤回)POST
- 1.1.03 开票申请单发票查询POST
- 1.1.04 开票申请单快速红冲(仅支持税控普票)POST
- 1.1.05 开票申请单批量作废(作废单据的发票,仅支持税控纸票)POST
- 1.1.06 开票申请单红冲单或作废单生成(星瀚发票云版本5.0.015支持,不支持数电票)POST
- 1.1.07 开票申请单重开单生成(星瀚发票云版本5.0.015支持,不支持数电票)POST
- 1.1.08 创建负数单匹配任务POST
- 1.1.09 查询负数单匹配任务结果POST
- 1.1.10 单据开票预览POST
- 直接开票接口
- 发票查询接口
- 回调接口(支持除数电票直接开票接口外的开票回调)
- 开票风控接口
- 扫码开票接口(税控+数电)
- 收票
- 页面类
- 影像
- 档案
- 设置类
- 订单
1.1.09 查询负数单匹配任务结果
开发中
快速开始环境
快速开始环境
POST
/kapi/app/sim/openApi
请求参数
Query 参数
access_token
string
可选
示例值:
1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8
Body 参数application/json
requestId
string
时间戳
businessSystemCode
string
必需
interfaceCode
enum<string>
接口业务编码
枚举值:
BILL.MATCH.RESULT
data
object
必需
batchNo
string
任务号
<= 50 字符
示例
{
"requestId": "1624601109096",
"businessSystemCode": "BUSINESS_FPY",
"interfaceCode": "BILL.PUSH",
"data": [
{
"billNo": "ids-uat-3std1-29",
"billDate": "2023-05-17",
"totalAmount": 11300,
"autoInvoice": "0",
"invoiceType": "08xdp",
"buyerName": "深圳市顺丰快运有限公司test01",
"buyerProperty": "0",
"sellerTaxpayerId": "91440300MA5G9GK78Y",
"sellerName": "金蝶票据云科技(深圳)有限公司",
"sellerBankAndAccount": "13710884704",
"sellerAddressAndTel": "高新技术产业园南区科技南十二路58996989",
"drawer": "开票人",
"billDetail": [
{
"amount": 11300,
"detailId": "1194121661989796666",
"goodsName": "蜂胶口腔膜",
"lineProperty": 2,
"price": 11300,
"quantity": 1,
"revenueCode": "1070304990000000000",
"taxRate": "0.13",
"units": "个"
}
]
}
]
}
示例代码
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://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8' \
--header 'Content-Type: application/json' \
--data-raw '{
"requestId": "1624601109096",
"businessSystemCode": "BUSINESS_FPY",
"interfaceCode": "BILL.PUSH",
"data": [
{
"billNo": "ids-uat-3std1-29",
"billDate": "2023-05-17",
"totalAmount": 11300,
"autoInvoice": "0",
"invoiceType": "08xdp",
"buyerName": "深圳市顺丰快运有限公司test01",
"buyerProperty": "0",
"sellerTaxpayerId": "91440300MA5G9GK78Y",
"sellerName": "金蝶票据云科技(深圳)有限公司",
"sellerBankAndAccount": "13710884704",
"sellerAddressAndTel": "高新技术产业园南区科技南十二路58996989",
"drawer": "开票人",
"billDetail": [
{
"amount": 11300,
"detailId": "1194121661989796666",
"goodsName": "蜂胶口腔膜",
"lineProperty": 2,
"price": 11300,
"quantity": 1,
"revenueCode": "1070304990000000000",
"taxRate": "0.13",
"units": "个"
}
]
}
]
}'
返回响应
🟢200成功
application/json
Body
errorCode
string
0为成功
message
string