客供料退料新建 Create Cs Return

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.cs-return-open-api-controller.createProReturn

Body 参数application/json

csReturnNum

string

客供料退料单号

必需

"1. 租户下唯一（单号XXX已在系统中存在） 2. 验证编码格式：全大小写及数字，必须以字母、数字开头，可包含“-”、“”（单号XXX不符合要求，单据编码需以字母、数字开头，可包含“-”、“”）"

organizationId

string

组织ID

可选

根据行数据带出

customerId

string

客户ID

可选

根据行数据带出

executeBy

string

退料人

必需

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

returnTime

string

退料时间

必需

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

lineList

object

可选

sequenceNum

string

退料单行号

必需

对应sequence_num，同单据下不可重复（单据XXX的行号XX重复）；行号不可为空（单据XXX无行数据不可新建）

csrSourceDcTypeCode

string

来源单据类型编码

可选

"1、二者不可同时为空（单据XXX的行XX中无上游单据类型） 2、编码有值时以编码为准，编码无值时以名称为准，编码和名称需存在于值集ZINV.CSR_SOURCE_DC_TYPE的有效值和含义下（单据XXX行XX的来源单据类型不存在于系统中）"

csrSourceDcTypeName

string

来源单据类型名称

可选

csrSourceDcNum

string

来源单据号

必需

"1、不可为空（单据XXX行XX无来源单据号） 2、单据号需存在于来源单据类型下（单据XXX行XX中的来源单据号XX不存在于来源单类型下） 3、所有行来源单的客户、组织必须保持一致（单据XX中各行数据中来源单据对应的客户或组织未保持一致）"

csrSourceDcLineNum

string

来源单据行号

必需

"1、行号有值时，不可为空（单据XXX行XX无来源单据行号） 2、来源单行号需存在于来源单据号下（单据XXX行XX中的来源单据行号XX不存在于来源单号XXX下）"

itemCode

string

物料编码

必需

必输,对应item_id，验证物料存在于组织下（单据XXX行XX的物料XX不存在于组织XX中或已被失效），需与来源单行物料保持一致（单据XX行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）；需与上游单据行SKU保持一致（单据XX行XX的SKUXX与来源单据行中的SKUXX不一致）

returnQty

string

退料数量

必需

必输,对应tx_qty，正数

uomCode

string

退料单位编码

可选

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

uomName

string

退料单位名称

可选

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

warehouseCode

string

仓库编码

可选

不能同时为空（单据XX行XX物料XX的退料方式为直接入库，仓库不可为空），对应to_warehouse_id，校验仓库与组织是否匹配（单据XX行XX的仓库XXX不存在于组织XX中）

warehouseName

string

仓库名称

可选

locatorCode

string

货位编码

可选

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

locatorName

string

货位名称

可选

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

lotNumber

string

批次号

可选

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

remark

string

备注

可选

snNumList

string

序列号

可选

"若物料在组织下开启全程序列号管理或者出入序列管理，则必传，且传入的数量要与基本单位的退料数量一致，传入的是事务单位数量，需要转化为基本单位数量（单据XX行XX的序列号数量与退料数量不一致）；否则必须为空（单据XXX行XX的物料未开启序列号管控，不可有值）"

示例

{
    "headerParamMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"csReturnNum\":\"api-1-222221\",\"executeBy\":\"ZQA_03\",\"returnTime\":\"2023-06-07 14:12:01\",\"lineList\":[{\"sequenceNum\":\"10\",\"csrSourceDcTypeCode\":\"CS_RETURN_PICK\",\"csrSourceDcTypeName\":\"\",\"csrSourceDcNum\":\"CSRA20220713000001\",\"csrSourceDcLineNum\":\"10\",\"itemCode\":\"DF_HYL01\",\"itemSkuCode\":\"DF_HYL01_SKU\",\"returnQty\":\"1\",\"uomCode\":\"\",\"uomName\":\"个\",\"warehouseCode\":\"DFYHZU-ZYZGC\",\"warehouseName\":\"\",\"locatorCode\":\"\",\"locatorName\":\"大福一号组织-自有自管仓\",\"lotNumber\":\"20220713000008000009\",\"remark\":\"c-测试\",\"snNumList\":[{\"snNum\":\"20220713000004000005\"}]}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

客供料退料新建 Create Cs Return

请求参数

示例代码

返回响应