# 采购单
# 审核采购单
接口地址:/api/open/v2/purchase/order/audit
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"message": "",
"orderCode": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
auditParam | auditParam | body | true | RequestParameter«PurchaseOrderAuditParam» | RequestParameter«PurchaseOrderAuditParam» |
body | false | PurchaseOrderAuditParam | PurchaseOrderAuditParam | ||
message | 审核人意见 | false | string | ||
orderCode | 审核的采购单编码 | true | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 创建采购单
接口地址:/api/open/v2/purchase/order/create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"addressLabel": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"orderStatus": "",
"procurementOrderType": 0,
"purchaseCode": "",
"realDirectorCode": "",
"supplierCode": "",
"useNum": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«ProcurementOrderSaveParam» | RequestParameter«ProcurementOrderSaveParam» |
body | false | ProcurementOrderSaveParam | ProcurementOrderSaveParam | ||
addressLabel | 地址标签 | true | string | ||
comments | 备注 | false | string | ||
currency | 币种 | false | string | ||
deliveryDate | 交货日期 | false | integer | ||
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | false | string | ||
extraCharge | 额外收费项 | false | array | ExtraCharge | |
name | 额外收费项的名字 | true | string | ||
price | 额外收费项的金额 | true | number | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | false | boolean | ||
itemDetails | 物料信息 | true | array | ItemDetail | |
assistUnit | 物料辅助单位 | false | array | ItemAssistUnitDTO | |
assistToBaseRatioVal | 辅助-基本 | false | number | ||
baseToAssistRatioVal | 基本-辅助 | false | number | ||
seq | 序号 | false | integer | ||
unitId | 辅助单位id | false | integer | ||
unitName | 辅助单位名称 | false | string | ||
baseQuantity | 数量 | false | number | ||
comments | 备注 | false | string | ||
containTaxPrice | 含税单价 | true | number | ||
deliveryDate | 交货日期 | true | integer | ||
extendFields | 关联订单行的自定义字段 | false | array | OrderExtendField | |
name | false | string | |||
value | false | string | |||
extendedFields | 拓展自定义字段 | false | object | ||
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | false | string | ||
isRaw | 是否用原物料标记 | false | integer | ||
itemCode | 物料编码 | true | string | ||
itemName | 物料名字 | false | string | ||
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | false | string | ||
num | 行号 | true | integer | ||
outSourceItems | 委外转出的物料 | false | array | OutSourceItemDetail | |
itemCode | 转出物料编号 | true | string | ||
quantity | 物料转出数量 | true | number | ||
price | 去税单价 | false | number | ||
productExtendedFieldList | 采购单物料行自定义字段 | false | array | BaseExtendedField | |
fieldId | false | integer | |||
fieldName | false | string | |||
fieldType | false | integer | |||
id | false | integer | |||
tenantId | false | string | |||
value | false | string | |||
valueId | false | string | |||
purchaseRequisitionOrder | 采购申清单编码 | false | string | ||
purchaseUnitName | 采购单位 | false | string | ||
quantity | 数量 | true | number | ||
sort | 行号 | false | integer | ||
taxRate | 税率 | true | number | ||
warehouseBinCode | 仓库库位code | false | string | ||
warehouseBinName | 仓库库位名字 | false | string | ||
warehouseCode | 仓库code | false | string | ||
warehouseName | 仓库名字 | false | string | ||
orderStatus | 采购单状态(【BEFORE_COMMIT】:待提交,【ORDER_AUDIT】:待采购单审核,【ORDER_AUDITING】:审核中,【RECEIVING_AUDIT】:已审核待完成,【FINISH】:已完成,【INVALID】:已作废,【DELETE】:已删除,【AUDITED_UN_RECEIVE】:已审核未收货,【AUDITED_RECEIVING】:收货中,【AUDITED_RECEIVED】:已收货待确认),可用值:BEFORE_COMMIT,ORDER_AUDIT,ORDER_AUDITING,RECEIVING_AUDIT,FINISH,INVALID,DELETE,AUDITED_UN_RECEIVE,AUDITED_RECEIVING,AUDITED_RECEIVED | false | string | ||
procurementOrderType | 采购单或委外单标识:1为一般采购单;2为委外采购单(【1】:一般采购单,【2】:委外采购单) | false | integer | ||
purchaseCode | 采购单编码 | false | string | ||
realDirectorCode | 负责人 | false | string | ||
supplierCode | 供应商编码 | true | string | ||
useNum | 是否开启行号:1为开启;0为关闭 | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 创建或更新采购单
接口地址:/api/open/v2/purchase/order/createOrUpdate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"addressLabel": "",
"code": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"orderStatus": "",
"procurementOrderType": 0,
"purchaseCode": "",
"realDirectorCode": "",
"supplierCode": "",
"useNum": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«ProcurementOrderModifyParam» | RequestParameter«ProcurementOrderModifyParam» |
body | false | ProcurementOrderModifyParam | ProcurementOrderModifyParam | ||
addressLabel | 地址标签 | true | string | ||
code | 采购单编码 | true | string | ||
comments | 备注 | false | string | ||
currency | 币种 | false | string | ||
deliveryDate | 交货日期 | false | integer | ||
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | false | string | ||
extraCharge | 额外收费项 | false | array | ExtraCharge | |
name | 额外收费项的名字 | true | string | ||
price | 额外收费项的金额 | true | number | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | false | boolean | ||
itemDetails | 物料信息 | true | array | ItemDetail | |
assistUnit | 物料辅助单位 | false | array | ItemAssistUnitDTO | |
assistToBaseRatioVal | 辅助-基本 | false | number | ||
baseToAssistRatioVal | 基本-辅助 | false | number | ||
seq | 序号 | false | integer | ||
unitId | 辅助单位id | false | integer | ||
unitName | 辅助单位名称 | false | string | ||
baseQuantity | 数量 | false | number | ||
comments | 备注 | false | string | ||
containTaxPrice | 含税单价 | true | number | ||
deliveryDate | 交货日期 | true | integer | ||
extendFields | 关联订单行的自定义字段 | false | array | OrderExtendField | |
name | false | string | |||
value | false | string | |||
extendedFields | 拓展自定义字段 | false | object | ||
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | false | string | ||
isRaw | 是否用原物料标记 | false | integer | ||
itemCode | 物料编码 | true | string | ||
itemName | 物料名字 | false | string | ||
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | false | string | ||
num | 行号 | true | integer | ||
outSourceItems | 委外转出的物料 | false | array | OutSourceItemDetail | |
itemCode | 转出物料编号 | true | string | ||
quantity | 物料转出数量 | true | number | ||
price | 去税单价 | false | number | ||
productExtendedFieldList | 采购单物料行自定义字段 | false | array | BaseExtendedField | |
fieldId | false | integer | |||
fieldName | false | string | |||
fieldType | false | integer | |||
id | false | integer | |||
tenantId | false | string | |||
value | false | string | |||
valueId | false | string | |||
purchaseRequisitionOrder | 采购申清单编码 | false | string | ||
purchaseUnitName | 采购单位 | false | string | ||
quantity | 数量 | true | number | ||
sort | 行号 | false | integer | ||
taxRate | 税率 | true | number | ||
warehouseBinCode | 仓库库位code | false | string | ||
warehouseBinName | 仓库库位名字 | false | string | ||
warehouseCode | 仓库code | false | string | ||
warehouseName | 仓库名字 | false | string | ||
orderStatus | 采购单状态(【BEFORE_COMMIT】:待提交,【ORDER_AUDIT】:待采购单审核,【ORDER_AUDITING】:审核中,【RECEIVING_AUDIT】:已审核待完成,【FINISH】:已完成,【INVALID】:已作废,【DELETE】:已删除,【AUDITED_UN_RECEIVE】:已审核未收货,【AUDITED_RECEIVING】:收货中,【AUDITED_RECEIVED】:已收货待确认),可用值:BEFORE_COMMIT,ORDER_AUDIT,ORDER_AUDITING,RECEIVING_AUDIT,FINISH,INVALID,DELETE,AUDITED_UN_RECEIVE,AUDITED_RECEIVING,AUDITED_RECEIVED | false | string | ||
procurementOrderType | 采购单或委外单标识:1为一般采购单;2为委外采购单(【1】:一般采购单,【2】:委外采购单) | false | integer | ||
purchaseCode | 采购单编码 | false | string | ||
realDirectorCode | 负责人 | false | string | ||
supplierCode | 供应商编码 | true | string | ||
useNum | 是否开启行号:1为开启;0为关闭 | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 删除采购单
接口地址:/api/open/v2/purchase/order/delete
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": ""
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | false | RequestParameter«string» | RequestParameter«string» |
body | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 审核委外采购单
接口地址:/api/open/v2/purchase/order/outsource/audit
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"message": "",
"orderCode": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
auditParam | auditParam | body | true | RequestParameter«PurchaseOrderAuditParam» | RequestParameter«PurchaseOrderAuditParam» |
body | false | PurchaseOrderAuditParam | PurchaseOrderAuditParam | ||
message | 审核人意见 | false | string | ||
orderCode | 审核的采购单编码 | true | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 创建委外采购单
接口地址:/api/open/v2/purchase/order/outsource/create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"addressLabel": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"orderStatus": "",
"procurementOrderType": 0,
"purchaseCode": "",
"realDirectorCode": "",
"supplierCode": "",
"useNum": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«ProcurementOrderSaveParam» | RequestParameter«ProcurementOrderSaveParam» |
body | false | ProcurementOrderSaveParam | ProcurementOrderSaveParam | ||
addressLabel | 地址标签 | true | string | ||
comments | 备注 | false | string | ||
currency | 币种 | false | string | ||
deliveryDate | 交货日期 | false | integer | ||
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | false | string | ||
extraCharge | 额外收费项 | false | array | ExtraCharge | |
name | 额外收费项的名字 | true | string | ||
price | 额外收费项的金额 | true | number | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | false | boolean | ||
itemDetails | 物料信息 | true | array | ItemDetail | |
assistUnit | 物料辅助单位 | false | array | ItemAssistUnitDTO | |
assistToBaseRatioVal | 辅助-基本 | false | number | ||
baseToAssistRatioVal | 基本-辅助 | false | number | ||
seq | 序号 | false | integer | ||
unitId | 辅助单位id | false | integer | ||
unitName | 辅助单位名称 | false | string | ||
baseQuantity | 数量 | false | number | ||
comments | 备注 | false | string | ||
containTaxPrice | 含税单价 | true | number | ||
deliveryDate | 交货日期 | true | integer | ||
extendFields | 关联订单行的自定义字段 | false | array | OrderExtendField | |
name | false | string | |||
value | false | string | |||
extendedFields | 拓展自定义字段 | false | object | ||
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | false | string | ||
isRaw | 是否用原物料标记 | false | integer | ||
itemCode | 物料编码 | true | string | ||
itemName | 物料名字 | false | string | ||
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | false | string | ||
num | 行号 | true | integer | ||
outSourceItems | 委外转出的物料 | false | array | OutSourceItemDetail | |
itemCode | 转出物料编号 | true | string | ||
quantity | 物料转出数量 | true | number | ||
price | 去税单价 | false | number | ||
productExtendedFieldList | 采购单物料行自定义字段 | false | array | BaseExtendedField | |
fieldId | false | integer | |||
fieldName | false | string | |||
fieldType | false | integer | |||
id | false | integer | |||
tenantId | false | string | |||
value | false | string | |||
valueId | false | string | |||
purchaseRequisitionOrder | 采购申清单编码 | false | string | ||
purchaseUnitName | 采购单位 | false | string | ||
quantity | 数量 | true | number | ||
sort | 行号 | false | integer | ||
taxRate | 税率 | true | number | ||
warehouseBinCode | 仓库库位code | false | string | ||
warehouseBinName | 仓库库位名字 | false | string | ||
warehouseCode | 仓库code | false | string | ||
warehouseName | 仓库名字 | false | string | ||
orderStatus | 采购单状态(【BEFORE_COMMIT】:待提交,【ORDER_AUDIT】:待采购单审核,【ORDER_AUDITING】:审核中,【RECEIVING_AUDIT】:已审核待完成,【FINISH】:已完成,【INVALID】:已作废,【DELETE】:已删除,【AUDITED_UN_RECEIVE】:已审核未收货,【AUDITED_RECEIVING】:收货中,【AUDITED_RECEIVED】:已收货待确认),可用值:BEFORE_COMMIT,ORDER_AUDIT,ORDER_AUDITING,RECEIVING_AUDIT,FINISH,INVALID,DELETE,AUDITED_UN_RECEIVE,AUDITED_RECEIVING,AUDITED_RECEIVED | false | string | ||
procurementOrderType | 采购单或委外单标识:1为一般采购单;2为委外采购单(【1】:一般采购单,【2】:委外采购单) | false | integer | ||
purchaseCode | 采购单编码 | false | string | ||
realDirectorCode | 负责人 | false | string | ||
supplierCode | 供应商编码 | true | string | ||
useNum | 是否开启行号:1为开启;0为关闭 | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 作废采购单
接口地址:/api/open/v2/purchase/order/prohibit
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": ""
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | false | RequestParameter«string» | RequestParameter«string» |
body | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 查询采购单
接口地址:/api/open/v2/purchase/order/query
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"codeLike": "",
"codes": [],
"ids": []
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
queryParamRequestParameter | queryParamRequestParameter | body | true | RequestParameter«PurchaseQueryOrderParam» | RequestParameter«PurchaseQueryOrderParam» |
body | false | PurchaseQueryOrderParam | PurchaseQueryOrderParam | ||
codeLike | 按采购单编码模糊匹配 | false | string | ||
codes | 按采购单编码完全匹配 | false | array | string | |
ids | 按采购单id匹配 | false | array | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | ListResponse«PurchaseOrderDTO» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
data | ListResponseData«PurchaseOrderDTO» | ListResponseData«PurchaseOrderDTO» | |
list | array | PurchaseOrderDTO | |
address | 收料地址详情 | string | |
addressLabel | 地址编码 | string | |
comments | 备注 | string | |
currency | 币种 | string | |
deliveryDate | 交货日期 | integer | |
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | string | |
directorCode | 负责人编号 | string | |
extraCharge | 额外收费项 | array | ExtraCharge |
name | 额外收费项的名字 | string | |
price | 额外收费项的金额 | number | |
id | integer | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | boolean | |
itemDetails | 物料信息 | array | ItemDetail |
assistUnit | 物料辅助单位 | array | ItemAssistUnitDTO |
assistToBaseRatioVal | 辅助-基本 | number | |
baseToAssistRatioVal | 基本-辅助 | number | |
seq | 序号 | integer | |
unitId | 辅助单位id | integer | |
unitName | 辅助单位名称 | string | |
baseQuantity | 数量 | number | |
comments | 备注 | string | |
containTaxPrice | 含税单价 | number | |
deliveryDate | 交货日期 | integer | |
extendFields | 关联订单行的自定义字段 | array | OrderExtendField |
name | string | ||
value | string | ||
extendedFields | 拓展自定义字段 | object | |
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | string | |
isRaw | 是否用原物料标记 | integer | |
itemCode | 物料编码 | string | |
itemName | 物料名字 | string | |
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | string | |
num | 行号 | integer | |
outSourceItems | 委外转出的物料 | array | OutSourceItemDetail |
itemCode | 转出物料编号 | string | |
quantity | 物料转出数量 | number | |
price | 去税单价 | number | |
productExtendedFieldList | 采购单物料行自定义字段 | array | BaseExtendedField |
fieldId | integer | ||
fieldName | string | ||
fieldType | integer | ||
id | integer | ||
tenantId | string | ||
value | string | ||
valueId | string | ||
purchaseRequisitionOrder | 采购申清单编码 | string | |
purchaseUnitName | 采购单位 | string | |
quantity | 数量 | number | |
sort | 行号 | integer | |
taxRate | 税率 | number | |
warehouseBinCode | 仓库库位code | string | |
warehouseBinName | 仓库库位名字 | string | |
warehouseCode | 仓库code | string | |
warehouseName | 仓库名字 | string | |
orderStatus | 采购单状态(【-1】:待提交,【0】:待采购单审核,【1】:审核中,【2】:已审核待完成,【3】:已完成,【4】:已作废,【5】:已删除,【6】:已审核未收货,【7】:收货中,【8】:已收货待确认) | integer | |
procurementOrderType | 采购单类型(【1】:一般采购单,【2】:委外采购单) | integer | |
purchaseApplyCode | 采购申请单编码 | string | |
purchaseCode | 采购单编码 | string | |
source | 委外单来源(【1】:手动创建,【2】:生产委外需求) | integer | |
staffCode | 员工编码 | string | |
supplierCode | 供应商编码 | string | |
supplierName | 供应商名字 | string | |
workOrderCode | 生产单编码 | string | |
workOrderProcedureCode | 生产单工序编码 | string | |
workOrderProcedureName | 生产单工序名称 | string | |
message | string |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"address": "",
"addressLabel": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"directorCode": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"id": 0,
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"orderStatus": 0,
"procurementOrderType": 0,
"purchaseApplyCode": "",
"purchaseCode": "",
"source": 0,
"staffCode": "",
"supplierCode": "",
"supplierName": "",
"workOrderCode": "",
"workOrderProcedureCode": "",
"workOrderProcedureName": ""
}
]
},
"message": ""
}
# 查询采购单编码是否存在
接口地址:/api/open/v2/purchase/order/queryCodes
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"codeLike": "",
"codes": [],
"ids": []
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
queryParamRequestParameter | queryParamRequestParameter | body | true | RequestParameter«PurchaseQueryOrderParam» | RequestParameter«PurchaseQueryOrderParam» |
body | false | PurchaseQueryOrderParam | PurchaseQueryOrderParam | ||
codeLike | 按采购单编码模糊匹配 | false | string | ||
codes | 按采购单编码完全匹配 | false | array | string | |
ids | 按采购单id匹配 | false | array | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | ListResponse«string» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
data | ListResponseData«string» | ListResponseData«string» | |
list | array | string | |
message | string |
响应示例:
{
"code": 0,
"data": {
"list": []
},
"message": ""
}
# 更新采购单
接口地址:/api/open/v2/purchase/order/update
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"addressLabel": "",
"code": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"orderStatus": "",
"procurementOrderType": 0,
"purchaseCode": "",
"realDirectorCode": "",
"supplierCode": "",
"useNum": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«ProcurementOrderModifyParam» | RequestParameter«ProcurementOrderModifyParam» |
body | false | ProcurementOrderModifyParam | ProcurementOrderModifyParam | ||
addressLabel | 地址标签 | true | string | ||
code | 采购单编码 | true | string | ||
comments | 备注 | false | string | ||
currency | 币种 | false | string | ||
deliveryDate | 交货日期 | false | integer | ||
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | false | string | ||
extraCharge | 额外收费项 | false | array | ExtraCharge | |
name | 额外收费项的名字 | true | string | ||
price | 额外收费项的金额 | true | number | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | false | boolean | ||
itemDetails | 物料信息 | true | array | ItemDetail | |
assistUnit | 物料辅助单位 | false | array | ItemAssistUnitDTO | |
assistToBaseRatioVal | 辅助-基本 | false | number | ||
baseToAssistRatioVal | 基本-辅助 | false | number | ||
seq | 序号 | false | integer | ||
unitId | 辅助单位id | false | integer | ||
unitName | 辅助单位名称 | false | string | ||
baseQuantity | 数量 | false | number | ||
comments | 备注 | false | string | ||
containTaxPrice | 含税单价 | true | number | ||
deliveryDate | 交货日期 | true | integer | ||
extendFields | 关联订单行的自定义字段 | false | array | OrderExtendField | |
name | false | string | |||
value | false | string | |||
extendedFields | 拓展自定义字段 | false | object | ||
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | false | string | ||
isRaw | 是否用原物料标记 | false | integer | ||
itemCode | 物料编码 | true | string | ||
itemName | 物料名字 | false | string | ||
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | false | string | ||
num | 行号 | true | integer | ||
outSourceItems | 委外转出的物料 | false | array | OutSourceItemDetail | |
itemCode | 转出物料编号 | true | string | ||
quantity | 物料转出数量 | true | number | ||
price | 去税单价 | false | number | ||
productExtendedFieldList | 采购单物料行自定义字段 | false | array | BaseExtendedField | |
fieldId | false | integer | |||
fieldName | false | string | |||
fieldType | false | integer | |||
id | false | integer | |||
tenantId | false | string | |||
value | false | string | |||
valueId | false | string | |||
purchaseRequisitionOrder | 采购申清单编码 | false | string | ||
purchaseUnitName | 采购单位 | false | string | ||
quantity | 数量 | true | number | ||
sort | 行号 | false | integer | ||
taxRate | 税率 | true | number | ||
warehouseBinCode | 仓库库位code | false | string | ||
warehouseBinName | 仓库库位名字 | false | string | ||
warehouseCode | 仓库code | false | string | ||
warehouseName | 仓库名字 | false | string | ||
orderStatus | 采购单状态(【BEFORE_COMMIT】:待提交,【ORDER_AUDIT】:待采购单审核,【ORDER_AUDITING】:审核中,【RECEIVING_AUDIT】:已审核待完成,【FINISH】:已完成,【INVALID】:已作废,【DELETE】:已删除,【AUDITED_UN_RECEIVE】:已审核未收货,【AUDITED_RECEIVING】:收货中,【AUDITED_RECEIVED】:已收货待确认),可用值:BEFORE_COMMIT,ORDER_AUDIT,ORDER_AUDITING,RECEIVING_AUDIT,FINISH,INVALID,DELETE,AUDITED_UN_RECEIVE,AUDITED_RECEIVING,AUDITED_RECEIVED | false | string | ||
procurementOrderType | 采购单或委外单标识:1为一般采购单;2为委外采购单(【1】:一般采购单,【2】:委外采购单) | false | integer | ||
purchaseCode | 采购单编码 | false | string | ||
realDirectorCode | 负责人 | false | string | ||
supplierCode | 供应商编码 | true | string | ||
useNum | 是否开启行号:1为开启;0为关闭 | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 采购收货 API
# 废弃采购收料单
接口地址:/api/open/v2/purchase/receive/abandon
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"abandonReason": "",
"receiptOrderNumber": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«废弃采购单参数» | RequestParameter«废弃采购单参数» |
body | false | 废弃采购单参数 | 废弃采购单参数 | ||
abandonReason | 废弃原因 | true | string | ||
receiptOrderNumber | 采购单编号 | true | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResult |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
data | object | ||
ret | boolean |
响应示例:
{
"data": {},
"ret": true
}
# 创建采购收料单
接口地址:/api/open/v2/purchase/receive/create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": ""
}
],
"comments": "",
"currency": 0,
"deliveryNumber": "",
"enableLineNo": 0,
"logisticsCompany": "",
"logisticsNumber": "",
"priceType": 0,
"receiptOrderNumber": "",
"receiptOrderType": "",
"receiveInventory": [
{
"batchNumber": "",
"comment": "",
"excludeTaxPrice": 0,
"ifUseDefaultWarehouse": "1.使用,2/other 不使用",
"itemCode": "",
"num": 0,
"orderCode": "",
"originQrCodeStr": "",
"price": 0,
"purchaseOrderNum": 0,
"quantity": 0,
"taxRate": 0,
"warehouseBinName": "",
"warehouseCode": ""
}
],
"receiveTime": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«创建采购收货单参数» | RequestParameter«创建采购收货单参数» |
body | false | 创建采购收货单参数 | 创建采购收货单参数 | ||
attachment | 附件 | false | array | AttachmentParams | |
key | false | string | |||
name | false | string | |||
size | false | integer | |||
type | false | string | |||
comments | 备注 | false | string | ||
currency | 币种(【1】:人民币,【2】:美元,【3】:欧元,【4】:英镑,【5】:日元,【6】:港币,【7】:韩元,【9】:澳元,【10】:台币,【11】:印尼盾,【12】:印度卢比,【13】:马来西亚币,【14】:菲律宾比索,【15】:俄罗斯卢布,【16】:新加坡元,【17】:泰铢,【18】:越南盾) | false | integer | ||
deliveryNumber | 送货单号 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
logisticsCompany | 物流公司 | false | string | ||
logisticsNumber | 物流单号 | false | string | ||
priceType | 单价类型(【1】:含税,【2】:不含税) | false | integer | ||
receiptOrderNumber | 收料编号 | false | string | ||
receiptOrderType | 收料单类型(【PURCHASE_ORDER】:采购单,【OUTSOURCE_ORDER】:生产委外单,【INVENTORY_OUTSOURCE_ORDER】:库存委外单),可用值:PURCHASE_ORDER,OUTSOURCE_ORDER,INVENTORY_OUTSOURCE_ORDER | false | string | ||
receiveInventory | 收料详情 | false | array | ApplyReceiptProductCreateParam | |
batchNumber | 物料批次号 | false | string | ||
comment | 备注 | false | string | ||
excludeTaxPrice | 去税单价 | false | number | ||
ifUseDefaultWarehouse | 是否使用默认仓库与库位 | false | integer | ||
itemCode | 物料编码 | true | string | ||
num | 对应采购收料单行号 | false | integer | ||
orderCode | 采购单编号 | true | string | ||
originQrCodeStr | 外部码,用于与内部码进行关联 | false | string | ||
price | 含税单价 | false | number | ||
purchaseOrderNum | 对应采购单行号 | false | integer | ||
quantity | 入库数量 | true | number | ||
taxRate | 税率 | false | number | ||
warehouseBinName | 库位id | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
receiveTime | 收料时间 | true | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 删除采购收料单
接口地址:/api/open/v2/purchase/receive/delete
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"receiptOrderNumber": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«删除采购单参数» | RequestParameter«删除采购单参数» |
body | false | 删除采购单参数 | 删除采购单参数 | ||
receiptOrderNumber | 采购单编号 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResult |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
data | object | ||
ret | boolean |
响应示例:
{
"data": {},
"ret": true
}
# 采购收料入库撤销加删除
接口地址:/api/open/v2/purchase/receive/in/autoCancel
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"purchaseReceiveCode": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«PurchaseInAutoCancelParam» | RequestParameter«PurchaseInAutoCancelParam» |
body | false | PurchaseInAutoCancelParam | PurchaseInAutoCancelParam | ||
purchaseReceiveCode | 采购收料单编号 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 采购收料自动完成
接口地址:/api/open/v2/purchase/receive/in/autoCreate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": ""
}
],
"comments": "",
"currency": 0,
"deliveryNumber": "",
"enableLineNo": 0,
"logisticsCompany": "",
"logisticsNumber": "",
"priceType": 0,
"purchaseInProducts": [
{
"batchNumber": "",
"comment": "",
"ifUseDefaultWarehouse": "1.使用,2/other 不使用",
"itemCode": "",
"num": 0,
"orderCode": "",
"originQrCodeStr": "",
"purchaseOrderNum": 0,
"quantity": 0,
"snInfos": [
{
"assistQuantity": 0,
"quantity": 0,
"sn": ""
}
],
"warehouseBinName": "",
"warehouseCode": ""
}
],
"receiptOrderNumber": "",
"receiveTime": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«PurchaseInAutoCreateParam» | RequestParameter«PurchaseInAutoCreateParam» |
body | false | PurchaseInAutoCreateParam | PurchaseInAutoCreateParam | ||
attachment | 附件 | false | array | AttachmentParams | |
key | false | string | |||
name | false | string | |||
size | false | integer | |||
type | false | string | |||
comments | 备注 | false | string | ||
currency | 币种(【1】:人民币,【2】:美元,【3】:欧元,【4】:英镑,【5】:日元,【6】:港币,【7】:韩元,【9】:澳元,【10】:台币,【11】:印尼盾,【12】:印度卢比,【13】:马来西亚币,【14】:菲律宾比索,【15】:俄罗斯卢布,【16】:新加坡元,【17】:泰铢,【18】:越南盾) | false | integer | ||
deliveryNumber | 送货单号 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
logisticsCompany | 物流公司 | false | string | ||
logisticsNumber | 物流单号 | false | string | ||
priceType | 单价类型(【1】:含税,【2】:不含税) | false | integer | ||
purchaseInProducts | 物料详情 | true | array | PurchaseInProductAutoCreateParam | |
batchNumber | 物料批次号 | false | string | ||
comment | 备注 | false | string | ||
ifUseDefaultWarehouse | 是否使用默认仓库与库位 | false | integer | ||
itemCode | 物料编码 | true | string | ||
num | 对应采购收料单行号 | false | integer | ||
orderCode | 采购单编号 | true | string | ||
originQrCodeStr | 外部码,用于与内部码进行关联 | false | string | ||
purchaseOrderNum | 对应采购单行号 | false | integer | ||
quantity | 入库数量 | true | number | ||
snInfos | sn信息 | false | array | SnParam | |
assistQuantity | sn物料确认数量 | false | number | ||
quantity | sn物料确认数量 | false | number | ||
sn | sn编号 | false | string | ||
warehouseBinName | 库位id | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
receiptOrderNumber | 收料编号 | true | string | ||
receiveTime | 收料时间 | true | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 创建委外采购收料单
接口地址:/api/open/v2/purchase/receive/outsource/create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": ""
}
],
"comments": "",
"currency": 0,
"deliveryNumber": "",
"enableLineNo": 0,
"logisticsCompany": "",
"logisticsNumber": "",
"priceType": 0,
"receiptOrderNumber": "",
"receiptOrderType": "",
"receiveInventory": [
{
"batchNumber": "",
"comment": "",
"excludeTaxPrice": 0,
"ifUseDefaultWarehouse": "1.使用,2/other 不使用",
"itemCode": "",
"num": 0,
"orderCode": "",
"originQrCodeStr": "",
"price": 0,
"purchaseOrderNum": 0,
"quantity": 0,
"taxRate": 0,
"warehouseBinName": "",
"warehouseCode": ""
}
],
"receiveTime": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«创建采购收货单参数» | RequestParameter«创建采购收货单参数» |
body | false | 创建采购收货单参数 | 创建采购收货单参数 | ||
attachment | 附件 | false | array | AttachmentParams | |
key | false | string | |||
name | false | string | |||
size | false | integer | |||
type | false | string | |||
comments | 备注 | false | string | ||
currency | 币种(【1】:人民币,【2】:美元,【3】:欧元,【4】:英镑,【5】:日元,【6】:港币,【7】:韩元,【9】:澳元,【10】:台币,【11】:印尼盾,【12】:印度卢比,【13】:马来西亚币,【14】:菲律宾比索,【15】:俄罗斯卢布,【16】:新加坡元,【17】:泰铢,【18】:越南盾) | false | integer | ||
deliveryNumber | 送货单号 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
logisticsCompany | 物流公司 | false | string | ||
logisticsNumber | 物流单号 | false | string | ||
priceType | 单价类型(【1】:含税,【2】:不含税) | false | integer | ||
receiptOrderNumber | 收料编号 | false | string | ||
receiptOrderType | 收料单类型(【PURCHASE_ORDER】:采购单,【OUTSOURCE_ORDER】:生产委外单,【INVENTORY_OUTSOURCE_ORDER】:库存委外单),可用值:PURCHASE_ORDER,OUTSOURCE_ORDER,INVENTORY_OUTSOURCE_ORDER | false | string | ||
receiveInventory | 收料详情 | false | array | ApplyReceiptProductCreateParam | |
batchNumber | 物料批次号 | false | string | ||
comment | 备注 | false | string | ||
excludeTaxPrice | 去税单价 | false | number | ||
ifUseDefaultWarehouse | 是否使用默认仓库与库位 | false | integer | ||
itemCode | 物料编码 | true | string | ||
num | 对应采购收料单行号 | false | integer | ||
orderCode | 采购单编号 | true | string | ||
originQrCodeStr | 外部码,用于与内部码进行关联 | false | string | ||
price | 含税单价 | false | number | ||
purchaseOrderNum | 对应采购单行号 | false | integer | ||
quantity | 入库数量 | true | number | ||
taxRate | 税率 | false | number | ||
warehouseBinName | 库位id | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
receiveTime | 收料时间 | true | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 查询采购收料单
接口地址:/api/open/v2/purchase/receive/query
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"codeList": [],
"pagingParam": {
"length": 0,
"start": 0
}
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«采购收料单查询参数» | RequestParameter«采购收料单查询参数» |
body | false | 采购收料单查询参数 | 采购收料单查询参数 | ||
codeList | 采购收料单编码列表 | false | array | string | |
pagingParam | false | PagingParam | PagingParam | ||
length | false | integer | |||
start | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | ListPagingResponse«ReceiveInOrderProductDTO» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
data | ListPagingResponseData«ReceiveInOrderProductDTO» | ListPagingResponseData«ReceiveInOrderProductDTO» | |
length | integer(int32) | ||
list | array | ReceiveInOrderProductDTO | |
attachment | 附件 | array | AttachmentDTO |
key | string | ||
name | string | ||
size | integer | ||
type | string | ||
url | string | ||
comment | 收料单备注 | string | |
deliveryNumber | 供应商送货单号 | string | |
logisticsCompany | 物流公司名称 | string | |
logisticsNumber | 物流单号 | string | |
purchaseReceiptItemInfoList | 收料单物料详情 | array | PurchaseReceiptItemInfo |
batchCode | 收料申请批次 | string | |
comment | 行备注 | string | |
itemCode | 物料编码 | string | |
itemName | 物料名称 | string | |
num | 采购单行号 | integer | |
purchaseOrderCode | 采购单编码 | string | |
purchaseOrderDeadLine | 供应商承诺日 | integer | |
purchaseQty | 收料数 | number | |
receivedQty | 入库数 | number | |
status | 物料状态 | integer | |
warehouseBinName | 仓库库位名称 | string | |
warehouseCode | 仓库编码 | string | |
warehouseName | 仓库名称 | string | |
receiptOrderCode | 采购单编码 | string | |
receiptTime | 收料时间 | integer | |
status | 收料单状态(【NOT_START】:未开始,【PROCESSING】:进行中,【FINISH】:已完成,【ABANDON】:已作废),可用值:NOT_START,PROCESSING,FINISH,ABANDON | string | |
supplierCode | 供应商编码 | string | |
supplierName | 供应商姓名 | string | |
type | 采购单类型(【PURCHASE_ORDER】:采购单,【OUTSOURCE_ORDER】:生产委外单,【INVENTORY_OUTSOURCE_ORDER】:库存委外单),可用值:PURCHASE_ORDER,OUTSOURCE_ORDER,INVENTORY_OUTSOURCE_ORDER | string | |
recordsTotal | integer(int32) | ||
start | integer(int32) | ||
message | string |
响应示例:
{
"code": 0,
"data": {
"length": 0,
"list": [
{
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": "",
"url": ""
}
],
"comment": "",
"deliveryNumber": "",
"logisticsCompany": "",
"logisticsNumber": "",
"purchaseReceiptItemInfoList": [
{
"batchCode": "",
"comment": "",
"itemCode": "",
"itemName": "",
"num": 0,
"purchaseOrderCode": "",
"purchaseOrderDeadLine": 0,
"purchaseQty": 0,
"receivedQty": 0,
"status": 0,
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"receiptOrderCode": "",
"receiptTime": 0,
"status": "",
"supplierCode": "",
"supplierName": "",
"type": ""
}
],
"recordsTotal": 0,
"start": 0
},
"message": ""
}
# 查询采购收料单详情
接口地址:/api/open/v2/purchase/receive/query/detail
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«采购收料单详情查询参数» | RequestParameter«采购收料单详情查询参数» |
body | false | 采购收料单详情查询参数 | 采购收料单详情查询参数 | ||
code | 采购收料单编码 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | EntityResponse«ReceiveOrderDetailDTO» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
data | EntityResponseData«ReceiveOrderDetailDTO» | EntityResponseData«ReceiveOrderDetailDTO» | |
entity | ReceiveOrderDetailDTO | ReceiveOrderDetailDTO | |
attachment | 附件 | array | AttachmentDTO |
key | string | ||
name | string | ||
size | integer | ||
type | string | ||
url | string | ||
comment | 备注 | string | |
deliveryNumber | 送货单号 | string | |
logisticsCompany | 物流公司 | string | |
logisticsNumber | 物流单号 | string | |
number | 收料单号 | string | |
procurementReceiptType | 收料单类型 1采购收料 2为生产委外 3为直接委外 | string | |
procurementReceiptTypeId | 收料单类型 1采购收料 2为生产委外 3为直接委外 | integer | |
receiveInventory | 收料详情 | array | ReceiptRecord |
attributes | 规格 | object | |
comment | 行备注 | string | |
itemCode | 物料编码 | string | |
itemName | 物料姓名 | string | |
num | 行号 | integer | |
orderCode | 采购单编号 | string | |
qualifiedQuantity | 入库数量 | number | |
quantity | 收料数量 | number | |
warehouseBinCode | 库位编号 | string | |
warehouseBinName | 库位id | string | |
warehouseCode | 仓库编码 | string | |
warehouseName | 仓库名 | string | |
receiveTime | 收料时间 | integer | |
supplierName | 供应商 | string | |
message | string |
响应示例:
{
"code": 0,
"data": {
"entity": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": "",
"url": ""
}
],
"comment": "",
"deliveryNumber": "",
"logisticsCompany": "",
"logisticsNumber": "",
"number": "",
"procurementReceiptType": "",
"procurementReceiptTypeId": 0,
"receiveInventory": [
{
"attributes": {},
"comment": "",
"itemCode": "",
"itemName": "",
"num": 0,
"orderCode": "",
"qualifiedQuantity": 0,
"quantity": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"receiveTime": 0,
"supplierName": ""
}
},
"message": ""
}
# 修改采购收料单
接口地址:/api/open/v2/purchase/receive/update
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": ""
}
],
"comments": "",
"currency": 0,
"deliveryNumber": "",
"enableLineNo": 0,
"logisticsCompany": "",
"logisticsNumber": "",
"priceType": 0,
"receiptOrderNumber": "",
"receiptOrderType": "",
"receiveInventory": [
{
"batchNumber": "",
"comment": "",
"excludeTaxPrice": 0,
"ifUseDefaultWarehouse": "1.使用,2/other 不使用",
"itemCode": "",
"num": 0,
"orderCode": "",
"originQrCodeStr": "",
"price": 0,
"purchaseOrderNum": 0,
"quantity": 0,
"taxRate": 0,
"warehouseBinName": "",
"warehouseCode": ""
}
],
"receiveTime": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«创建采购收货单参数» | RequestParameter«创建采购收货单参数» |
body | false | 创建采购收货单参数 | 创建采购收货单参数 | ||
attachment | 附件 | false | array | AttachmentParams | |
key | false | string | |||
name | false | string | |||
size | false | integer | |||
type | false | string | |||
comments | 备注 | false | string | ||
currency | 币种(【1】:人民币,【2】:美元,【3】:欧元,【4】:英镑,【5】:日元,【6】:港币,【7】:韩元,【9】:澳元,【10】:台币,【11】:印尼盾,【12】:印度卢比,【13】:马来西亚币,【14】:菲律宾比索,【15】:俄罗斯卢布,【16】:新加坡元,【17】:泰铢,【18】:越南盾) | false | integer | ||
deliveryNumber | 送货单号 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
logisticsCompany | 物流公司 | false | string | ||
logisticsNumber | 物流单号 | false | string | ||
priceType | 单价类型(【1】:含税,【2】:不含税) | false | integer | ||
receiptOrderNumber | 收料编号 | false | string | ||
receiptOrderType | 收料单类型(【PURCHASE_ORDER】:采购单,【OUTSOURCE_ORDER】:生产委外单,【INVENTORY_OUTSOURCE_ORDER】:库存委外单),可用值:PURCHASE_ORDER,OUTSOURCE_ORDER,INVENTORY_OUTSOURCE_ORDER | false | string | ||
receiveInventory | 收料详情 | false | array | ApplyReceiptProductCreateParam | |
batchNumber | 物料批次号 | false | string | ||
comment | 备注 | false | string | ||
excludeTaxPrice | 去税单价 | false | number | ||
ifUseDefaultWarehouse | 是否使用默认仓库与库位 | false | integer | ||
itemCode | 物料编码 | true | string | ||
num | 对应采购收料单行号 | false | integer | ||
orderCode | 采购单编号 | true | string | ||
originQrCodeStr | 外部码,用于与内部码进行关联 | false | string | ||
price | 含税单价 | false | number | ||
purchaseOrderNum | 对应采购单行号 | false | integer | ||
quantity | 入库数量 | true | number | ||
taxRate | 税率 | false | number | ||
warehouseBinName | 库位id | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
receiveTime | 收料时间 | true | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResult |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
data | object | ||
ret | boolean |
响应示例:
{
"data": {},
"ret": true
}
# 采购检验 API
# 作废收料检验单
接口地址:/api/open/v2/purchase/qc/abandon
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"abandonReason": "",
"code": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«ReceiptInspectionAbandonParam» | RequestParameter«ReceiptInspectionAbandonParam» |
body | false | ReceiptInspectionAbandonParam | ReceiptInspectionAbandonParam | ||
abandonReason | 作废原因 | false | string | ||
code | 检验单编号 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 创建收料检验单
接口地址:/api/open/v2/purchase/qc/create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": "",
"products": [
{
"batchNumber": "",
"comments": "",
"departmentCodes": [],
"inspectionMethod": 0,
"inspectionScheme": "",
"inspectionStandard": "",
"itemCode": "",
"quantity": 0,
"receiptCode": "",
"staffCodes": []
}
]
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«创建来料检验单参数» | RequestParameter«创建来料检验单参数» |
body | false | 创建来料检验单参数 | 创建来料检验单参数 | ||
code | 检验单号 | false | string | ||
products | 待检验物料 | true | array | InspectionProduct | |
batchNumber | 批次号 | false | string | ||
comments | 备注 | false | string | ||
departmentCodes | 检验部门编码,当检验人为空时启用,如果都为空则使用物料默认 | false | array | string | |
inspectionMethod | 检验方式:1为普通,2为AQL,为空则使用物料默认检验方式(【0】:无,【1】:普通,【2】:AQL) | false | integer | ||
inspectionScheme | 检验方案,为空则使用物料默认检验方案 | false | string | ||
inspectionStandard | 检验规范,为空则使用物料默认检验规范 | false | string | ||
itemCode | 物料编码 | true | string | ||
quantity | 待检验数量 | true | number | ||
receiptCode | 收料单号 | true | string | ||
staffCodes | 检验人编码,优先于检验部门 | false | array | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 删除收料检验单
接口地址:/api/open/v2/purchase/qc/delete
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": ""
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«string» | RequestParameter«string» |
body | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 反审收料检验单
接口地址:/api/open/v2/purchase/qc/workFlow
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": "",
"message": "",
"status": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«ReceiptInspectionWorkFlowParam» | RequestParameter«ReceiptInspectionWorkFlowParam» |
body | false | ReceiptInspectionWorkFlowParam | ReceiptInspectionWorkFlowParam | ||
code | 检验单编号 | false | string | ||
message | 审核人意见 | false | string | ||
status | 审核人结论 1:通过 2:驳回 3:撤回 4:重审(【1】:通过,【2】:驳回,【3】:撤回,【4】:重审) | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 采购申请 API
# 确认采购申请任务
接口地址:/api/open/v2/purchase/purchaseRequisition/confirm
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": "",
"records": [
{
"itemCode": "",
"quantity": 0
}
]
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«PurchaseRequisitionConfirmParams» | RequestParameter«PurchaseRequisitionConfirmParams» |
body | false | PurchaseRequisitionConfirmParams | PurchaseRequisitionConfirmParams | ||
code | 采购申请单编码 | true | string | ||
records | 采购申请单确认明细 | true | array | Record | |
itemCode | 物料编码 | true | string | ||
quantity | 确认数量 | true | number |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 查询采购申请任务
接口地址:/api/open/v2/purchase/purchaseRequisition/query
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«PurchaseRequisitionQueryParams» | RequestParameter«PurchaseRequisitionQueryParams» |
body | false | PurchaseRequisitionQueryParams | PurchaseRequisitionQueryParams | ||
code | 采购申请编码 | true | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | ListPagingResponse«List«PurchaseRequisitionOrder»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
data | ListPagingResponseData«List«PurchaseRequisitionOrder»» | ListPagingResponseData«List«PurchaseRequisitionOrder»» | |
length | integer(int32) | ||
list | array | PurchaseRequisitionOrder | |
code | 采购清单编码 | string | |
comments | 备注 | string | |
createTime | 申请单创建时间 | integer | |
extendedFields | 扩展自定义筛选参数 | array | PurchaseRequisitionExtendedField |
name | 自定义字段名 | string | |
value | 自定义字段值 | string | |
records | 申请单明细 | array | PurchaseRequisitionOrderRecord |
confirmQuantity | 已确认数量 | number | |
deadline | 预计交期 | integer | |
extendedFields | 扩展自定义筛选参数 | array | PurchaseRequisitionExtendedField |
name | 自定义字段名 | string | |
value | 自定义字段值 | string | |
itemCode | 物料编码 | string | |
itemUnit | 物料单位 | string | |
latestCreateOrderDate | 最新创建单据日期 | integer | |
procedureCode | 工序编号 | string | |
procedureName | 工序名称 | string | |
quantity | 申请数量 | number | |
sourceOrderNumber | 源单号 | string | |
supplierCode | 供应商编码 | string | |
staffCode | 申请员工编码 | string | |
status | 采购申请状态(【0】:待提交,【1】:审核中,【2】:已审核,【3】:已完成) | integer | |
type | 采购申请类型(【0】:仓库,【1】:物料需求计划,【2】:新建,【3】:生产单,【4】:委外物料需求计划 ) | integer | |
recordsTotal | integer(int32) | ||
start | integer(int32) | ||
message | string |
响应示例:
{
"code": 0,
"data": {
"length": 0,
"list": [
{
"code": "",
"comments": "",
"createTime": 0,
"extendedFields": [
{
"name": "",
"value": ""
}
],
"records": [
{
"confirmQuantity": 0,
"deadline": 0,
"extendedFields": [
{
"name": "",
"value": ""
}
],
"itemCode": "",
"itemUnit": "",
"latestCreateOrderDate": 0,
"procedureCode": "",
"procedureName": "",
"quantity": 0,
"sourceOrderNumber": "",
"supplierCode": ""
}
],
"staffCode": "",
"status": 0,
"type": 0
}
],
"recordsTotal": 0,
"start": 0
},
"message": ""
}
# 采购退货 API
# 创建采购退货单
接口地址:/api/open/v2/purchase/return/Create
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"comments": "",
"enableLineNo": 0,
"receiptNumber": "",
"records": [
{
"assistQuantity": 0,
"batchNumber": "",
"comment": "",
"configurableSpecs": [
{
"code": "",
"name": "",
"value": ""
}
],
"executionOrderNumber": "",
"inQuality": 0,
"itemCode": "",
"locationCode": "",
"num": 0,
"outQuality": 0,
"quantity": 0,
"receiptNum": 0,
"snInfos": [
{
"assistQuantity": 0,
"quantity": 0,
"sn": ""
}
],
"warehouseCode": ""
}
],
"returnNumber": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«ReceiptReturnParam» | RequestParameter«ReceiptReturnParam» |
body | false | ReceiptReturnParam | ReceiptReturnParam | ||
comments | 备注 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
receiptNumber | 收料单编码 | false | string | ||
records | 退料记录 | false | array | TaskConfirmParamsRecord | |
assistQuantity | 辅助单位数量 | false | number | ||
batchNumber | 批次编码 | false | string | ||
comment | 申请单行-备注信息 | false | string | ||
configurableSpecs | 可配置物料属性 | false | array | ConfigurableSpecificationConfirmParam | |
code | 属性编码 | false | string | ||
name | 属性名称 | false | string | ||
value | 属性值 | false | string | ||
executionOrderNumber | 任务单号 | false | string | ||
inQuality | 入库品质(【0】:合格品,【1】:次品) | false | integer | ||
itemCode | 物料编码 | true | string | ||
locationCode | 库位编码 | false | string | ||
num | 行号 | false | integer | ||
outQuality | 出库品质(【0】:合格品,【1】:次品) | false | integer | ||
quantity | 确认数量 | true | number | ||
receiptNum | 收料单行号 | false | integer | ||
snInfos | sn信息 | false | array | SnParam | |
assistQuantity | sn物料确认数量 | false | number | ||
quantity | sn物料确认数量 | false | number | ||
sn | sn编号 | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
returnNumber | 退料单编码 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 自动创建退料单(执行至入库)
接口地址:/api/open/v2/purchase/return/autoCreate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"comments": "",
"enableLineNo": 0,
"receiptNumber": "",
"records": [
{
"assistQuantity": 0,
"batchNumber": "",
"comment": "",
"configurableSpecs": [
{
"code": "",
"name": "",
"value": ""
}
],
"executionOrderNumber": "",
"inQuality": 0,
"itemCode": "",
"locationCode": "",
"num": 0,
"outQuality": 0,
"quantity": 0,
"receiptNum": 0,
"snInfos": [
{
"assistQuantity": 0,
"quantity": 0,
"sn": ""
}
],
"warehouseCode": ""
}
],
"returnNumber": ""
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
parameter | parameter | body | true | RequestParameter«ReceiptReturnParam» | RequestParameter«ReceiptReturnParam» |
body | false | ReceiptReturnParam | ReceiptReturnParam | ||
comments | 备注 | false | string | ||
enableLineNo | 是否开启行号(【1】:是,【0】:否) | false | integer | ||
receiptNumber | 收料单编码 | false | string | ||
records | 退料记录 | false | array | TaskConfirmParamsRecord | |
assistQuantity | 辅助单位数量 | false | number | ||
batchNumber | 批次编码 | false | string | ||
comment | 申请单行-备注信息 | false | string | ||
configurableSpecs | 可配置物料属性 | false | array | ConfigurableSpecificationConfirmParam | |
code | 属性编码 | false | string | ||
name | 属性名称 | false | string | ||
value | 属性值 | false | string | ||
executionOrderNumber | 任务单号 | false | string | ||
inQuality | 入库品质(【0】:合格品,【1】:次品) | false | integer | ||
itemCode | 物料编码 | true | string | ||
locationCode | 库位编码 | false | string | ||
num | 行号 | false | integer | ||
outQuality | 出库品质(【0】:合格品,【1】:次品) | false | integer | ||
quantity | 确认数量 | true | number | ||
receiptNum | 收料单行号 | false | integer | ||
snInfos | sn信息 | false | array | SnParam | |
assistQuantity | sn物料确认数量 | false | number | ||
quantity | sn物料确认数量 | false | number | ||
sn | sn编号 | false | string | ||
warehouseCode | 仓库编码 | false | string | ||
returnNumber | 退料单编码 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 委外收料单
# 创建工序委外采购单-自动完成
接口地址:/api/open/v2/outSource/receive/in/autocreate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"attachment": [
{
"key": "",
"name": "",
"size": 0,
"type": ""
}
],
"comments": "",
"deliveryNumber": "",
"logisticsCompany": "",
"logisticsNumber": "",
"receiptOrderNumber": "",
"records": [
{
"batchNumber": "",
"comment": "",
"ifUseDefaultWarehouse": "1 使用,2 不使用",
"itemCode": "",
"orderCode": "",
"quantity": 0,
"sort": 0,
"warehouseBinName": "",
"warehouseCode": ""
}
]
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«OutSourceReceiptInParam» | RequestParameter«OutSourceReceiptInParam» |
body | false | OutSourceReceiptInParam | OutSourceReceiptInParam | ||
attachment | 附件 | false | array | AttachmentParams | |
key | false | string | |||
name | false | string | |||
size | false | integer | |||
type | false | string | |||
comments | 备注 | false | string | ||
deliveryNumber | 送货单号 | false | string | ||
logisticsCompany | 物流公司 | false | string | ||
logisticsNumber | 物流单号 | false | string | ||
receiptOrderNumber | 收料编号 | false | string | ||
records | false | array | OutSourceReceiptInRecord | ||
batchNumber | 物料批次号 | false | string | ||
comment | 备注 | false | string | ||
ifUseDefaultWarehouse | 是否使用默认仓库与库位 | false | integer | ||
itemCode | 物料编码 | true | string | ||
orderCode | 采购单编号 | true | string | ||
quantity | 入库数量 | true | number | ||
sort | 对应采购单行号 | false | integer | ||
warehouseBinName | 库位id | false | string | ||
warehouseCode | 仓库编码 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 委外转出单
# 工序委外出库-自动完成接口
接口地址:/api/open/v2/outSource/transfer/out/autoCreate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"addressLabel": "",
"comments": "",
"currency": "",
"deliveryDate": 0,
"deliveryDateType": "",
"extraCharge": [
{
"name": "",
"price": 0
}
],
"isContainTax": true,
"itemDetails": [
{
"assistUnit": [
{
"assistToBaseRatioVal": 0,
"baseToAssistRatioVal": 0,
"seq": 0,
"unitId": 0,
"unitName": ""
}
],
"baseQuantity": 0,
"comments": "",
"containTaxPrice": 0,
"deliveryDate": 0,
"extendFields": [
{
"name": "",
"value": ""
}
],
"extendedFields": {},
"handleStatus": "",
"isRaw": 0,
"itemCode": "",
"itemName": "",
"newReceiveStatus": "",
"num": 0,
"outSourceItems": [
{
"itemCode": "",
"quantity": 0
}
],
"price": 0,
"productExtendedFieldList": [
{
"fieldId": 0,
"fieldName": "",
"fieldType": 0,
"id": 0,
"tenantId": "",
"value": "",
"valueId": ""
}
],
"purchaseRequisitionOrder": "",
"purchaseUnitName": "",
"quantity": 0,
"sort": 0,
"taxRate": 0,
"warehouseBinCode": "",
"warehouseBinName": "",
"warehouseCode": "",
"warehouseName": ""
}
],
"procurementOrderType": 0,
"purchaseCode": "",
"realDirectorCode": "",
"supplierCode": "",
"useNum": 0
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«OutSourceTransferOutAutoCreateParams» | RequestParameter«OutSourceTransferOutAutoCreateParams» |
body | false | OutSourceTransferOutAutoCreateParams | OutSourceTransferOutAutoCreateParams | ||
addressLabel | 地址标签 | true | string | ||
comments | 备注 | false | string | ||
currency | 币种 | false | string | ||
deliveryDate | 交货日期 | false | integer | ||
deliveryDateType | 交期类型(【UNIFIED_DELIVERY】:统一交期,【MULTIPLE_DELIVERY】:多交期),可用值:UNIFIED_DELIVERY,MULTIPLE_DELIVERY | false | string | ||
extraCharge | 额外收费项 | false | array | ExtraCharge | |
name | 额外收费项的名字 | true | string | ||
price | 额外收费项的金额 | true | number | ||
isContainTax | 单价类型 是否含税(true为含税 false为不含税)默认为含税 | false | boolean | ||
itemDetails | 物料信息 | true | array | ItemDetail | |
assistUnit | 物料辅助单位 | false | array | ItemAssistUnitDTO | |
assistToBaseRatioVal | 辅助-基本 | false | number | ||
baseToAssistRatioVal | 基本-辅助 | false | number | ||
seq | 序号 | false | integer | ||
unitId | 辅助单位id | false | integer | ||
unitName | 辅助单位名称 | false | string | ||
baseQuantity | 数量 | false | number | ||
comments | 备注 | false | string | ||
containTaxPrice | 含税单价 | true | number | ||
deliveryDate | 交货日期 | true | integer | ||
extendFields | 关联订单行的自定义字段 | false | array | OrderExtendField | |
name | false | string | |||
value | false | string | |||
extendedFields | 拓展自定义字段 | false | object | ||
handleStatus | 处理状态(【NOT_STARTED】:未开始,【IN_PROGRESS】:进行中,【MANUAL_FINISH】:已完成,【AUTO_FINISH】:已完成),可用值:NOT_STARTED,IN_PROGRESS,MANUAL_FINISH,AUTO_FINISH | false | string | ||
isRaw | 是否用原物料标记 | false | integer | ||
itemCode | 物料编码 | true | string | ||
itemName | 物料名字 | false | string | ||
newReceiveStatus | 新的收料状态(【NOT_RECEIVE】:未收料,【PART_RECEIVE】:部分收料,【ALL_RECEIVE】:全部收料,【OVER_RECEIVE】:超额收料),可用值:NOT_RECEIVE,PART_RECEIVE,ALL_RECEIVE,OVER_RECEIVE | false | string | ||
num | 行号 | true | integer | ||
outSourceItems | 委外转出的物料 | false | array | OutSourceItemDetail | |
itemCode | 转出物料编号 | true | string | ||
quantity | 物料转出数量 | true | number | ||
price | 去税单价 | false | number | ||
productExtendedFieldList | 采购单物料行自定义字段 | false | array | BaseExtendedField | |
fieldId | false | integer | |||
fieldName | false | string | |||
fieldType | false | integer | |||
id | false | integer | |||
tenantId | false | string | |||
value | false | string | |||
valueId | false | string | |||
purchaseRequisitionOrder | 采购申清单编码 | false | string | ||
purchaseUnitName | 采购单位 | false | string | ||
quantity | 数量 | true | number | ||
sort | 行号 | false | integer | ||
taxRate | 税率 | true | number | ||
warehouseBinCode | 仓库库位code | false | string | ||
warehouseBinName | 仓库库位名字 | false | string | ||
warehouseCode | 仓库code | false | string | ||
warehouseName | 仓库名字 | false | string | ||
procurementOrderType | 采购单或委外单标识:1为一般采购单;2为委外采购单(【1】:一般采购单,【2】:委外采购单) | false | integer | ||
purchaseCode | 采购单编码 | false | string | ||
realDirectorCode | 负责人 | false | string | ||
supplierCode | 供应商编码 | true | string | ||
useNum | 是否开启行号:1为开启;0为关闭 | false | integer |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}
# 工序委外出库-确认接口
接口地址:/api/open/v2/outSource/transfer/out/confirm
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述:
请求示例:
{
"body": {
"code": "",
"records": [
{
"batchNumber": "",
"itemCode": "",
"locationCode": "",
"quantity": 0,
"snCodes": [],
"warehouseCode": ""
}
]
}
}
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
requestParameter | requestParameter | body | true | RequestParameter«OutSourceTransferOutConfirmParams» | RequestParameter«OutSourceTransferOutConfirmParams» |
body | false | OutSourceTransferOutConfirmParams | OutSourceTransferOutConfirmParams | ||
code | 委外转出编码 | true | string | ||
records | 库存确认明细 | false | array | OutSourceTransferOutConfirmParamsRecord | |
batchNumber | 批次编码 | false | string | ||
itemCode | 物料编码 | true | string | ||
locationCode | 库位编码 | false | string | ||
quantity | 确认数量 | true | number | ||
snCodes | sn编码 | false | array | string | |
warehouseCode | 仓库编码 | false | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | BaseResponse |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | integer(int32) | integer(int32) | |
message | string |
响应示例:
{
"code": 0,
"message": ""
}