Banas 开放平台
账户
  1. 发票查验
  • 公共业务
    • 健康检查
      GET
    • 获取 access_token
      POST
  • 票据识别
    • 国内通用票据识别
      POST
  • 发票查验
    • 增值税发票查验
      POST
    • 区块链发票查验
      POST
  • 发票认证
    • 简介
    • 业务流程
    • 自主授权登录
      POST
    • 自主授权登录并提交短信验证码
      POST
    • 同步纳税所属期
      POST
    • 同步进项发票
      POST
    • 同步海关缴款书
      POST
    • 全量发票列表(含发票文件)
      POST
    • 全量发票查询(含发票明细)
      POST
    • 发票-抵扣勾选
      POST
    • 申请、撤销、确认
      POST
    • 统计信息查询
      POST
    • 查询统计信息(历史)
      POST
    • 发票入账查询
      POST
    • 发票入账
      POST
    • 入账调整
      POST
    • 海关缴款书勾选抵扣
      POST
  • 数电开票
    • 登记应用
      POST
    • 自主授权登录
      POST
    • 自主授权登录并提交短信验证码
      POST
    • 自主授权异步查询扫码状态接口
      POST
    • 授权存活状态查询
      POST
    • 获取人脸识别二维码
      POST
    • 获取人脸识别结果
      POST
    • 发票开具(蓝票)
      POST
    • 红字发票信息表申请
      POST
    • 红字发票信息表查询(仅数电)
      POST
    • 红字发票信息表明细查询(仅数电)
      POST
    • 红字发票信息审核(仅数电)
      POST
    • 蓝字发票数据统计(仅数电)
      POST
    • 红字发票数据统计(仅数电)
      POST
    • 数电发票文件获取(数电)
      POST
    • 数电发票文件链接获取(数电)
      POST
  • 附录
    • 发票类型
    • 地区代码
  • 常见问题
    • 发票业务
  • 版本发布
    • 2024年8月发布内容
  1. 发票查验

区块链发票查验

POST
/api/checkInvoice/blockchain
checkInvoice

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
区块链发票 请求参数
uid
string 
唯一编码
必需
>= 16 字符<= 36 字符
invoiceCode
string  | null 
发票代码
可选
正则匹配:
^\d{12}$
invoiceNumber
string 
发票号码
必需
>= 1 字符
正则匹配:
^\d{8}$
saleTaxNumber
string 
销方税号
必需
>= 1 字符
checkCode
string 
校验码
必需
>= 1 字符
示例
{
    "uid": "stringstringstri",
    "invoiceCode": "string",
    "invoiceNumber": "string",
    "saleTaxNumber": "string",
    "checkCode": "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://banas.ccitcn.com/api/checkInvoice/blockchain' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid": "stringstringstri",
    "invoiceCode": "string",
    "invoiceNumber": "string",
    "saleTaxNumber": "string",
    "checkCode": "string"
}'

返回响应

🟢200OK
application/json
Body
result
object 
必需
successInvoiceOutputs
array [object {11}]  | null 
发票查验成功信息
必需
failureInvoiceOutputs
array [object {3}]  | null 
发票查验失败信息
必需
status
integer 
必需
errorMessage
string 
必需
示例
{
  "result": {
    "successInvoiceOutputs": [
      {
        "TaxBureau": "深圳",
        "InvStatus": "0",
        "InvoiceType": "21",
        "InvoiceCode": "1440******10",
        "InvoiceNumber": "38*****1",
        "InvoiceDate": "2022-09-20 00:00:00",
        "CheckCode": "9fc7d",
        "BuyName": "******技术(上海)有限公司",
        "SumAmount": "240.00",
        "SaleName": "深圳市宝****餐饮服务有限公司",
        "SaleTaxNumber": "914403*******H6H9L"
      }
    ],
    "failureInvoiceOutputs": [
      {
        "InvoiceCode": "",
        "InvoiceNumber": "",
        "Message": ""
      }
    ],
    "status": 200,
    "errorMessage": ""
  }
}
修改于 2024-10-24 10:34:06
上一页
增值税发票查验
下一页
简介
Built with