2.2.11税控/数电机动车发票开具

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/sim/openApi

请求参数

Query 参数

access_token

string

必需

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

对接业务系统来源编码

必需

用于区分不同业务系统的回调接口

interfaceCode

enum<string>

接口编码

必需

开票固定为[INVOICE.OPEN.VEHICLE]

枚举值:

INVOICE.OPEN.VEHICLE

data

object

必需

需要把data的值加密成字符串，默认为base64

serialNo

string

单据编号

必需

【长度：50】唯一

<= 50 字符

salerName

string

销方名称

必需

<= 100 字符

salerTaxNo

string

销方税号

必需

<= 50 字符

salerAddress

string

销方地址

必需

<= 80 字符

salerPhone

string

销方电话

必需

<= 50 字符

salerAccount

string

销方银行账号

必需

<= 50 字符

salerBankName

string

销方银行

必需

<= 80 字符

buyerName

string

购买方名称

必需

<= 100 字符

buyerTaxNo

string

购方税号/身份证号

必需

<= 50 字符

invoiceType

enum<string>

发票类型

可选

06xdp:机动车发票（数电纸票）、006：机动车销售统一发票，51xdp 二手车发票（数电纸票）、机动车数电电票83xdp，二手车数电电票84xdp，默认值：006

枚举值:

00606xdp51xdp

drawer

string

开票人

必需

【长度：10】

<= 10 字符

account

string

数电账号

可选

开具机动车发票（数电纸票）、机动车发票（数电电票）、二手车（数电电票）、二手车（数电纸票）时，如果为空使用默认数电账号

<= 20 字符

machineNo

string

设备编号

必需

totalAmount

number

价税合计

必需

totalTaxAmount

string

税额

必需

goodsCode

string

税收分类编码

必需

<= 50 字符

taxRate

number

税率

必需

zeroTaxRateFlag

string

零税率标识

必需

preferentialPolicy

enum<string>

是否享受优惠政策

必需

0不享受，1享受

枚举值:

vatException

string

优惠政策内容

必需

buyerEmail

string

收票邮箱

必需

vehicleIdentificationCode

string

车架号/车辆识别代码

必需

<= 50 字符

brandModel

string

厂牌型号

必需

<= 50 字符

vehicleType

string

车辆类型

必需

<= 50 字符

limitePeople

string

机动车限乘人数

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

overTaxCode

string

机动车完税凭证号码

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

producingArea

string

机动车产地

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

taxAuthorityCode

string

机动车税务机关代码

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

importCertificate

string

机动车进口证明书号

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

commodityInspectionNum

string

机动车商检单号

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

engineNum

string

机动车发动机号

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 100 字符

totalTon

string

机动车吨位

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

taxAuthorityName

string

机动车税务机关名称

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

certificateNum

string

机动车合格证号

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

producingName

string

机动车生产企业名称

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

<= 50 字符

version

string

机动车版本号，0旧版，1新版

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

invoiceCopyType

enum<string>

机动车联次，6-6联

可选

机动车、机动车（数电纸票）必传，二手车（数电纸票）不传

枚举值:

vehicleUuid

string

机动车机动车uuid

可选

机动车发票（数电纸票）必传

<= 30 字符

usedCarInfo

object

二手车发票信息

可选

仅开具二手车销售统一发票时填写。请先在发票云-基础资料-企业信息中配置企业资质，例如：二手车经销企业、二手车交易市场

示例

{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": "INVOICE.OPEN.VEHICLE",
    "data": {
        "serialNo": "string",
        "salerName": "string",
        "salerTaxNo": "string",
        "salerAddress": "string",
        "salerPhone": "string",
        "salerAccount": "string",
        "salerBankName": "string",
        "buyerName": "string",
        "buyerTaxNo": "string",
        "invoiceType": "006",
        "drawer": "string",
        "account": "string",
        "machineNo": "string",
        "totalAmount": 0,
        "totalTaxAmount": "string",
        "goodsCode": "string",
        "taxRate": 0,
        "zeroTaxRateFlag": "string",
        "preferentialPolicy": "0",
        "vatException": "string",
        "buyerEmail": "string",
        "vehicleIdentificationCode": "string",
        "brandModel": "string",
        "vehicleType": "string",
        "limitePeople": "string",
        "overTaxCode": "string",
        "producingArea": "string",
        "taxAuthorityCode": "string",
        "importCertificate": "string",
        "commodityInspectionNum": "string",
        "engineNum": "string",
        "totalTon": "string",
        "taxAuthorityName": "string",
        "certificateNum": "string",
        "producingName": "string",
        "version": "string",
        "invoiceCopyType": "6",
        "vehicleUuid": "string",
        "usedCarInfo": {
            "issueWay": "0",
            "licensePlateNumber": "string",
            "registerNumber": "string",
            "vehicleAdminName": "string",
            "sellerProperty": "0",
            "sellerName": "string",
            "sellerTaxNo": "string",
            "sellerrAddress": "string",
            "sellerPhone": "string",
            "sellerCardtype": "103",
            "sellerNation": "004",
            "buyerProperty": "0",
            "buyerAddress": "string",
            "buyerPhone": "string",
            "buyerCardType": "103",
            "buyerNation": "004"
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": "INVOICE.OPEN.VEHICLE",
    "data": {
        "serialNo": "string",
        "salerName": "string",
        "salerTaxNo": "string",
        "salerAddress": "string",
        "salerPhone": "string",
        "salerAccount": "string",
        "salerBankName": "string",
        "buyerName": "string",
        "buyerTaxNo": "string",
        "invoiceType": "006",
        "drawer": "string",
        "account": "string",
        "machineNo": "string",
        "totalAmount": 0,
        "totalTaxAmount": "string",
        "goodsCode": "string",
        "taxRate": 0,
        "zeroTaxRateFlag": "string",
        "preferentialPolicy": "0",
        "vatException": "string",
        "buyerEmail": "string",
        "vehicleIdentificationCode": "string",
        "brandModel": "string",
        "vehicleType": "string",
        "limitePeople": "string",
        "overTaxCode": "string",
        "producingArea": "string",
        "taxAuthorityCode": "string",
        "importCertificate": "string",
        "commodityInspectionNum": "string",
        "engineNum": "string",
        "totalTon": "string",
        "taxAuthorityName": "string",
        "certificateNum": "string",
        "producingName": "string",
        "version": "string",
        "invoiceCopyType": "6",
        "vehicleUuid": "string",
        "usedCarInfo": {
            "issueWay": "0",
            "licensePlateNumber": "string",
            "registerNumber": "string",
            "vehicleAdminName": "string",
            "sellerProperty": "0",
            "sellerName": "string",
            "sellerTaxNo": "string",
            "sellerrAddress": "string",
            "sellerPhone": "string",
            "sellerCardtype": "103",
            "sellerNation": "004",
            "buyerProperty": "0",
            "buyerAddress": "string",
            "buyerPhone": "string",
            "buyerCardType": "103",
            "buyerNation": "004"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

data

string

必需

返回内容，需要解密，成功返回同机动车发票查询

errorCode

string

响应码

必需

success

boolean

成功响应

必需

示例

{
    "data": "string",
    "errorCode": "string",
    "success": true
}

修改于 2025-07-08 06:52:47

2.2.10邮件短信重发（数电票和税控发票都支持）

2.2.12税控机动车发票作废