---
updatedAt: 2026-08-27T02:31:50.000Z
---

# 一件代发出库单(WMS)-详情

与OMP管理端一件代发出库单（WMS发货单）详情一致。

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "【领星WMS】服务商内部系统对接文档（基于管理后台信息）",
    "version": "2.10.0",
    "description": "【领星WMS】服务商内部系统对接文档（基于管理后台信息）\n\nv2.3.0 更新：分页/详情 schema 与 OpenApi* VO 完全对齐，修正 quotationNo 字段名、补全费用/报价/产品/充值附件字段，补充 warehouseRentType/moduleType 等必填入参。\n\nv2.4.0 更新：新增全局订单/全局库存/仓租成本/充值统计/币种资产共31个查询接口（入参出参与OMP管理端页面口径一致）；v2.5.0 更新：新增全局工单6个查询接口（工单分页/详情/消息/附件/费用/增值服务）。\n\n【序列化说明】平台对null值有统一序列化行为：字符串/日期字段为null时返回空字符串\"\"，数值字段为null时可能返回空字符串\"\"或0，集合字段为null时返回空数组[]。对接时请做空值兼容处理。\n\nv2.6.0 更新：新增备货中转出库（分页/按箱详情/按产品详情/统计/OMS异常分页/成本费用调整详情）、直邮单（分页/详情/状态统计）、装箱单（分页/状态统计）、入库认领（分页/详情）、全局库存（产品库存分页，含主仓库存对比）、仓租明细（OMP链路）共15个查询接口，入参出参与OMP管理端页面口径一致。\n\nv2.7.0 更新：新增物流渠道4个查询接口（渠道分页/详情/绑定仓库/仓库绑定地址，tag=物流渠道）及业务费用2个调整接口（手动调整费用或成本/手动调整仓租费用或成本）。调整接口的明细列表须提交调整后的完整集合，详见接口说明。\n\nv2.8.0 更新：仓库列表查询（warehouse/page）出参新增16个字段：仓库名称（英文）、国家中文名称、国家英文名称、配对主仓名称、仓库状态、公司名称、州/省名称、城市名称、地址1、地址2、邮编、街道号、联系人、联系电话、邮箱、时区。\n\nv2.9.0 更新：新增批量创建产品接口（product/create）。租户级接口，一次调用可为多个客户创建产品（productList 内每条自带 customerCode），单次最多 200 条，同步返回逐 SKU 结果且支持部分成功。\n\nv2.10.0 更新：全局库存新增3个箱库存查询接口（箱库存总计 boxStock/boxTypeTotal、箱库存分页 boxStock/page、箱库存流水分页 boxStockCellBook/page），与OMP管理端箱库存页面口径一致，租户级接口。"
  },
  "servers": [
    {
      "url": "https://api.xlwms.com",
      "description": "生产环境"
    }
  ],
  "components": {
    "schemas": {
      "BaseRequest": {
        "type": "object",
        "required": [
          "sign",
          "appKey",
          "timestamp"
        ],
        "properties": {
          "sign": {
            "type": "string",
            "description": "签名参数，根据签名算法生成",
            "minLength": 64,
            "maxLength": 64
          },
          "appKey": {
            "type": "string",
            "description": "租户身份标识（在管理后台-个人中心-API信息-自研系统获取）",
            "minLength": 32,
            "maxLength": 32
          },
          "timestamp": {
            "type": "string",
            "description": "请求时间，单位秒",
            "pattern": "^\\d{10}$"
          }
        }
      },
      "BaseResponse": {
        "type": "object",
        "required": [
          "code",
          "success",
          "msg"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "description": "错误码"
          },
          "success": {
            "type": "boolean",
            "description": "是否成功"
          },
          "msg": {
            "type": "string",
            "description": "成功/异常信息"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "200",
              "11002",
              "11003",
              "11004",
              "11005",
              "11006",
              "11007",
              "11008",
              "11010",
              "31001"
            ],
            "description": "错误码：\n200-请求成功\n11002-时间超时\n11003-时间戳不能为空\n11004-appKey不能为空\n11005-appKey有误\n11006-验签不通过\n11007-传入参数不能为空\n11008-无接口权限\n11010-sign不能为空\n31001-调用鉴权服务异常"
          },
          "msg": {
            "type": "string",
            "description": "错误信息"
          }
        }
      },
      "OpenApiDeliveryDetailVO": {
        "type": "object",
        "properties": {
          "tenantCode": {
            "type": "string",
            "description": "租户编码"
          },
          "customerCode": {
            "type": "string",
            "description": "客户编码"
          },
          "customerName": {
            "type": "string",
            "description": "客户名称"
          },
          "whCode": {
            "type": "string",
            "description": "仓库编码"
          },
          "whCodeName": {
            "type": "string",
            "description": "仓库名字"
          },
          "sourceNo": {
            "type": "string",
            "description": "来源单号"
          },
          "orderType": {
            "type": "integer",
            "description": "出库单类型"
          },
          "referOrderNo": {
            "type": "string",
            "description": "参考单号"
          },
          "deliveryNo": {
            "type": "string",
            "description": "出库单号"
          },
          "expressNo": {
            "type": "string",
            "description": "物流跟踪号"
          },
          "platformOrderNo": {
            "type": "string",
            "description": "平台单号"
          },
          "logisticsCarrier": {
            "type": "string",
            "description": "物流承运商"
          },
          "logisticsChannel": {
            "type": "string",
            "description": "物流渠道"
          },
          "logisticsChannelName": {
            "type": "string",
            "description": "物流渠道名"
          },
          "channelGroupCode": {
            "type": "string",
            "description": "物流渠道组编码"
          },
          "channelGroupName": {
            "type": "string",
            "description": "物流渠道组名称"
          },
          "remark": {
            "type": "string",
            "description": "审核备注"
          },
          "status": {
            "type": "integer",
            "description": "单据状态"
          },
          "statusName": {
            "type": "string",
            "description": "状态名称"
          },
          "varietyType": {
            "type": "integer",
            "description": "出库单种类"
          },
          "skuKind": {
            "type": "integer",
            "description": "sku种类"
          },
          "skuAmount": {
            "type": "integer",
            "description": "sku总数量"
          },
          "packageNum": {
            "type": "integer",
            "description": "包裹数量"
          },
          "pallets": {
            "type": "integer",
            "description": "出库托盘数"
          },
          "isEditPallets": {
            "type": "integer",
            "description": "是否填写过托盘数 0-未填写 1-填写了"
          },
          "orderCreateTime": {
            "type": "string",
            "description": "新建时间"
          },
          "pickTime": {
            "type": "string",
            "description": "拣货完成时间"
          },
          "recheckTime": {
            "type": "string",
            "description": "复核完成时间"
          },
          "weighTime": {
            "type": "string",
            "description": "称重完成时间"
          },
          "outboundTime": {
            "type": "string",
            "description": "出库时间"
          },
          "outboundWay": {
            "type": "integer",
            "description": "出库方式"
          },
          "insureMoney": {
            "type": "number",
            "description": "保险金额"
          },
          "signatureService": {
            "type": "integer",
            "description": "签名服务类型: 1-间接签名 2-直接签名 3-成人签名"
          },
          "unread": {
            "type": "integer",
            "description": "是否未读 0已读 1未读"
          },
          "packageList": {
            "type": "array",
            "description": "包裹物流信息",
            "items": {
              "type": "object",
              "properties": {
                "wmsPackSerial": {
                  "type": "integer",
                  "description": "WMS包裹序号"
                },
                "wmsPackNo": {
                  "type": "string",
                  "description": "WMS包裹编号"
                },
                "logisticsCarrier": {
                  "type": "string",
                  "description": "物流承运商"
                },
                "expressNo": {
                  "type": "string",
                  "description": "物流跟踪号"
                },
                "length": {
                  "type": "number",
                  "description": "长"
                },
                "width": {
                  "type": "number",
                  "description": "宽"
                },
                "height": {
                  "type": "number",
                  "description": "高"
                },
                "sizeUnit": {
                  "type": "string",
                  "description": "尺寸单位"
                },
                "weight": {
                  "type": "number",
                  "description": "重量"
                },
                "weightUnit": {
                  "type": "string",
                  "description": "重量单位"
                },
                "lengthBs": {
                  "type": "number",
                  "description": "英制-长"
                },
                "widthBs": {
                  "type": "number",
                  "description": "英制-宽"
                },
                "heightBs": {
                  "type": "number",
                  "description": "英制-高"
                },
                "sizeUnitBs": {
                  "type": "string",
                  "description": "英制-尺寸单位：默认为inch 英寸"
                },
                "weightBs": {
                  "type": "number",
                  "description": "英制-重量"
                },
                "weightUnitBs": {
                  "type": "string",
                  "description": "英制-重量单位：默认为lb镑"
                },
                "realWeight": {
                  "type": "number",
                  "description": "wms称重-重量"
                },
                "realWeightBs": {
                  "type": "number",
                  "description": "wms称重-英制重量"
                },
                "logisticsSheetUrl": {
                  "type": "string",
                  "description": "物流面单url"
                },
                "fileKey": {
                  "type": "string",
                  "description": "文件唯一key"
                },
                "fileName": {
                  "type": "string",
                  "description": "附件文件名"
                },
                "packNo": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  },
                  "description": "包材编码"
                },
                "skuList": {
                  "type": "array",
                  "description": "SKU列表",
                  "items": {
                    "type": "object",
                    "properties": {
                      "productSku": {
                        "type": "string",
                        "description": "产品SKU"
                      },
                      "productName": {
                        "type": "string",
                        "description": "商品名称"
                      },
                      "deliveryQty": {
                        "type": "integer",
                        "description": "预报出库数量"
                      },
                      "actualDeliveryQty": {
                        "type": "string",
                        "description": "实际出库数量"
                      },
                      "currencyCode": {
                        "type": "string",
                        "description": "结算币种"
                      },
                      "declarePrice": {
                        "type": "string",
                        "description": "申报价值;（单位：USD，不做币种转换）"
                      },
                      "productSnFlag": {
                        "type": "boolean",
                        "description": "sku是否开启序列号"
                      },
                      "productSnList": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "单据内的sku序列号"
                      },
                      "pickingRecommendationInfoList": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "拣货推荐信息列表"
                      },
                      "pickingRelInfoList": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "拣货关联信息列表"
                      }
                    }
                  }
                },
                "realLength": {
                  "type": "number",
                  "description": "长"
                },
                "realLengthBs": {
                  "type": "number",
                  "description": "英制长"
                },
                "realWidth": {
                  "type": "number",
                  "description": "宽"
                },
                "realWidthBs": {
                  "type": "number",
                  "description": "英制宽"
                },
                "realHeight": {
                  "type": "number",
                  "description": "高"
                },
                "realHeightBs": {
                  "type": "number",
                  "description": "英制高"
                },
                "realSizeUnit": {
                  "type": "string",
                  "description": "wms实际尺寸单位"
                },
                "packList": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "包材编码列表"
                },
                "returnFileKey": {
                  "type": "string",
                  "description": "回邮面单文件唯一key"
                },
                "returnFileName": {
                  "type": "string",
                  "description": "回邮面单附件文件名"
                },
                "returnFileExt": {
                  "type": "string",
                  "description": "回邮面单附件文件格式"
                },
                "returnTrackNo": {
                  "type": "string",
                  "description": "回邮单号"
                },
                "relateBoxType": {
                  "type": "string",
                  "description": "related box type"
                }
              }
            }
          },
          "skuVOList": {
            "type": "array",
            "description": "产品明细",
            "items": {
              "type": "object",
              "properties": {
                "productSku": {
                  "type": "string",
                  "description": "产品SKU"
                },
                "productName": {
                  "type": "string",
                  "description": "商品名称"
                },
                "deliveryQty": {
                  "type": "integer",
                  "description": "预报出库数量"
                },
                "actualDeliveryQty": {
                  "type": "integer",
                  "description": "实际出库数量"
                },
                "currencyCode": {
                  "type": "string",
                  "description": "结算币种"
                },
                "declarePrice": {
                  "type": "number",
                  "description": "申报价值;（单位：USD，不做币种转换）"
                },
                "productSnFlag": {
                  "type": "boolean",
                  "description": "sku是否开启序列号"
                },
                "productSnList": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "单据内的sku序列号"
                },
                "pickingRecommendationInfoList": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "拣货推荐信息列表"
                },
                "pickingRelInfoList": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "拣货关联信息列表"
                }
              }
            }
          },
          "wmsAppendixList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OpenApiAppendixVO"
            },
            "description": "附件列表"
          },
          "salesPlatform": {
            "type": "string",
            "description": "销售平台"
          },
          "orderSource": {
            "type": "integer",
            "description": "订单来源：1-手动创建，2-外部推送，3-平台拉单，-1=Temu合作仓"
          },
          "forecastStatus": {
            "type": "integer",
            "description": "预报状态"
          },
          "forecastRemark": {
            "type": "string",
            "description": "面单获取备注、异常信息等"
          },
          "vasList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OpenApiVasVO"
            },
            "description": "增值服务详情"
          },
          "productSnFlag": {
            "type": "boolean",
            "description": "sku是否开启序列号"
          },
          "orderExtensionTimeBO": {
            "type": "object",
            "description": "指定配送时间参数",
            "properties": {
              "deliveryDate": {
                "type": "string",
                "description": "指定配送日期"
              },
              "deliveryTime": {
                "type": "string",
                "description": "交运时间"
              }
            }
          },
          "storeName": {
            "type": "string",
            "description": "店铺名称"
          },
          "reissueFlag": {
            "type": "integer",
            "description": "是否补发单：0-否，1-是"
          },
          "relatedOutboundOrderNo": {
            "type": "string",
            "description": "补发直接关联的源出库单号"
          },
          "useOriginalLabel": {
            "type": "string",
            "description": "是否使用原面单：0-否，1-是"
          },
          "agentCode": {
            "type": "string",
            "description": "代理商类型：0=易仓wms，1=星链wms，2=易达云，3=shipOutWms"
          },
          "orderExtInfo": {
            "type": "object",
            "description": "订单扩展信息（结构随单据类型不同而异，可能为空）",
            "properties": {
              "wbPlatformFlag": {
                "type": "boolean",
                "description": "是否WB平台单据（代理仓场景标识）"
              },
              "agentAuthStoreCode": {
                "type": "string",
                "description": "代理仓授权店铺编码"
              },
              "agentAuthCustomerCode": {
                "type": "string",
                "description": "代理仓授权客户编码"
              },
              "supplyId": {
                "type": "string",
                "description": "袋子编号"
              },
              "originStatus": {
                "type": "string",
                "description": "平台订单状态"
              },
              "platformOrderId": {
                "type": "string",
                "description": "平台订单ID"
              },
              "platformPackageId": {
                "type": "string",
                "description": "平台包裹ID"
              },
              "storeCode": {
                "type": "string",
                "description": "店铺名称"
              }
            }
          },
          "secOrderSource": {
            "type": "integer",
            "description": "二级订单来源"
          }
        }
      },
      "OpenApiAppendixVO": {
        "type": "object",
        "properties": {
          "bizCode": {
            "type": "string",
            "description": "业务编码"
          },
          "bizName": {
            "type": "string",
            "description": "业务编码名称"
          },
          "bizAppendixType": {
            "type": "integer",
            "description": "附件业务类型"
          },
          "bizAppendixTypeName": {
            "type": "string",
            "description": "附件业务类型名称"
          },
          "sourceAppendix": {
            "type": "string",
            "description": "附件来源，oms-客户上传、wms-仓库上传"
          },
          "bizNo": {
            "type": "string",
            "description": "业务单据唯一编号"
          },
          "url": {
            "type": "string",
            "description": "附件文件url"
          },
          "originName": {
            "type": "string",
            "description": "附件文件原始名"
          },
          "fileName": {
            "type": "string",
            "description": "附件文件名"
          },
          "fileExt": {
            "type": "string",
            "description": "附件文件格式"
          },
          "fileSize": {
            "type": "integer",
            "description": "附件大小"
          },
          "fileKey": {
            "type": "string",
            "description": "文件唯一key"
          },
          "uploadTime": {
            "type": "string",
            "description": "文件上传时间"
          },
          "remark": {
            "type": "string",
            "description": "备注"
          }
        }
      },
      "OpenApiVasVO": {
        "type": "object",
        "properties": {
          "customerCode": {
            "type": "string",
            "description": "客户编码"
          },
          "outboundOrderNo": {
            "type": "string",
            "description": "出库单号"
          },
          "billCode": {
            "type": "string",
            "description": "计费变量编码"
          },
          "unitPrice": {
            "type": "number",
            "description": "单价"
          },
          "workCount": {
            "type": "number",
            "description": "作业数量"
          },
          "omsRemark": {
            "type": "string",
            "description": "OMS备注（卖家备注）"
          },
          "wmsRemark": {
            "type": "string",
            "description": "WMS备注（仓库备注）"
          },
          "billItemId": {
            "type": "string",
            "description": "计费项ID"
          },
          "billItemName": {
            "type": "string",
            "description": "计费项名称"
          }
        }
      }
    }
  },
  "security": [],
  "paths": {
    "/openapi/v2/order/delivery/detail": {
      "post": {
        "tags": [
          "全局订单"
        ],
        "summary": "一件代发出库单(WMS)-详情",
        "description": "与OMP管理端一件代发出库单（WMS发货单）详情一致。",
        "security": [
          {
            "ApiKeyAuth": [],
            "SignatureAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BaseRequest"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "data": {
                        "type": "object",
                        "properties": {
                          "whCode": {
                            "type": "string",
                            "description": "仓库编码"
                          },
                          "customerCode": {
                            "type": "string",
                            "description": "客户编码"
                          },
                          "deliveryNo": {
                            "type": "string",
                            "description": "发货单单号"
                          }
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/BaseResponse"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/OpenApiDeliveryDetailVO"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "未认证",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "未授权",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务器错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}
```