- 整体介绍
- 快速开始
- 加解密
- 文件预览&文件上传&文件下载
- 发票数据结构
- 错误码
- 常见接口错误
- 场景指引
- 授权
- 开票
- 单据开票接口(税控+数电)
- 单据开票对接指引
- 开票申请单错误码列表
- 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.03 开票申请单发票查询
快速开始环境
快速开始环境
POST
/kapi/app/sim/openApi
请求参数
Query 参数
access_token
string
可选
示例值:
1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI
Body 参数application/json
requestId
string
时间戳
businessSystemCode
string
必需
interfaceCode
enum<string>
接口编码
枚举值:
BILL.INVOICE.QUERY
data
object
必需
sellerTaxpayerId
string
必需
<= 20 字符
serialNo
string
单据编号
<= 50 字符
示例
{
"requestId": "string",
"businessSystemCode": "string",
"interfaceCode": "BILL.INVOICE.QUERY",
"data": {
"sellerTaxpayerId": "string",
"serialNo": "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://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI' \
--header 'Content-Type: application/json' \
--data-raw ''
返回响应
🟢200成功
application/json
Body
data
array [object {2}]
返回内容,需要解密
invoiceList
array [object {54}]
可选
billNo
string
单据编号
errorCode
string
响应码
success
boolean
响应状态
示例
{
"data": [
{
"invoiceList": [
{
"abolishReason": "",
"billNo": "INTFACE_WW_BILL202105320231",
"buyerAddressAndTel": "购方地址",
"buyerBankAndAccount": "购方银行",
"buyerName": "顺丰科技有限公司",
"buyerProperty": 0,
"buyerRecipientMail": "",
"buyerRecipientPhone": "",
"buyerTaxpayerId": "91440300687582704U",
"canRedAmount": 91.74,
"canRedTaxAmount": 8.26,
"canceler": "",
"checkCode": "",
"contractNo": "HT202011231984",
"deviceNo": "44661620662214",
"downloadFlag": 0,
"drawer": "文浩",
"goods": [
{
"amount": 91.74,
"billSourceId": "111",
"detailId": "1223726550327786496",
"detailRowNo": 0,
"goodsName": "*谷物*金额商品1",
"includeTaxAmount": 100,
"includeTaxPrice": "100.0000000000",
"lineProperty": 0,
"price": "91.7400000000",
"privilegeContent": "",
"privilegeFlag": 0,
"quantity": "1.0000000000",
"revenueCode": "1010101040000000000",
"revenueName": "",
"seq": 0,
"specification": "",
"taxAmount": 8.26,
"taxFlag": "0",
"taxRate": "0.09",
"units": "忠",
"zeroTaxRateFlag": ""
}
],
"id": 1223726550327785500,
"invoiceFileUrl": "",
"invoiceImageUrl": "",
"includeTaxAmount": 100,
"inventoryFlag": 0,
"invoiceCode": "4403092140",
"invoiceDate": 1629043200000,
"invoiceNumber": "10452076",
"invoiceProperty": 0,
"invoiceSource": "4",
"invoiceStatus": 0,
"invoiceType": "004",
"issueStatus": "0",
"mergeDifferTaxAmount": 0,
"orgName": "发票云事业部",
"originalInvoiceCode": "",
"originalInvoiceNumber": "",
"payee": "test1",
"printFlag": 0,
"redInfoBillNo": "",
"redReason": "",
"remark": "发票备注",
"reviewer": "test2",
"sellerAddressAndTel": "银行及电话银行",
"sellerBankAndAccount": "银行及电话银行及电话银行及电话银",
"sellerName": "航信培训企业",
"sellerTaxpayerId": "440300999999068",
"serialNo": "200_20210816100612556_0001",
"specialRedFlag": 0,
"splitOrMergeFlag": "0",
"terminalNo": "",
"totalAmount": 91.74,
"totalTaxAmount": 8.26
}
],
"billNo": "INTFACE_WW_BILL202105320231"
}
],
"errorCode": "0",
"success": true
}
🟢200失败
修改于 2025-03-14 01:33:17