MTY AN 相关接口

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

Create AN

请求地址

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

请求参数

• Method: POST

• Content-Type: application/json

参数	key	类型	default必填	AirAN 必填	GroundAn 必填	OceanAn 必填	长度	描述	示例
trackingNumber	Y	String	Y	Y	Y	Y	30	运单号	**
shipmentType		String	Y	Y	Y	Y	30	运输类型	Air Shipment
hblNumber	Y	String				Y	30	车牌
containerNo		Date				Y	30	预约时间
customsEntry		String	Y	Y	Y	Y	30	预约原因	2005311-32
pieces		String	Y	Y	Y	Y	30	备注	2
forwarder		String	Y	Y	Y	Y	30	收件人邮箱	**
truckCompany		String	Y	Y	Y	Y	30	附件集合	**
consecutiveUnit		String		Y			30	连续单位	9th
entry		String			Y		30	条目
warehouse		String	Y	Y	Y	Y	30	仓库	Lenovo ###
truckPlates		String	Y	Y	Y	Y	30	卡车牌照	RG-**
clearanceTime		String	Y	Y	Y	Y	30	清关时间	16:40:00
vehicleType		String	Y	Y	Y	Y	30	车辆类型	Truck
truckNumber		String		Y	Y		30	运单号	****
createDate		String	Y	Y	Y	Y	30	部分装运序号	2023-08-01

响应参数

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

请求示例

{
    "trackingNumber": "**",
    "shipmentType": "Air Shipment",
    "customsEntry": "**-1",
    "pieces": "2",
    "forwarder": "Test",
    "truckCompany": "****",
    "consecutiveUnit": "2th",
    "warehouse": "#123",
    "truckPlates": "**",
    "clearanceTime": "16:35:00",
    "vehicleType": "53'",
    "truckNumber": "****",
    "createDate": "2023-08-23"
}

响应示例

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

异常示例

{
	"code": "-1",
	"msg": "CDA data not found. Please check!"
}

业务错误码

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

Update AN

请求地址

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

• Method: PUT

• Content-Type: application/json

请求参数

参数	类型	必填	长度	描述	示例
anNo	String	Y	30	AN 编号	AN**1
customsEntry	String	Y	30	海关手续	200**1
pieces	String	Y	30	数量	2
forwarder	String	Y	30	货代	Test
truckCompany	String	Y	30	货运公司
warehouse	String	Y	30	仓库	#123
truckPlates	String	Y	30	卡车牌照	**
clearanceTime	String	Y	30	清关时间	16:35:12
vehicleType	String	Y	30	车辆类型	53'

响应参数

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

请求示例

[
    {
        "anNo": "AN****001",
        "customsEntry": "20****-1",
        "pieces": "2",
        "forwarder": "Test",
        "truckCompany": "xxx",
        "warehouse": "#123",
        "truckPlates": "****",
        "clearanceTime": "16:35",
        "vehicleType": "53'"
    }
]

响应示例

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

异常示例

{
    "code": "-1",
    "msg": "ClearanceTime(HH:mm:ss) format error, please check!"
}

业务错误码

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

Delete AN

请求地址

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

• Method: DELETE

• Content-Type: application/json

请求参数

参数	类型	必填	长度	描述	示例
anNo	String	Y	30	AN 编号	AN20********001

响应参数

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

请求示例

[
	"AN20****1","AN2023****2"
]

响应示例

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

业务错误码

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