PRC CDA 相关接口

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

Create CDA

请求地址

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

请求参数

参数	key	类型	必填	长度	格式	描述	示例
cdaNo	Y	String	Y	50		报关申请号	2***16粤B12345-A 编码规则为日期+车牌号+(-)+批次（a/b/c/d…..）
cdaType		String	Y	50		报关申请类型	NORMAL REBALANCE FOC 字符串需为大写
portOfLading		String	Y	50		起运港	123456 详情见码表附件
portOfEntry		String	Y	50		入境口岸	123456 详情见码表附件
importModeOfTransport		String	Y	50		入境运输方式	2 详情见码表附件
manifestType		String		50		公路舱单类型	入境详情见码表附件
manifestNo		String		50		公路舱单号（载货清单号）	CODE0000001
tmsTrafNO		String		50		TMS运单号
hawb		String		50		入境提运单号	CODE0000001
voyageNo		String		50		入境航次号	CODE0000001
golden2system		String		50		金关二期账册号	CODE0000001
vehicleType		String	Y	50		车辆类型	吨车详情见码表附件
containerType		String		50		集装箱箱型	CODE0000001
containerNo		String		50		集装箱号	CODE0000001
truckLicense		String		50		车牌号	**
driver		String		50		司机姓名	王**
telOfDriver		String		50		司机电话	18**000 请符合手机号规则, 不支持座机
weightOfVehicle		Number		50		车自重（KG）	0
vehicleFrameId		String		50		车架号	CODE0000001
weightOfVehicleFrame		Number		50		车架重（KGS)	2000
weightOfContainer		Number		50		集装箱重（KGS)	2000
cdaLineList		Array	Y	0	集合	CDA LINE 属性集合	[]
cdaLine	Y	Number	Y	50		CDA 行号	1
deliveryNote		String	Y	16		发货单号	DN00001
packageType		String	Y	50		包装类型	22 详情见码表附件
totalGrossWeightOfGoods		Number	Y	50		货物总毛重（kg）	0
totalQtyOfCarton		Number	Y	50		此包装类型货物的数量	800
cdaPoList		Array	Y	0	集合	PO 信息相关集合	[]
deliveryNote		String	Y	16		发货单号	DN00001 此字段在 cdaLineList,cdaPoList 中都要存在
vendorCode		String	Y	150		供应商代码	CODE0000001
vendorName		String	Y	150		供应商名称	供应商 A
lenovoPn		String	Y	50		联想料号	PN000001
declarationQty		Number	Y	50		报关数量	98
coo		String	Y	50		原产国	AD 详情见码表附件
brand		String	Y	50		品牌	品牌 A 无品牌请填写"无品牌"
price		Number		50		单价	0.0 FOC 类型填写
currency		String		50		币制	CNY FOC 类型填写
shipToPlant		String		50		联想工厂代码	CODE0000001 FOC 类型填写
storageLocation		String		50		联想库存地点	CODE0000001 FOC 类型填写
invoice		String		16		发票编号	CODE0000001
poNo		String	Y	50		联想 PO/SA/FOC	CODE0000001
poLine		String	Y	50		联想 PO/SA/FOC 行号	00010
uom		String		50		单位	EA FOC 类型填写
tier2VendorName		String		100		二级供应商名称
netWeight		String		100		天津厂净重需必填

响应参数

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

请求示例

JSON

{
  "cdaNo": "20220801****-A",
  "cdaType": "REBALANCE",
  "portOfLading": "****",
  "importModeOfTransport": "4",
  "manifestType": "入境",
  "portOfEntry": "****A",
  "vehicleType": "柜车",
  "driver": "王**",
  "telOfDriver": "131**abc",
  "truckLicense": "****",
  "vehicleFrameId": "****",
  "weightOfVehicle": 111,
  "weightOfVehicleFrame": 111,
  "containerType": "****",
  "containerNo": "A**A",
  "weightOfContainer": 0,
  "manifestNo": "****",
  "tmsTrafNO": "****",
  "cdaLineList": [
    {
      "cdaLine": "10",
      "deliveryNote": "****",
      "totalQtyOfCarton": 0,
      "packageType": "99",
      "totalGrossWeightOfGoods": 0,
      "cdaPoList": [
        {
          "poNo": "****",
          "poLine": "1",
          "lenovoPn": "****",
          "coo": "CN",
          "brand": "****",
          "declarationQty": 1,
          "invoice": "BCD",
          "tier2VendorName": "AAA"
        },
        {
          "poNo": "****",
          "poLine": "00020",
          "lenovoPn": "****",
          "coo": "CN",
          "brand": "****",
          "declarationQty": 100,
          "invoice": "BCD",
          "tier2VendorName": "BBB"
        }
      ]
    }
  ]
}

响应示例

JSON

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

异常示例

JSON

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20220801****-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20220801****-A",
              "error": "当前cdaNo已创建, 请修改后重试"
            }
          ]
        },
        {
          "field": "poLine",
          "message": [
            {
              "value": "00010",
              "error": "数据组合 ****:00010:**** 已存在, 无法执行此操作"
            },
            {
              "value": "00020",
              "error": "数据组合 ****:00020:**** 已存在, 无法执行此操作"
            }
          ]
        }
      ]
    }
  ]
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 result 回执修改具体字段的值
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

补充、修改 CDA 附件

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNo	String	Y	50		报关申请号	20220801 粤 A78978-A
file	File	Y	50M	文件	附件	附件需要是 zip 或者 7z 后缀的压缩包

响应参数

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

请求示例

响应示例

JSON

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

异常示例

JSON

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20220801****-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20220801****-A",
              "error": "cdaNo不存在, 请修改后重试"
            }
          ]
        },
        {
          "field": "file",
          "message": [
            {
              "value": "file",
              "error": "文件后缀名必须是zip或者7z"
            }
          ]
        }
      ]
    }
  ]
}

业务错误码

错误码	错误描述	解决方案
-1	回执 code	请根据 result 回执修改具体字段的值
500	接口系统错误	请提供具体错误报文以及触发时间给 IT

Update CDA

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNo	String	Y	50		报关申请号	202****粤B12345-A 编码规则为日期+车牌号+(-)+批次（a/b/c/d…..）
cdaType	String	Y	50		报关申请类型	NORMAL REBALANCE FOC 字符串需为大写
portOfLading	String	Y	50		起运港	123456 详情见码表附件
portOfEntry	String	Y	50		入境口岸	123456 详情见码表附件
importModeOfTransport	String	Y	50		入境运输方式	2 详情见码表附件
manifestType	String		50		公路舱单类型	入境详情见码表附件
manifestNo	String		50		公路舱单号（载货清单号）	CODE0000001
hawb	String		50		入境提运单号	CODE0000001
voyageNo	String		50		入境航次号	CODE0000001
golden2system	String		50		金关二期账册号	CODE0000001
vehicleType	String	Y	50		车辆类型	吨车详情见码表附件
containerType	String		50		集装箱箱型	CODE0000001
containerNo	String		50		集装箱号	CODE0000001
truckLicense	String		50		车牌号	粤**
driver	String		50		司机姓名	王**傅
telOfDriver	String		50		司机电话	18**00 请符合手机号规则, 不支持座机
weightOfVehicle	Number		50		车自重（KG）	0
vehicleFrameId	String		50		车架号	CODE0000001
weightOfVehicleFrame	Number		50		车架重（KGS)	0
weightOfContainer	Number		50		集装箱重（KGS)	0
cdaLineList	Array	Y	0	集合	CDA LINE 属性集合	[]
cdaLine	Number	Y	50		CDA 行号	1
deliveryNote	String	Y	16		发货单号	DN00001
packageType	String	Y	50		包装类型	22 详情见码表附件
totalGrossWeightOfGoods	Number	Y	50		货物总毛重（kg）	0
totalQtyOfCarton	Number	Y	50		此包装类型货物的数量	0
cdaPoList	Array	Y	0	集合	PO 信息相关集合	[]
deliveryNote	String	Y	16		发货单号	DN00001 此字段在 cdaLineList,cdaPoList 中都要存在
vendorCode	String	Y	150		供应商代码	CODE0000001
vendorName	String	Y	150		供应商名称	供应商 A
lenovoPn	String	Y	50		联想料号	PN000001
tier2VendorName	String		100		二级供应商名称
declarationQty	Number	Y	50		报关数量	98
coo	String	Y	50		原产国	AD 详情见码表附件
brand	String	Y	50		品牌	品牌 A 无品牌请填写"无品牌"
price	Number	?	50		单价	0 FOC 类型填写
currency	String	?	50		币制	CNY FOC 类型填写
shipToPlant	String	?	50		联想工厂代码	CODE0000001 FOC 类型填写
storageLocation	String	?	50		联想库存地点	CODE0000001 FOC 类型填写
invoice	String		16		发票编号	CODE0000001
poNo	String	Y	50		联想 PO/SA/FOC	CODE0000001
poLine	String	Y	50		联想 PO/SA/FOC 行号	00010
uom	String	?	50		单位	EA FOC 类型填写
netWeight	String	?	50		天津厂净重需必填

响应参数

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

请求示例

JSON

{
  "cdaNo": "20220801****-A",
  "cdaType": "REBALANCE",
  "portOfLading": "****",
  "importModeOfTransport": "4",
  "manifestType": "入境",
  "portOfEntry": "****A",
  "vehicleType": "柜车",
  "driver": "王**傅",
  "telOfDriver": "131**abc",
  "truckLicense": "****",
  "vehicleFrameId": "****",
  "weightOfVehicle": 111,
  "weightOfVehicleFrame": 111,
  "containerType": "****",
  "containerNo": "A**A",
  "weightOfContainer": 0,
  "manifestNo": "****",
  "cdaLineList": [
    {
      "cdaLine": "10",
      "deliveryNote": "****",
      "totalQtyOfCarton": 0,
      "packageType": "99",
      "totalGrossWeightOfGoods": 0,
      "cdaPoList": [
        {
          "deliveryNote": "****",
          "poNo": "****",
          "poLine": "00010",
          "lenovoPn": "****",
          "tier2VendorName": "str",
          "coo": "CN",
          "brand": "****",
          "declarationQty": 0,
          "invoice": "BCD"
        },
        {
          "deliveryNote": "****",
          "poNo": "****",
          "poLine": "00020",
          "lenovoPn": "****",
          "tier2VendorName": "str",
          "coo": "CN",
          "brand": "****",
          "declarationQty": 0,
          "invoice": "BCD"
        }
      ]
    }
  ]
}

响应示例

JSON

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

异常示例

JSON

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20220801****-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20220801****-A",
              "error": "当前cdaNo已创建, 请修改后重试"
            }
          ]
        },
        {
          "field": "poLine",
          "message": [
            {
              "value": "00010",
              "error": "数据组合 ****:00010:**** 已存在, 无法执行此操作"
            },
            {
              "value": "00020",
              "error": "数据组合 ****:00020:**** 已存在, 无法执行此操作"
            }
          ]
        }
      ]
    }
  ]
}

Query CDA

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNo	Array	Y			报关申请号	2022***粤A8-A

响应参数

参数	类型	必填	长度	格式	描述
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例
status	String	Y		回执示例	报关状态
vehInfoStatus	String	Y		回执示例	车裂信息报关状态

请求示例

JSON

{
  "cdaNoList": [
    "20**345-A"
  ]
}

响应示例

JSON

{
  "code": "0",
  "msg": "ok",
  "result": [
    {
      "cdaNo": "20220801****-A",
      "cdaType": "REBALANCE",
      "status": "Draft",
      "vehInfoStatus": "Draft",
      "portOfLading": "****",
      "importModeOfTransport": "4",
      "manifestType": "入境",
      "portOfEntry": "****A",
      "vehicleType": "柜车",
      "driver": "王**",
      "telOfDriver": "131**abc",
      "truckLicense": "****",
      "vehicleFrameId": "****",
      "weightOfVehicle": 1,
      "weightOfVehicleFrame": 1,
      "containerType": "****",
      "containerNo": "A**A",
      "weightOfContainer": 1,
      "manifestNo": "****",
      "cdaLineList": [
        {
          "cdaLine": "10",
          "deliveryNote": "****",
          "totalQtyOfCarton": 0,
          "packageType": "99",
          "totalGrossWeightOfGoods": 0,
          "cdaPoList": [
            {
              "deliveryNote": "****",
              "poNo": "****",
              "poLine": "00010",
              "lenovoPn": "****",
              "coo": "CN",
              "brand": "****",
              "declarationQty": 0,
              "invoice": "BCD"
            },
            {
              "deliveryNote": "****",
              "poNo": "****",
              "poLine": "00020",
              "lenovoPn": "****",
              "coo": "CN",
              "brand": "****",
              "declarationQty": 100,
              "invoice": "BCD"
            }
          ]
        }
      ]
    }
  ]
}

异常示例

JSON

{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20220801****-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20220801****-A",
              "error": "当前cdaNo不存在"
            }
          ]
        }
      ]
    }
  ]
}

Query CDA Status

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNoList	Array	Y			报关申请号集合	20220801 粤 A78978-A

响应参数

参数	类型	必填	长度	格式	描述
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	Y		回执示例	见响应示例
status	String	Y	10	回执示例	Draft 该申请可以编辑 Deleted 该申请已删除 Published 该申请已经发布给联想关务团队 Returned 该申请被联想关务拒绝(原因可查看关务备注) Rejected 报关改单（在打报告或过门时被海关发现有问题） Confirmed 该申请已通过联想关务审核，等待报关 Inspection 报关查验 Declared 该报关申请已经申报 Failed 报关删单（在打报告或过门时被海关发现有问题） Success 该申请已报关成功
vehInfoStatus	String	Y	10	回执示例	Draft 车辆信息未发送 Published 车辆信息发送到关务系统 Confirmed 车辆信息确认 Error 车辆信息退回
message	String	N	500	回执示例	车裂信息报关状态

请求示例

JSON

{
  "cdaNoList": [
    "20220801****-A"
  ]
}

响应示例

JSON

{
  "code": "0",
  "msg": "ok",
  "result": [
    {
      "cdaNo": "20220801****-A",
      "status": "Draft",
      "vehInfoStatus": "Draft",
      "message": "关务备注"
    }
  ]
}

异常示例

JSON

发布CDA

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNo	String	Y			报关申请号	20**粤A123-A

响应参数

参数	类型	必填	长度	格式	描述
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例
status	String	Y		回执示例	报关状态
vehInfoStatus	String	Y		回执示例	车裂信息报关状态

请求示例

JSON

{
  "cdaNo": "20**粤A123-A"
}

响应示例

JSON

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

- 异常示例

```JSON
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20**粤A123-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20**粤A123-A",
              "error": "当前cdaNo不存在"
            }
          ]
        }
      ]
    }
  ]
}

发布CDA车辆信息

请求地址

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

请求参数

参数	类型	必填	长度	格式	描述	示例
cdaNo	String	Y			报关申请号	20**粤A123-A

响应参数

参数	类型	必填	长度	格式	描述
code	String	Y	10	回执 code	"0"
msg	String	Y	10	回执信息	"ok"/"error"
result	Object	N		回执示例	见响应示例
status	String	Y		回执示例	报关状态
vehInfoStatus	String	Y		回执示例	车裂信息报关状态

请求示例

JSON

{
  "cdaNo": "20**粤A123-A"
}

响应示例

JSON

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

- 异常示例

```JSON
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "20**粤A123-A",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "20**粤A123-A",
              "error": "当前cdaNo不存在"
            }
          ]
        }
      ]
    }
  ]
}

状态相关

字段	值	是否可编辑	注释
status	Draft	Y	该申请可以编辑
status	Deleted	Y	该申请已删除
status	Published	N	该申请已经发布给联想关务团队
status	Returned	Y	该申请被联想关务拒绝(原因可查看关务备注)
status	Rejected	Y	报关改单（在打报告或过门时被海关发现有问题）
status	Confirmed	N	该申请已通过联想关务审核，等待报关
status	Inspection	N	报关查验中
status	Declared	N	该报关申请已经申报
status	Rejected	N	报关删单（在打报告或过门时被海关发现有问题）
status	Success	N	该申请已报关成功
vehInfoStatus	Draft	Y	车辆信息未报关
vehInfoStatus	Published	N	车辆信息发送到关务系统
vehInfoStatus	Confirmed	N	车辆信息确认中
vehInfoStatus	Error	Y	车辆信息退回
vehInfoStatus	Success	N	车辆信息报关成功

PRC CDA 相关接口 ​

Create CDA ​

补充、修改 CDA 附件 ​

Update CDA ​

Query CDA ​

Query CDA Status ​

发布CDA ​

发布CDA车辆信息 ​

状态相关 ​

PRC CDA 相关接口

Create CDA

补充、修改 CDA 附件

Update CDA

Query CDA

Query CDA Status

发布CDA

发布CDA车辆信息

状态相关