红字确认单申请（红冲）

请求地址: /api/v3/redConfirm

请求方式: POST

说明: 红冲用于开具红字负数发票冲抵原票。多数情况下本接口即可红冲成功；当没有返回红字发票号码（或 redStatus 不为 Y）时，需要根据 confirmStatus 状态处理；当 confirmStatus 为 01 或 04 时，调用红字确认开具接口。

请求参数

参数名称	参数类型	必填	说明
applicant	string	否	发起方，0：销方发起（默认），1：购方发起
digitAccount	string	否	设置了多个账号时，传此参数可以指定开票账号
buyerTaxNo	string	否	购买方纳税人识别号
sellerTaxNo	string	是	销售方纳税人识别号
digitInvoiceNo	string	是	蓝字数电发票号码
invoiceTime	string	是	蓝票开具时间，格式 yyyy-MM-dd HH:mm:ss
invoiceTypeCode	string	是	发票类型代码：02 全电普通发票，01 全电专用发票
redIssueReason	string	是	红冲原因：01 开票有误，02 销货退回，03 服务中止，04 销售折让
invoiceTotalPriceTax	string	否	红冲价税合计。可不传；传入用于确认与原蓝字发票票面金额一致性
fileFormat	string	否	需要返回发票版式文件格式（PDF,OFD,XML）。多个以逗号分隔（影响速度）
confirmPdf	string	否	是否返回确认单 PDF 文件，1：返回，2：不返回

请求 JSON 示例

{ "buyerTaxNo": "", "sellerTaxNo": "91520198M******9P", "digitInvoiceNo": "245220000000******59", "invoiceTime": "2024-08-01 10:59:12", "invoiceTypeCode": "02", "redIssueReason": "01" }

返回参数

参数名称	参数类型	必填	说明
uuid	string	是	红字确认单 uuid
redInfoNo	string	是	红字确认单编号
buyerTaxNo	string	是	购买方识别号
buyerName	string	是	购买方名称
sellerTaxNo	string	是	销售方识别号
sellerName	string	是	销售方名称
confirmIssue	string	是	红字确认后是否立即开具红票（Y/N）
confirmStatus	string	是	红字确认状态代码：01 无需确认（数电大多数情况自动为 01），02 销方录入待购方确认，03 购方录入待销方确认，04 购销双方已确认，05 作废（销方录入购方否认），06 作废（购方录入销方否认），07 作废（超 72 小时未确认），08 发起方撤销，09 确认后撤销
confirmDate	string	否	确认日期
redStatus	string	是	红票开具标志，Y 已开票；N 或空为未开票
digitInvoiceNo	string	否	红票发票号码
invoiceTime	string	否	红票开具时间
invoiceTotalPrice	string	否	红票金额
invoiceTotalTax	string	否	红票税额
remarks	string	否	红票备注
confirmPdfUrl	string	否	红字确认单 PDF 下载地址
pdfUrl	string	否	红字发票 PDF 下载地址
ofdUrl	string	否	红字发票 OFD 下载地址
xmlUrl	string	否	红字发票 XML 下载地址

返回 JSON 示例

{
  "code": 200,
  "msg": "开具成功",
  "data": {
    "uuid": "2e84e900a1af481eaebb1b1abec",
    "redInfoNo": "5201982408******92",
    "buyerName": "个人",
    "buyerTaxNo": null,
    "sellerName": "贵州xxxx有限公司",
    "sellerTaxNo": "91520198******9P",
    "confirmIssue": "Y",
    "confirmStatus": "01",
    "confirmDate": "",
    "redStatus": "N",
    "digitInvoiceNo": "245220000000******22",
    "invoiceTime": "2024-08-01 03:21:21",
    "invoiceTotalPrice": -1,
    "invoiceTotalTax": -0.06,
    "remarks": ""
  }
}