新建完工退回发出单 Create Oso Complete Return

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.oso-return-open-api-controller.createOsoReturn

Body 参数application/json

organizationCode

string

组织编码

必需

不能同时为空，且推送的编码或名称是已在系统配置的，否则返回错误

organizationName

string

组织名称

可选

不能同时为空，且推送的编码或名称是已在系统配置的，否则返回错误

osoCompReturnCode

string

完工退回发出单号

必需

唯一性校验，编码格式：全大小写及数字，必须以字母、数字开头，可包含“-”、“_”；校验不可与已有单号重复，保持唯一

relatedPartyCode

string

供应商编码

可选

不可同时空，，同时有值则以code为准。有效性校验：供应商必须在当前租户下存在并有效，报错：“供应商desc（code）在当前租户下不存在或无效，请确认后重试。”

relatedPartyName

string

供应商名称

可选

不可同时空，，同时有值则以code为准。有效性校验：供应商必须在当前租户下存在并有效，报错：“供应商desc（code）在当前租户下不存在或无效，请确认后重试。”

relatedPartyAddressCode

string

供应商地址编码

必需

有效性校验：供应商地点必须在当前供应商下存在并有效，供应商地点必须在当前组织所属公司下存在并有效，否则报错：“供应商地点code在当前供应商desc（code）或公司desc（code）下不存在或无效，请确认后重试。”

rcvContactsName

string

收货人

可选

rcvContactsMobile

string

收货电话

可选

合法性校验

executedByName

string

发出人

必需

输入用户名（登录账户名），需在当前租户下存在且有效

issueTime

string

发出时间

必需

格式：yyyy-MM-dd HH:mm:ss，合法性校验

lineList

object

可选

sequenceNum

string

行号

必需

同一发料单的序号必须唯一

moNum

string

生产工单号

必需

校验生产工单号必须在当前组织下存在，且状态为“已下发”或“已完成”，否则报错：“生产工单号code不存在或状态不为已下发/已完成，请确认后重试。”

moOperationSeqNum

string

工单工序行号

必需

"校验工单工序行号必须在当前生产工单下存在，否则报错：“工单工序行XX在生产工单code下不存在，请确认后重试。”；校验工单工序行的外协供应商地点必须为头数据的供应商地点，否则报错：“工单工序行XX的外协供应商地点编码和供应商地址编码不匹配，请确认后重试。”"

statusCode

string

质量状态编码

可选

不可同时为空，同时有值则以code为准。校验输入值的有效性

statusMeaning

string

质量状态

可选

不可同时为空，同时有值则以code为准。校验输入值的有效性

shippingQty

string

发出数量

必需

必须为正数，根据工序外协配置，若启用序列，则必须为正整数

lotNum

string

批次号

可选

根据工序外协配置，若启用批次，则必填；否则不可输入值，报错：“行XX的物料在和工序外协配置的配置下，批次未启用，不可输入，请确认后重试。”

snNum

string

序列号

可选

根据工序外协配置，若启用序列，则必输；否则不可输入值，报错：“行XX的物料在和工序外协配置的配置下，批次未启用，不可输入，请确认后重试。”

示例

{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"organizationCode\":\"test1\",\"organizationName\":\"上海1号有限公司\",\"osoCompReturnCode\":\"WB20221221600204\",\"relatedPartyCode\":\"S00000002\",\"relatedPartyName\":\"\",\"relatedPartyAddressCode\":\"01\",\"rcvContactsName\":\"Q\",\"rcvContactsMobile\":\"123456789\",\"executedByName\":\"ZQA_10\",\"issueTime\":\"2022-12-16 15:38:12\",\"lineList\":[{\"sequenceNum\":\"10\",\"moNum\":\"MO202212090001\",\"moOperationSeqNum\":\"10\",\"statusCode\":\"\",\"statusMeaning\":\"完工\",\"shippingQty\":\"1\",\"lotNum\":\"\"}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/hitf/v1/rest/invoke' \
--header 'Content-Type: application/json' \
--data-raw '{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"organizationCode\":\"test1\",\"organizationName\":\"上海1号有限公司\",\"osoCompReturnCode\":\"WB20221221600204\",\"relatedPartyCode\":\"S00000002\",\"relatedPartyName\":\"\",\"relatedPartyAddressCode\":\"01\",\"rcvContactsName\":\"Q\",\"rcvContactsMobile\":\"123456789\",\"executedByName\":\"ZQA_10\",\"issueTime\":\"2022-12-16 15:38:12\",\"lineList\":[{\"sequenceNum\":\"10\",\"moNum\":\"MO202212090001\",\"moOperationSeqNum\":\"10\",\"statusCode\":\"\",\"statusMeaning\":\"完工\",\"shippingQty\":\"1\",\"lotNum\":\"\"}]}]"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}