SCM下单预警触发接口

接口说明

a. 通过SCM预警指令，传的值【单号+制单号】（单号为加工厂入库单中的单号， 单号会存在多个）
b. 发起时间 <= 面料合约货期+72小时 (实时API查询SCM大货下单)
c. 制单号SCM下单状态=已审核，大货状态=未完成（实时查询SCM工厂跟单）
d. 发送预警消息(理单和开发员)并返回SCM “预警消息发起成功”。b 条件判断失败返回”当前时间已经超过发起有效时间，如果疑问请线下联系对应理单员”,c条件判断失败返回”当前采购单订单状态非未完成状态，请线下联系理单员”

接口版本

版本号 制定人 制定日期 修订日期
1.0.0 许克胜 2021-03-05 2021-03-05

请求URL

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/factory/order/warning
预发布环境 http://apiuat.yptcgroup.com/thirdpart/factory/order/warning
正式环境 http://api.yptcgroup.com/thirdpart/factory/order/warning

请求方式

  • POST

请求头

参数名 是否必须 类型 说明
X-AUTH-TOKEN 是 string 令牌
Content-Type 是 string 请求类型,统一是 application/json

请求参数

参数名 字段 是否必须 类型 长度 说明
制单号 purchase_order_no 是 string 对应scm 商品管理 - 大货 - 大货下单管理的单号
入库单号列表 factory_po_in_list 是 list 制单号对应加工厂入库单的单号数组

返回参数说明

参数名 字段 是否必须 类型 长度 说明
状态码 code 是 int 11 状态码:1表示成功,其他表示失败
返回信息 msg 是 varchar 255 错误原因
请求id requestId 是 varchar 255 请求后,返回唯一id(成功与否都会返回)
返回标识 flag 是 string

接口调用示例

接口请求体:

{
    "purchase_order_no":"20210118003",
    "factory_po_in_list":["20210100003","20210100001"]
}

响应消息体:

{
    "code": "1",
    "flag": "success",
    "msg": "当前时间已经超过发起有效时间，如果疑问请线下联系对应理单员。",
    "requestId": "dd62078e276f44a78958e651ac570266"
}

失败响应案例

接口请求体:

{
    "purchase_order_no":"2021011803",
    "factory_po_in_list":["20210100003","20210100001"]
}

响应消息体:

{
    "code": "failure",
    "flag": "failure",
    "msg": "SCM大货下单查询结果为空, 【2021011803】制单号SCM大货下单数据不存在",
    "requestId": "ed7e254ef382436e983b5d06e42e6b81",
    "subCode": "200013",
    "subMsg": "【2021011803】制单号SCM大货下单数据不存在"
}

备注

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-03-05 18:00   作者：许克胜