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

数电发票生成开票二维码

请求参数

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服务器错误