杂项入库 Misc In - 甄一科技OpenApi

请求参数

Query 参数

namespace

string

必需

示例值:

HZERO

serverCode

string

必需

示例值:

ZOSC_OPEN_API

interfaceCode

string

必需

示例值:

zosc-open-api.stock-api-controller.miscIn

Body 参数application/json

array of:

organizationCode

string

组织编码

可选

不能同时为空（若同时有值，则以编码为准）,获取对应的组织ID，若获取不到，则根据校验的值报错“组织编码不存在”或“组织名称不存在”

organizationName

string

组织名称

可选

不能同时为空（若同时有值，则以编码为准）,获取对应的组织ID，若获取不到，则根据校验的值报错“组织编码不存在”或“组织名称不存在”

itemCode

string

物料编码

必需

获取对应的物料ID，若物料不存在，则报错“物料编码不存在”

itemSkuCode

string

物料sku

可选

若物料未开启SKU管理，则必须为空（若非空则报错“物料未开启SKU管控，无对应SKU”），否则必输，根据物料ID获取对应的物料SKU ID，若获取不到，则报错“SKU编码在该物料下不存在”

miscInQty

integer

杂出数量

必需

必须大于0，若小于等于0，则报错“杂入数量不可小于0”

uomCode

string

单位编码

可选

不能同时为空（若同时有值，则以编码为准），获取对应的单位ID，获取不到，则根据校验的值报错“单位编码不存在于物料单位中”或“单位名称不存在与物料单位中”

uomName

string

单位名称

可选

warehouseCode

string

仓库编码

可选

不能同时为空，获取对应的仓库ID，验证组织与仓库是否匹配，若不匹配，则根据校验的值报错“仓库编码不存在”或“仓库名称不存在”

warehouseName

string

仓库名称

可选

不能同时为空，获取对应的仓库ID，验证组织与仓库是否匹配，若不匹配，则根据校验的值报错“仓库编码不存在”或“仓库名称不存在”

locatorCode

string

货位编码

可选

不能同时为空，获取对应的货位ID，验证仓库和货位是否匹配，若不匹配，则根据传的值报错“货位编码不存在”或“货位名称不存在”

locatorName

string

货位名称

可选

不能同时为空，获取对应的货位ID，验证仓库和货位是否匹配，若不匹配，则根据传的值报错“货位编码不存在”或“货位名称不存在”

lotNumber

string

批次号

可选

判断物料在组织下是否启用批次管控，若启用，不能为空，验证长度不能超过60，以及合法性（正则表达式）

lotActiveDate

string

批次生产日期

可选

lotExpireDate

string

批次失效日期

可选

businessReasonCode

string

业务原因编码

可选

"可同时为空（同时有值时，以编码为准）,到杂项入库业务原因业务快速编码中获取对应的数据ID，获取不到时则根据校验的值报错“业务原因编码不存在”或“业务原因描述不存在” "

businessReasonDesc

string

业务原因描述

可选

remark

string

备注

可选

验证长度不能大于240

executeTime

string

执行时间

必需

格式为"yyyy-MM-dd HH:ss:mm"

qualityReasonCode

string

质量原因编码

可选

"当仓库未开启“强制质量原因”时，可同时为空，当开启时，至少一个字段有值（同时有值时，以编码为准）,到入库质量原因业务快速编码中获取对应的数据ID，获取不到时则根据校验的值报错“质量原因编码不存在”或“质量原因描述不存在” "

qualityReasonDesc

string

质量原因描述

可选

attributeTinyint1

integer

可选

attributeTinyint2

integer

可选

attributeTinyint3

integer

可选

attributeTinyint4

integer

可选

attributeTinyint5

integer

可选

attributeDatetime1

string

可选

attributeDatetime2

string

可选

attributeDatetime3

string

可选

attributeDatetime4

string

可选

attributeDatetime5

string

可选

attributeBigint1

integer

可选

attributeBigint2

integer

可选

attributeBigint3

integer

可选

attributeBigint4

integer

可选

attributeBigint5

integer

可选

attributeDecimal1

integer

可选

attributeDecimal2

integer

可选

attributeDecimal3

integer

可选

attributeDecimal4

integer

可选

attributeDecimal5

integer

可选

attributeString1

string

可选

attributeString2

string

可选

attributeString3

string

可选

attributeString4

string

可选

attributeString5

string

可选

attributeString6

string

可选

attributeString7

string

可选

attributeString8

string

可选

attributeString9

string

可选

attributeString10

string

可选

attributeString11

string

可选

attributeString12

string

可选

attributeString13

string

可选

attributeString14

string

可选

attributeString15

string

可选

snNumList

array [object {1}]

可选

snNum

string

序列号

可选

示例

{"headerParamMap":{},"pathVariableMap":{},"requestParamMap":{},"bodyParamMap":{},"payload":"[{\"organizationCode\":\"Test2\",\"organizationName\":\"\",\"itemCode\":\"Zone-ALL\",\"itemSkuCode\":\"z-all\",\"miscInQty\":1,\"uomCode\":\"\",\"uomName\":\"个\",\"warehouseCode\":\"\",\"warehouseName\":\"甄二成品仓\",\"locatorCode\":\"\",\"locatorName\":\"甄二成品仓\",\"lotNumber\":\"\",\"businessReasonCode\":\"\",\"businessReasonDesc\":\"\",\"remark\":\"拉式供应\",\"qualityReasonCode\":\"\",\"qualityReasonDesc\":\"\",\"executeTime\":\"2022-04-14 15:31:31\",\"attributeTinyint1\":6,\"attributeTinyint2\":6,\"attributeTinyint3\":3,\"attributeTinyint4\":4,\"attributeTinyint5\":5,\"attributeDatetime1\":\"2022-05-25 10:53:00\",\"attributeDatetime2\":\"2022-05-25 10:53:00\",\"attributeDatetime3\":\"2022-05-25 10:53:00\",\"attributeDatetime4\":\"2022-05-25 10:53:00\",\"attributeDatetime5\":\"2022-05-25 10:53:00\",\"attributeBigint1\":14380602,\"attributeBigint2\":2,\"attributeBigint3\":3,\"attributeBigint4\":4,\"attributeBigint5\":5,\"attributeDecimal1\":1,\"attributeDecimal2\":2,\"attributeDecimal3\":3,\"attributeDecimal4\":4,\"attributeDecimal5\":5,\"attributeString1\":\"0525\",\"attributeString2\":\"0525\",\"attributeString3\":\"0525\",\"attributeString4\":\"0525\",\"attributeString5\":\"0525\",\"attributeString6\":\"0525\",\"attributeString7\":\"0525\",\"attributeString8\":\"0525\",\"attributeString9\":\"0525\",\"attributeString10\":\"0525\",\"attributeString11\":\"0525\",\"attributeString12\":\"0525\",\"attributeString13\":\"0525\",\"attributeString14\":\"0525\",\"attributeString15\":\"0525\",\"snNumList\":[{\"snNum\":\"3912031203\"}],\"lotNumber\":\"1657867321290621\"}]"}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

boolean

是否成功

必需

message

string

返回消息

必需

示例

{
    "headers": {},
    "body": null,
    "status": "200",
    "message": "OK",
    "mediaType": null,
    "payload": "{\"result\":true}",
    "apiInfo": null,
    "targetResponseHeaders": {
        "date": "Wed, 17 Aug 2022 06:23:59 GMT",
        "expires": "0",
        "transfer-encoding": "chunked",
        "x-content-type-options": "nosniff",
        "x-xss-protection": "1; mode=block",
        "connection": "keep-alive",
        "content-type": "application/json",
        "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
        "pragma": "no-cache"
    },
    "invokeKey": null,
    "interfaceContext": null,
    "statusCode": "OK",
    "statusCodeValue": 200
}