淘宝开放平台

登录
文档中心 > API类目 > 电子发票

电子发票

qimen.alibaba.einvoice.proxy.invoice.create (发票代开)

阿里发票中台接入畅易代开发票能力，发起发票代开请求。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
serialNumber String 必须 202006031415590001 业务请求流水号
buyerTaxNo String 可选 1234567890 购方单位税号，专用发票开具时必传
buyerName String 必须 测试企业 购方单位名称
buyerAddress String 可选 浙江省杭州市西湖区紫荆花路88号 购方地址(专票必填)
buyerPhone String 可选 0571-7357869 购方电话(专票必填)
buyerBank String 可选 中国银行 购方开户行(专票必填)
buyerBankAccount String 可选 0345657896564356 购方银行账号(专票必填)
sellerTaxNo String 必须 1234567891 销方企业税号
sellerName String 必须 哈哈企业 销方企业名称
sellerAddress String 可选 浙江省杭州市西湖区古墩路123号 销方地址
sellerPhone String 可选 13456785467 销方电话
sellerBank String 可选 招商银行 销方开户行及账号
sellerBankAccount String 可选 1234567865764356 销方银行账号
invoiceTypeCode String 必须 026 发票种类编码 026：增值税电子普通发票 028：增值税电子专用发票
invoiceType Number 必须 0 开票类型 0：正数发票 1：负数发票
drawer String 必须 张三 开票人
checker String 必须 李四 复核人
payee String 必须 王二 收款人
invoiceTotalPriceTax String 必须 200.00 价税合计， 保留两位小数
remarks String 可选 备注信息 用户填写备注
originalInvoiceCode String 可选 034563456743 原发票代码，invoiceType=1，负数票开具时必传
originalInvoiceNo String 可选 23456788 原发票号码，invoiceType=1，负数票开具时必传
invoiceDetailsList ProxyInvoiceDetailDTO [] 必须
  • 最大列表长度：999
    		•  商品明细节点
    • └ goodsTotalTax
    • String
    • 可选
    • 4.35
    • 税额
    • └ goodsTotalPriceTax
    • String
    • 必须
    • 34.56
    • 价税合计
    • └ goodsTotalPrice
    • String
    • 必须
    • 43.23
    • 金额（不含税）
    • └ goodsPrice
    • String
    • 可选
    • 12.34
    • 商品单价（不含税）
    • └ goodsQuantity
    • String
    • 必须
    • 1
    • 商品数量
    • └ goodsUnit
    • String
    • 可选
    • 斤
    • 计量单位
    • └ goodsSpecification
    • String
    • 可选
    • dw
    • 规格型号
    • └ goodsName
    • String
    • 必须
    • 苹果
    • 商品名称
    • └ goodsCode
    • String
    • 必须
    • 0101010100193
    • 税收分类编码
    • └ goodsLineNo
    • Number
    • 必须
    • 1
    • 明细行号
    • └ goodsTaxRate
    • String
    • 必须
    • 0.03
    • 税率
    agentIsuse Number 必须 0 代开发票标志，0:代开，1:自开
    reqIndex String 必须 sfsghslg_12324242 开票请求的唯一索引

    响应参数

    名称 类型 示例值 描述
    respMessage String 成功 响应描述
    success Boolean true 响应结果
    dataList ProxyDataList [] 响应对象
    • └ serialNumber
    • String
    • 20191111111152524526
    • 业务请求序号
    • └ bizCode
    • String
    • B0000
    • 业务错误编号，B0000为成功
    • └ bizMessage
    • String
    • 成功
    • 业务错误信息，code不为B0000时有效
    respCode String A0000 响应代码

    请求示例

    {"buyerBankAccount":"0345657896564356","sellerBank":"招商银行","sellerName":"哈哈企业","sellerAddress":"浙江省杭州市西湖区古墩路123号","checker":"李四","payee":"王二","buyerAddress":"浙江省杭州市西湖区紫荆花路88号","agentIsuse":0,"invoiceType":0,"buyerBank":"中国银行","serialNumber":"202006031415590001","buyerTaxNo":"1234567890","sellerPhone":"13456785467","drawer":"张三","buyerName":"测试企业","originalInvoiceNo":"23456788","invoiceTotalPriceTax":"200.00","sellerTaxNo":"1234567891","buyerPhone":"0571-7357869","reqIndex":"sfsghslg_12324242","sellerBankAccount":"1234567865764356","invoiceDetailsList":[{"goodsSpecification":"dw","goodsTaxRate":"0.03","goodsPrice":"12.34","goodsQuantity":"1","goodsTotalTax":"4.35","goodsUnit":"斤","goodsTotalPriceTax":"34.56","goodsCode":"0101010100193","goodsName":"苹果","goodsTotalPrice":"43.23","goodsLineNo":1}],"invoiceTypeCode":"026","remarks":"备注信息","originalInvoiceCode":"034563456743"}

    响应示例

    {
    "respMessage":"成功",
    "success":true,
    "dataList":[
        {
                "serialNumber":"20191111111152524526",
                "bizCode":"B0000",
                "bizMessage":"成功"
        }
    ],
    "respCode":"A0000"
}

    验签示例

    {"respMessage":"Illegal request","success":"false","respCode":"sign-check-failure"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部