检验单新建 create - 甄一科技OpenApi

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.inspection-platform-controller.create

Body 参数application/json

inspectionPlatformNum

string

检验单号

必需

租户下不可重复（检验单单号已存在。）

organizationCode

string

组织编码

可选

不能同时为空（组织不可为空），对应organization_id，若同时有值，以code为准 2. 组织需有效（组织已失效）

quantityGroupCode

string

质检组编码

可选

非必输，若是同时有值，以编码为主，在系统快码QUALITY_MANAGEMENT_GROUP下存在且有效

quantityGroupDesc

string

质检组描述

可选

非必输，若是同时有值，以编码为主，在系统快码QUALITY_MANAGEMENT_GROUP下存在且有效

organizationName

string

组织名称

可选

"1. 不能同时为空，对应ins_document_type_id，若同时有值，以code为准（检验单据类型不存在）； 2. 需有效（检验单据类型已失效）"

insDocumentTypeCode

string

检验单据类型编码

可选

"1. 不能同时为空，对应ins_document_type_id，若同时有值，以code为准（检验单据类型不存在）； 2. 需有效（检验单据类型已失效）"

insDocumentTypeName

string

检验单据类型名称

可选

"1. 不能同时为空，对应ins_document_type_id，若同时有值，以code为准（检验单据类型不存在）； 2. 需有效（检验单据类型已失效）"

inspectionSourceCode

string

检验来源编码

可选

不能同时为空，对应inspectionSource，若同时有值，以code为准（检验来源类型不存在）；

inspectionSourceName

string

检验来源名称

可选

不能同时为空，对应inspectionSource，若同时有值，以code为准（检验来源类型不存在）；

documentNum

string

来源单据号

可选

"1. 需存在于检验单来源下，且状态符合对应要求（单据不存在或状态不符）；若检验来源为“其它”，则单据需为空（检验来源是“其它”类型，不可输入来源单据号） 2. 属于组织下"

documentLineNum

string

来源单据行号

可选

若单据号有值，则单据行不可为空（来源单据行号不可为空），且二者存在归属关系（行号不存在于该单据下）

relatedPartyType

string

交易方类型

可选

"1. 交易方类型需为SUPPLIER或CUSTOMER，需与来源单据对应，来源单可能为空（与来源单据上的交易方不一致。）； 2. 若无来源单号，则非必输"

relatedPartyCode

string

交易方编码

可选

"1. 交易方类型不为空时，此值必输（交易方类型有值时，交易方必输），同时存在时，以CODE为准 2. 需存在于该交易方类型下 3. 若存在单据，需与单据一致"

relatedPartyName

string

交易方名称

可选

operationCode

string

工序编码

可选

"1. 若存在检验来源单据，则需与单据上的值保持一致，可能为空（工序与来源单据行号不一致）； 2. 同时有值时，以编码为准"

operationName

string

工序名称

必需

"1. 若存在检验来源单据，则需与单据上的值保持一致，可能为空（工序与来源单据行号不一致）； 2. 同时有值时，以编码为准"

itemCode

string

物料编码

可选

"1. 不可为空（物料编码不可为空） 2. 需与单据上的物料保持一致（物料编码与单据上的编码不一致。），若单据不存在，则不校验 3. 需存在于组织下的有效物料中（物料在该组织下不存在或已被失效）"

itemSkuCode

string

SKU编码

可选

"1. 当物料启用SKU管理时，不可为空（物料已启用SKU管控，SKU编码不可为空） 2. 当SKU有值时，需与单据上的SKU保持一致（SKU编码与单据上的编码不一致。） 3. 需存在于物料的有效SKU中（SKU在该物料下不存在或已被失效）"

lotNum

string

批次号

可选

"1. 非必输，有值时物料需启用生产或库存批次管控（物料未启用批次管控） 2. 批次需存在于批次表中（批次不存在） 3. 批次需与组织、物料、SKU保持一致（批次与组织、物料或SKU不匹配）"

inspectLot

string

检验批次

可选

可为空，非必输

inspectionQty

string

报检数量

必需

必输，正整数，不可大于制单数量（报检数量不可大于制单数量）

inspectionPlanCode

string

检验计划编码

必需

"1. 需有效且存在于系统中（检验计划编码不存在或已被失效） 2. 该计划编码需与组织、检验来源、检验单据类型保持一致（检验计划与组织、检验来源、检验单据类型不一致） 3. 必输"

sampleQty

string

抽样数量

必需

必输，正整数，不可大于报检数量（抽检数量不可大于报检数量）

applyInspector

string

报检人

可选

必输，正整数，不可大于报检数量（抽检数量不可大于报检数量）

applyInspectTime

string

报检时间

可选

可为空，年月日时分秒

inspector

string

检验人

可选

可为空，对应登陆账号，需存在于租户下

inspectTime

string

检验时间

可选

可为空，年月日时分秒

inspectionResult

string

检验结果

可选

非必输，对应OK/NG

remark

string

备注

可选

非必输

lineList

object

可选

sampleCode

string

样本编码

必需

必输，样本编码不可重复，总样本数量不可大于报检数量

snNum

string

序列号

可选

"非必输 1. 若存在来源单据，序列号需存在于单据行下（序列号不存在于单据中） 2. 若不存在来源单据，序列号需存在于序列号表，且与组织、物料、SKU保持匹配（序列号与组织、物料、SKU不匹配）"

inspectionResult

string

检验结果

可选

非必输，OK/NG

defectMeasureCode

string

不合格处理措施编码

可选

"非必输 1. 不合格处理措施编码需与对应的检验单据对应的检验大类相匹配（该不合格处理措施编码与检验单据对应的检验单大类不匹配） 2. 不合格处理措施编码对应的检验结果需与判定结果保持一致（若判定结果无值，则不受限）"

detailList

object

可选

示例

{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"inspectionPlatformNum\":\"QC202206260002-8\",\"organizationCode\":\"code1\",\"organizationName\":\"组织111\",\"insDocumentTypeCode\":\"CCD\",\"insDocumentTypeName\":\"测试12\",\"inspectionSourceCode\":\"IQC|ZINV.PO_RECEIVE\",\"inspectionSourceName\":\"采购接收\",\"documentNum\":\"PR20221027000003\",\"documentLineNum\":\"10\",\"relatedPartyType\":\"CUSTOMER\",\"relatedPartyCode\":\"\",\"relatedPartyName\":\"大福公司\",\"operationCode\":\"\",\"operationName\":\"\",\"itemCode\":\"ITEM-0815-cp\",\"itemSkuCode\":\"\",\"lotNum\":\"\",\"inspectLot\":\"\",\"inspectionQty\":\"123\",\"inspectionPlanCode\":\"QMPLAN20220718000429\",\"sampleQty\":\"20\",\"applyInspector\":\"1n_dev\",\"applyInspectTime\":\"2022-12-07 00:00:00\",\"inspector\":\"1n_dev\",\"inspectTime\":\"2022-12-07 00:00:00\",\"inspectionResult\":\"OK\",\"remark\":\"备注\",\"sampleList\":[{\"sampleCode\":\"S000001\",\"snNum\":\"\",\"inspectionResult\":\"OK\",\"defectMeasureCode\":\"IQC_TEST\",\"inspectionItemList\":[{\"sequenceNum\":\"20\",\"measuredValue\":\"12\",\"judgementResultCode\":\"1111\",\"defectCode\":\"ceshi2\",\"remark\":\"测试啊\"}]}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
    "headers": {},
    "body": null,
    "status": "200",
    "message": "OK",
    "mediaType": null,
    "payload": "{\"result\":true}",
    "apiInfo": null,
    "targetResponseHeaders": {
        "date": "Fri, 23 Dec 2022 05:16:54 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
}