1. 开票[RPA/NS共用]
发票云(生态版)API文档
  • 错误处理 & 错误编码
  • 认证与安全[RPA/NS共用]
    • 内容安全
    • 认证
      POST
  • 订单[RPA/NS共用]
    • 对接指引
    • 创建订单
      POST
    • 关闭订单
      POST
    • 查询订单列表
      GET
  • 基础资料[RPA/NS共用]
    • 对接指引
    • 新增常用开票项
      POST
    • 删除常用开票项
      POST
    • 查询常用开票项列表
      GET
    • 新增常用不动产租赁明细
      POST
    • 删除常用不动产租赁明细
      POST
    • 查询常用不动产租赁明细列表
      GET
    • 新增电子税局账号
      POST
    • 删除电子税局账号
      POST
    • 查询电子税局账号列表
      GET
  • 开票[RPA/NS共用]
    • 对接指引
    • 开票[RPA/NS共用]
    • 查询电子税局账号状态
      GET
    • 二维码扫码登录电子税局账号
      POST
    • 验证码登录电子税局账号
      POST
    • 获取电子税局扫脸认证二维码信息
      POST
    • 获取扫脸认证结果
      GET
    • 查询企业授信额度
      GET
    • 创建发票开具任务
      POST
    • 修改发票的开具任务
      PATCH
    • 查询发票的开具任务结果
      GET
    • 查询车架号及合格证信息
      GET
  • 乐企联用[NS专用]
    • 乐企联用申请
    • 查询乐企申请结果
  • 发票查验
    • 发票查验
  • 数据模型
    • 开票数据结构
      • 发票类型
      • 税局发票类型(中国大陆地区)
      • 时间格式
      • 订单
      • 电子税局账号
      • 开票数据
      • 企业对象
      • InvoiceLineItem
      • 不动产租赁明细
      • 税局城市编码
      • 电子税局登录角色
      • 扫脸认证二维码信息
      • 两位小数金额的字符串
      • 乐企联用申请
    • 公用代码
      • 国家或地区代码
      • 医疗机构类型
      • 证件类型
      • 电子税局登录角色
      • 零税率标识
      • 代开标识
      • 发票状态标识
      • 是否蓝字发票
      • 税控发票特殊票种类型
      • 发票开具方式
      • 电子税局账号
      • 税局城市编码
      • 省市级税务机关代码
      • 乐企开票能力编码
      • 乐企申请结果状态
    • 查验数据结构
      • 发票状态
      • 发票类型
      • 二手车销售统一发票数据
      • 数字化电子发票-二手车销售统一发票数据
      • 数字化电子发票-增值税发票数据
      • 增值税发票数据
      • 增值税普通发票(卷式)数据
      • 增值税普通发票(通行费)数据
      • 机动车销售统一发票数据
      • 航空运输客票电子行程单数据
      • 铁路电子客票数据
      • 数字化电子发票-机动车销售统一发票数据
      • 财政票据数据
      • 红字发票列表
    • 响应数据结构
      • 错误响应
      • 分页信息
      • 批量新增的返回
      • 批量删除的返回
  1. 开票[RPA/NS共用]

查询车架号及合格证信息

开发中
GET
/partners/motor-vehicles

接口说明#

按企业税号、数电账号和车架号查询车辆基础信息、机动车 UUID 及合格证状态,单次查询一个车架号。
这是独立查询接口。客户取得 vehicle_uuid 后,自行将其带入现有开票接口。本接口不自动登录、不创建或激活订单、不锁定合格证,也不发起开票。

调用条件#

1.
企业应具备有效开票权益;电子税局通道需使用可用的已登录账号。
2.
电子税局通道 invoice_type 必填,支持 12、27、83。企业已完成乐企联用接入且服务可取得联用信息时可不传;明确票种时建议始终传入。
3.
乐企直连/使用单位 ID 由服务端补充,客户无需传入。
4.
GET 请求没有请求体,无需加密 Body;Authorization、X-Request-Id 的使用方式与其他接口一致。

结果处理#

成功响应为顶层对象,不包裹 data;所有字段使用下划线命名。
查询成功与是否可开票是两个不同结果。查到车辆但不可开票时仍返回 HTTP 200,返回 can_issue_blue_invoice=false 和原因,并保留可用车辆信息。
未查到合格证时也可能返回 HTTP 200、不可开票原因01,而不返回 UUID。不得把缺少 UUID 一律当成查询失败。
电子税局通道仅返回车辆基础信息,不返回合格证状态。缺失的可选字段省略;没有 can_issue_blue_invoice 不表示允许开票。
UUID 必须按字符串保存。重量必须结合单位使用。vehicle_type 可能是名称,不能直接填入开票字段 vehicle_type_code。

错误说明#

HTTP错误码含义/处理建议
400missing_tax_no / missing_etax_account / missing_identify_no必填查询参数缺失
400invalid_tax_no / invalid_etax_account / invalid_identify_no参数长度超过限制
400missing_invoice_type / invalid_invoice_type缺少条件必填票种或票种不支持
400missing_request_id / missing_authorization / invalid_authorization请求头缺失或格式不正确
40091300电子税局账号登录失效,需先完成登录
4001306当前企业无可用开票权益,需处理权益后再查询
4000499下游返回不支持的接口,请联系服务商核查通道支持情况
4001001下游请求企业/租户信息失败,请联系服务商核查
400MOTOR_VEHICLE_QUERY_FAILED查询服务/网络异常或超时,请稍后重试
400MOTOR_VEHICLE_QUERY_INVALID_RESPONSE未取得有效查询结果或返回车架号不匹配
400MOTOR_VEHICLE_QUERY_CONFIG_ERROR查询服务授权配置异常,请联系服务商处理
401网关授权错误码token 缺失、失效或未授权
业务失败沿用统一 error 对象;网关错误的链路字段可能为 traceId。不要依赖错误文案进行程序判断。

当前联调状态#

开发中。2026-11-18 已验证新 ISV 接口参数校验、鉴权及下游错误返回;测试环境电子税局通道返回 0499「不支持的接口」,待下游确认。新 ISV 接口成功获取 UUID 的完整链路尚未验证通过。下列成功响应为结构示例,不代表该链路已通过验收。

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff '/partners/motor-vehicles?tax_no={{tax_no}}&etax_account={{etax_account}}&identify_no=TESTVIN0000000001&invoice_type=83' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'X-Request-Id: req_example_001' \
--header 'Accept-Language: zh-CN' \
--header 'X-Encryption-Mode;'

返回响应

🟢200查询成功
application/json
查询成功;不等同于车辆允许开票。
Bodyapplication/json

示例
{
    "request_id": "req_example_001",
    "trace_id": "trace_example_001",
    "identify_no": "TESTVIN0000000001",
    "vehicle_uuid": "1234567890123456789",
    "product_model": "示例牌车辆型号",
    "compliance_no": "CERT-EXAMPLE-001",
    "engine_no": "ENGINE-EXAMPLE-001",
    "manufacturer": "示例车辆制造企业",
    "vehicle_weight": "580",
    "vehicle_weight_unit": "kg",
    "vehicle_type": "自卸三轮汽车",
    "vehicle_name": "自卸三轮汽车",
    "vehicle_source": "00",
    "manufacture_date": "2026-09-18 00:00:00",
    "certificate_status": "0",
    "can_issue_blue_invoice": true
}
🟠400参数或业务错误
🟠401未授权
修改于 2026-11-18 15:24:10
上一页
查询发票的开具任务结果
下一页
乐企联用申请
Built with