生成开票二维码 - 易宝开放平台

数电发票生成开票二维码

请求参数

Header 参数

x-yop-sdk-version

string

可选

默认值:

4.0.0

Body 参数application/json

生成开票二维码入参

reqId

string

请求流水号

必需

只能是大小写字母和数字，最小长度：20位，最大长度：40位。

>= 20 字符<= 40 字符

示例值:

requestId100666001370197734

merchantNo

string

开票商编

必需

<= 11 字符

invoiceType

integer <int32>

发票类型

必需

1-数电票（增值税专用发票） 2-数电票（普通发票）

< 1

priceTaxMark

integer <int32>

含税标志

必需

0-都不含税 1-都含税

TaxationType为1，即差额征税，此处传1

< 1

taxationType

string

征收类型

可选

仅支持传1，即差额征税-差额开票

<= 1 字符

digitalAccount

string

电子税局登录账号

可选

电子税局手机号，不传取数电发票服务激活时预留的手机号

<= 11 字符

remarks

string

备注

可选

<= 230 字符

contactPhone

string

联系人电话

可选

填写后，将展示在开票失败结果页及开票二维码失效页面下方

<= 11 字符

detailList

array[object (invoice.YopGenOrderQrCodeDetailReqDto) {12}]

发票明细行信息

必需

TaxationType为1，即差额征税-差额开票，则仅支持一行明细

goodsLineNature

integer <int32>

发票行性质

必需

默认值0-正常行

> 1< 1

goodsTaxName

string

商品名称

必需

示例值：信息技术服务技术维护服务

<= 90 字符

goodsTaxCode

string

税收分类编码

必需

<= 21 字符

goodsQuantity

number

商品数量

可选

unitPrice

number

单价

可选

单位：元

如含税标志为0，则此处传入单价（含税）

如含税标志为1，则此处传入单价（不含税）

TaxationType为1，即差额征税，该字段以易宝计算为准，当数量非空时，易宝会为您计算该字段值

goodsSpecification

string

规格型号

可选

<= 40 字符

goodsUnit

string

单位

可选

<= 20 字符

goodsTotalAmount

number

金额

必需

最多支持2位小数

含税标志为0，则此处应传入金额（不含税）。此时如单价和数量均有值，则会校验金额（不含税）=单价*数量。

含税标志为1，则此处应传入金额（含税）。此时如单价和数量均有值，则会校验金额（含税）=单价*数量。

金额（不含税）=金额（含税）/（1+税率）

< 9999999999999.99

goodsTaxRate

number

税率

必需

最大长度10，最大支持3位小数
示例值：0.01

< 10

freeTaxMark

integer <int32>

零税率标识

可选

默认为空，

如需传非零税率，则参考以下枚举值：1-免税、2-不征税、3-普通零税率

< 1

favorablePolicySign

integer <int32>

优惠政策标识

可选

0：不使用 1：使用

< 1

favorablePolicy

string

优惠政策名称

可选

枚举：简易征收、稀土产品、免税、不征税、先征后退、100%先征后退、50%先征后退、按3%简易征收、按5%简易征收、按5%简易征收减按1.5%计征、即征即退30%、即征即退50%、即征即退70%、即征即退100%、超税负3%即征即退、超和免费8%即征即退、超税负12%即征即退、超税负6%即征即退(当favorablePolicySign为1时,此项必填)

<= 50 字符

balanceInfoList

array[object (invoice.YopInvoiceDigitApplyRecordsBalanceInfoReqDto) {9}]

差额征税凭证列表

可选

balanceType

enum<string> <enum>

凭证类型

必需

可选项如下:
1:数电票
2:增值税专用发票
3:增值税普通发票
4:营业税发票
5:财政票据
6:法院裁决书
7:契税完税凭证
8:其他发票类
9:其他扣除凭证

<= 2 字符

枚举值:

123456789

balanceElectricNo

string

数电发票号码

可选

<= 20 字符

balanceInvoiceCode

string

发票代码

可选

<= 12 字符

balanceInvoiceNo

string

发票号码

可选

<= 8 字符

balanceVoucherNo

string

凭证号码

可选

<= 20 字符

balanceIssueDate

string

开具日期

可选

<= 10 字符

balanceTotalAmount

number

凭证合计金额

必需

最大长度 16，精确到小数点后2位

balanceDeductAmount

number

本次扣除金额

必需

最大长度 16，精确到小数点后2位

balanceRemarks

string

备注

可选

<= 100 字符

sellerAddress

string

销方地址

可选

<= 100 字符

sellerTel

string

销方电话

可选

<= 20 字符

sellerBankName

string

销方银行名称

可选

<= 80 字符

sellerBankAccount

string

销方银行账号

可选

<= 50 字符

示例

{
    "reqId": "requestId100666001370197734",
    "merchantNo": "string",
    "invoiceType": 0,
    "priceTaxMark": 0,
    "taxationType": "s",
    "digitalAccount": "string",
    "remarks": "string",
    "contactPhone": "string",
    "detailList": [
        {
            "goodsLineNature": 2,
            "goodsTaxName": "string",
            "goodsTaxCode": "string",
            "goodsQuantity": 0,
            "unitPrice": 0,
            "goodsSpecification": "string",
            "goodsUnit": "string",
            "goodsTotalAmount": 9999999999998.99,
            "goodsTaxRate": 9,
            "freeTaxMark": 0,
            "favorablePolicySign": 0,
            "favorablePolicy": "string"
        }
    ],
    "balanceInfoList": [
        {
            "balanceType": "1",
            "balanceElectricNo": "string",
            "balanceInvoiceCode": "string",
            "balanceInvoiceNo": "string",
            "balanceVoucherNo": "string",
            "balanceIssueDate": "string",
            "balanceTotalAmount": 0,
            "balanceDeductAmount": 0,
            "balanceRemarks": "string"
        }
    ],
    "sellerAddress": "string",
    "sellerTel": "string",
    "sellerBankName": "string",
    "sellerBankAccount": "string"
}

返回响应

🟢200成功

application/json

Body

result

object (invoice.RespDto2YopGenOrderQrCodeRespDto)

生成开票二维码

可选

code

string

结果码

必需

<= 100 字符

msg

string

结果信息

必需

<= 100 字符

data

object (invoice.YopGenOrderQrCodeRespDto)

生成开票二维码

可选

示例

{
    "result": {
        "code": "string",
        "msg": "string",
        "data": {
            "reqId": "stringstringstringst",
            "orderNo": "string",
            "merchantNo": "string",
            "orderQrCode": "string",
            "createTime": "2019-08-24T14:15:22Z",
            "invoiceType": 0,
            "priceTaxMark": 0,
            "taxationType": "s",
            "digitalAccount": "stringstrin",
            "remarks": "string",
            "contactPhone": "stringstrin",
            "detailList": [
                {
                    "goodsLineNature": 2,
                    "goodsTaxName": "string",
                    "goodsTaxCode": "string",
                    "goodsQuantity": 0,
                    "unitPrice": 0,
                    "goodsSpecification": "string",
                    "goodsUnit": "string",
                    "goodsTotalAmount": 9999999999998.99,
                    "goodsTaxRate": 9,
                    "freeTaxMark": 0,
                    "favorablePolicySign": 0,
                    "favorablePolicy": "string"
                }
            ],
            "balanceInfoList": [
                {
                    "balanceType": "1",
                    "balanceElectricNo": "string",
                    "balanceInvoiceCode": "string",
                    "balanceInvoiceNo": "string",
                    "balanceVoucherNo": "string",
                    "balanceIssueDate": "string",
                    "balanceTotalAmount": 0,
                    "balanceDeductAmount": 0,
                    "balanceRemarks": "string"
                }
            ],
            "sellerAddress": "string",
            "sellerTel": "string",
            "sellerBankName": "string",
            "sellerBankAccount": "string"
        }
    }
}

🔴500服务器错误