创建委外组件退料申请 Create Osc Return Appl

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.osc-return-appl-api-controller.createOscReturnAppl

Body 参数application/json

oscReturnApplNum

string

申请单号

必需

校验申请单号在一步云不存在，否则报错：申请单号XXX已存在，不允许重复

applyTypeCode

string

申请类型编码

可选

"1、编码和描述至少有一个必输，若同时有值，则取编码 2、校验值需存在于值集ZOSO.CS_RETURN_PICK_TYPE中，若不存在或已失效，则报错：申请单XXXX的申请类型编码XXX不为系统定义的申请类型。"

applyTypeMeaning

string

申请类型描述

可选

"1、编码和描述至少有一个必输，若同时有值，则取编码 2、校验值需存在于值集ZOSO.CS_RETURN_PICK_TYPE中，若不存在或已失效，则报错：申请单XXXX的申请类型编码XXX不为系统定义的申请类型。"

companyCode

string

公司编码

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的公司XXX不存在或已失效"

companyName

string

公司名称

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的公司XXX不存在或已失效"

organizationCode

string

收货组织编码

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的组织XXX不存在或已失效"

organizationName

string

收货组织名称

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的组织XXX不存在或已失效"

supplierCode

string

供应商编码

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的供应商XXX不存在或已失效"

supplierName

string

供应商名称

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在一步云存在且有效，否则报错：申请单XXXX对应的供应商XXX不存在或已失效"

warehouseCode

string

退料仓库编码

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在指定收货组织下存在且有效，否则报错：申请单XXXX对应的退料仓库XXX不存在于组织XXX下 3、编码或名称需为对应供应商的代管仓，否则报错：申请单XXX对应的退料仓库XXX不为供应商XXX的代管仓"

warehouseName

string

退料仓库名称

可选

"1、编码和名称至少有一个必输，若同时有值，则取编码 2、编码或名称需在指定收货组织下存在且有效，否则报错：申请单XXXX对应的退料仓库XXX不存在于组织XXX下 3、编码或名称需为对应供应商的代管仓，否则报错：申请单XXX对应的退料仓库XXX不为供应商XXX的代管仓"

supplierReturnAddress

string

供应商地址

可选

receivingAddress

string

收货地址

可选

returnReason

string

退料原因

可选

cooperateRemark

string

协同备注

可选

supplierReturnContactsName

string

供应商联系人

可选

supplierReturnContactsMobile

string

供应商联系人电话

可选

supplierReturnContactsEmail

string

供应商联系人邮箱

可选

supplierReturnContactsFax

string

供应商联系人传真

可选

contactsName

string

联系人

可选

contactsMobile

string

联系人电话

可选

contactsEmail

string

联系人邮箱

可选

contactsFax

string

联系人船长

可选

receiverName

string

收货人

可选

receiverMobile

string

收货人电话

可选

lineList

object

可选

oscReturnApplLineSeq

string

行号

可选

校验在指定申请单号下不存在，否则报错：申请单号XXX对应的行号XX已存在，不允许重复

itemCode

string

物料编码

必需

校验物料编码在一步云存在且有效，否则报错：申请单号XXX行号XX对应的物料编码XXX不存在或已失效

itemSkuCode

string

sku编码

可选

"1、校验SKU编码在一步云存在且有效，否则报错：申请单号XXX行号XX对应的SKU编码XXX不存在或已失效 2、若指定物料在一步云未开启SKU管理，则必须为空，否则返回报错"

returnQty

string

申请退料数量

必需

必须为大于0的数字

uomCode

string

退料单位编码

可选

编码和名称至少有一个必输，若同时有值，则取编码

uomName

string

退料单位名称

可选

编码和名称至少有一个必输，若同时有值，则取编码

adviseReturnDate

string

建议退料日期

必需

格式：YYYY-MM-DD

示例

{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"oscReturnApplNum\":\"OSRA20231212000001\",\"applyTypeCode\":\"\",\"applyTypeMeaning\":\"订单委外退料申请\",\"companyCode\":\"Co00000290\",\"companyName\":\"公司名称\",\"organizationCode\":\"test1\",\"organizationName\":\"组织名称\",\"supplierCode\":\"S00000002\",\"supplierName\":\"供应商名称\",\"warehouseCode\":\"ckkk\",\"warehouseName\":\"\",\"supplierReturnAddress\":\"供应商地址\",\"receivingAddress\":\"收货地址\",\"returnReason\":\"退料原因\",\"cooperateRemark\":\"协同备注\",\"supplierReturnContactsName\":\"联系人\",\"supplierReturnContactsMobile\":\"18519205220\",\"supplierReturnContactsEmail\":\"3912389@163.com\",\"supplierReturnContactsFax\":\"123901203910230\",\"contactsName\":\"上海人\",\"contactsMobile\":\"19210231991\",\"contactsEmail\":\"12938192389@qq.com\",\"contactsFax\":\"1239102390123\",\"receiverName\":\"收货人\",\"receiverMobile\":\"19519231923\",\"lineList\":[{\"oscReturnApplLineSeq\":\"10\",\"itemCode\":\"aazujian-2\",\"itemSkuCode\":\"\",\"returnQty\":\"1\",\"uomCode\":\"\",\"uomName\":\"个\",\"adviseReturnDate\":\"2023-12-21\"}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/hitf/v1/rest/invoke?namespace=HZERO&serverCode=ZOSC_OPEN_API&interfaceCode=zosc-open-api.osc-return-appl-api-controller.createOscReturnAppl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "payload": "[{\"oscReturnApplNum\":\"OSRA20231212000001\",\"applyTypeCode\":\"\",\"applyTypeMeaning\":\"订单委外退料申请\",\"companyCode\":\"Co00000290\",\"companyName\":\"公司名称\",\"organizationCode\":\"test1\",\"organizationName\":\"组织名称\",\"supplierCode\":\"S00000002\",\"supplierName\":\"供应商名称\",\"warehouseCode\":\"ckkk\",\"warehouseName\":\"\",\"supplierReturnAddress\":\"供应商地址\",\"receivingAddress\":\"收货地址\",\"returnReason\":\"退料原因\",\"cooperateRemark\":\"协同备注\",\"supplierReturnContactsName\":\"联系人\",\"supplierReturnContactsMobile\":\"18519205220\",\"supplierReturnContactsEmail\":\"3912389@163.com\",\"supplierReturnContactsFax\":\"123901203910230\",\"contactsName\":\"上海人\",\"contactsMobile\":\"19210231991\",\"contactsEmail\":\"12938192389@qq.com\",\"contactsFax\":\"1239102390123\",\"receiverName\":\"收货人\",\"receiverMobile\":\"19519231923\",\"lineList\":[{\"oscReturnApplLineSeq\":\"10\",\"itemCode\":\"aazujian-2\",\"itemSkuCode\":\"\",\"returnQty\":\"1\",\"uomCode\":\"\",\"uomName\":\"个\",\"adviseReturnDate\":\"2023-12-21\"}]}]"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}