采购退货订单变更 changePurchaseReturnOrder

请求参数

Query 参数

namespace

string

可选

示例值:

HZERO

serverCode

string

可选

示例值:

ZOSC_OPEN_API

interfaceCode

string

可选

示例值:

zosc-open-api.po-return-open-api-controller.changePurchaseReturnOrder

Body 参数application/json

purchaseReturnOrderNum

string

采购退货订单号

必需

租户下唯一

returnWarehouseCode

string

退货仓库编码

可选

"手工同时输入时，以编码为主采购退货订单不允许选择“客户处寄售”仓库（任何类型都不可以选择）寄售采购退货订单，头收货仓库限制只能选择类型为“供应商寄售”的仓库"

returnWarehouseName

string

退货仓库名称

可选

returnAddressDesc

string

退货地址描述

可选

supplierDemandOrder

string

供应商需求订单

可选

internalRemark

string

内部备注

可选

supplierContactName

string

供应商联系人

可选

supplierContactMobile

string

联系人电话

可选

supplierContactFax

string

联系人传真

可选

supplierContactEmail

string

联系人邮箱

可选

purchaserCode

string

采购员编码

可选

purchaserName

string

采购员名称

可选

手工同时输入时，以编码为主

purchaserMobile

string

采购员电话

可选

手工同时输入时，以编码为主

purchaseGroupName

string

采购组名称

可选

purchaseGroupCode

string

采购组编码

可选

purchaserFax

string

采购员传真

可选

purchaserEmail

string

采购员邮箱

可选

consigneeName

string

收货人名称

可选

consigneeMobile

string

收货人电话

可选

approvalStatusCode

string

审批状态编码

可选

"若输入，仅允许输入“已审批”/“未审批” 同时输入时，以编码为主"

approvalStatusName

string

审批状态名称

可选

"若输入，仅允许输入“已审批”/“未审批” 同时输入时，以编码为主"

cooperateStatusCode

string

协同状态编码

可选

非必填字段，同时输入时以编码为主

cooperateStatusName

string

协同状态名称

必需

非必填字段，同时输入时以编码为主

purchaseReturnOrderLineList

object

可选

purchaseOrderNum

string

采购订单号

必需

"新增类型为手工创建时，输入无效新增类型为“引用采购订单”时，必输，且需要校验输入的采购订单号是否符合引用条件，条件如下： 1、校验验同一采购退货订单下的所有行，关联的采购订单号对应的审批状态、协同状态是否符合要求 2、校验同一采购退货订单下的所有行，关联的采购订单号对应的“采购公司、采购单据类型（二级）、供应商、组织、币种”是否一致"

purchaseOrderLineNum

string

采购订单行号

可选

"新增类型为手工创建时，输入无效新增类型为“引用采购订单”时，必输，且需要校验输入的采购订单行号是否符合引用条件，条件如下： 1、采购订单行号是否存在"

lineNum

string

采购退货订单行号

必需

根据行号判断数据唯一

itemCode

string

物料编码

必需

"新增类型为“引用采购订单”时，根据行上输入的采购订单号+行号自动取值，输入无效新增类型为“手工创建”时，必输，物料信息根据code入参"

itemSkuCode

string

SKU编码

可选

"新增类型为“引用采购订单”时，根据行上输入的采购订单号+行号自动取值，输入无效新增类型为“手工创建”时，物料信息根据code入参，当物料启用SKU管理时必填"

ReturnQty

string

退货数量

必需

"字段必输仅当新增类型为“引用采购订单”时，提交审批需校验输入的数量是否超出原采购订单行的“可退货数量”"

UomCode

string

退货单位编码

可选

"新增类型为“引用采购订单”时，根据行上输入的采购订单号+行号自动取值，输入无效新增类型为“手工创建”时，字段必填且不能同时为空，同时输入时，以编码为主"

UomName

string

退货单位名称

可选

priceIncludingTax

string

含税单价

必需

字段必填

taxRateCode

string

税率代码

可选

"新增类型为“引用采购订单”时，根据行上输入的采购订单号+行号自动取值，输入无效新增类型为“手工创建”时，字段必填且不能同时为空，同时输入时，以编码为主必填字段"

taxRateDesc

string

税率描述

可选

suggestTakeDate

string

建议取货日期

必需

格式：yyyy-MM-dd

operation

string

操作类型

可选

"非必输，ADD新增，UPDATE修改若未输入值，则默认为“UPDATE修改”"

示例

{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "mediaType": null,
    "payload": "[{\"purchaseReturnOrderNum\":\"PRO20230105000007-OPEN\",\"createType\":\"manual\",\"purchaseReturnOrderTypeCode\":\"\",\"purchaseReturnOrderTypeDesc\":\"采购退货订单\",\"purchaseCompanyCode\":\"\",\"purchaseCompanyName\":\"上海甄一科技有限公司\",\"supplierCode\":\"\",\"supplierName\":\"甄一test公司D\",\"returnOrganizationCode\":\"code1\",\"returnOrganizationName\":\"组织111\",\"returnWarehouseCode\":\"test01\",\"returnWarehouseName\":\"\",\"returnAddressDesc\":\"山东滨州市博兴县庞家镇213123\",\"supplierAddressDesc\":\"河北承德市双滦区西地满族乡22\",\"currencyCode\":\"\",\"currencyName\":\"人民币\",\"supplierDemandOrder\":\"\",\"internalRemark\":\"测试\",\"supplierContactName\":\"\",\"supplierContactMobile\":\"\",\"supplierContactFax\":\"\",\"supplierContactEmail\":\"\",\"purchaserCode\":\"\",\"purchaserName\":\"小王\",\"purchaserMobile\":\"13816706169\",\"purchaserFax\":\"\",\"purchaserEmail\":\"12312311111@qq.com\",\"consigneeName\":\"1\",\"consigneeMobile\":\"1\",\"approvalStatusCode\":\"\",\"approvalStatusName\":\"\",\"cooperateStatusCode\":\"UNCONFIRMED\",\"cooperateStatusName\":\"无需协同\",\"createPurchaseReturnOrderLineList\":[{\"purchaseOrderNum\":\"PO202212150015\",\"purchaseOrderLineNum\":\"10\",\"lineNum\":\"10\",\"itemCode\":\"item1216\",\"itemSkuCode\":\"\",\"returnQty\":\"12\",\"uomCode\":\"cm*cm\",\"uomName\":\"平方厘米\",\"priceIncludingTax\":\"12\",\"taxRateCode\":\"\",\"taxRateDesc\":\"3%\",\"suggestTakeDate\":\"2023-01-05\"}]}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/hitf/v1/rest/invoke?namespace=HZERO&serverCode=ZOSC_OPEN_API&interfaceCode=zosc-open-api.po-return-open-api-controller.changePurchaseReturnOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "headerParamMap": {},
    "pathVariableMap": {},
    "requestParamMap": {},
    "bodyParamMap": {},
    "mediaType": null,
    "payload": "[{\"purchaseReturnOrderNum\":\"PRO20230105000007-OPEN\",\"createType\":\"manual\",\"purchaseReturnOrderTypeCode\":\"\",\"purchaseReturnOrderTypeDesc\":\"采购退货订单\",\"purchaseCompanyCode\":\"\",\"purchaseCompanyName\":\"上海甄一科技有限公司\",\"supplierCode\":\"\",\"supplierName\":\"甄一test公司D\",\"returnOrganizationCode\":\"code1\",\"returnOrganizationName\":\"组织111\",\"returnWarehouseCode\":\"test01\",\"returnWarehouseName\":\"\",\"returnAddressDesc\":\"山东滨州市博兴县庞家镇213123\",\"supplierAddressDesc\":\"河北承德市双滦区西地满族乡22\",\"currencyCode\":\"\",\"currencyName\":\"人民币\",\"supplierDemandOrder\":\"\",\"internalRemark\":\"测试\",\"supplierContactName\":\"\",\"supplierContactMobile\":\"\",\"supplierContactFax\":\"\",\"supplierContactEmail\":\"\",\"purchaserCode\":\"\",\"purchaserName\":\"小王\",\"purchaserMobile\":\"13816706169\",\"purchaserFax\":\"\",\"purchaserEmail\":\"12312311111@qq.com\",\"consigneeName\":\"1\",\"consigneeMobile\":\"1\",\"approvalStatusCode\":\"\",\"approvalStatusName\":\"\",\"cooperateStatusCode\":\"UNCONFIRMED\",\"cooperateStatusName\":\"无需协同\",\"createPurchaseReturnOrderLineList\":[{\"purchaseOrderNum\":\"PO202212150015\",\"purchaseOrderLineNum\":\"10\",\"lineNum\":\"10\",\"itemCode\":\"item1216\",\"itemSkuCode\":\"\",\"returnQty\":\"12\",\"uomCode\":\"cm*cm\",\"uomName\":\"平方厘米\",\"priceIncludingTax\":\"12\",\"taxRateCode\":\"\",\"taxRateDesc\":\"3%\",\"suggestTakeDate\":\"2023-01-05\"}]}]"
}'

采购退货订单变更 changePurchaseReturnOrder

请求参数

示例代码

返回响应