同步接口 - 工业魔方API

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

Authorization

Body 参数application/json

array of:

bomId

integer <int32>

关联的bomId

可选

bomVersionRevision

integer <int32>

可选

关联的bom的即时修订次数

businessType

string

业务类型

可选

createBy

string

创建人

可选

createTime

string <date-time>

创建时间

可选

materialListCode

string

必需

生产订单用料清单编号

materialListExtendFieldEight

string

可选

生产订单用料清单扩展字段8

materialListExtendFieldFive

string

可选

生产订单用料清单扩展字段5

materialListExtendFieldFour

string

可选

生产订单用料清单扩展字段4

materialListExtendFieldNine

string

可选

生产订单用料清单扩展字段9

materialListExtendFieldOne

string

可选

生产订单用料清单扩展字段1

materialListExtendFieldSeven

string

可选

生产订单用料清单扩展字段7

materialListExtendFieldSix

string

可选

生产订单用料清单扩展字段6

materialListExtendFieldTen

string

可选

生产订单用料清单扩展字段10

materialListExtendFieldThree

string

可选

生产订单用料清单扩展字段3

materialListExtendFieldTwo

string

可选

生产订单用料清单扩展字段2

orderType

string

单据类型

可选

relateMaterialCode

string

关联单据物料编码

必需

relateNumber

string

关联单据编号

必需

relateQuantity

number <double>

关联单据数量

必需

relateSkuId

integer <int32>

可选

关联单据特征参数skuId

relateType

string

关联单据类型

必需

relatedMaterialList

array[object (com.yelink.dfscommon.dto.ams.open.order.MaterialListMaterialInsertDTO) {43}]

关联的物料列表

必需

actualQuantity

number

实际数量

可选

availableStockQuantity

number

可用库存数

可选

bomDenominator

number

bom分母

可选

bomNumerator

number

bom分子

可选

bomRawMaterialExtendOne

string

可选

BOM子物料扩展字段

bomRawMaterialId

integer <int32>

BOM子物料id

可选

businessUnitCode

string

业务单元编码

可选

businessUnitName

string

业务单元名称

可选

createTime

string <date-time>

创建时间

可选

externalMaterialId

string

可选

ERP关联物料行id

fixedDamage

number <double>

固定损耗率

可选

lossRate

number <double>

预估损耗率

可选

mainMaterialCode

string

主物料数量

可选

materialCode

string

物料编码

必需

materialListCode

string

必需

生产订单用料清单编号

materialListId

integer <int32>

可选

生产订单用料清单id

materialListMaterialExtendFieldEight

string

可选

生产订单用料清单物料扩展字段8

materialListMaterialExtendFieldFive

string

可选

生产订单用料清单物料扩展字段5

materialListMaterialExtendFieldFour

string

可选

生产订单用料清单物料扩展字段4

materialListMaterialExtendFieldNine

string

可选

生产订单用料清单物料扩展字段9

materialListMaterialExtendFieldOne

string

可选

生产订单用料清单物料扩展字段1

materialListMaterialExtendFieldSeven

string

可选

生产订单用料清单物料扩展字段7

materialListMaterialExtendFieldSix

string

可选

生产订单用料清单物料扩展字段6

materialListMaterialExtendFieldTen

string

可选

生产订单用料清单物料扩展字段10

materialListMaterialExtendFieldThree

string

可选

生产订单用料清单物料扩展字段3

materialListMaterialExtendFieldTwo

string

可选

生产订单用料清单物料扩展字段2

materialListPlanQuantity

number

必需

生产订单用料清单计划数量

planQuantity

number

计划数量

必需

pushDownQuantity

number

已下推数量

可选

referenceQuantity

number

参考数量

可选

relateMaterialRowId

string

可选

关联上级单据物料行id

replaceMaterialId

string

可选

可供选择的替代物id（多个则按逗号分隔）

replaceQuantity

number

替代数量

可选

returnQuantity

number

退料数量

可选

selectedReplaceMaterialCode

string

可选

已选择的替代物物料编码（多个则按逗号分隔）

selectedReplaceMaterialId

string

可选

已选择的替代物id（多个则按逗号分隔）

skuId

integer <int32>

特征参数skuId

可选

stockQuantity

number

物料当前总库存

可选

subType

integer <int32>

子项类型

可选

supplementOutQuantity

number

补料出库数

可选

totalPlanQuantity

number

累计计划数量

可选

totalReceiveQuantity

number

可选

累计领用数量、领料数量

uncollectedQuantity

number

未领数量

可选

updateBy

string

修改人

可选

updateTime

string <date-time>

修改时间

可选

示例

[
    {
        "bomId": 0,
        "bomVersionRevision": 0,
        "businessType": "string",
        "createBy": "string",
        "createTime": "2019-08-24T14:15:22Z",
        "materialListCode": "string",
        "materialListExtendFieldEight": "string",
        "materialListExtendFieldFive": "string",
        "materialListExtendFieldFour": "string",
        "materialListExtendFieldNine": "string",
        "materialListExtendFieldOne": "string",
        "materialListExtendFieldSeven": "string",
        "materialListExtendFieldSix": "string",
        "materialListExtendFieldTen": "string",
        "materialListExtendFieldThree": "string",
        "materialListExtendFieldTwo": "string",
        "orderType": "string",
        "relateMaterialCode": "string",
        "relateNumber": "string",
        "relateQuantity": 0,
        "relateSkuId": 0,
        "relateType": "string",
        "relatedMaterialList": [
            {
                "actualQuantity": 0,
                "availableStockQuantity": 0,
                "bomDenominator": 0,
                "bomNumerator": 0,
                "bomRawMaterialExtendOne": "string",
                "bomRawMaterialId": 0,
                "businessUnitCode": "string",
                "businessUnitName": "string",
                "createTime": "2019-08-24T14:15:22Z",
                "externalMaterialId": "string",
                "fixedDamage": 0,
                "lossRate": 0,
                "mainMaterialCode": "string",
                "materialCode": "string",
                "materialListCode": "string",
                "materialListId": 0,
                "materialListMaterialExtendFieldEight": "string",
                "materialListMaterialExtendFieldFive": "string",
                "materialListMaterialExtendFieldFour": "string",
                "materialListMaterialExtendFieldNine": "string",
                "materialListMaterialExtendFieldOne": "string",
                "materialListMaterialExtendFieldSeven": "string",
                "materialListMaterialExtendFieldSix": "string",
                "materialListMaterialExtendFieldTen": "string",
                "materialListMaterialExtendFieldThree": "string",
                "materialListMaterialExtendFieldTwo": "string",
                "materialListPlanQuantity": 0,
                "planQuantity": 0,
                "pushDownQuantity": 0,
                "referenceQuantity": 0,
                "relateMaterialRowId": "string",
                "replaceMaterialId": "string",
                "replaceQuantity": 0,
                "returnQuantity": 0,
                "selectedReplaceMaterialCode": "string",
                "selectedReplaceMaterialId": "string",
                "skuId": 0,
                "stockQuantity": 0,
                "subType": 0,
                "supplementOutQuantity": 0,
                "totalPlanQuantity": 0,
                "totalReceiveQuantity": 0,
                "uncollectedQuantity": 0
            }
        ],
        "updateBy": "string",
        "updateTime": "2019-08-24T14:15:22Z"
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://ip:port/openApi/ams/v2/open/material_lists/upsert' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "bomId": 0,
        "bomVersionRevision": 0,
        "businessType": "string",
        "createBy": "string",
        "createTime": "2019-08-24T14:15:22Z",
        "materialListCode": "string",
        "materialListExtendFieldEight": "string",
        "materialListExtendFieldFive": "string",
        "materialListExtendFieldFour": "string",
        "materialListExtendFieldNine": "string",
        "materialListExtendFieldOne": "string",
        "materialListExtendFieldSeven": "string",
        "materialListExtendFieldSix": "string",
        "materialListExtendFieldTen": "string",
        "materialListExtendFieldThree": "string",
        "materialListExtendFieldTwo": "string",
        "orderType": "string",
        "relateMaterialCode": "string",
        "relateNumber": "string",
        "relateQuantity": 0,
        "relateSkuId": 0,
        "relateType": "string",
        "relatedMaterialList": [
            {
                "actualQuantity": 0,
                "availableStockQuantity": 0,
                "bomDenominator": 0,
                "bomNumerator": 0,
                "bomRawMaterialExtendOne": "string",
                "bomRawMaterialId": 0,
                "businessUnitCode": "string",
                "businessUnitName": "string",
                "createTime": "2019-08-24T14:15:22Z",
                "externalMaterialId": "string",
                "fixedDamage": 0,
                "lossRate": 0,
                "mainMaterialCode": "string",
                "materialCode": "string",
                "materialListCode": "string",
                "materialListId": 0,
                "materialListMaterialExtendFieldEight": "string",
                "materialListMaterialExtendFieldFive": "string",
                "materialListMaterialExtendFieldFour": "string",
                "materialListMaterialExtendFieldNine": "string",
                "materialListMaterialExtendFieldOne": "string",
                "materialListMaterialExtendFieldSeven": "string",
                "materialListMaterialExtendFieldSix": "string",
                "materialListMaterialExtendFieldTen": "string",
                "materialListMaterialExtendFieldThree": "string",
                "materialListMaterialExtendFieldTwo": "string",
                "materialListPlanQuantity": 0,
                "planQuantity": 0,
                "pushDownQuantity": 0,
                "referenceQuantity": 0,
                "relateMaterialRowId": "string",
                "replaceMaterialId": "string",
                "replaceQuantity": 0,
                "returnQuantity": 0,
                "selectedReplaceMaterialCode": "string",
                "selectedReplaceMaterialId": "string",
                "skuId": 0,
                "stockQuantity": 0,
                "subType": 0,
                "supplementOutQuantity": 0,
                "totalPlanQuantity": 0,
                "totalReceiveQuantity": 0,
                "uncollectedQuantity": 0
            }
        ],
        "updateBy": "string",
        "updateTime": "2019-08-24T14:15:22Z"
    }
]'

返回响应

🟢200成功

*/*

Body

code

string

可选

状态码 200：操作成功，300：操作失败，400：未登录，1008：参数异常

data

object

业务数据

可选

message

string

可选

消息提示默认操作成功

time

string <date-time>

可选

格式yyyy-MM-dd HH:mm:ss

示例

{
    "code": "string",
    "data": {},
    "message": "string",
    "time": "2019-08-24T14:15:22Z"
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在