计件报工

说明

本接口用于MES系统上报计件数据到平台。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	制造业计件报工数据写权限	API Explorer
第三方企业应用	支持	制造业计件报工数据写权限	API Explorer
第三方个人应用	暂不支持	制造业计件报工数据写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
401	illegal.argument	参数有误 %s	参数有误 %s
403	permission.wrong	无权限 %s	无权限 %s
404	error.notFound	接口路径错误 %s	接口路径错误 %s
500	error.unknownerror	服务器内部错误 %s	服务器内部错误 %s
501	illegal.field.notnull	当前字段不能为空 %s	当前字段不能为空 %s
999	error.unknownerror	%s	%s

请求参数

Path 参数

userId

string

必需

员工钉钉userid。

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

scrappedQuantity

string

报废数量。

可选

productSpecification

string

产品规格。

可选

qualifiedQuantity

string

合格数量。

必需

reworkableQuantity

string

可重工数量。

可选

userName

string

员工姓名。

可选

uuid

string

必需

随机字符串，唯一标识，用于幂等及更新。

productName

string

可选

产品名称，例如：双头螺柱001。

productEnName

string

产品英文名称。

可选

extend

string

可选

扩展字段，用于增加自定义字段。

productCode

string

产品唯一标识。

可选

processName

string

制程名称。

可选

processEnName

string

制程英文名称。

可选

mesAppKey

string

必需

mes系统唯一标识。

instNo

string

工单编号。

必需

manufactureDate

string

必需

生产日期时间，格式：yyyy-MM-dd HH:mm:ss。

dingCorpId

string

可选

工厂所在钉钉组织的企业corpId。

isBatchJob

string

可选

是否是批量报工，即一次计件报工由多个工人一起分担。

userNameList

string

可选

批量报工时，多个工人的用户名列表，以英文逗号分隔。

userIdList

string

可选

批量报工时，多个工人的钉钉工号列表，以英文逗号分隔。

unitPrice

string

可选

计件单价，单位：分。

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

httpCode

string

HTTP响应码。

可选

uuid

string

可选

此次上报的计件数据的唯一标识。

content

string

返回结果。

可选

errorMsg

string

错误码描述。

可选

errorLevel

integer

错误级别，取值：

可选

errorCode

string

可选

调用失败时返回的错误码。

success

boolean

可选

调用是否成功，取值:

示例

{
  "httpCode": "string",
  "uuid": "string",
  "content": "string",
  "errorMsg": "string",
  "errorLevel": 0,
  "errorCode": "string",
  "success": true
}

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码