开票重试接口
发票开票失败时,可使用该接口进行重推开票,发票订单号、流水号与原请求一致 1、对于开票成功状态的发票(发票生成、开票完成),调用该接口,提示:发票已生成,无需再重试开票 2、对于开票中状态的发票,调用该接口,提示:开票中(重试中),请耐心等待开票结果
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/nuonuo/invoice/rebillingnew
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
tax_num | String | true | 4214132412414 | 销售方税号 |
request_data | Json | true | 见示例代码 | 重试开票业务报文 |
2. 请求示例代码(Java)
// 开票接口重试
@Test
public void NNReBillingNEW() throws Exception {
// 销售方公司税号
String saleTaxNum = "91310117568051223X"; //上海xx节能科技有限公司
//订单号orderNo为之前请求开具发票接口中的orderNo 一致。表示对之前那个订单进行重试。
String request_data = "{" +
" \"orderno\": \"20240122150518179381\"" +
"}";
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tax_num", saleTaxNum);
data.put("request_data",request_data);
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.NN_RE_BILLING_NEW, data);
System.out.println(resp);
}
2.1 请求参数说明
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
tax_num | String | Y | 91310117568051222X | 销售方的税号 |
request_data | String | Y | {“orderno”:”223881341324”} | 业务报文,json格式 |
3. 返回结果
重试成功时code返回为0
{ "code": 0, "message": "重试成功" }
如果之前开票成功,code为100, 则直接返回发票号和pdf下载地址
{
"code": 100,
"invoice_down_url": "https://inv.jss.com.cn/fp2/_du8ccsApfF5aFxZaYEBkckAQ2xe8yafOkSoUyQt9Po8-KM11E_Yx2g-dd4e4lP5i-2j5waUWLpqbkFgmT79TQ.pdf",
"invoice_no": "24312000000022669098",
"message": "发票已经生成,不需要重复提交"
}
如果code是其他数值,则说明重试失败,message字段包含失败的原因。
4 返回参数说明
参数接口 | 参数类型 | 例子 | 说明 |
---|---|---|---|
code | int | 0 | 状态码,0:重试成功,蜂巢将稍后重新推送开票结果,100:成功并直返回发票号和pdf下载地址, 其他值:重试失败 |
message | String | 本次操作需登录电子发票服务平台,请先使用短信验证码登录 | 重试失败时的消息 |
文档更新时间: 2024-01-22 17:44 作者:admin