生产单报工 API

创建报工单

接口地址:/api/open/v2/jobBooking/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

参数是编码

请求示例:

{
  "body": {
    "autoConsume": "OFF",
    "cards": [
      {
        "inspectStandardItems": [
          {
            "name": "",
            "qualified": 0,
            "value": 0
          }
        ],
        "inspectStandardParameterItems": [
          {
            "name": "",
            "value": ""
          }
        ],
        "inspectStandardQualityItems": [
          {
            "name": "",
            "qualified": 0,
            "value": ""
          }
        ],
        "machineCode": "",
        "qtyOnJbkUnit": 0,
        "qtyOnProductionUnit": 0,
        "status": 0
      }
    ],
    "comments": "PO-3",
    "envParams": [
      {
        "key": "",
        "value": ""
      }
    ],
    "groupCode": "G1",
    "images": [
      {
        "key": "",
        "name": "",
        "size": 0,
        "type": "",
        "url": ""
      }
    ],
    "lotCode": "B-220123-001-001",
    "machineCode": "",
    "materialConsumeParams": [
      {
        "assistUnitOutQty": 5,
        "batchNumber": "220101-001",
        "itemCode": "FL-01",
        "materialType": "BYOrder",
        "quantity": 5,
        "snNumber": "sn-001"
      }
    ],
    "oldSn": "",
    "procedureCode": "P001",
    "quantity": 3.14,
    "sn": "",
    "staffCodes": [],
    "timeSpan": 0,
    "workOrderCode": "B-220123-001"
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
param	param	body	true	RequestParameter«JobBookingParam»	RequestParameter«JobBookingParam»
body			false	JobBookingParam	JobBookingParam
autoConsume	是否自动耗料(【1】：是,【0】：否)		false	integer
cards	自检卡片		false	array	SelfInspectCardParams
inspectStandardItems	检验规范项		false	array	InspectStandardItemParam
name	检验项名称		false	string
qualified	是否合格{合格：1，不合格：0}		false	integer
value	检验值，如果为空，则默认为0		false	number
inspectStandardParameterItems	检验规范检验参数项		false	array	InspectStandardParameterItemParam
name	检验项名称		false	string
value	检验值，如果为空，则默认为0		false	string
inspectStandardQualityItems	检验规范质量特性项		false	array	InspectStandardQualityItemParam
name	检验项名称		false	string
qualified	是否合格{合格：1，不合格：0}		false	integer
value	检验值，如果为空，则默认为0		false	string
machineCode	设备编码		false	string
qtyOnJbkUnit	报工数量 - 报工单位		false	number
qtyOnProductionUnit	报工数量 - 报工单位数量		false	number
status	合格状态{合格：1,不合格：2}		false	integer
comments	备注		false	string
envParams	环境参数		false	array	EnvParams
key			false	string
value			false	string
groupCode	报工小组编码		false	string
images	图片		false	array	AttachmentParams
key	文件key		false	string
name	文件名		false	string
size	大小		false	integer
type	类型		false	string
url	文件路径		false	string
lotCode	生产批量码		false	string
machineCode	报工设备		false	string
materialConsumeParams	报工耗料		false	array	MaterialConsumeParam
assistUnitOutQty	辅助单位数量		false	number
batchNumber	库存批次		false	string
itemCode	物料		false	string
materialType	耗料类型-按单料，调拨料,可用值:BYORDER,ALLOCATE		false	string
quantity	数量		false	number
snNumber	sn编码		false	string
oldSn	原始sn，工序是sn替换工序的时候必传		false	string
procedureCode	报工工序编码		false	string
quantity	报工数量		false	number
sn	sn		false	string
staffCodes	报工员工编码		false	array	string
timeSpan	报工计时		false	number
workOrderCode	生产单编号，不用sn报工或者采用线下sn报工的话生产单编号必填		false	string

响应状态:

状态码	说明	schema
200	OK	EntityResponse«AppJobBookingDTO»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		EntityResponseData«AppJobBookingDTO»	EntityResponseData«AppJobBookingDTO»
entity		AppJobBookingDTO	AppJobBookingDTO
jobBookingRecordIds		array	integer
needDefectiveHandleTasks		array	InspectDefectiveLotCarWithJbkLineDTO
container	流转容器基本信息	ContainerSimpleDTO	ContainerSimpleDTO
activityId	活动id	integer
capacityQty	计划容量	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
code	编号	string
containerType	类型(【0】：无,【1】：批量,【2】：SN)	integer
filledQty	填充数	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
flowQty	流转到该批量数量	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
id	容器id	integer
idStr	容器id字符串	string
loop	是否是回线容器(【1】：是,【0】：否)	integer
workOrderId	工单id	integer
containerType	流转容器类型(【0】：无,【1】：批量,【2】：SN)	integer
convertRate	生产单位和报工单位之间的转换关系	ProductionJbkUnitConvertRateDTO	ProductionJbkUnitConvertRateDTO
jbkUnitToProductionUnitRate	生产单位和报工单位之间的转换比例。productionUnitQty * jbkUnitToProductionUnitRate = jbkUnitQty * productionUnitToJbkUnitRate	number
productionUnitToJbkUnitRate	生产单位和报工单位之间的转换比例。productionUnitQty * jbkUnitToProductionUnitRate = jbkUnitQty * productionUnitToJbkUnitRate	number
handleQuantityType	处理数量方式 1: 仅不合格品 2: 批量	integer
inspectJobBookingLine	检验报工行	array	InspectJobBookingLineWithStandardItemsDTO
defect	缺陷	DefectDTO	DefectDTO
id	缺陷id	integer
name	缺陷名称	string
defectCategoryIds	缺陷分类id集合	array	integer
defectCause	缺陷原因	DefectCauseDTO	DefectCauseDTO
defectCauseCode	缺陷原因编号	string
defectCauseName	缺陷原因名称	string
id	缺陷原因id	integer
id	检验报工行id	integer
inspectStandardParameterItemWithResults	检验参数项	array	InspectStandardParameterItemWithResultDTO
dataType	数据类型，1=文本型，2=单选，3=多选(【1】：文本型,【2】：单选,【3】：多选)	integer
dataValue	数据值	string
id	主键ID	integer
isMultiterm	是否允许多项(【1】：是,【0】：否)	integer
name	检验参数名称	string
parameterExplain	参数说明	string
qualified	是否合格 0:否 1:是(【1】：是,【0】：否)	integer
value	检验值	string
inspectStandardQualityItemWithResults	质量特性项	array	InspectStandardQualityItemWithResultDTO
dataType	数据类型，1=计量型，2=文本型，3=单选，4=多选(【1】：计量型,【2】：文本型,【3】：单选项,【4】：多选项)	integer
dataValue	数据值	string
id	主键ID	integer
isMultiterm	是否允许多项(【1】：是,【0】：否)	integer
isRequired	是否必填(【1】：是,【0】：否)	integer
name	质量特性名称	string
qualified	是否合格 0:否 1:是(【1】：是,【0】：否)	integer
qualityCategoryId	质量特性分类id	integer
qualityCategoryName	质量特性分类名称	string
requirements	技术要求	string
value	检验值	string
newUnQualifiedQuantity	不合格品数	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
inspectTaskId	检验任务id	integer
inspectTaskIdStr	检验任务id字符类型	string
method	检验方法 1:首检 2:全检 3:抽检 4:末检 6:抽检转全检	integer
newQualifiedQuantity	合格品数	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
newUnQualifiedQuantity	不合格品数	ProductionWithJbkUnitAndQtyDTO	ProductionWithJbkUnitAndQtyDTO
jbkUnit	报工单位和报工单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
productionUnit	生产单位和生产单位对应的数量	UnitWithQuantityDTO	UnitWithQuantityDTO
id	单位Id	integer
name	单位名称	string
qty	该单位对应的数量	number
procedure	检验工序	BaseProcedureSimpleDTO	BaseProcedureSimpleDTO
code	工序编号	string
id	id	integer
name	工序名称	string
type	检验类型	integer
unitConvert	是否开启报工单位(【ON】：是,【OFF】：否),可用值:ON,OFF	string
suspendFlowedLotCars	截停流转的批量	SuspendFlowedLotCarDTO	SuspendFlowedLotCarDTO
lotCarIds	关联的批量Ids	array	integer
suspendType	批量截停的类型。0：创建联产品；1：生产入库；,可用值:CREATE_CO_PRODUCT,INVENTORY	string
totalQty	允许创建联产品的数量	number
message		string

响应示例:

{
	"code": 0,
	"data": {
		"entity": {
			"jobBookingRecordIds": [],
			"needDefectiveHandleTasks": [
				{
					"container": {
						"activityId": 0,
						"capacityQty": {
							"jbkUnit": {
								"id": 0,
								"name": "",
								"qty": 0
							},
							"productionUnit": {
								"id": 0,
								"name": "",
								"qty": 0
							}
						},
						"code": "",
						"containerType": 0,
						"filledQty": {},
						"flowQty": {},
						"id": 0,
						"idStr": "",
						"loop": 0,
						"workOrderId": 0
					},
					"containerType": 0,
					"convertRate": {
						"jbkUnitToProductionUnitRate": 0,
						"productionUnitToJbkUnitRate": 0
					},
					"handleQuantityType": 0,
					"inspectJobBookingLine": [
						{
							"defect": {
								"id": 0,
								"name": ""
							},
							"defectCategoryIds": [],
							"defectCause": {
								"defectCauseCode": "",
								"defectCauseName": "",
								"id": 0
							},
							"id": 0,
							"inspectStandardParameterItemWithResults": [
								{
									"dataType": 0,
									"dataValue": "",
									"id": 0,
									"isMultiterm": 0,
									"name": "",
									"parameterExplain": "",
									"qualified": 0,
									"value": ""
								}
							],
							"inspectStandardQualityItemWithResults": [
								{
									"dataType": 0,
									"dataValue": "",
									"id": 0,
									"isMultiterm": 0,
									"isRequired": 0,
									"name": "",
									"qualified": 0,
									"qualityCategoryId": 0,
									"qualityCategoryName": "",
									"requirements": "",
									"value": ""
								}
							],
							"newUnQualifiedQuantity": {}
						}
					],
					"inspectTaskId": 0,
					"inspectTaskIdStr": "",
					"method": 0,
					"newQualifiedQuantity": {},
					"newUnQualifiedQuantity": {},
					"procedure": {
						"code": "",
						"id": 0,
						"name": ""
					},
					"type": 0,
					"unitConvert": ""
				}
			],
			"suspendFlowedLotCars": {
				"lotCarIds": [],
				"suspendType": "",
				"totalQty": 0
			}
		}
	},
	"message": ""
}

删除报工单

接口地址:/api/open/v2/jobBooking/delete

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

参数是编码

请求示例:

{
  "body": 0
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
param	param	body	true	RequestParameter«long»	RequestParameter«long»
body			false	integer(int64)

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

根据id查询报工记录

接口地址:/api/open/v2/jobBooking/queryByIds

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

参数是报工记录id

请求示例:

{
  "body": []
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
param	param	body	true	RequestParameter«Collection«long»»	RequestParameter«Collection«long»»
body			false	array	integer

响应状态:

状态码	说明	schema
200	OK	ListResponse«JobBookingRecord»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		ListResponseData«JobBookingRecord»	ListResponseData«JobBookingRecord»
list		array	JobBookingRecord
allInspect	是否全检	boolean
assignees	派发人	array	Assignee
code	编码	string
name	名称	string
type	人员类型,可用值:NULL,STAFF,GROUP,MACHINE	string
comment	备注	string
consumeUsageRecords	耗料记录	array	ConsumeUsageRecordDTO
applyQuantity	申请数	number
batchNumber	批次号	string
confirmedQuantity	确认数	number
consumeType	消耗类型,可用值:WORK_REPORT,FINISHED,ASSEMBLY	string
itemCode	耗料产品	string
itemName	耗料产品	string
itemType	物料类型 1按单 2 调拨,可用值:BY_ORDER,ALLOCATION	string
itemUnit	耗料产品	string
lotCarCode	批量编号	string
snNumber	序列号编号	string
customerFields	报工自定义字段	array	CustomerFieldDTO
name		string
value		string
headInspect	是否首检	boolean
headInspectQuantity	首检数量	number
id	id	integer
images	图片	array	AttachmentDTO
key	key	string
name	文件名	string
size	文件大小	integer
type	文件类型	string
url	url	string
isLast	是否是最后一道工序	boolean
isSelfInspect	此工序是否有自检	boolean
isSpecialInspect	此工序是否有专检	boolean
itemCode	根物料编码	string
itemName	物料名称	string
itemUnit	物料单位	string
jbkEnvs	报工环境参数	array	JbkEnvDTO
name	参数名称	string
value	参数值	string
jbkQuantity	报工数量	number
jobBookingTime	报工时间	integer
jobBookingUnitName	报工单位名称	string
jobBookingUnitQuantity	报工单位数量	number
lastInspect	是否末检	boolean
lastInspectQuantity	末检数量	number
lotCode	批量号	string
machineRecords	报工设备信息	array	MachineRecord
actualQuantity	实际产量	number
jobBookingTime	报工时间	integer
machineCode	报工设备Code	string
quantity	总报工数量[生产单位]	number
recommendQuantity	推荐产量	number
operatorCode	报工操作人编码	string
prepareTime	准备时间	number
prepareTimeUnit	准备时间单位,可用值:DAY,HOUR,MINUTE,SECOND	string
prepareTimeUnitName	准备时间单位描述	string
procedureTime	报工计时,秒	integer
processTime	加工时间	number
processTimeUnit	加工时间的单位(【1】：time,【2】：product,【3】：product,【4】：time,【5】：time,【6】：product,【7】：time,【8】：product)	integer
processTimeUnitName	加工时间的单位描述	string
quantity	数量	number
samplingInspect	是否抽检	boolean
samplingInspectPercent	抽检比例	number
samplingInspectPercentType	抽检按比例 小数位处理方式,可用值:NONE,CEIL,DECIMAL	string
samplingInspectQuantity	抽检数量	number
samplingInspectType	抽检类型,可用值:NON,PERCENT,AMOUNT	string
selfInspectQualifiedQuantity	自检合格品	number
selfInspectUnQualifiedQuantity	自检不合格品	number
snCode	sn号	string
status	状态1新增,2编辑,3删除,可用值:ADD,EDIT,DELETE	string
timeSpan	报工计时	integer
timeUnit	报工计时单位,可用值:DAY,HOUR,MINUTE,SECOND	string
workCenterCode	工作中心编码	string
workOrderCode	工单号	string
workOrderProcedureCode	工单工序编码	string
workOrderProcedureName	工单工序名称	string
workOrderProductType	生产单产品类型 1:普通产品 2:副产品(【1】：普通产品,【2】：副产品)	integer
workOrderType	工单类型(【1】：生产单,【2】：返工单,【3】：联产品生产单,【4】：集中返修单,【5】：重工单,【6】：售后返修单)	integer
message		string

响应示例:

{
	"code": 0,
	"data": {
		"list": [
			{
				"allInspect": true,
				"assignees": [
					{
						"code": "",
						"name": "",
						"type": ""
					}
				],
				"comment": "",
				"consumeUsageRecords": [
					{
						"applyQuantity": 0,
						"batchNumber": "",
						"confirmedQuantity": 0,
						"consumeType": "",
						"itemCode": "",
						"itemName": "",
						"itemType": "",
						"itemUnit": "",
						"lotCarCode": "",
						"snNumber": ""
					}
				],
				"customerFields": [
					{
						"name": "",
						"value": ""
					}
				],
				"headInspect": true,
				"headInspectQuantity": 0,
				"id": 0,
				"images": [
					{
						"key": "",
						"name": "",
						"size": 0,
						"type": "",
						"url": ""
					}
				],
				"isLast": true,
				"isSelfInspect": true,
				"isSpecialInspect": true,
				"itemCode": "",
				"itemName": "",
				"itemUnit": "",
				"jbkEnvs": [
					{
						"name": "",
						"value": ""
					}
				],
				"jbkQuantity": 0,
				"jobBookingTime": 0,
				"jobBookingUnitName": "",
				"jobBookingUnitQuantity": 0,
				"lastInspect": true,
				"lastInspectQuantity": 0,
				"lotCode": "",
				"machineRecords": [
					{
						"actualQuantity": 0,
						"jobBookingTime": 0,
						"machineCode": "",
						"quantity": 0,
						"recommendQuantity": 0
					}
				],
				"operatorCode": "",
				"prepareTime": 0,
				"prepareTimeUnit": "",
				"prepareTimeUnitName": "",
				"procedureTime": 0,
				"processTime": 0,
				"processTimeUnit": 0,
				"processTimeUnitName": "",
				"quantity": 0,
				"samplingInspect": true,
				"samplingInspectPercent": 0,
				"samplingInspectPercentType": "",
				"samplingInspectQuantity": 0,
				"samplingInspectType": "",
				"selfInspectQualifiedQuantity": 0,
				"selfInspectUnQualifiedQuantity": 0,
				"snCode": "",
				"status": "",
				"timeSpan": 0,
				"timeUnit": "",
				"workCenterCode": "",
				"workOrderCode": "",
				"workOrderProcedureCode": "",
				"workOrderProcedureName": "",
				"workOrderProductType": 0,
				"workOrderType": 0
			}
		]
	},
	"message": ""
}