跳到主要内容
版本：v2.0

获取营种待确认plu

获取指定营种（pid）的待确认营期（delay = 1）对应的 plu。待确认营期不做多规格，直接返回单个 plu，可原样作为 更换营期 的 plu 入参，用于把线下导入订单迁移到"待确认"营期。

信息

本接口是 更换营期 链路的取 plu 前置接口。每个营种至多一个待确认营期：待确认营期缺失时会自动创建（以该营种一个正常营期为配置模板），plu 缺失时按默认规格自动补齐，均为"缺失才补、幂等不重复"，多次调用返回同一 plu。

POST/api/getDelayPlu

核心语义​

  1. 定位待确认营期：按 pid 找到该营种 delay=1 的待确认营期；每个营种至多一个。
  2. 缺失自动创建：该营种尚无待确认营期时，以其一个正常营期为模板复制配置（sku_data、差价等）并创建待确认营期。
  3. 缺 plu 自动补齐：待确认营期为特殊状态、常规规格生成流程不覆盖，故当查不到其 plu 时按默认规格补写一条，保证返回可用 plu；已有则直接返回，幂等不重复插入。
  4. 单 plu 返回：待确认营期不涉及多规格，返回体仅一个 plu（不返回 sku_list / plu_str）。
  5. 落库副作用：待确认营期缺失时创建营期记录；plu 缺失时补写 product_plu。均"缺失才补、幂等不重复"。
  6. 工具接口契约：code 恒为 0；成功时 msg 为空、data 为结果对象；失败时 msg 非空、data 为空数组。

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
pidNumber营种 ID必填-见 获取营种列表；pid <= 0 视为未传

CURL​

V1​

curl --location --request POST 'https://open.xinduobang.cn/api/getDelayPlu' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'pid=2690'

V2（appid 为 V2 版本）​

curl --location --request POST 'https://open.xinduobang.cn/api/getDelayPlu' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'pid=2690'
信息

V2 签名算法及 X-Signature 计算方式见 V2 接入示例。

成功响应​

{
  "code": 0,
  "msg": "",
  "data": {
    "pid": 2690,
    "delay_period_id": 12400,
    "plu": "939623321586"
  }
}

响应字段说明​

键类型说明
pidNumber入参营种 ID
delay_period_idNumber待确认营期 id（delay=1）；原不存在时为本接口新建
pluString待确认营期的 plu；原缺失时为本接口补齐的默认规格 plu，可直接用于 更换营期

失败响应​

工具接口契约下 code 恒为 0，失败通过非空 msg 与空 data 标识。

{ "code": 0, "msg": "创建待确认营期失败", "data": [] }
错误文案说明
pid不能为空pid 缺失或非法（pid <= 0）
创建待确认营期失败待确认营期不存在且自动创建未成功

相关接口​

变更记录​

日期变更
2026-10-16首次发布：/api/getDelayPlu（POST：pid），透传上游 /Tools/getDelayPlu。获取营种待确认营期（delay=1）的 plu，不做多规格、直接返回单个 plu；待确认营期缺失时以正常营期为模板自动创建，product_plu 缺失时按默认规格补齐（幂等）；返回 pid、delay_period_id、plu，作为 更换营期 的 plu 入参来源