U9产业链API使用手册物料.docx
《U9产业链API使用手册物料.docx》由会员分享,可在线阅读,更多相关《U9产业链API使用手册物料.docx(61页珍藏版)》请在冰豆网上搜索。
U9产业链API使用手册物料
物料服务
版本记录
版本
修改与参与人
修改时间
修改原因
修改内容
设计
毛鸿涛
2009-12-18
按照规范进行修改
V1.0
杜华侨
2010-01-18
按照设计文档整理
基于U9标准产品的最低版本
最低版本号:
V2.0sp1
服务清单
在此处列举文档中包含的服务,并简要介绍功能,及使用注意事项
服务
说明
创建物料服务
删除物料服务
修改物料服务
查询物料服务
1、创建物料服务
使用说明
说明服务使用前提,使用注意
所属DLL
UFIDA.U9.ISV.Item.Agent.dll
服务全名称
UFIDA.U9.ISV.Item.BatchCreateItemByDTOSRV
接口说明
说明服务的传入、返回参数
接口名称(英文)
接口名称(中文)
类型(英文)
类型(中文描述)
入/返
说明
可空
ItemInfoDTOList
物料主档DTO列表
List<物料主档DTO>
ItemDTOList
入
N
List
返
参数1:
物料主档DTO集合
物料主档DTO
全路径名:
UFIDA.U9.ISV.Item.ItemMasterDTO
类图:
业务主键:
组织+编码
名称
中文名称
类型
说明
必赋值
ID
ID
Long
◆创建时为空
◆修改时,ID和Code不能同时为空
Code
编码
String
◆默认为空
◆创建时非空
◆修改时,ID和Code不能同时为空
Org
组织
通用档案DTO
◆如果为空,取上下文组织
Code1
参考料号1
String
◆如果非空,则不能重复
◆可以是对应政府/行业组织的物料编码
Code2
参考料号2
String
◆如果非空,则不能重复
◆可以是对应政府/行业组织的物料编码
Name
品名
String
◆可空
◆创建时非空,修改时可空
AliasName
别名
String
◆
SPECS
规格
String
◆
CatalogNO
目录编号
String
◆
SearchCode
搜索码
String
◆
IsVersionQtyControl
版本数量控制
Bool
◆默认为空
◆库存交易时是否要输入物料的版本号,库存数量是否按物料版本号保存。
◆物料形态属性为服务时,=false
VersionID
当前版本ID
通用档案DTO
◆默认为空
Version
当前版本
String
◆当[版本数量控制]=<否>时,可空,手工维护
◆当[版本数量控制]=<是>时,非空,初始建档时,手工录入,以后,系统维护
◆默认为空
Description
描述
String
◆
Picture
图片
二进制流
◆
ItemFormAttribute
物料形态属性
枚举
0.Model模型:
其BOM结构中子项含有可选类,录入销售订单时需要选配,选配结果产生FAS料号
1.PTO:
直接按PTO子件出货(类似配比出库)
2.ATO:
按订单装配
3.Optionclass可选类:
为虚类,仅为模型选配服务,其子项为可选择的制造件
4.Subcontractpart委外加工件:
定义全程委外物料
5.工序委外件:
定义工序委外物料
6.Phantom虚拟:
MRP展开过程中不对虚拟件产生MO,仅作为过渡
7.Planning计划:
销售计划按计划件制定,通过对计划BOM的展开,得到具体产品的计划
8.Family系列:
通过BOM定义产品系列构成,用于统计分析
9.Purchasepart采购件:
定义采购件
10.Makepart制造件:
普通制造件
11.FAS:
为Model模型最终选配结果而产生的料号
12.Kit套件:
类似某型号空调的室内机和室外机,销售以套件计算,库存以子件计算
13.Routable工艺:
在母子MO中,子MO的Routable件完工后直接转入上层工序中
14.Freestock低值易耗品
15.Commodity商品:
用于商品流通企业
16.Misc:
杂项物料,库存实物管理,收货后直接进费用
17.Service服务:
无库存
18.Assets资产:
定义资产类物料
19.Spare备件:
定义备品备件,用于设备维修
20.Ingredient配方:
流程行业需要定义配方的物料
21.Repetitive重复:
计划过程为Repetitive物料作重复计划处理
22.费用性物料:
收货直接进部门费用,不入库
◆
IsMISC
杂项料品
Bool
◆默认为空
◆物料形态属性为杂项时,必须为true
否则,必须为false
Status
物料状态
通用档案DTO
◆
IsInventoryEnable
可库存交易
Bool
◆
IsInventoryEnable
可采购
Bool
◆
IsSalesEnable
可销售
Bool
◆
IsBuildEnable
可生产
Bool
◆
IsOutsideOperationEnable
可委外
Bool
◆
IsMRPEnable
可MRP
Bool
◆
IsBOMEnable
可BOM
Bool
◆
IsVMIEnable
VMI标志
Bool
◆VMI标识的料号才能入VMI仓
StatusLastModify
状态最近更新日期
Datetime
◆
State
物料状态
枚举:
0待核准
1核准中
2已核准
◆
IsCanFlowStat
可流向统计
bool
◆修改时,当前料品•[料品形态属性]为以下类型时,系统自动赋值,可流向统计=false
资产,费用性物料,低值易耗品,配方,杂项料品,模型,可选类,PTO,计划,工序委外件,工艺
RefrenceCost
参考成本
Decimal
IsSpecialItem
专用料
bool
WeightUom
重量单位
通用档案DTO
Weight
库存单位重量
Decimal
BulkUom
体积单位
通用档案DTO
Bulk
体积
Decimal
IsDualUOM
双单位
Bool
◆如果双单位=“否”,销售单位、采购单位必须等于计价单位
◆序列号管理的料品不能双单位
IsDualQTY
双数量
Bool
◆是:
交易单位数量1和交易单位数量2只能输入整数。
◆否:
交易单位数量1可以输入小数(decimal),屏蔽交易单位数量2。
◆序列号管理的料品不能双数量
ConverRatioRule
转换率策略
枚举
0:
标准转换率
1:
物料特定转换率
2:
先找后者,再找前者
IsVarRatio
固定转换率
Bool
IsMultyUOM
多单位
Bool
◆默认交易单位与库存单位不同
◆序列号管理的料品不能多单位
InventoryUOM
库存主单位
通用档案DTO
◆非空
◆计划系统运算数量单位
Y
InventoryUOMGroup
库存主单位计量单位组
Int
0时间
1长度
2重量
3面积
4体积
5重量
7财务
◆库存主单位对应的计量单位组
InventorySecondUOM
库存单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
CostUOM
成本单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
PurchaseUOM
采购单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
SalesUOM
销售单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
MaterialOutUOM
领料单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
ManufactureUOM
生产单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
PriceUOM
计价单位
通用档案DTO
◆创建时,如果为空,系统自动赋值,=库存主单位
SnParam
序列号参数
通用档案DTO
◆如果为空,则不进行序列号管理
成份控制
IsPotencyControl
Bool
◆默认=false
◆物料形态属性=5服务或17工序委外件时,成分控制必须为false
标准成份
StandardPotency
Int
0A
1B
2C
3D
4E
◆成分控制=true,必输,标准成分>=起始成分并且标准成分<=结束成分
起始成份
StartPotency
Int
◆成分控制=true时,非空
结束成份
EndPotency
Int
◆成分控制=true时,非空
等级控制
IsGradeControl
Bool
◆默认=false
标准等级
StandardGrade
Int
◆成分控制=true,必输,标准等级>=起始等级并且标准等级<=结束等级
起始等级
StartGrade
Int
◆等级控制=true时,非空
结束等级
EndGrade
Int
◆等级控制=true时,非空
厂牌管理
IsTrademark
Bool
厂牌
Trademark
通用档案DTO
厂牌管理=true,非空
厂牌管理=false,必空
FreeItem1
自由项1
通用档案DTO
◆
FreeItem2
自由项2
通用档案DTO
◆
FreeItem3
自由项3
通用档案DTO
◆
CustomNumber
海关编码
String
◆
CustomTaxRate
海关征税率
Decimal
◆
DrawbackRate
退税率
Decimal
◆
IsNeedLicence
需要许可证
Bool
◆
NeedInspect
需要商检
Bool
◆
IsBounded
保税品
Bool
◆
BoundedCategory
保税品类别
Int
0默认类别
◆
BoundedTaxNO
保税料品税则编号
String
◆
BoundedCountTolerance
保税盘差容忍率
Decimal
◆
BoundedCountTaxRate
保税应补税率
Decimal
◆
StandardBatchQty
标准批量
Decimal
◆
StandardCost
标准成本
Decimal
◆
RecentlyCost
最新成本
Decimal
◆
IsIncludedStockAsset
存货资产
Bool
◆
IsIncludedCostCa
成本卷算
Bool
◆
PlanCost
计划价
Decimal
◆
StockCategory
库存分类
通用档案DTO
◆
ProductionCategory
生产分类
通用档案DTO
◆
SaleCategory
销售分类
通用档案DTO
◆
PurchaseCategory
采购分类
通用档案DTO
◆
MRPCategory
MRP分类
通用档案DTO
◆
CostCategory
成本分类
通用档案DTO
◆
PriceCategory
价格分类
通用档案DTO
◆
AssetCategory
财务分类
通用档案DTO
◆
CreditCategory
信用分类
通用档案DTO
◆
料品库存相关信息DTO
全路径名:
UFIDA.U9.ISV.Item.ItemInvInfoDTO;
业务主键:
物料
名称
中文名称
类型
说明
必赋值
ID
ID
Long
◆创建时为空
◆修改时可赋值,ID和物料不能同时为空
ItemMaster
物料
ItemDTO
◆非空,无需赋值,系统维护
IsKitMustWholeSet
KIT件成套收发货
Bool
IsLimitWarehouse
存储地点限制
Bool
◆=true时,表示当前物料交易要指定存储地点
Warehouse
存储地点
通用档案DTO
◆存储地点限制=true时,非空
=false时,为空
IsLimitBin
货位限制
Bool
◆=true,表示当前物料交易要指定货位
Bin
货位
通用档案DTO
◆存储地点限制=true时,非空
=false时,为空
ReserveMode
预留方式
Int
0.硬预留;
1.软预留
◆
IsReservable
可预留
Bool
◆
ReserveDays
预留天数
int
◆>=1并且<=999
IsNegativeInventory
允许负库存
Bool
◆
WarehouseManager
业务员
通用档案DTO
◆业务员.业务类型=库管员
ATPRule
ATP规则
通用档案DTO
◆IsATPCheck=TRUE时,非空
PickingRule
拣货规则
通用档案DTO
◆
PutawayRule
理货规则
通用档案DTO
◆
PurchaseControlModeEnum
采购控制方法
Int
0.物料周转率
1.最高存量限制
2.物料周转时间
◆表示超过此标准就禁止物料的采购
TurnOverRate
周转率
Decimal
◆采购控制方法=0:
物料周转率>时,非空
否则,可空
TurnOverDays
周转天数
Decimal
◆采购控制方法=2.物料周转时间非空
否则可空
AvgUsageQtyCalDays
平均用量天数
Decimal
◆采购控制方法=1.最高存量限制
否则可空
AvgUsageQty
平均用量
Decimal
◆采购控制方法=1.最高存量限制
否则可空
IsShipmentOverdueLot
出过期批号
Bool
◆
CostCurrency
成本币种
通用档案DTO
◆
ReferrenceCost
参考成本
Decimal
◆
IsIncSerialNo
盘序列号
Bool
◆料序列号管理时有效
IsIncZeroQty
零账存盘点
Bool
◆
ApprDiffRule
允差原则
Int
0-不检查允差;
1-检查允差比率和绝对允差值;
2-检查允差比率或绝对允差值
◆
ApprDiffQty
允差数量
Decimal
◆核准允差适用原则=0,此项无效不可维护;
◆核准允差适用原则<>0,此项可维护>=0
ApprDiffQtyRate
数量允差比
Decimal
◆核准允差适用原则=0,此项无效不可维护;
◆核准允差适用原则<>0,此项可维护>=0
ApprDiffAmt
允差金额
Decimal
◆核准允差适用原则=0,此项无效不可维护;
◆核准允差适用原则<>0,此项可维护>=0
ApprDiffAmtRate
金额允差比
Decimal
◆核准允差适用原则=0,此项无效不可维护;
◆核准允差适用原则<>0,此项可维护>=0
InventoryPlanningMethod
规划方法
Int
0最高最低点
1再订货点
2盘点补货法
3固定期间法
4MRP规划
5经济批量法
6不使用物料规划
◆0时,[库存上限][库存下限]有效;
◆1时,[再订货量][安全库存]有效;
◆2时,([库存上限][库存下限])和([再订货量][安全库存])互斥,不能同时有效;
◆3时,([固定期间][下次补货日期])和([再订货量])有效;
◆4时,需要设置MRP计划方法;
◆5时,[订单成本][持货成本百分比][经济订购量]有效;
◆6时,本部分字段均无效;
SupplyMethod
补货方法
Int
0按上限/再订货量补货
1按需求补货
2按需求和上限/再订货量的较大量补货
◆当[规划方法]=最高最低点,再订货点,盘点补货法时,非空;否则,为空。
InventoryMaxLimitQty
库存上限
Decimal
◆当[物料规划方法]=<0>\<2>时,非空,输入
◆计量单位为库存单位,且库存上限≥库存下限
InventoryMinLimitQty
库存下限
Decimal
◆当[物料规划方法]=<0>\<2>时,非空,输入
◆计量单位为库存单位,且库存上限≥库存下限
FixPeriod
固定期间(天)
Decimal
◆当[物料规划方法]=<3>时,非空,输入其他情况下,可空
NextSupplyDate
下次补货日
Date
◆当[物料规划方法]=<3>时,非空,输入其他情况下,可空
SafetyStockType
安全存量法
Int
0安全存量期间法
1安全存量法
◆0、安全存量直接取安全存量
◆1、安全存量=安全存量期间总量*安全存量百分比
SafetyStockPeriod
安全库存期
Int
◆当[安全存量法]=<1>时,非空其他情况下,可空
SafetyStockRate
安全库存量百分比
Decimal
◆当[安全存量法]=<1>时,非空其他情况下,可空
SafetyStockQty
安全库存量
Decimal
◆计量单位为库存单位
WastageRate
损耗率
Decimal
◆
OrderCost
订单成本
Decimal
◆当[物料规划方法]=<5>时,非空
◆其他情况下,可空
InventoryCostRate
持货成本百分比
Decimal
◆当[物料规划方法]=<5>时,非空
◆其他情况下,可空
InventoryPlanTime
规划时机
Int
0及时规划
1批次规划
◆
EconomyOrderQty
经济订购量
Decimal
◆当[物料规划方法]=<5>时,非空
◆其他情况下,可空
◆最佳经济订购量,按库存单位
TimeBucket
时格
通用档案DTO
◆当[物料规划方法]=<0>高低点时,非空
ReorderQty
再订货量
Decimal
◆当[物料规划方法]=<1>\<2>\<3>时,非空,输入计量单位为库存单位
InvToPurMode
规划转采购方式
Int
0协同
1单据
◆协同表示转需求计划表
◆默认为空单据表示转PR/PO
LotControlMode
批号控制
Int
0全部控制
1部分控制
2无
◆
LotParam
批号参数
通用档案DTO
◆如果为空,则不进行批号管理
LotValidDate
有效期天数
int
◆如果不进行批号管理,则不需要设置有效期天数,进行批次管理时,可设可不设
IsCanalBinUnMarkCheck
渠道库存滞销检查
Bool
◆
IsRequiredShipperSupply
按需求货主补货
Bool
◆
StandardBox
库存单位标箱
Decimal
◆
InternalTransCost
内部转移成本
Decimal
◆
IsEffective
是否有效
Bool
◆
EffectiveDate
生效日期
Date
◆
DisableDate
失效日期
Date
◆
料品生产相关信息DTO
全路径名:
UFIDA.U9.ISV.Item.ItemMFGInfoDTO;
业务主键:
物料
名称
中文名称
类型
说明
必赋值
ID
ID
Long
◆可空
◆默认为空
◆创建时为空
◆修改时可赋值,ID和物料不能同时为空
ItemMaster
物料
ItemDTO
◆非空,无需赋值,系统维护
BuildQuanSelectType
生产数量选择
int
0、依需求量
1、依生产批量
◆可空
◆默认为空
BuildBatch
生产批量
Decimal
◆可空
◆默认为空
◆如果[生产数量选择]=<0>,可空;制令按需求量下,BOM按批量算;
◆如果[生产数量选择]=<1>,非空,生产订单量按批量进行生产,BOM按批量算
BuildMultiplier
生产倍量
Long
◆
BuildShrinkageRate
生产损耗率
Decimal
◆可空
◆默认为空
◆>=0and<=1
IsOutputControlFlag
产出控制
Long
◆可空
◆默认为空
MultiHierarchyExpandFlag
多层展开层数
int
◆可空
◆默认为空
◆>=0and<=99
IssueMaterialBatchQty
发料倍量
Decimal
◆
MinSupplyMaterialQty
最小发料量
Decimal
◆
IssueMaterialSafeStockQty
发料安全库存量
Decimal
◆可空
◆默认为空
◆针对线上仓的安全库存量,用于计算发料量
IssueMaterialSafeStockPeriod
安全库存期
int
◆
IsAllowExcessMaterial
允许超额领料
bool
◆
StandardMaterialScale
标准超额比例
decimal
◆[允许超额领料]为“是”时,非空
否则为空
IsECNControl
ECN控制
Bool
◆
CommonRoutingMaterial
共享工艺物料
通用档案DTO
◆
CommonBOMMaterial
共享BOM物料
通用档案DTO
◆
LowLevelCode
低阶码
Int
◆
PictureCode
图号
String
◆
Bom