接口说明
具备诺税通saas资质的企业,可以通过该接口对发票进行进项税转出或生成无发票的转出记录
API 方法名:nuonuo.OpeMplatform.transfer 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| transferList | Array | 否 | - | | - |
| └ buyerTaxnum | String | 否 | - | 购方税号:企业税号,税号与header中businessTaxNum保持一致。 | - |
| └ invoiceNumber | String | 是 | - | 发票号码 | 12345678 |
| └ invoiceCode | String | 是 | - | 发票代码 | 1234567890 |
| └ sellerTaxNum | String | 是 | - | 被扣缴人识别号(转出代扣代缴完税凭证时必填) | - |
| └ businessType | String | 否 | - | 转出状态:0转出 (默认为0) | 0 |
| └ transferOutPeriod | String | 是 | - | 转出属期:转出必填,不能早于202006。 | - |
| └ transferOutTax | String | 否 | - | 转出税额(保留两位小数):转出时必填 | - |
| └ transferOutReason | String | 否 | - | 转出类型:0.免税项目用 1.集体福利、个人消费 2.非正常损失 3.简易计税方法征税项目用 4.免抵退税办法不得抵扣的进项税额 5.纳税检查调减进项税额 6.红字专用发票信息表注明的进项税额 7.上期留抵税额抵减欠税 8.上期留抵税额退税 9.其他应做进项税额转出的情形 10.异常凭证转出进项税额 (转出时必填) | - |
| └ transferVoucherNo | String | 否 | - | 转出凭证号 | - |
| └ remark | String | 否 | - | 备注 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | Number | 否 | - | 返回码,200代表成功 | 200 |
| message | String | 否 | - | 返回码描述 | 成功 |
| data | Object | 否 | - | 第三方调用返回的code | - |
| └ total | String | 否 | - | 发票总条数 | 10 |
| └ success | String | 否 | - | 操作成功条数 | 5 |
| └ invoiceList | Array | 否 | - | 发票列表 | - |
| └ invoiceCode | String | 否 | - | 发票代码 | 123456789012 |
| └ invoiceNumber | String | 否 | - | 发票号码 | 123456789 |
| └ businessType | String | 否 | - | 转出状态:0转出 | 0 |
| └ transferOutTax | String | 否 | - | 转出时税额 | 155.12 |
| └ transferResult | String | 否 | - | 操作是否成功true:成功、false:失败 | true |
| └ transferVoucherNo | String | 否 | - | 转出凭证号 | 123456 |
| └ failReason | String | 否 | - | 失败原因 | - |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.transfer"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"transferList\": [
{
\"transferOutReason\": \"\",
\"transferVoucherNo\": \"\",
\"buyerTaxnum\": \"\",
\"transferOutPeriod\": \"\",
\"invoiceNumber\": \"12345678\",
\"transferOutTax\": \"\",
\"remark\": \"\",
\"businessType\": \"0\",
\"invoiceCode\": \"1234567890\",
\"sellerTaxNum\": \"\"
}
]
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
返回码说明