接口说明
此接口用于新增和更新诺税通SaaS商品信息库的商品信息
API 方法名:nuonuo.OpeMplatform.saveProductInfo 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| taxNum | String | 否 | 20 | 销方税号 | 339901999999199 |
| goodsId | String | 是 | 20 | 商品编号,用户可自定义的编号 | - |
| goodsName | String | 否 | 90 | 商品名称 | 示例商品 |
| specAndTypes | String | 是 | 40 | 规格型号 | - |
| goodsCode | String | 否 | 19 | 商品编码,指税收分类编码 | 1020511010102 |
| taxRate | String | 否 | 10 | 税率 | 13% |
| unit | String | 是 | 22 | 单位 | 斤 |
| price | String | 是 | 16 | 单价,最多16位(小数点后最多13位) | - |
| includingTaxFlag | String | 否 | 1 | 含税标识,价格含税标识 0:不含税,1:含税 | 1 |
| favouredPolicyFlag | String | 是 | 2 | 是否享受优惠政策 | - |
| favouredPolicyName | String | 是 | 50 | 优惠政策名称 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 返回编码 | E0000 |
| message | String | 否 | - | 返回提示 | 成功 |
| result | String | 否 | - | 返回数据 | - |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.saveProductInfo"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"taxRate\": \"13%\",
\"unit\": \"斤\",
\"favouredPolicyName\": \"\",
\"goodsId\": \"\",
\"price\": \"\",
\"includingTaxFlag\": \"1\",
\"taxNum\": \"339901999999199\",
\"goodsCode\": \"1020511010102\",
\"favouredPolicyFlag\": \"\",
\"goodsName\": \"示例商品\",
\"specAndTypes\": \"\"
}";
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 成功 | |
E0069 | 税号不能为空 | |
E9513 | 企业资质不存在或已关闭 | |
E9371 | 商品名称不能为空 | |
E0070 | 商品规格型号有误 | |
E0071 | 商品名称有误 | |
E0038 | 商品编号不得超过20个字符,仅限数字或字母 | |
E0072 | 商品名称+规格型号已存在,商品编号也必须和商品库中该商品名称+规格型号对应的保持一致 | |
E0084 | 商品编号已存在,商品名称+规格型号也必须和商品库中该商品编号对应的保持一致 | |
E0073 | 商品计量单位有误 | |
E0074 | 商品税率有误 | |
E9389 | 商品税率不能为空 | |
E0075 | 商品单价有误 | |
E0076 | 含税标志有误 | |
E0079 | 暂不支持添加该类商品 | |
E0083 | 税率、优惠政策名称逻辑关系不正确 | |