1. 简介

2. 入库单模块API

2.1. 创建入库单接口

2.1.1. SERVICE_TYPE

GLINK_CREATE_ASN_NOTIFY

2.1.2. 请求参数

创建入库单请求

参数名 类型 列表 必填 备注
partnerId string N Y 合作伙伴ID，用于客户路由与校验
customerCode string N Y 客户编码
warehouseCode string N Y 仓库编码
asnNumber string N Y 入库单号
extAsnNumber string N N 外部入库单号
extUserId string N N 外部用户ID
asnType string N N 入库单类型；为空时默认 SUPPLIER_RECEIPT。可选值：SUPPLIER_RECEIPT（采购入库）、RETURN（退货入库）、OTHER_INBOUND（其他入库）、PURCHASE（采购/ERP需箱唛）、MANUAL（手工/其他入库）、FIRST_LEG（头程入库）、TRANSFER_PLAN（调拨计划入库）、TRANSFER_AVAILABLE（可用库存调拨入库）
trackingNumber string N N 运单号
referenceNumber string N N 参考单号
containerNumber string N N 集装箱号
sealNumber string N N 封箱号
expectedReceiptDate date N N 预计收货时间
warehouseNotes string N N 仓库备注，会过滤 emoji 后保存
carrier string N N 承运商
supplier string N N 供应商
capacityType string N N 到货方式/容器类型；常见值：LTL（零担货运）、PARCEL（包裹）、40HQ（40尺高柜）、20GP（20尺普柜）等
isSpecifyBatch boolean N N 是否指定批次标记
snUrl string N N SN列表文件URL
udf5 string N N 自定义字段5
udf6 string N N 自定义字段6
udf7 string N N 自定义字段7
udf8 string N N 自定义字段8
udf9 string N N 自定义字段9
udf10 string N N 自定义字段10
udf11 string N N 自定义字段11
udf12 string N N 自定义字段12
asnTagList long Y N 入库单标记列表
asnLineItems object Y Y 入库单商品信息
└ sku string N Y 商品编码
└ quantity int N Y 商品数量，必须大于0
└ lineNo string N N 行号；为空时系统自动生成
└ skuStatus string N N 库存状态；为空时默认 GOOD。GOOD（良品）、DAMAGE（残品/破损）
└ poNumber string N N PO号
└ poLineNo string N N PO行号
└ markCode string N N 箱唛编码
└ barCodeEA string N N EA规格条码
└ mfgDate string N N 生产日期
└ expDate string N N 失效日期
└ batchNo string N N 批次号
└ originCountry string N N 原产国
└ udf1 string N N 自定义字段1
└ udf2 string N N 自定义字段2
└ udf3 string N N 自定义字段3
└ udf4 string N N 自定义字段4
└ udf5 string N N 自定义字段5
└ udf6 string N N 自定义字段6
└ udf7 string N N 自定义字段7
└ udf8 string N N 自定义字段8
└ udf9 string N N 自定义字段9
└ udf10 string N N 自定义字段10
└ udf11 string N N 自定义字段11
└ udf12 string N N 自定义字段12
markList object Y N 箱唛信息
└ markCode string N Y 箱唛编码
└ weight decimal N N 箱重量
└ length decimal N N 箱长
└ width decimal N N 箱宽
└ height decimal N N 箱高
└ lengthUnit string N N 长度单位；cm：厘米，In：英寸，m：米
└ weightUnit string N N 重量单位；KG：千克，LBS：磅，GRAM：克

2.1.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "asnNumber": "ASN202606050001",
  "extAsnNumber": "EXTASN202606050001",
  "extUserId": "EXT_USER_001",
  "asnType": "SUPPLIER_RECEIPT",
  "trackingNumber": "TRK202606050001",
  "referenceNumber": "REF202606050001",
  "containerNumber": "CONT202606050001",
  "sealNumber": "SEAL202606050001",
  "expectedReceiptDate": "2026-06-06 09:00:00",
  "warehouseNotes": "到货前请提前预约",
  "carrier": "BEST",
  "supplier": "SUPPLIER001",
  "capacityType": "LTL",
  "isSpecifyBatch": false,
  "snUrl": "https://example.com/files/asn-sn.xlsx",
  "udf5": "自定义字段5",
  "udf6": "自定义字段6",
  "udf7": "自定义字段7",
  "udf8": "自定义字段8",
  "udf9": "自定义字段9",
  "udf10": "自定义字段10",
  "udf11": "自定义字段11",
  "udf12": "自定义字段12",
  "asnTagList": [1001],
  "asnLineItems": [
    {
      "sku": "SKU001",
      "quantity": 10,
      "lineNo": "1",
      "skuStatus": "GOOD",
      "poNumber": "PO202606050001",
      "poLineNo": "10",
      "markCode": "MARK001",
      "barCodeEA": "690000000001",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN",
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12"
    }
  ],
  "markList": [
    {
      "markCode": "MARK001",
      "weight": 12.5,
      "length": 40.0,
      "width": 30.0,
      "height": 20.0,
      "lengthUnit": "cm",
      "weightUnit": "KG"
    }
  ]
}

2.1.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 操作的处理结果，true表示处理成功，false表示处理失败
code string N N 操作状态码
message string N N 提示信息

2.1.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.2. 取消入库单接口

2.2.1. SERVICE_TYPE

GLINK_CANCEL_ASN_NOTIFY

2.2.2. 请求参数

取消入库单请求

参数名 类型 列表 必填 备注
partnerId string N Y 合作伙伴ID，用于客户路由与校验
customerCode string N Y 客户编码
asnNumbers string Y Y 入库单号列表；接口一次仅处理列表中的第一张入库单
extUserId string N N 外部用户ID

2.2.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "extUserId": "EXT_USER_001"
}

2.2.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 操作的处理结果，true表示处理成功，false表示处理失败
code string N N 操作状态码
message string N N 提示信息

2.2.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.3. 查询入库单接口

2.3.1. SERVICE_TYPE

GLINK_QUERY_ASN_NOTIFY

2.3.2. 请求参数

查询入库单请求

参数名 类型 列表 必填 备注
partnerId string N Y 合作伙伴ID，用于客户路由
customerCode string N Y 客户编码
asnNumbers string Y Y 入库单号列表，最多100个，不能为空字符串
extUserId string N N 外部用户ID

2.3.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "extUserId": "EXT_USER_001"
}

2.3.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 成功标志
code string N N 响应编码
message string N N 响应消息
asnInfoList object Y N 入库单信息列表
└ customerCode string N Y 客户编码
└ warehouseCode string N N 仓库编码
└ warehouseNotes string N N 仓库备注
└ asnNumber string N Y 入库单号
└ extAsnNumber string N N 外部入库单号
└ extUserId string N N 外部用户ID
└ wmsAsnNumber string N N WMS入库单号
└ carrier string N N 承运商
└ poNumber string N N PO号
└ receiveTime string N N 收货时间
└ remark string N N 备注
└ status string N N 入库单状态；SendingToWMS（发送仓库中）、Received（已收货/仓库已接收）、Error（异常）、Voided（已取消）、Fulfilled（已完成）
└ asnType string N N 入库单类型；SUPPLIER_RECEIPT（采购入库）、RETURN（退货入库）、OTHER_INBOUND（其他入库）、PURCHASE（采购/ERP需箱唛）、MANUAL（手工/其他入库）、FIRST_LEG（头程入库）、TRANSFER_PLAN（调拨计划入库）、TRANSFER_AVAILABLE（可用库存调拨入库）
└ trackingNumber string N N 运单号
└ referenceNumber string N N 参考单号
└ containerNumber string N N 集装箱号
└ sealNumber string N N 封箱号
└ snUrl string N N SN列表文件URL
└ asnLineItems object Y N 入库单商品信息
  └ sku string N N 商品编码
  └ quantity int N N 收货数量
  └ putawayedQuantity int N N 上架数量
  └ lineNo string N N 行号
  └ expectedQuantity int N N 期望数量
  └ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
  └ mfgDate string N N 生产日期
  └ expDate string N N 失效日期
  └ originCountry string N N 原产国
  └ batchNo string N N 批次号

2.3.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "asnInfoList": [
    {
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "warehouseNotes": "到货前请提前预约",
      "asnNumber": "ASN202606050001",
      "extAsnNumber": "EXTASN202606050001",
      "extUserId": "EXT_USER_001",
      "wmsAsnNumber": "WMSASN202606050001",
      "carrier": "BEST",
      "poNumber": "PO202606050001",
      "receiveTime": "2026-06-05 10:30:00",
      "remark": "",
      "status": "Received",
      "asnType": "SUPPLIER_RECEIPT",
      "trackingNumber": "TRK202606050001",
      "referenceNumber": "REF202606050001",
      "containerNumber": "CONT202606050001",
      "sealNumber": "SEAL202606050001",
      "snUrl": "https://example.com/files/asn-sn.xlsx",
      "asnLineItems": [
        {
          "sku": "SKU001",
          "quantity": 10,
          "putawayedQuantity": 8,
          "lineNo": "1",
          "expectedQuantity": 10,
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "originCountry": "CN",
          "batchNo": "BATCH20260501"
        }
      ]
    }
  ]
}

2.4. 查询入库单接口(V2)

2.4.1. SERVICE_TYPE

GLINK_BATCH_QUERY_ASN_NOTIFY

2.4.2. 请求参数

查询入库单请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴ID
customerCode string N Y 客户编码
warehouseCode string N Y 仓库编码
asnNumbers string Y N 入库单号列表，最多100个
refNumbers string Y N 参考单号列表
asnType string N N 入库单类型；SUPPLIER_RECEIPT（采购入库）、RETURN（退货入库）、OTHER_INBOUND（其他入库）、PURCHASE（采购/ERP需箱唛）、MANUAL（手工/其他入库）、FIRST_LEG（头程入库）、TRANSFER_PLAN（调拨计划入库）、TRANSFER_AVAILABLE（可用库存调拨入库）
extUserId string N N 外部用户ID
receiveTimeFrom string N N 收货时间从，格式 yyyy-MM-dd HH:mm:ss
receiveTimeTo string N N 收货时间到，格式 yyyy-MM-dd HH:mm:ss
putawayCompletedTimeFrom string N N 上架完成时间从，格式 yyyy-MM-dd HH:mm:ss
putawayCompletedTimeTo string N N 上架完成时间到，格式 yyyy-MM-dd HH:mm:ss
createdTimeFrom string N N 创建时间从，格式 yyyy-MM-dd HH:mm:ss
createdTimeTo string N N 创建时间到，格式 yyyy-MM-dd HH:mm:ss
lastUpdatedTimeFrom string N N 最后更新时间从，格式 yyyy-MM-dd HH:mm:ss
lastUpdatedTimeTo string N N 最后更新时间到，格式 yyyy-MM-dd HH:mm:ss
stage string N N 入库阶段；常见值：DUE_IN（待到货）、ARRIVED（已到货）、INSPECTING（验收中）、INSPECTED（已验收）、RECEIVING（收货中）、RECEIVED（已收货）、CLOSED（已关闭）、VOID（已取消）
ifNeedBatchInfo boolean N N 是否返回批次信息；默认 false
page int N N 页号；为空默认 1
pageSize int N N 每页记录数；为空默认 100，最大 200

当 asnNumbers、refNumbers 均为空时，创建时间、最后更新时间、收货时间至少填写一组完整的起止时间。

2.4.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "refNumbers": [
    "REF202606050001"
  ],
  "asnType": "SUPPLIER_RECEIPT",
  "extUserId": "EXT_USER_001",
  "receiveTimeFrom": "2026-06-05 00:00:00",
  "receiveTimeTo": "2026-06-05 23:59:59",
  "stage": "CLOSED",
  "ifNeedBatchInfo": true,
  "page": 1,
  "pageSize": 50
}

2.4.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 成功标志
code string N N 响应编码
message string N N 响应消息
total long N N 总记录数
asnInfoList object Y N 当前页入库单信息
└ partnerId string N N 合作伙伴ID
└ customerCode string N Y 客户编码
└ warehouseCode string N Y 仓库编码
└ warehouseNotes string N N 仓库备注
└ asnNumber string N Y 入库单号
└ extAsnNumber string N N 外部入库单号
└ wmsAsnNumber string N N WMS入库单号
└ extUserId string N N 外部用户ID
└ carrier string N N 承运商
└ receiveTime string N N 收货时间
└ remark string N N 备注
└ status string N N 入库单状态；SendingToWMS（发送仓库中）、Received（已收货/仓库已接收）、Error（异常）、Voided（已取消）、Fulfilled（已完成）
└ wmsStatus string N N WMS入库单状态；常见值：DUE_IN（待到货）、ARRIVED（已到货）、INSPECTING（验收中）、INSPECTED（已验收）、RECEIVING（收货中）、RECEIVED（已收货）、CLOSED（已关闭）、VOID（已取消）
└ stage string N N 入库阶段；常见值：DUE_IN（待到货）、ARRIVED（已到货）、INSPECTING（验收中）、INSPECTED（已验收）、RECEIVING（收货中）、RECEIVED（已收货）、CLOSED（已关闭）、VOID（已取消）
└ putawayStage string N N 上架阶段；PENDING（待上架）、IN PROGRESS（上架中）、COMPLETED（上架完成）
└ asnType string N N 入库单类型；SUPPLIER_RECEIPT（采购入库）、RETURN（退货入库）、OTHER_INBOUND（其他入库）、PURCHASE（采购/ERP需箱唛）、MANUAL（手工/其他入库）、FIRST_LEG（头程入库）、TRANSFER_PLAN（调拨计划入库）、TRANSFER_AVAILABLE（可用库存调拨入库）
└ trackingNumber string N N 运单号
└ referenceNumber string N N 参考单号
└ containerNumber string N N 集装箱号
└ sealNumber string N N 封箱号
└ expectedReceiptDate string N N 预计收货时间
└ wmsDocSource string N N 仓库单据来源；常见值：ENTRY（后台录入）、API（接口创建）、PO（采购单生成）、AUTO_GWMS（仓库自动生成）
└ orderNumber string N N 关联出库单号
└ itemLineQty int N N 入库单商品种类数
└ supplier string N N 供应商
└ putawayTime string N N 上架完成时间
└ arrivalTime string N N 到达时间
└ udf5 string N N 自定义字段5
└ udf6 string N N 自定义字段6
└ udf7 string N N 自定义字段7
└ udf8 string N N 自定义字段8
└ udf9 string N N 自定义字段9
└ udf10 string N N 自定义字段10
└ udf11 string N N 自定义字段11
└ udf12 string N N 自定义字段12
└ snUrl string N N SN列表文件URL
└ asnLineItems object Y N 入库单商品信息
  └ sku string N N 商品编码
  └ quantity int N N 数量
  └ lineNo string N N 行号
  └ putawayedQuantity int N N 上架数量
  └ expectedQuantity int N N 期望数量
  └ poLineNo string N N PO行号
  └ poNumber string N N PO号
  └ skuLength double N N SKU长度
  └ skuWidth double N N SKU宽度
  └ skuHeight double N N SKU高度
  └ dimensionUnit string N N 尺寸单位；cm：厘米，inch：英寸
  └ skuWeight double N N SKU重量
  └ weightUnit string N N 重量单位；KG：千克，LBS：磅，GRAM：克
  └ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
  └ mfgDate string N N 生产日期
  └ expDate string N N 失效日期
  └ batchNo string N N 批次号
  └ originCountry string N N 原产国
  └ udf1 string N N 自定义字段1
  └ udf2 string N N 自定义字段2
  └ udf3 string N N 自定义字段3
  └ udf4 string N N 自定义字段4
  └ udf5 string N N 自定义字段5
  └ udf6 string N N 自定义字段6
  └ udf7 string N N 自定义字段7
  └ udf8 string N N 自定义字段8
  └ udf9 string N N 自定义字段9
  └ udf10 string N N 自定义字段10
  └ udf11 string N N 自定义字段11
  └ udf12 string N N 自定义字段12
└ adjustInfos object Y N 入库调整信息
  └ sku string N N 商品编码
  └ adjustQty int N N 调整数量
  └ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
  └ mfgDate string N N 生产日期
  └ expDate string N N 失效日期
  └ batchNo string N N 批次号
  └ originCountry string N N 原产国
└ asnItemReceiveDetails object Y N 入库商品收货/上架明细
  └ lineNo string N N 行号
  └ detailId string N N 凭证明细ID
  └ sku string N N 商品编码
  └ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
  └ receiveQty int N N 收货数量
  └ receiveTime string N N 收货时间
  └ putawayQty int N N 上架数量
  └ putawayTime string N N 上架时间
  └ originCountry string N N 原产国
  └ batchNo string N N 批次号
  └ expDate string N N 失效日期
  └ mfgDate string N N 生产日期
└ batchInfo object Y N 批次信息，仅 ifNeedBatchInfo=true 时组装
  └ lineNo string N N 行号
  └ sku string N N 商品编码
  └ quantity double N N 批次数量
  └ stockStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
  └ batchNumber string N N 批次号
  └ mfgDate string N N 生产日期
  └ expDate string N N 失效日期
  └ originCountry string N N 原产国
└ additionalInfoList object Y N 附加信息
  └ infoType string N N 附加信息类型名称
  └ infoTypeCode string N N 附加信息类型编码；常见值：NO_EXCEPTION（无异常）、WRONG_SKU（商品错误）、DAMAGED_SKU（货损）、OTHER（其他）等
  └ content string N N 信息内容
  └ note string N N 信息描述
  └ uploadedTime string N N 上传时间
  └ asnAdditionalFiles object Y N 文件列表
    └ fileName string N N 附件名称
    └ fileUrl string N N 附件URL
    └ fileType string N N 附件类型；常见值：BILL_OF_LADING（提单）、PACKING_LIST（装箱单）、OTHER（其他）
    └ fileFormat string N N 附件格式
    └ isUpdate boolean N N 是否更新附件
    └ fileBase64 string N N Base64文件内容

2.4.5. 响应样例

JSON

{
  "success": true,
  "code": null,
  "message": null,
  "total": 1,
  "asnInfoList": [
    {
      "partnerId": "GLINK",
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "warehouseNotes": "到货外箱完好",
      "asnNumber": "ASN202606050001",
      "extAsnNumber": "ASN202606050001",
      "wmsAsnNumber": "WMSASN202606050001",
      "extUserId": "EXT_USER_001",
      "carrier": "BEST",
      "receiveTime": "2026-06-05 10:30:00",
      "remark": "",
      "status": "Received",
      "wmsStatus": "CLOSED",
      "stage": "CLOSED",
      "putawayStage": "COMPLETED",
      "asnType": "SUPPLIER_RECEIPT",
      "trackingNumber": "TRK202606050001",
      "referenceNumber": "REF202606050001",
      "containerNumber": "CONT202606050001",
      "sealNumber": "SEAL202606050001",
      "expectedReceiptDate": "2026-06-06 09:00:00",
      "wmsDocSource": "API",
      "orderNumber": "SO202606050001",
      "itemLineQty": 1,
      "supplier": "SUPPLIER001",
      "putawayTime": "2026-06-05 11:20:00",
      "arrivalTime": "2026-06-05 09:20:00",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12",
      "snUrl": "https://example.com/files/asn-sn.xlsx",
      "asnLineItems": [
        {
          "sku": "SKU001",
          "quantity": 10,
          "lineNo": "1",
          "putawayedQuantity": 8,
          "expectedQuantity": 10,
          "poLineNo": "10",
          "poNumber": "PO202606050001",
          "skuLength": 10.0,
          "skuWidth": 8.0,
          "skuHeight": 5.0,
          "dimensionUnit": "cm",
          "skuWeight": 0.5,
          "weightUnit": "KG",
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "batchNo": "BATCH20260501",
          "originCountry": "CN",
          "udf1": "自定义字段1",
          "udf2": "自定义字段2",
          "udf3": "自定义字段3",
          "udf4": "自定义字段4",
          "udf5": "自定义字段5",
          "udf6": "自定义字段6",
          "udf7": "自定义字段7",
          "udf8": "自定义字段8",
          "udf9": "自定义字段9",
          "udf10": "自定义字段10",
          "udf11": "自定义字段11",
          "udf12": "自定义字段12"
        }
      ],
      "adjustInfos": [
        {
          "sku": "SKU001",
          "adjustQty": -1,
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "batchNo": "BATCH20260501",
          "originCountry": "CN"
        }
      ],
      "asnItemReceiveDetails": [
        {
          "lineNo": "1",
          "detailId": "RV202606050001",
          "sku": "SKU001",
          "skuStatus": "GOOD",
          "receiveQty": 10,
          "receiveTime": "2026-06-05 10:30:00",
          "putawayQty": 8,
          "putawayTime": "2026-06-05 11:20:00",
          "originCountry": "CN",
          "batchNo": "BATCH20260501",
          "expDate": "2027-05-01",
          "mfgDate": "2026-05-01"
        }
      ],
      "batchInfo": [
        {
          "lineNo": "1",
          "sku": "SKU001",
          "quantity": 10.0,
          "stockStatus": "GOOD",
          "batchNumber": "BATCH20260501",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "originCountry": "CN"
        }
      ],
      "additionalInfoList": [
        {
          "infoType": "无异常",
          "infoTypeCode": "NO_EXCEPTION",
          "content": "到货照片",
          "note": "外箱照片",
          "uploadedTime": "2026-06-05 10:40:00",
          "asnAdditionalFiles": [
            {
              "fileName": "receipt-photo.jpg",
              "fileUrl": "https://example.com/files/receipt-photo.jpg",
              "fileType": "OTHER",
              "fileFormat": "JPG",
              "isUpdate": false,
              "fileBase64": ""
            }
          ]
        }
      ]
    }
  ]
}

2.5. 入库单反馈接口

2.5.1. SERVICE_TYPE

GLINK_UPDATE_ASN_STATUS

2.5.2. 接口说明

入库单状态变更时，平台按配置向客户系统推送入库单信息。客户系统需返回处理结果。

2.5.3. 请求参数

入库单反馈信息

参数名 类型 列表 必填 备注
partnerId string N Y 合作伙伴ID
asnNumber string N Y 入库单号
wmsAsnNumber string N Y WMS入库单号
status string N Y 入库单反馈状态。当入库单已关单（stage=CLOSED）且上架未完成时返回 RECEIVED（已收货），否则返回入库阶段 stage。常见值：DUE_IN（待到货）、ARRIVED（已到货）、INSPECTING（验收中）、INSPECTED（已验收）、RECEIVING（收货中）、RECEIVED（已收货）、CLOSED（已关闭/完成）、VOID（已取消）
customerCode string N Y 客户编码
warehouseCode string N N 仓库编码
receiveTime string N N 收货时间，格式 yyyy-MM-dd HH:mm:ss
remark string N N 备注，当前固定为空字符串
asnType string N N 入库单类型；SUPPLIER_RECEIPT（采购入库）、RETURN（退货入库）、OTHER_INBOUND（其他入库）、PURCHASE（采购/ERP需箱唛）、MANUAL（手工/其他入库）、FIRST_LEG（头程入库）、TRANSFER_PLAN（调拨计划入库）、TRANSFER_AVAILABLE（可用库存调拨入库）
expectedReceiptDate string N N 预计收货时间
wmsDocSource string N N 仓库单据来源；常见值：ENTRY（后台录入）、API（接口创建）、PO（采购单生成）、AUTO_GWMS（仓库自动生成）
trackingNumber string N N 运单号
warehouseNotes string N N 仓库备注
referenceNumber string N N 参考单号
orderNumber string N N 关联出库单号
carrier string N N 承运商
extUserId string N N 外部用户ID
stage string N N 入库阶段；常见值：DUE_IN（待到货）、ARRIVED（已到货）、INSPECTING（验收中）、INSPECTED（已验收）、RECEIVING（收货中）、RECEIVED（已收货）、CLOSED（已关闭）、VOID（已取消）
putawayStage string N N 上架阶段；PENDING（待上架）、IN PROGRESS（上架中）、COMPLETED（上架完成）
handlings object N N 入库单操作/计费信息
└ arrivalDate string N N 到货时间
└ capacityType string N N 到货方式/容器类型；常见值：LTL（零担货运）、PARCEL（包裹）、40HQ（40尺高柜）、20GP（20尺普柜）等
└ preBuilt boolean N N 是否预打板
└ palletQty int N N 托盘数量
└ cartonQty int N N 箱数
└ volume float N N 体积
└ lengthUnit string N N 长度单位；cm：厘米，In：英寸，m：米
└ weight float N N 重量
└ weightUnit string N N 重量单位；KG：千克，LBS：磅，GRAM：克
└ note string N N 备注
└ handlingDetailList object Y N 操作信息明细
  └ chargeType string N N 操作/计费活动类型；常见值：INBOUND（入库操作）、OUTBOUND（出库操作）等，具体取值以仓库配置为准
  └ chargeUnit string N N 操作/计费活动单位；常见值：PIECE（件）、COUNT（次）、MANHOUR（工时）等
  └ chargeQty float N N 活动数量
  └ chargeManHour float N N 活动总时长
  └ chargeNote string N N 备注
asnLineItems object Y N 商品反馈信息
└ lineNo string N N 行号
└ sku string N N 商品编码
└ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
└ mfgDate string N N 生产日期
└ expDate string N N 失效日期
└ batchNo string N N 批次号
└ originCountry string N N 原产国
└ expectedQuantity int N N 期望数量
└ poLineNo string N N PO行号
└ poNumber string N N PO号
└ quantity int N N 可用数量，按可售时机取收货量或上架量
└ putawayedQuantity int N N 上架数量
└ skuHeight double N N SKU高度
└ skuWidth double N N SKU宽度
└ skuLength double N N SKU长度
└ dimensionUnit string N N 尺寸单位；cm：厘米，inch：英寸
└ skuWeight double N N SKU重量
└ weightUnit string N N 重量单位；KG：千克，LBS：磅，GRAM：克
└ udf1 string N N 自定义字段1
└ udf2 string N N 自定义字段2
└ udf3 string N N 自定义字段3
└ udf4 string N N 自定义字段4
└ udf5 string N N 自定义字段5
└ udf6 string N N 自定义字段6
└ udf7 string N N 自定义字段7
└ udf8 string N N 自定义字段8
└ udf9 string N N 自定义字段9
└ udf10 string N N 自定义字段10
└ udf11 string N N 自定义字段11
└ udf12 string N N 自定义字段12
adjustInfos object Y N 入库调整信息
└ sku string N N 商品编码
└ adjustQty int N N 调整数量
└ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
└ mfgDate string N N 生产日期
└ expDate string N N 失效日期
└ batchNo string N N 批次号
└ originCountry string N N 原产国
asnItemReceiveDetails object Y N 入库商品收货/上架明细
└ lineNo string N N 行号
└ detailId string N N 明细ID
└ sku string N N 商品编码
└ skuStatus string N N 库存状态；GOOD（良品）、DAMAGE（残品/破损）
└ receiveQty int N N 收货数量
└ receiveTime string N N 收货时间
└ putawayQty int N N 上架数量
└ putawayTime string N N 上架时间
└ originCountry string N N 原产国
└ batchNo string N N 批次号
└ expDate string N N 失效日期
└ mfgDate string N N 生产日期
additionalInfoList object Y N 附加信息
└ infoType string N N 附加信息类型名称
└ infoTypeCode string N N 附加信息类型编码；常见值：NO_EXCEPTION（无异常）、WRONG_SKU（商品错误）、DAMAGED_SKU（货损）、OTHER（其他）等
└ content string N N 信息内容
└ note string N N 信息描述
└ uploadedTime string N N 上传时间
└ asnAdditionalFiles object Y N 文件列表
  └ fileName string N N 附件名称
  └ fileUrl string N N 附件URL
  └ fileType string N N 附件类型；常见值：BILL_OF_LADING（提单）、PACKING_LIST（装箱单）、OTHER（其他）
  └ fileFormat string N N 附件格式
  └ isUpdate boolean N N 是否更新附件
  └ fileBase64 string N N Base64文件内容
snUrl string N N SN列表文件URL

2.5.4. 请求样例

JSON

{
  "partnerId": "GLINK",
  "asnNumber": "ASN202606050001",
  "wmsAsnNumber": "WMSASN202606050001",
  "status": "RECEIVED",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "receiveTime": "2026-06-05 10:30:00",
  "remark": "",
  "asnType": "SUPPLIER_RECEIPT",
  "expectedReceiptDate": "2026-06-06 09:00:00",
  "wmsDocSource": "API",
  "trackingNumber": "TRK202606050001",
  "warehouseNotes": "到货外箱完好",
  "referenceNumber": "REF202606050001",
  "orderNumber": "SO202606050001",
  "carrier": "BEST",
  "extUserId": "EXT_USER_001",
  "stage": "CLOSED",
  "putawayStage": "IN PROGRESS",
  "handlings": {
    "arrivalDate": "2026-06-05 09:20:00",
    "capacityType": "LTL",
    "preBuilt": false,
    "palletQty": 2,
    "cartonQty": 20,
    "volume": 1.5,
    "lengthUnit": "cm",
    "weight": 120.5,
    "weightUnit": "KG",
    "note": "正常卸货",
    "handlingDetailList": [
      {
        "chargeType": "INBOUND",
        "chargeUnit": "MANHOUR",
        "chargeQty": 2.0,
        "chargeManHour": 1.5,
        "chargeNote": "卸货服务"
      }
    ]
  },
  "asnLineItems": [
    {
      "lineNo": "1",
      "sku": "SKU001",
      "skuStatus": "GOOD",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN",
      "expectedQuantity": 10,
      "poLineNo": "10",
      "poNumber": "PO202606050001",
      "quantity": 10,
      "putawayedQuantity": 8,
      "skuHeight": 5.0,
      "skuWidth": 8.0,
      "skuLength": 10.0,
      "dimensionUnit": "cm",
      "skuWeight": 0.5,
      "weightUnit": "KG",
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12"
    }
  ],
  "adjustInfos": [
    {
      "sku": "SKU001",
      "adjustQty": -1,
      "skuStatus": "GOOD",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN"
    }
  ],
  "asnItemReceiveDetails": [
    {
      "lineNo": "1",
      "detailId": "D202606050001",
      "sku": "SKU001",
      "skuStatus": "GOOD",
      "receiveQty": 10,
      "receiveTime": "2026-06-05 10:30:00",
      "putawayQty": 8,
      "putawayTime": "2026-06-05 11:20:00",
      "originCountry": "CN",
      "batchNo": "BATCH20260501",
      "expDate": "2027-05-01",
      "mfgDate": "2026-05-01"
    }
  ],
  "additionalInfoList": [
    {
      "infoType": "无异常",
      "infoTypeCode": "NO_EXCEPTION",
      "content": "到货照片",
      "note": "外箱照片",
      "uploadedTime": "2026-06-05 10:40:00",
      "asnAdditionalFiles": [
        {
          "fileName": "receipt-photo.jpg",
          "fileUrl": "https://example.com/files/receipt-photo.jpg",
          "fileType": "PHOTO",
          "fileFormat": "JPG",
          "isUpdate": false,
          "fileBase64": ""
        }
      ]
    }
  ],
  "snUrl": "https://example.com/files/asn-sn.xlsx"
}

2.5.5. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 外部系统处理结果，true表示处理成功，false表示处理失败
code string N N 操作状态码
message string N N 提示信息

2.5.6. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": ""
}
© Copyright QianYi Team 2025 All Rights Reserved            Updated 2026-06-22 11:07:34

results matching ""

    No results matching ""