Customs 相关接口

以下接口适用于 Master Data Customs 数据集成 API，对接前请了解 API 接入流程

Create Customs

⚠️ 整个报文需小于20M(包含图片)。

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs

请求参数

Method: POST
Content-Type: multipart/form-data

参数	key	类型	必填	长度	描述	示例
lenovoPn	Y	String	Y	20	联想料号	pn1
vendorCode	Y	String	Y	20	供应商编号	vendor1
countryIsoCode	Y	String	Y	20	国家ISO编码	CN
inhouseSite	Y	String	Y	20	海关关区	ABC
hsCode		String	Y	10	海关编码	11111
brand	Y	String	Y	50	品牌	无品牌
commodityNameInChinese		String	Y	100	物料中文名称	内存条
partEnglishDescription		String	Y	100	物料英文名称	DRAM
declareElements		String	Y	2000	申报要素(\| 分隔)	-
conversionRatioPerUnit		Number	Y	15,4	单位转换比例	1
netWeightKgs		Number	Y	21,10	净重(KGS)	0.00
unitPrice		Number	Y	15,4	参考单价	0.00
currency		String	Y	20	币种	USD
files		File	Y		照片文件	-
certificateNo		String		100	证书编号	20220109085
expiryDate		String		20	证书有效期	2023-12-12
additionalInformation		String		500	产品补充说明	-
eccnCode		String		100	ECCN编码	1A2B3C

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

customsData:{
    "lenovoPn": "pn1",
    "vendorCode": "vendor1",  
    "countryIsoCode": "CN",
    "inhouseSite": "ABC",
    "hsCode": "11111",
    "brand": "无品牌",
    "commodityNameInChinese": "内存条",
    "partEnglishDescription": "DRAM",
    "declareElements": "declaration abc",    
    "conversionRatioPerUnit": 1,
    "netWeightKgs": 0.00,
    "unitPrice": 0.00,
    "currency": "USD",		
    "certificateNo": "20220109085",
    "expiryDate": "2023-12-12",
    "additionalInformation": "",
    "eccnCode": "1A2B3C" 
}
files: [
    photo01,photo02...
]

响应示例

JSON

{
	"code": "0",
	"msg": "ok"
}

异常示例

JSON

{
	"code": "-1",
	"msg": "Data already exists,please check!(数据已存在,请检查)"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Edit Customs

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs

Method: PUT
Content-Type: application/json

请求参数

参数	key	类型	必填	长度	描述	示例
lenovoPn	Y	String	Y	20	联想料号	pn1
vendorCode	Y	String	Y	20	供应商编号	vendor1
countryIsoCode	Y	String	Y	20	国家ISO编码	CN
inhouseSite	Y	String	Y	20	海关关区	ABC
hsCode		String	Y	10	海关编码	1111111
brand	Y	String	Y	50	品牌	无品牌
commodityNameInChinese		String	Y	100	物料中文名称	内存条
partEnglishDescription		String	Y	100	物料英文名称	DRAM
declareElements		String	Y	2000	申报要素	-
conversionRatioPerUnit		Number	Y	15,4	单位转换比例	1
netWeightKgs		Number	Y	21,10	净重(KGS)	0.00
unitPrice		Number	Y	15,4	参考单价	0.00
currency		String	Y	20	币种	USD
certificateNo		String		100	证书编号	20220109085
expiryDate		String		20	证书有效期	2023-12-12
additionalInformation		String		500	产品补充说明	-
eccnCode		String		100	ECCN编码	1A2B3C

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

{
	"lenovoPn": "pn1",
    "vendorCode": "vendor1",  
    "countryIsoCode": "CN",
    "inhouseSite": "ABC",
    "hsCode": "1111111",
    "brand": "无品牌",
    "commodityNameInChinese": "内存条",
    "partEnglishDescription": "DRAM",
    "declareElements": "declaration",    
    "conversionRatioPerUnit": 1,
    "netWeightKgs": 0.00,
    "unitPrice": 0.00,
    "currency": "USD",  		
    "certificateNo": "20220109085",
    "expiryDate": "2023-12-12",
    "additionalInformation": "",
    "eccnCode": "1A2B3C" 
}

响应示例

JSON

{
	"code": "0",
	"msg": "ok"
}

异常示例

JSON

{
    "code": "-1",
    "msg": "备案信息正在LCCH审核中,不允许修改!"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Delete Customs

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs

**Method：**DELETE
Content-Type: application/json

请求参数

参数	key	类型	必填	长度	描述	示例
lenovoPn	Y	String	Y	20	联想料号	pn1
vendorCode	Y	String	Y	20	供应商编号	vendor1
countryIsoCode	Y	String	Y	20	国家ISO编码	CN
inhouseSite	Y	String	Y	20	海关关区	aa
brand	Y	String	Y	50	品牌	无品牌

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

{
	"lenovoPn": "pn1",
    "vendorCode": "vendor1",  
    "countryIsoCode": "CN",
    "inhouseSite": "aa",    
    "brand": "无品牌"
}

响应示例

JSON

{
	"code": "0",
	"msg": "ok"
}

异常示例

JSON

{
    "code": "-1",
    "msg": "备案信息正在LCCH审核中,不允许删除!"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Query Customs

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs

Method: GET
Content-Type: application/json

请求参数

参数	类型	必填	长度	描述	示例
pageNum	Number	Y	10	页码	1
pageSize	Number	Y	4	每页数据	20
lenovoPn	String		20	联想料号	pn1
vendorCode	String		20	供应商编号	vendor1
inhouseSite	String		20	海关关区	aa
hsCode	String		10	海关编码	1111111
status	String		50	品牌	无品牌
creationDate	String		50	创建时间	"["2023-03-15","2023-03-17"]"

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

{
	"pageNum": 1,
    "pageSize": 20,
    "lenovoPn": "pn2"
}

响应示例

JSON

{
    "code": "0",
    "msg": "ok",
    "result": {
        "total": 2,
        "pageNum": 1,
        "pageSize": 20,
        "list": [
            {
                "customsId": "abcde",
                "status": "Approved",
                "lenovoPn": "pn2",
                "vendorCode": "vendor1",
                "countryIsoCode": "CN-中国",
                "inhouseSite": "abd",
                "hsCode": "code1",
                "commodityNameInChinese": "支架",
                "partEnglishDescription": "partEnglishDescription",
                "brand": "无品牌",
                "declareElements": "declaration",
                "conversionRatioPerUnit": 1,
                "netWeightKgs": 0.00,
                "unitPrice": 0.00,
                "currency": "USD",
                "creationDate": "2022-07-12",
                "sysCreationBy": "abc",
                "sysCreationDate": "2022-07-12 10:10:12",
                "sysLastmodifiedBy": "abc",
                "sysLastmodifiedDate": "2022-07-13 16:39:53"
            },
            ...
        ]
    }
}

异常示例

JSON

{
    "code": "-1",
    "msg": "creationDate格式化异常！"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Query DeclareElements

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs/declareElements
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs/declareElements

Method: GET
Content-Type: application/json

请求参数

参数	类型	必填	长度	描述	示例
hsCode	String	Y	10	海关编码	1111111

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

{
    "hsCode": "1111111"
}

响应示例

JSON

{
	"code": "0",
	"msg": "ok",
    "result": {
        "cusElements": [
            {
                "textName": "品牌类型",
                "decfaccode": "0|1|2|3|4",
                "snum": "0",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "1",
                "decFacContent": "无品牌|境内自主品牌|境内收购品牌|境外品牌(贴牌生产)|境外品牌(其它)"
            },
            {
                "textName": "abcde",
                "decfaccode": "0|1|2|3",
                "snum": "1",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "1",
                "decFacContent": "dec fac content"
            },
            {
                "textName": "用途（适用于XX品牌XX机或通用于XX机等）",
                "decfaccode": "",
                "snum": "2",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "品牌（中文或外文名称）",
                "decfaccode": "",
                "snum": "3",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "型号",
                "decfaccode": "",
                "snum": "4",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "如为内存条需申报容量",
                "decfaccode": "",
                "snum": "5",
                "codets": null,
                "requireCheck": "1",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "GTIN",
                "decfaccode": "",
                "snum": "6",
                "codets": null,
                "requireCheck": "0",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "CAS",
                "decfaccode": "",
                "snum": "7",
                "codets": null,
                "requireCheck": "0",
                "decFacType": "",
                "decFacContent": ""
            },
            {
                "textName": "其他",
                "decfaccode": "",
                "snum": "8",
                "codets": null,
                "requireCheck": "0",
                "decFacType": "",
                "decFacContent": ""
            }
        ],
        "hsCode": "111111",
        "inspMonitorCond": "\\0"
    }
}

异常示例

JSON

{
    "code": "-1",
    "msg": "hsCode不能为空！"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Upload Attachment

⚠️ 更新附件时会先清空原始附件！

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs/upload
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs/upload

Method: POST
Content-Type: multipart/form-data

请求参数

参数	key	类型	必填	长度	描述	示例
lenovoPn	Y	String	Y	20	联想料号	pn1
vendorCode	Y	String	Y	20	供应商编号	vendor1
countryIsoCode	Y	String	Y	20	国家ISO编码	CN
inhouseSite	Y	String	Y	20	海关关区	aa
brand	Y	String	Y	50	品牌	无品牌
fileType		Number	Y	1	文件类型	0
files		File	Y	-	附件	-

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

customsData:{
    "lenovoPn": "pn1",
    "vendorCode": "vendor1",  
    "countryIsoCode": "CN",
    "inhouseSite": "aa",
    "brand": "无品牌",
    "fileType": 0
},
files: [
	photo01,photo02
]

响应示例

JSON

{
	"code": "0",
	"msg": "ok"
}

异常示例

JSON

{
    "code": "-1",
    "msg": "Data Not Found！"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Publish Customs

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/master_data_pool/customs/publish
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/master_data_pool/customs/publish

Method: POST
Content-Type: application/json

请求参数

参数	key	类型	必填	长度	描述	示例
lenovoPn	Y	String	Y	20	联想料号	pn1
vendorCode	Y	String	Y	20	供应商编号	vendor1
countryIsoCode	Y	String	Y	20	国家ISO编码	CN
inhouseSite	Y	String	Y	20	海关关区	aa
brand	Y	String	Y	50	品牌	无品牌

响应参数

参数	类型	是否必填	长度	描述	示例值
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例

请求示例

json

[
	{
		"lenovoPn": "pn1",
  		"vendorCode": "vendor1",  
  		"countryIsoCode": "CN",
  		"inhouseSite": "aa",
  		"brand": "无品牌"
  	},
    ...
]

响应示例

JSON

{
	"code": "0",
	"msg": "ok"
}

异常示例

JSON

{
    "code": "-1",
    "msg": "Data Not Found！"
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 msg提示处理
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Customs 相关接口 ​

Create Customs ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Edit Customs ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Delete Customs ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Query Customs ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Query DeclareElements ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Upload Attachment ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Publish Customs ​

请求地址 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​

异常示例 ​

业务错误码 ​

Customs 相关接口

Create Customs

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Edit Customs

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Delete Customs

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Query Customs

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Query DeclareElements

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Upload Attachment

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码

Publish Customs

请求地址

请求参数

响应参数

请求示例

响应示例

异常示例

业务错误码