新建委外组件退料接收 Create osr Receive

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.osr-receive-open-controller.createOsrReceive

Body 参数application/json

osrReceiveNum

string

委外组件退料接收单号

必需

租户下唯一，验证编码格式：全大小写及数字，必须以字母、数字开头，可包含“-”、“”（单据编码需以字母、数字开头，可包含“-”、“”，单据XXX不符合此校验）

asnCode

string

送货通知单号

可选

"验证送货通知单号在租户下存在且状态为已提交、类型为委外组件退料送货通知 1、送货通知单不存在 2、送货通知单状态不为已提交 3、送货通知单类型不为委外组件退料送货通知"

organizationCode

string

接收组织编码

可选

不能同时为空(单据XXX的组织无值，无法创建成功)，获取对应的组织ID，对应organization_id（单据XXX的组织XXX不存在于系统中或已被失效）

organizationName

string

接收组织名称

可选

不能同时为空(单据XXX的组织无值，无法创建成功)，获取对应的组织ID，对应organization_id（单据XXX的组织XXX不存在于系统中或已被失效）

supplierCode

string

供应商编码

可选

不能同时为空（单据XXX的供应商无值，无法创建成功），获取对应的供应商ID，对应supplier_id，同时有值时以编码为准，供应商需与组织对应的公司存在交易关系（单据XXX的供应商XXX与接收组织XXX对应的公司XXX无交易关系或供应商XXX已被失效）

supplierName

string

供应商名称

可选

executeBy

string

接收人

必需

传入的是登录用户名，需要根据登录用户名获取用户ID,对应executed_by（接收人XXX不存在于系统中）

receiveTime

string

接收时间

必需

对应inv_tx_time,yyyy-MM-dd HH:mm:ss

lineList

object

可选

sequenceNum

string

接收单行号

可选

对应sequence_num，同单据下不可重复（单据XXX的行号XX重复）

asnLineSeq

string

送货通知单行号

可选

"1、送货通知单号有值且行号不为空时，必输（单据XXX存在送货通知，则行上送货通知行号不可为空） 2、校验填写的行号是否在送货通知单号下存在（单据XXX行XX中的送货通知单行号XX不存在与送货通知单下）"

itemCode

string

物料编码

可选

若行号不为空，必输,对应item_id，验证物料存在于组织下（单据XXX行XX的物料XX不存在于组织XX中或已被失效），若ASN行存在，则需与ASN行物料保持一致（单据XX行XX的物料XX与送货通知行XX中的物料XX不一致）

itemSkuCode

string

物料sku编码

可选

若物料不开启SKU管理则取默认SKUID，且传入的SKU编码必须为空（单据XXX行XX的物料XX未启用SKU管控），否则必传（单据XXX行XX的物料XX开启SKU管控，SKU不可为空），需为物料的有效SKU编码（单据XX行XX的SKU编码XX不为物料XX的有效SKU）；若ASN行存在，则需与ASN行SKU保持一致（单据XX行XX的SKUXX与送货通知行中的SKUXX不一致）

receiveQty

string

接收数量

可选

若行号不为空，必输,对应tx_qty，正数

uomCode

string

接收单位编码

可选

若行号不为空，不能同时为空,对应tx_uom_id，需为物料单位（单据XXX行XX的单位XX不为物料XX的有效单位）

uomName

string

接收单位名称

可选

若行号不为空，不能同时为空,对应tx_uom_id，需为物料单位（单据XXX行XX的单位XX不为物料XX的有效单位）

toWarehouseCode

string

目标仓库编码

可选

若行号不为空，且接收方式为直接入库（INVENTORY），则不能同时为空（单据XX行XX物料XX的接收方式为直接入库，目标仓库不可为空），否则必须为空（单据XX行XX物料XX的接收方式不为直接入库，目标仓库不可有值），对应to_warehouse_id，校验仓库与组织是否匹配（单据XX行XX的目标组织仓库XXX不存在于组织XX中）

toWarehouseName

string

目标仓库名称

可选

toLocatorCode

string

目标货位编码

可选

若目标仓库不为空，则目标货位不可为空（单据XX行XX的目标仓库有值，则目标货位必须有值），且目标货位需存在于目标仓库下（单据XX行XX的目标货位不为目标仓库的有效货位）

tolocatorName

string

目标货位名称

可选

lotNumber

string

批次号

可选

若行号不为空，且接收方式为直接入库（INVENTORY）、物料在组织下开启批次管控，则必输（单据XX行XX的物料开启批次管控，且接收方式为直接入库，则批次号不可为空），否则不可输入（单据XX行XX接收类型不为直接入库或物料未开启批次管控，故批次不可有值），且批次号必须为物料的有效批次（单据XX行XX的批次XX不为物料XX的有效批次），对应lot_num

qcReasonCode

string

质量原因编码

可选

若行号不为空，且接收方式为直接入库（INVENTORY），则不能同时为空（单据XX行XX对应的目标仓库开启强制质量原因，质量原因不可为空），需存在于业务快速编码质量原因中（单据XX行XX中的质量原因XXX不为业务快速编码入库质量原因的有效值）

qcRaesonDesc

string

质量原因描述

可选

sourceWarehouseCode

string

来源仓库编码

可选

若行号不为空，则不能同时为空（单据XX行XX中的来源仓库不可为空），对应warehouse_id，校验仓库与组织是否匹配（单据XX行XX的仓库XX不存在于组织XX下或已被失效），且为供应商的代管仓（单据XX行XX的仓库XX不为供应商XX的有效代管仓）

sourceWarehouseName

string

来源仓库描述

可选

sourceLocatorCode

string

来源货位编

可选

若来源仓库不为空，则来源货位不可为空（单据XX行XX的来源仓库有值，则来源货位必须有值），且来源货位需存在于来源仓库下（单据XX行XX的来源货位不为来源仓库的有效货位）

sourceLocatorName

string

来源货位描述

可选

remark

string

备注

可选

snNumList

object

可选

示例

{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"osrReceiveNum\":\"api-11123\",\"asnCode\":\"ASN443817651294781440\",\"organizationCode\":\"test1\",\"organizationName\":\"\",\"supplierCode\":\"openapi-214\",\"supplierName\":\"\",\"executeBy\":\"ZQA_10\",\"receiveTime\":\"2023-02-07 14:47:39\",\"lineList\":[{\"sequenceNum\":\"10\",\"asnLineSeq\":\"10\",\"itemCode\":\"aazujian-2\",\"itemSkuCode\":\"\",\"receiveQty\":\"1\",\"uomCode\":\"\",\"uomName\":\"个\",\"toWarehouseCode\":\"\",\"toWarehouseName\":\"\",\"toLocatorCode\":\"\",\"tolocatorName\":\"\",\"lotNumber\":\"\",\"qcReasonCode\":\"\",\"qcRaesonDesc\":\"\",\"sourceWarehouseCode\":\"1203012\",\"sourceWarehouseName\":\"\",\"sourceLocatorCode\":\"1203012\",\"sourceLocatorName\":\"\"}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

新建委外组件退料接收 Create osr Receive

请求参数

示例代码

返回响应