电子发票
接入文档
接入文档 /发票开具/二手车发票开具

二手车发票开具

开具二手车销售统一发票。接口同步校验并受理，实际开票异步完成，结果通过 回调通知 或 查询发票 获取，查询结果中的 usedCar 字段为二手车信息。

POST/invoice/used-car/make
开票前准备

二手车发票要求销售方的地址、电话、开户行、银行账号完整，请先在控制台「发票配置 - 企业信息」中填写，否则返回 请进入发票配置-企业信息页面完善地址 等错误。

请求参数

请求体为 JSON。

参数 类型 必填 说明
appKey string 条件必填 服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret string 条件必填 服务密钥 Secret
accessToken string 条件必填 访问令牌，通过 获取访问令牌 接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber string 必填 企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
category string 选填 发票类型：二手车销售统一发票（默认，纸质）、电子发票（二手车销售统一发票）、数电纸质发票（二手车销售统一发票）
outOrderNo string 必填 外部订单号，同一企业内唯一
marketType string 必填 开票方类型：01 经营单位、02 拍卖单位、03 二手车市场
purchaserIfPerson boolean 选填 买方是否为自然人，默认 false
purchaserName string 必填 买方单位 / 个人名称，首尾不能有空格，不能包含换行
purchaserTaxpayerNumber string 必填 买方单位代码 / 身份证号码，不能包含空格、换行
purchaserAddress string 选填 买方单位 / 个人地址
purchaserPhone string 选填 买方电话
purchaserIdType string 选填 买方证件类型代码，见 证件类型代码
purchaserIdNumber string 选填 买方证件号码
purchaserCountry string 选填 买方国籍（或地区）
sellerIfPerson boolean 选填 卖方是否为自然人，默认 false
sellerName string 必填 卖方单位 / 个人名称
sellerTaxpayerNumber string 必填 卖方单位代码 / 身份证号码
sellerAddress string 选填 卖方地址
sellerPhone string 选填 卖方电话
sellerIdType string 选填 卖方证件类型代码
sellerIdNumber string 选填 卖方证件号码
sellerCountry string 选填 卖方国籍（或地区）
licensePlateNumber string 必填 车牌照号
registrationCertificateNumber string 必填 登记证号
carType string 必填 车辆类型，与 taxNo 对应的商品名称一致
taxNo string 必填 税收分类编码（乘用车等车辆分类编码）
vin string 必填 车架号 / 车辆识别号
brandModel string 必填 厂牌型号
transferDestOfficeName string 必填 转入地车辆管理所名称
price decimal 必填 车价合计（元，两位小数），必须大于 0
operateCompanyName string 条件必填 经营、拍卖单位名称，marketType 为 01 / 02 时必填
operateCompanyTaxpayerNumber string 条件必填 经营、拍卖单位纳税人识别号，marketType 为 01 / 02 时必填
operateCompanyAddress string 选填 经营、拍卖单位地址
operateCompanyBank string 选填 经营、拍卖单位开户银行
operateCompanyBankAccount string 选填 经营、拍卖单位开户银行账号
operateCompanyPhone string 选填 经营、拍卖单位电话
marketName string 选填 二手车市场名称，不填以电子税务局为准
marketTaxpayerNumber string 选填 二手车市场税号，不填以电子税务局为准
marketAddress string 选填 二手车市场地址，如果传值需与电子税务局下拉框中的数据一致
marketBank string 选填 二手车市场开户银行，如果传值需与电子税务局下拉框中的数据一致
marketBankAccount string 选填 二手车市场开户银行账号，如果传值需与电子税务局下拉框中的数据一致
marketPhone string 选填 二手车市场电话，如果传值需与电子税务局下拉框中的数据一致
email string 选填 接收发票的邮箱，多个用英文逗号分隔；控制台可配置为必填
mobile string 选填 接收发票的手机号；控制台可配置为必填
username string 选填 用户标识
chinaTaxMobile string 选填 指定开票员的电子税务局手机号
remark string 选填 发票备注
ifPrint boolean 选填 开票完成后是否直接调起打印（纸质票），默认 false
callbackUrl string 选填 开票结果回调地址

请求示例

json
{
  "appKey": "你的appKey",
  "appSecret": "你的appSecret",
  "taxNumber": "91320211MA1WML8X6T",
  "category": "电子发票（二手车销售统一发票）",
  "outOrderNo": "USEDCAR20260101001",
  "marketType": "01",
  "purchaserIfPerson": true,
  "purchaserName": "张三",
  "purchaserTaxpayerNumber": "310101199001011234",
  "purchaserIdType": "201",
  "purchaserIdNumber": "310101199001011234",
  "purchaserAddress": "上海市浦东新区",
  "purchaserPhone": "13800000000",
  "sellerIfPerson": false,
  "sellerName": "上海某某汽车销售有限公司",
  "sellerTaxpayerNumber": "91310115MA1K00000X",
  "sellerAddress": "上海市浦东新区某某路1号",
  "sellerPhone": "021-00000000",
  "licensePlateNumber": "沪A12345",
  "registrationCertificateNumber": "310000000000",
  "carType": "小型轿车",
  "taxNo": "1090511010000000000",
  "vin": "LSGXXXXXXXXXXXXXX",
  "brandModel": "大众 帕萨特",
  "transferDestOfficeName": "上海市公安局交通警察总队车辆管理所",
  "price": 88000,
  "operateCompanyName": "上海某某汽车销售有限公司",
  "operateCompanyTaxpayerNumber": "91310115MA1K00000X",
  "email": "buyer@example.com",
  "callbackUrl": "https://www.example.com/invoice/callback"
}

响应示例

json
{
  "code": 1,
  "message": "提交成功",
  "content": "USEDCAR20260101001"
}

业务规则

  • 同一 outOrderNo 开票失败或审核中时允许再次提交覆盖；已开票或开票中返回 该外部订单号已存在!。
  • 同一 outOrderNo 30 秒内重复提交返回 请不要瞬间重复提交同一外部订单号。
  • 买卖双方名称与证件号码不能完全相同。
  • 控制台配置了「实际可开票金额查询地址」时，开票前会校验可开票金额。

错误信息

message 说明
缺少开票方类型（01经营单位，02拍卖单位，03二手车市场） 等「缺少xxx」 必填字段为空
缺少外部订单号 outOrderNo 为空
请输入买方单位/个人 / 买方单位/个人开头末尾不能包含空格 / 不能包含换行符 买方信息格式错误
买方单位代码/身份证号码不能包含空格 / 换行符 买方证件号格式错误（卖方同理）
买卖双方不能为同一纳税人 买卖双方信息相同
车价合计不能小于等于0 price 不合法
请进入发票配置-企业信息页面完善地址 / 电话 / 开户行 / 银行账号 销售方信息不完整
当前助手不支持开具纸质二手车发票，请联系技术处理 当前开票通道不支持纸质二手车票
二手车发票信息错误，请重新开具 覆盖开票时找不到原二手车信息
上一篇 修改发票下一篇 重试与失败处理