API开放平台

TIP

# 要货计划新增

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/goodsDemand/v1/addGoodsDemandTask/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "task_name": "要货计划2024-11",
  "cm_id": "7948067685105588621",
  "cm_code": "POS00000005",
  "emp_id": "7029463435931699319",
  "emp_code": "ssl",
  "remark": "",
  "ext_columns": [
    {
      "ext_key": "自定义字段01",
      "ext_value": "自定义字段-文本框"
    },
    {
      "ext_key": "自定义字段02",
      "ext_value": "100"
    }
  ],
  "prods": [
    {
      "prod_id": "6229122800439537923",
      "prod_code": "6229122800439537923",
      "unit_id": "6229122800439537923",
      "unit_name": "盒",
      "plan_num": 5,
      "remark": "",
      "ext_columns": [
        {
          "ext_key": "自定义字段01",
          "ext_value": "自定义字段-文本框"
        },
        {
          "ext_key": "自定义字段02",
          "ext_value": "100"
        }
      ]
    },
    {
      "prod_id": "5795225643429153297",
      "prod_code": "SP202410240001",
      "unit_id": "6148746347138151623",
      "unit_name": "箱",
      "plan_num": 10,
      "remark": "",
      "ext_columns": [
        {
          "ext_key": "自定义字段01",
          "ext_value": "自定义字段-文本框"
        },
        {
          "ext_key": "自定义字段02",
          "ext_value": "100"
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
creator_id VARCHAR(32) 否 创建人id（创建人id和创建人编码必须传一个，优先使用创建人id）
creator_code VARCHAR(100) 否 创建人编码（创建人id和创建人编码必须传一个，优先使用创建人id）
task_name VARCHAR(100) 是 任务计划名称
cm_id VARCHAR(32) 否 客户id（客户id和客户编码必须传一个，优先使用客户id）
cm_code VARCHAR(100) 否 客户编码（客户id和客户编码必须传一个，优先使用客户id）
emp_id VARCHAR(32) 否 业务员id（业务员id和业务员编码必须传一个，优先使用业务员id）
emp_code VARCHAR(100) 否 业务员编码（业务员id和业务员编码必须传一个，优先使用业务员id）
remark TEXT 否 备注
ext_columns List 否 头自定义字段
ext_columns.ext_key varchar(4000) 否 头自定义字段名称
ext_columns.ext_value varchar(4000) 否 头自定义字段值
prods List 是 商品信息列表
prods.prod_id VARCHAR(32) 否 商品id（商品id和商品编码必须传一个，优先使用商品id）
prods.prod_code VARCHAR(100) 否 商品编码（商品id和商品编码必须传一个，优先使用商品id）
prods.unit_id VARCHAR(32) 否 计划数量单位id（单位id和单位名称传一个即可，优先使用单位id，不传使用基本单位）
prods.unit_name VARCHAR(32) 否 计划数量单位名称（单位id和单位名称传一个即可，优先使用单位id，不传使用基本单位）
prods.plan_num NUMERIC(28,8) 是 计划数量
prods.remark TEXT 否 行备注
prods.ext_columns List 否 行自定义字段
prods.ext_columns.ext_key varchar(4000) 否 行自定义字段名称
prods.ext_columns.ext_value varchar(4000) 否 行自定义字段值

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码。0：成功，1：失败
return_msg VARCHAR(100) 是 响应说明

# 要货计划查询

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/goodsDemand/v1/queryGoodsDemandTask/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "page_number": 1,
  "page_length": 1000,
  "start_create_date": "2023-05-02",
  "end_create_date": "2023-05-31",
  "start_modify_date": "2023-05-02",
  "end_modify_date": "2023-05-02"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number INT 否 分页页码，默认为1
page_length INT 否 分页大小，每页默认1000条
status CHAR(1) 否 记录状态。0：已删除，1：正常
demand_plan_status VARCHAR(32) 否 单据状态(DTJ：待提交，DSP：待审批，YSP：已审批，YDH：已打回)
demand_plan_id VARCHAR(32) 否 要货计划id
demand_plan_no VARCHAR(32) 否 要货计划单号
cm_code VARCHAR(32) 否 客户编码
cm_source_code VARCHAR(32) 否 客户sourcecode
create_date VARCHAR(32) 否 创建日期。格式：yyyy-MM-dd
modify_date VARCHAR(32) 否 修改日期。格式：yyyy-MM-dd
after_create_date VARCHAR(32) 否 创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 否 修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 否 创建时间开始。格式：yyyy-MM-dd
end_create_date VARCHAR(32) 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date VARCHAR(32) 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date VARCHAR(32) 否 修改时间结束。格式：yyyy-MM-dd
start_confirm_time VARCHAR(32) 否 确认时间开始。格式：yyyy-MM-dd HH:mm:ss
end_confirm_time VARCHAR(32) 否 确认时间结束。格式：yyyy-MM-dd HH:mm:ss

响应示例：

{
  "return_code": "0",
  "response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
    "task_name": "要货计划2024-09",
    "end_date": "2024-09-30 23:59:59",
    "dept_code": "caigoubu",
    "modify_time": "",
    "demand_plan_status": "DSP",
    "remark": "",
    "prod_type_num": "3",
    "cm_code": "CUS000019",
    "demand_plan_type_code": "10",
    "creator_source_code": "",
    "confirmer_source_code": "",
    "details": [
      {
        "master_id": "6208333179680074559",
        "sequ": "3",
        "base_unit_id": "6161949396316964019",
        "remark": "",
        "remain_num": "0.00",
        "wait_sign_num": "0.00",
        "detail_id": "5866249294396458655",
        "prod_code": "SP202206100001",
        "prod_id": "6769537103629248209",
        "input_unit_id": "6161949396316964019",
        "prod_source_code": "",
        "plan_num": "10.00000000",
        "input_unit_name": "件",
        "wait_sent_num": "0.00",
        "exts": []
      },
      {
        "master_id": "6208333179680074559",
        "sequ": "1",
        "base_unit_id": "4626649663668879242",
        "remark": "",
        "remain_num": "0.00",
        "wait_sign_num": "0.00",
        "detail_id": "6603092061589137428",
        "prod_code": "SP202211170004",
        "prod_id": "7049911285223929403",
        "input_unit_id": "4626649663668879242",
        "prod_source_code": "",
        "plan_num": "10.00000000",
        "input_unit_name": "瓶",
        "wait_sent_num": "0.00",
        "exts": []
      },
      {
        "master_id": "6208333179680074559",
        "sequ": "4",
        "base_unit_id": "4626649663668879242",
        "remark": "",
        "remain_num": "0.00",
        "wait_sign_num": "0.00",
        "detail_id": "6308117674246088158",
        "prod_code": "SP202211170004",
        "prod_id": "7049911285223929403",
        "input_unit_id": "7240299510880846324",
        "prod_source_code": "",
        "plan_num": "10.00000000",
        "input_unit_name": "件",
        "wait_sent_num": "0.00",
        "exts": []
      },
      {
        "master_id": "6208333179680074559",
        "sequ": "5",
        "base_unit_id": "7320215892776049167",
        "remark": "",
        "remain_num": "0.00",
        "wait_sign_num": "0.00",
        "detail_id": "7378681586404664027",
        "prod_code": "SP202212270003",
        "prod_id": "9105822847309988053",
        "input_unit_id": "7320215892776049167",
        "prod_source_code": "telunsu",
        "plan_num": "10.00000000",
        "input_unit_name": "盒",
        "wait_sent_num": "0.00",
        "exts": []
      },
      {
        "master_id": "6208333179680074559",
        "sequ": "2",
        "base_unit_id": "7320215892776049167",
        "remark": "",
        "remain_num": "0.00",
        "wait_sign_num": "0.00",
        "detail_id": "7745747342971233248",
        "prod_code": "SP202212270003",
        "prod_id": "9105822847309988053",
        "input_unit_id": "8094804923588311803",
        "prod_source_code": "telunsu",
        "plan_num": "10.00000000",
        "input_unit_name": "件",
        "wait_sent_num": "0.00",
        "exts": []
      }
    ],
    "cm_source_code": "",
    "dept_source_code": "cgb",
    "exts": [],
    "start_date": "2024-09-01 00:00:00",
    "creator_code": "ssl",
    "year_month": "2024-09",
    "emp_code": "yang1",
    "create_time": "2024-08-22 16:00:14",
    "modifier_source_code": "",
    "demand_plan_no": "JH20240822000001",
    "confirm_time": "",
    "emp_source_code": "",
    "demand_plan_id": "6208333179680074559",
    "confirmer_code": "",
    "modifier_code": "",
    "status": "1"
  }
]

参数说明：

参数 类型 必填 说明
demand_plan_id VARCHAR(32) 否 要货计划id
status VARCHAR(32) 否 状态0：已删除，1：正常
demand_plan_status VARCHAR(32) 否 单据状态(0：待审批，1：已审批，2：已打回)
demand_plan_no VARCHAR(32) 否 要货计划单号
cm_code VARCHAR(32) 否 客户编码
cm_name VARCHAR(32) 否 客户名称
cm_source_code VARCHAR(32) 否 客户sourcecode
demand_plan_type_code VARCHAR(32) 否 计划类型编码
task_name VARCHAR(32) 否 任务名称
year_month VARCHAR(32) 否 年月，yyyyMM格式
start_date VARCHAR(32) 否 任务开始日期
end_date VARCHAR(32) 否 任务结束日期
dept_code VARCHAR(32) 否 部门编码
dept_name VARCHAR(32) 否 部门名称
dept_source_code VARCHAR(32) 否 部门sourcecode
emp_code VARCHAR(32) 否 业务员编码
emp_name VARCHAR(32) 否 业务员名称
emp_source_code VARCHAR(32) 否 业务员sourcecode
remark TEXT 否 备注
exts List 否 要货计划主数据自定义字段集合
exts.ext_key VARCHAR(100) 否 要货计划主数据自定义字段名称
exts.ext_value TEXT 否 要货计划主数据自定义字段数据值
prod_type_num VARCHAR(32) 否 品种数
creator_code VARCHAR(32) 否 创建人编码
creator_name VARCHAR(32) 否 创建人名称
creator_source_code VARCHAR(32) 否 创建人sourcecode
create_time VARCHAR(32) 否 创建时间，yyyy-mm-dd hh24:mi:ss格式
modifier_code VARCHAR(32) 否 修改人编码
modifier_name VARCHAR(32) 否 修改人名称
modifier_source_code VARCHAR(32) 否 修改人sourcecode
modify_time VARCHAR(32) 否 修改时间，yyyy-mm-dd hh24:mi:ss格式
confirmer_code VARCHAR(32) 否 最后审批人编码
confirmer_name VARCHAR(32) 否 最后审批人名称
confirmer_source_code VARCHAR(32) 否 最后审批人sourcecode
confirm_time VARCHAR(32) 否 审批时间，yyyy-mm-dd hh24:mi:ss格式
details LIST 否 要货计划子数据
details.detail_id VARCHAR(32) 否 子表id
details.sequ VARCHAR(32) 否 序号
details.prod_id VARCHAR(32) 否 商品id
details.prod_code VARCHAR(32) 否 商品编码
details.prod_name VARCHAR(32) 否 商品名称
details.prod_source_code VARCHAR(32) 否 商品sourcecode
details.input_unit_id VARCHAR(32) 否 单位id
details.input_unit_name VARCHAR(32) 否 单位名称
details.remain_num VARCHAR(32) 否 剩余库存数量
details.wait_sign_num VARCHAR(32) 否 在途库存数量
details.wait_sent_num VARCHAR(32) 否 采购未发数量
details.plan_num VARCHAR(32) 否 计划数量
details.remark TEXT 否 备注
details.exts List 否 要货计划子数据自定义字段集合
details.exts.ext_key VARCHAR(32) 否 要货计划子数据自定义字段key
details.exts.ext_value VARCHAR(32) 否 要货计划子数据自定义字段value

← 要货计划数据推送 →