跳到主要内容

POST 批量创建临时物料(单据明细导入专用,每次最多 100 条)

POST,body JSON。仅为销售/采购等单据导入明细行时创建或匹配临时物料(type=1,需转正后才是正式物料),不是物料主数据导入;导入正式物料请用 srm.data-task-center.import-rows(taskCode=SRM_PRODUCT)。每次最多 100 条,超出报 59412。

接口编码所需范围后端接口
srm.material-import.temp-materialssrm:writePOST /v1/material-import/temp-materials(comap-srm)

必填字段

字段依据
items接口规格

条件必填(如「某状态时必填」)不在此表,以上方参数说明为准。 判定规则见必填字段的判定。

请求体字段(body)

字段类型必填说明
sourcestring—发起临时物料创建的实际单据来源:SALES_ORDER=销售订单, SALES_CONTRACT=销售合同, SALES_QUOTATION=销售报价, PURCHASE_ORDER=采购订单, PURCHASE_REQUEST=采购申请, BOM=BOM
items12MaterialImportTempCreateItemDTO[]是已由用户明确确认创建的物料行

「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验, 标「—」不等于可以不传;租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。

请求示例

curl -X POST https://open.risemap.cn/v1/api/invoke \
-H "Authorization: Bearer <访问令牌>" \
-H "Content-Type: application/json" \
-d '{
"apiCode": "srm.material-import.temp-materials",
"body": {
"items": []
}
}'

响应 data 字段

字段类型必填说明
rowIdstring—前端行标识
productIdinteger(int64)—物料 ID
skuIdinteger(int64)—SKU ID
productNostring—物料编码
namestring—物料名称
modelstring—物料型号
specLabelstring—SKU 规格
brandNamestring—品牌名称
categoryIdinteger(int64)—分类 ID
categoryNamestring—分类名称
unitIdinteger(int64)—单位 ID
unitNamestring—单位名称
defaultTaxRatenumber—默认税率
costPricenumber—成本价
taxInclusiveCostPricenumber—SKU 含税成本价
salePricenumber—SKU 售价
taxInclusiveSalePricenumber—SKU 含税售价
purchasePricenumber—SKU 采购价
taxInclusivePurchasePricenumber—SKU 含税采购价
createdboolean—是否为本次确认创建的临时物料

错误处理​

响应统一信封 { code, message, data },code == 200 为成功。以下是本接口可能返回的开放平台层错误:

错误码说明可重试
92101访问凭证无效否
92201接口未登记或已停用否
92202超出凭证授权范围——本接口需 srm:write否
92204绑定员工无此接口的功能权限否
92203上游服务调用失败先查询处理结果,禁止盲目重试
92301请求过于频繁是
92205写操作处理超时,结果未知(下游可能仍在执行)否,先查询确认结果
92302有参数相同的写请求正在处理中等待并确认前一次结果,勿重复提交

除此之外,comap-srm 自身的业务校验失败会原样透传其业务码与提示 (如字段校验、状态不允许、数据不存在),这类码不在开放平台的号段内, 以响应里的 message 为准。完整的平台层错误码见错误码说明。

← 返回单据物料导入