Supply Chain Open Platform

简体中文

English

简体中文

English

主题

PRC AN 相关接口 ​

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

ASN Create AN ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/create_by_asn
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/create_by_asn
  • 请求参数
参数key类型必填长度格式描述示例
deliveryNoYstringY16联想发货单号
shipDateYstringY10发货时间
truckLicensestringN8车牌号
driverstringN100司机名称
telOfDriverstringN11司机电话
ttlCartonQtynumberN100总箱数
ttlGrossWeightnumberN100总重量
  • 响应参数
参数类型是否必填长度描述示例值
codeStringY10回执code"0"
msgStringY10回执信息"ok"/"error"
resultObjectN回执示例见响应示例
  • 请求示例
json
{
  "truckLicense": "京A00001",
  "driver": "张三",
  "telOfDriver": "13333333333",
  "ttlCartonQty": 10,
  "ttlGrossWeight": 10,
  "asnList": [
    {
      "deliveryNo": "DN2022071320220713",
      "shipDate": "2025-03-12"
    },
    {
      "deliveryNo": "DN2022071320220711",
      "shipDate": "2025-03-12"
    }
  ]
}
  • 响应示例
json
{
  "code": "0",
  "msg": "ok",
  "result": {
    "anNo": "AN2022071320220713"
  }
}
  • 异常示例
json
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "asnNo",
          "message":[
            {
              "value": "TEST2022071320220713",
              "error": "ASN不存在"
            }
          ]
        }
      ]
    }
  ]
}
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

CDA Create AN ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/create_by_cda
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/create_by_cda
  • 请求参数
参数key类型必填长度格式描述示例
cdaNoYstringY50报关单号
truckLicensestringN8车牌号
driverstringN100司机名称
telOfDriverstringN11司机电话
ttlCartonQtynumberN100总箱数
ttlGrossWeightnumberN100总重量
  • 响应参数
参数类型是否必填长度描述示例值
codeStringY10回执code"0"
msgStringY10回执信息"ok"/"error"
resultObjectN回执示例见响应示例
  • 请求示例
json
{
  "truckLicense": "京A00001",
  "driver": "张三",
  "telOfDriver": "13333333333",
  "ttlCartonQty": 1,
  "ttlGrossWeight": 1,
  "cdaNoList": [
    "20250312粤-001","20250312粤-002"
  ]
}
  • 响应示例
json
{
  "code": "0",
  "msg": "ok",
  "result": {
    "anNo": "AN2022071320220713"
  }
}
  • 异常示例
json
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "cdaNo",
          "message":[
            {
              "value": "TEST2022071320220713",
              "error": "CDA不存在"
            }
          ]
        }
      ]
    }
  ]
}
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

Update AN ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/update
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/update
  • 请求参数
参数类型必填长度格式描述示例
anNostringYAN 号
truckLicensestring车牌号
driverstring司机姓名
telOfDriverstring司机电话
ttlCartonQtynumber总箱数
ttlGrossWeightnumber总重量
  • 响应参数
参数类型是否必填长度描述示例值
codeStringY10回执code"0"
msgStringY10回执信息"ok"/"error"
resultObjectN回执示例见响应示例
  • 请求示例
json
{
  "anNo": "AN2022071320220713",
  "truckLicense": "京A00001",
  "driver": "张三",
  "telOfDriver": "133333333333",
  "ttlCartonQty": 1,
  "ttlGrossWeight": 1
}
  • 响应示例
json
{
  "code": "0",
  "msg": "ok"
}
  • 异常示例
json
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "anNo",
          "message":[
            {
              "value": "TEST2022071320220713",
              "error": "AN不存在"
            }
          ]
        }
      ]
    }
  ]
}
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

Delete AN ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/delete
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/delete
  • 请求参数
参数类型必填长度格式描述示例
anNoY收货单号
  • 响应参数
参数类型是否必填长度描述示例值
codeStringY10回执code"0"
msgStringY10回执信息"ok"/"error"
resultObjectN回执示例见响应示例
  • 请求示例
json
[
  {
    "asnNo": "AN2022071320220713"
  }
]
  • 响应示例
json
{
  "code": "0",
  "msg": "ok"
}
  • 异常示例
json
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "anNo",
          "message":[
            {
              "value": "TEST2022071320220713",
              "error": "AN不存在"
            }
          ]
        }
      ]
    }
  ]
}
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

Search AN ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/query
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/query
  • 请求参数
参数类型必填长度格式描述示例
anNoListY收货单号集合
cdaNoList报关申请单号集合
asnNoList供应商发货单号集合
  • 响应参数
参数类型是否必填长度描述示例值
codeStringY10回执code"0"
msgStringY10回执信息"ok"/"error"
resultObjectN回执示例见响应示例
  • 请求示例
json
[
  {
    "anNoList": [
      "AN2022071320220713",
      "AN2022071320220714"
    ]
  }
]
  • 响应示例
json
{
  "anNo": "AN2022071320220713",
  "driver": "张三",
  "telOfDriver": "133333333333",
  "ttlCartonQty": 1,
  "ttlGrossWeight": 1,
  "status": "Open",
  "sysCreatedDate": "2022-08-01",
  "sysCreatedBy": "luzh5",
  "sysModifyDate": "2022-08-01",
  "sysModifyBy": "luzh5",
  "truckLicense": "京A00001",
  "eta": "2022-08-01",
  "anItemList": [
    {
      "anNo": "AN2022071320220713",
      "anLine": "1",
      "status": "Close",
      "grQty": 10,
      "deliveryQty": 10,
      "sysCreatedDate": "2022-08-01",
      "sysCreatedBy": "luzh5",
      "sysModifyDate": "2022-08-01",
      "sysModifyBy": "luzh5",
      "type": "ASN",
      "deliveryNote": "DN0222222",
      "deliveryLine": "1",
      "po": "4000123096",
      "poLine": "00010",
      "coo": "CN",
      "brand": "无品牌",
      "lenovoPn": "4XH0R55468",
      "cdaType": null,
      "asnOrCdaNo": "DN022222220250312"
    }
  ]
}
  • 异常示例
json
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

Export AN File ​

  • 请求地址
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/an/export
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/an/export
  • 请求参数
参数类型必填长度格式描述示例
anNoListY收货单号集合
  • 响应参数
类型是否必填格式描述示例值
数据流YZIP返回文件压缩包
  • 请求示例
json
[
  {
    "anNoList": [
      "AN2022071320220713",
      "AN2022071320220714"
    ]
  }
]
  • 响应示例
压缩文件
  • 异常示例
json
{
  "code": "-1",
  "msg": "error",
  "result": [
    {
      "key": "TEST2022071320220713",
      "errors": [
        {
          "field": "anNo",
          "message":[
            {
              "value": "TEST2022071320220713",
              "error": "AN不存在"
            }
          ]
        }
      ]
    }
  ]
}
  • 业务错误码
错误码错误描述解决方案
-1回执code请根据result回执修改具体字段的值
500接口系统错误请提供具体错误报文以及触发时间给IT

版权所有 © 2022-present Lenovo Supply Chain Collaboration Center.