1. 发票快速冲红
1.1. 接口说明
根据已开蓝票发票流水号进行发票整单快速冲红,若为纸质专票、电子专票、数电票则自动申请红字信息表,申请成功则自动开具红票,申请失败则不会开票。
1.2. 调用方式
请求方式:GET
https://invoice.youepiao.com/openApi/v4/fp/fpch
1.3. 请求参数
1.3.1. 参数说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
lsh | 申请流水号 | String | 50 | 是 | 蓝票开票申请流水号 |
chyydm | 冲红原因代码 | String | 1 | 是 | 数电发票申请时必填 1-销货退回 2-开票有误 3-服务中止 4-销售折让 |
xhdwsbh | 销货单位识别号 | String | 20 | 是 |
1.4. 返回结果
1.4.1. 返回示例
{
"status": true,
"code": 0,
"msg": "提示信息",
"timestamp": "2021-06-23T03:42:23.517+00:00",
"data": [
{
"fplxdm": "发票类型代码",
"fpdm": "发票代码",
"fphm": "66987825",
"kprq": "2021-06-11T05:32:10.000+00:00",
"skm": "税控码",
"jym": "校验码",
"pdf": "pdf地址",
"ofd": "ofd地址",
"xml": "xml地址",
"qr": "二维码地址",
"kplx": "开票类型",
"zflx": "作废类型",
"jshj": "价税合计",
"lsh": "请求流水号(订单编号)"
}
]
}
1.4.2. 返回说明
除税控服务器外其余设备快速冲红都为异步执行,提交冲红请求成功后需调用开具结果查询接口查询冲红结果,或者以相同流水号再次请求发票快速冲红获取相应结果。
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
fplxdm | 发票类型 | String | 3 | 是 | 004-纸质专票 007-纸质普票 025-卷票 026-电子普票 028-电子专票 81-数电票专票 82-数电票普票 |
fpdm | 发票代码 | String | 10/12 | 是 | |
fphm | 发票号码 | String | 8 | 是 | |
kprq | 开票日期 | 是 | 时间格式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) | ||
skm | 税控码 | 否 | |||
jym | 校验码 | 否 | |||
发票PDF地址 | String | 300 | 否 | PDF下载地址 | |
ofd | 发票OFD地址 | String | 300 | 否 | OFD下载地址 |
xml | 发票XML地址 | String | 300 | 否 | XML下载地址 |
lsh | 流水号 | 50 | 否 | 请求流水号(订单编号) | |
qr | 发票二维码地址 | String | 300 | 否 | 二维码地址 |
kplx | 开票类型 | 否 | 0-蓝票(正数发票) 1-红票(负数发票) |
||
zflx | 作废类型 | String | 1 | 否 | null-非作废票 0-空白票作废 1-已开票作废 |
jshj | 价税合计 | Decimal | 是 | 价税合计保留小数点后2位 |