发票红冲

接口说明

如果出现交易失败或退货等情况，开发者可通过此接口红冲已经开具的发票。

1. 电子发票只有红冲没有作废，纸质发票为当月作废，跨月红冲。
2. 专用发票红冲时，需先申请红字信息表。
3. 此接口纸票、电票共用。

地址

/tax-api/invoice/red/v1

请求参数

说明：如果既传了order_sn也传了order_id则以order_sn为准

参数名称	类型	必填	最大长度	描述	示例
invoices	list	是		红冲发票信息
invoices.seller_taxpayer_num	string	是	20	销方纳税人识别号（销方票面信息）：即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外）	91469027MA5RH09M0R
invoices.callback_url	string	是	500	发票结果回传地址：接收平台推送的开票结果消息地址，可参见【开票结果异步通知】	开发者服务器地址
invoices.order_sn	string	否	21	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识((开具蓝票时返回值) 此字段与order_id不能同时为空	6590128277141372177
invoices.order_id	string	否	64	商户订单号：开发者接入方业务订单唯一标识(开具蓝票开具时填入值) 此字段与order_sn不能同时为空	gd_1904242006002627690
invoices.red_serial_no	string	否	64	红字信息表编码：专票红冲时需申请红字信息表，此字段专票红冲时必填	3202201506013858
confirm_info_state	string	否		全电发票时必填，红字确认信息状态代码
confirm_info_uuid	string	否		全电发票时必填，红字确认单uuid
special_element_code	string	否		全电发票时必填，特定要素代码

响应参数

说明：响应参数为list

字段	类型	必须	备注
state	int	是	红冲状态 1：已提交成功【开票结果会通过异步通知，开发者可以通过查询接口手动进行查询】 3：提交失败或已红冲
message	int	是	提交红冲描述
order_sn	int	是	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识((开具蓝票时返回值)
invoice_id	int	是	高灯红票发票唯一标识

请求示例

{
    "invoices":[{
       "seller_taxpayer_num":"111112222233333",
       "callback_url":"http://test.feehi.com/sign/mock/invoice-callback.php",
       "order_sn":"6555407740980870214"
    }]
}

响应示例

{
    "code": 0,
    "data": [
        {
            "state": 1,
            "message": "",
            "order_sn": "6555407740980870214",
            "invoice_id": "6555408438640385099"
        }
    ],
    "message": ""
}