用友U9产业链API-使用手册-物料.doc

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列表listitemdtolist入nlist返参数1：物料主档dto集合物料主档dto全路径名：ufida.u9.isv.item.itemmasterdto类图：业务主键：组织+编码 名称中文名称类型说明必赋值ididlongu 创建时为空u 修改时,id和code不能同时为空code编码stringu 默认为空u 创建时非空u 修改时,id和code不能同时为空org组织通用档案dtou 如果为空,取上下文组织code1参考料号1stringu 如果非空，则不能重复u 可以是对应政府/行业组织的物料编码code2参考料号2stringu 如果非空，则不能重复u 可以是对应政府/行业组织的物料编码name品名stringu 可空u 创建时非空,修改时可空aliasname别名stringuspecs规格stringucatalogno目录编号stringusearchcode搜索码stringuisversionqtycontrol版本数量控制boolu 默认为空u 库存交易时是否要输入物料的版本号，库存数量是否按物料版本号保存。u 物料形态属性为服务时,= falseversionid当前版本id通用档案dtou 默认为空version当前版本stringu 当版本数量控制=时，可空，手工维护u 当版本数量控制=时，非空，初始建档时，手工录入，以后，系统维护u 默认为空description描述stringupicture图片二进制流uitemformattribute物料形态属性枚举0model模型：其bom结构中子项含有可选类，录入销售订单时需要选配，选配结果产生fas料号1pto：直接按pto子件出货（类似配比出库）2ato：按订单装配3option class可选类：为虚类，仅为模型选配服务，其子项为可选择的制造件4subcontract part委外加工件：定义全程委外物料5工序委外件：定义工序委外物料6phantom虚拟：mrp展开过程中不对虚拟件产生mo，仅作为过渡7planning计划：销售计划按计划件制定，通过对计划bom的展开，得到具体产品的计划8family系列：通过bom定义产品系列构成，用于统计分析9purchase part采购件：定义采购件10make part制造件：普通制造件11fas：为model模型最终选配结果而产生的料号12kit套件：类似某型号空调的室内机和室外机，销售以套件计算，库存以子件计算13routable工艺：在母子mo中，子mo的routable件完工后直接转入上层工序中14free stock 低值易耗品15commodity商品：用于商品流通企业16misc：杂项物料，库存实物管理，收货后直接进费用17service服务：无库存18assets资产：定义资产类物料19spare备件：定义备品备件，用于设备维修20ingredient配方：流程行业需要定义配方的物料21repetitive重复：计划过程为repetitive物料作重复计划处理22费用性物料：收货直接进部门费用，不入库uismisc杂项料品boolu 默认为空u 物料形态属性为杂项时,必须为true否则,必须为falsestatus物料状态通用档案dtouisinventoryenable可库存交易booluisinventoryenable可采购booluissalesenable可销售booluisbuildenable可生产booluisoutsideoperationenable可委外booluismrpenable可mrpbooluisbomenable可bombooluisvmienablevmi标志boolu vmi标识的料号才能入vmi仓statuslastmodify状态最近更新日期datetimeustate物料状态枚举：0待核准1核准中2已核准uiscanflowstat可流向统计boolu 修改时,当前料品料品形态属性为以下类型时,系统自动赋值,可流向统计 = false资产,费用性物料,低值易耗品,配方,杂项料品,模型,可选类,pto,计划,工序委外件,工艺refrencecost参考成本decimalisspecialitem专用料boolweightuom重量单位通用档案dtoweight库存单位重量decimalbulkuom体积单位通用档案dtobulk体积decimalisdualuom双单位boolu 如果双单位=“否”，销售单位、采购单位必须等于计价单位u 序列号管理的料品不能双单位isdualqty双数量boolu 是：交易单位数量1和交易单位数量2只能输入整数。u 否：交易单位数量1可以输入小数（decimal），屏蔽交易单位数量2。u 序列号管理的料品不能双数量converratiorule转换率策略枚举0：标准转换率1：物料特定转换率2：先找后者，再找前者isvarratio固定转换率boolismultyuom多单位boolu 默认交易单位与库存单位不同u 序列号管理的料品不能多单位inventoryuom库存主单位通用档案dtou 非空u 计划系统运算数量单位yinventoryuomgroup库存主单位计量单位组int0 时间1 长度2 重量3 面积4 体积5 重量7 财务u 库存主单位对应的计量单位组inventoryseconduom库存单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位costuom成本单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位purchaseuom采购单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位salesuom销售单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位materialoutuom领料单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位manufactureuom生产单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位priceuom计价单位通用档案dtou 创建时,如果为空,系统自动赋值, = 库存主单位snparam序列号参数通用档案dtou 如果为空，则不进行序列号管理成份控制ispotencycontrolboolu 默认 =falseu 物料形态属性 = 5 服务 或 17工序委外件时,成分控制必须为false标准成份standardpotencyint0 a 1 b2 c3 d4 eu 成分控制 = true,必输,标准成分=起始成分并且标准成分=起始等级并且标准等级=1 并且时，非空否则,可空turnoverdays周转天数decimalu 采购控制方法 = 2.物料周转时间非空否则可空avgusageqtycaldays平均用量天数decimalu 采购控制方法 = 1.最高存量限制否则可空avgusageqty平均用量decimalu 采购控制方法 = 1.最高存量限制否则可空isshipmentoverduelot出过期批号boolucostcurrency成本币种通用档案dtoureferrencecost参考成本decimaluisincserialno盘序列号boolu 料序列号管理时有效isinczeroqty零账存盘点booluapprdiffrule允差原则int0-不检查允差 ;1-检查允差比率和绝对允差值;2-检查允差比率或绝对允差值uapprdiffqty允差数量decimalu 核准允差适用原则=0，此项无效不可维护；u 核准允差适用原则0，此项可维护=0apprdiffqtyrate数量允差比decimalu 核准允差适用原则=0，此项无效不可维护；u 核准允差适用原则0，此项可维护=0apprdiffamt允差金额decimalu 核准允差适用原则=0，此项无效不可维护；u 核准允差适用原则0，此项可维护=0apprdiffamtrate金额允差比decimalu 核准允差适用原则=0，此项无效不可维护；u 核准允差适用原则0，此项可维护=0inventoryplanningmethod规划方法int0 最高最低点1 再订货点2 盘点补货法3 固定期间法4 mrp规划5 经济批量法6 不使用物料规划u 0时，库存上限库存下限有效；u 1时，再订货量安全库存有效；u 2时，（库存上限库存下限）和（再订货量安全库存）互斥，不能同时有效； u 3时，（固定期间下次补货日期）和（再订货量）有效；u 4时，需要设置mrp计划方法；u 5时，订单成本持货成本百分比 经济订购量有效；u 6时，本部分字段均无效；supplymethod补货方法int0 按上限/再订货量补货1 按需求补货2 按需求和上限/再订货量的较大量补货u 当规划方法=最高最低点，再订货点，盘点补货法时，非空；否则，为空。inventorymaxlimitqty库存上限decimalu 当物料规划方法=时，非空，输入u 计量单位为库存单位，且库存上限库存下限inventoryminlimitqty库存下限decimalu 当物料规划方法=时，非空，输入u 计量单位为库存单位，且库存上限库存下限fixperiod固定期间(天)decimalu 当物料规划方法=时，非空，输入 其他情况下，可空nextsupplydate下次补货日dateu 当物料规划方法=时，非空，输入 其他情况下，可空safetystocktype安全存量法int0 安全存量期间法1 安全存量法u 0、安全存量直接取安全存量u 1、安全存量=安全存量期间总量*安全存量百分比safetystockperiod安全库存期intu 当安全存量法=时，非空其他情况下，可空safetystockrate安全库存量百分比decimalu 当安全存量法=时，非空其他情况下，可空safetystockqty安全库存量decimalu 计量单位为库存单位wastagerate损耗率decimaluordercost订单成本decimalu 当物料规划方法=时，非空u 其他情况下，可空inventorycostrate持货成本百分比decimalu 当物料规划方法=时，非空u 其他情况下，可空inventoryplantime规划时机int0 及时规划1 批次规划ueconomyorderqty经济订购量decimalu 当物料规划方法=时，非空u 其他情况下，可空u 最佳经济订购量，按库存单位timebucket时格通用档案dtou 当物料规划方法=高低点时，非空reorderqty再订货量decimalu 当物料规划方法=时，非空，输入计量单位为库存单位invtopurmode规划转采购方式int0 协同1 单据u 协同表示转需求计划表u 默认为空单据表示转pr/polotcontrolmode批号控制int0 全部控制1 部分控制2 无ulotparam批号参数通用档案dtou 如果为空，则不进行批号管理lotvaliddate有效期天数intu 如果不进行批号管理，则不需要设置有效期天数，进行批次管理时，可设可不设iscanalbinunmarkcheck渠道库存滞销检查booluisrequiredshippersupply按需求货主补货boolustandardbox库存单位标箱decimaluinternaltranscost内部转移成本decimaluiseffective是否有效boolueffectivedate生效日期dateudisabledate失效日期dateu料品生产相关信息dto全路径名：ufida.u9.isv.item. itemmfginfodto；业务主键：物料名称中文名称类型说明必赋值ididlongu 可空u 默认为空u 创建时为空u 修改时可赋值,id和物料不能同时为空itemmaster物料itemdtou 非空,无需赋值,系统维护buildquanselecttype生产数量选择int0、 依需求量1、 依生产批量u 可空u 默认为空buildbatch生产批量decimalu 可空u 默认为空u 如果生产数量选择=，可空；制令按需求量下，bom按批量算；u 如果生产数量选择=，非空，生产订单量按批量进行生产，bom按批量算buildmultiplier生产倍量longubuildshrinkagerate生产损耗率decimalu 可空u 默认为空u =0 and =0 and =99issuematerialbatchqty发料倍量decimaluminsupplymaterialqty最小发料量decimaluissuematerialsafestockqty发料安全库存量decimalu 可空u 默认为空u 针对线上仓的安全库存量，用于计算发料量issuematerialsafestockperiod安全库存期intuisallowexcessmaterial允许超额领料boolustandardmaterialscale标准超额比例decimalu 允许超额领料为“是”时，非空否则为空isecncontrolecn控制boolucommonroutingmaterial共享工艺物料通用档案dtoucommonbommaterial共享bom物料通用档案dtoulowlevelcode低阶码intupicturecode图号stringubomcontrolmodebom控制方式int0 有效期1 数量控制upurchasepartmakemode采购件自制模式int0 制造件1 虚拟件uisinheritbommasterno继承母项番号boolupreoffsettime提前期偏置时间decimalutimeuom时间单位通用档案dtouproductdepartment生产部门通用档案dtouisbyproduct副产品标示boolu料品采购相关信息dto全路径名：ufida.u9.isv.item. itempurchaseinfodto；业务主键：物料名称中文名称类型说明必输值ididlongu 可空u 默认为空u 创建时为空u 修改时可赋值,id和物料不能同时为空itemmaster物料itemdtou 非空,无需赋值,系统维护isuseapprovesupplier核准供货商boolu 可空u 默认为空u =true,表示只使用已核准的供货商supplier主供应商通用档案dtou 可空u 默认为空u po单体中的建议供应商从此字段取isneedrequest请购boolu 可空u 默认为空isneedinquire询价boolu 可空u 默认为空u 指请购物料时是否需要询价inquirerule询价策略int0、定期1、每次u 可空u 默认= -1u 当询价=，非空inquirefixedperiod间隔期intu 可空u 默认为空u 当询价策略=，非空，其他情况，可空inquirecount询价厂商数intu 可空u 默认为空u 当询价=，非空，输入当询价=，可空u 指是须要询价的家数purchasequotamode配额方式int0：主供应商优先1：主供应商；2：顺序轮流分配；3：按消耗量分配；4：按固定比例分配5：按动态比例分配6:建议供应商u 可空u 默认为空u 0：主供应商优先，超过其最大供货能力后，其它供应商顺序候补；1：只考虑主供应商；2：顺序轮流分配；3：根据各供应商供应物料最近一期消耗量分配；4：逐笔按固定比例分配。5：逐笔按已下订单的历史情况比例进行分配6:建议供应商statisticperiod配额统计期间int0 上月1 本月2 近30天3 上年4 本年u 可空u 默认为空u 采购配额方式为“3. 按消耗量分配”或“5. 按动态比例分配”时候的期间定义u 0. 按计算日期的上一个自然月；2. 计算日期所在自然月，从开始到计算日期。3. 按计算日期起倒溯30天。4. 按上年累计5. 按本年累计purchasebatchqty采购倍量decimalu 可空u 默认为空u 采购倍量为空或=“0”时，表示没有启用采购倍量。否则启用。u 采购倍量为负值时，表示向下倍量。举例：采购数量为95，采购倍量为10，则下单的采购数量为90。u 采购倍量为正值时，通常表示向上倍量，但要受最高采购量和最高库存限制。举例：采购数量为95，采购倍量为10，则下单的采购数量为100。但如果采购最高数量设为99，则只能为90。maxlimitcurrency限价币种通用档案dtou 可空u 默认为空maxlimitprice最高限价decimalu 可空u 默认为空u 最高限价=0，显示不进行采购限价ispricebyquality以质论价boolu 可空u 默认为空purchasedepartment部门通用档案dtou 可空u 默认为空buyer业务员通用档案dtou 可空u 默认为空u 业务员类型=receiptrule收货原则通用档案dtou 可空u 默认为空chargeassignmode费用分配int0、 数量1、 金额2、 重量3、 体积u 可空u 默认为空u 当物料形态属性=非空unnumber联合国码stringu 可空u 默认为空u 联合国识别码。采购管理系统会针对国际贸易的目的，使用un编号来识别特定的物料(如具有危险性的物料)。dangertype危险类别int0 放射物u 可空u 默认为空u 采购管理系统针对国际贸易的目的，使用危险类别来识别危险性物料的种类。receipttype收货方式int0：收货至仓库1：收货至线上仓2：收货至工序3：收货至固定资产4：收货至费用u 可空u 默认为空fixedassetscategory固定资产种类longu 可空u 默认为空u 当物料形态属性=,非空 其他情况下，可空chargeprocessmode费用料处理int0、 领用进费用1、 收货一次进费用u 可空u 默认为空u 当物料形态属性费用性物料时非空pricesource取价来源int0、最近一次采购价；1、市价；2、手工录入；3、最新询价。u 可空u 默认为空istotalagreementpurchase一揽子协议采购boolu 可空u 默认为空u 若物料形态属性=全程委外，则一定=falsestatrule统计期间规则通用档案dtou 可空u 默认 =为空budgetcontroltype预算控制方式int0、自动控制 1、手工执行u 可空u 默认为空quotalimitvalue配额阀值decimalu 可空u 默认为空u 以库存主单位为单位receiptmodeallowmodify收货程序可改booolu 可空u 默认为空receiptmode收货程序int0：收货入库1：收货点收入库2：收货检验入库3：收货点收检验入库4：收货入库检验5：收货点收入库检验u 可空u 默认为空maxlimitpricesource最高限价来源int0 手工（默认值）1 标准成本2最新一次采购价3 最新询价u 可空u 默认为空isreceiptsourcecontrol进货货源控管booolu 可空u 默认为空u 选择y，表示当前物料必须有有效的货源表记录，才能发生采购行为；u 选择n，表示当前物料不必维护货源表，采购的时候，货源表中无有效记录也可以采购，人工在单据上决定供应商；isreturnsourcecontrol退货货源控管booolu 可空u 默认为空u 只有当进货货源控管=y时，才允许为yreturnpricesource退货取价来源int0.手工录入1.最新采购价2.最新询价3.市价4.参考成本u 可空u 默认为空minrcvqty最小叫货量decimalu 可空u 默认为空料品mrp相关信息dto全路径名：ufida.u9.isv.item. itemmrpinfodto；业务主键：物料名称中文名称类型说明必赋值ididlongu 可空u 默认为空u 创建时为空u 修改时可赋值,id和物料不能同时为空itemmaster物料itemdtou 非空,无需赋值,系统维护mrpplanningtype计划方法int0、 mps1、 mrp2、 lrp3、 drp4、 drp+mps5、 drp+mrp。u 可空u 默认为空u 如果物料请购=true，则计划方法不能等于“lrp”。u 如果物料档案.规划方法“mrp规划”，则当计划方法为3、drp，4、drp+mps，5, drp+mrpforecastcontorltype预测控制int0、独立1、独立与相关2、无u 可空u 默认为空istracerequirement需求追溯boolu 可空u 默认为空rearrangetimefence重排时界decimalu 可空u 默认为空overrunratio超量百分比decimalu 可空u 默认为空isreducemps减少mpsboolu 可空u 默认为空planningtimefence计划时界类型int0累计汇总提前期1累计制造提前期2本层制造提前期3使用者定义u 可空u 默认为空u .累计汇总提前期（总生产时间+采购时间）1.累计制造提前期（总生产时间）2.本层制造提前期（本层生产时间）planningtimefencedays计划时界天数decimalu 可空u 默认为空demandtimefenceruletype需求时界原则int0、客户订单1、预测u 可空u 默认为空planningtimefenceruletype计划时界原则int0、客户订单1、预测2、订单或预测最大值3、订单加预测u 可空u 默认为空u 0:时界内以客户订单为主, 1:时界内以预测为主, 2:时界内订单或预测两者那个为大3:时界内需求加预测,demandtimefence需求时界类型int0累计汇总提前期1累计制造提前期2本层制造提前期3使用者定义u 可空u 默认为空demandtimefencedays需求时界天数decimalu 可空u 默认为空releasetimefence发放时界int0累计汇总提前期1累计制造提前期2本层制造提前期3使用者定义4人工发放5使用看板u 可空u 默认为空u 计划订单转化为生产订单时用releasetimefencedays发放时界天数decimalu 可空u 默认为空firmplannedmotimefence计划订单天数decimalu 可空u 默认为空planer默认计划员通用档案dtou 可空u 默认为空u 业务员类型=purforwardprocesslt采购预处理提前期（天）decimalu 可空u 默认为空u 采购用purprocesslt采购处理提前期（天）decimalu 可空u 默认为空u 采购用purbackwardprocesslt采购后处理提前期（天）decimalu 可空u 默认为空u 采购用fixedlt固定提前期（天）decimalu 可空u 默认为空u 生产用，（本层）可系统维护，用bom主替换类型+生产批量 计算得出varietylt变动提前期(天)decimalu 可空u 默认为空u 生产用，（本层）可系统维护，用bom主替换类型+生产批量 计算得出summanufacturelt制造提前期(天)decimalu 可空u 默认为空u 生产用，（本层）可系统维护，用bom主替换类型+生产批量 计算得出sumlt汇总提前期(天)decimalu 可空u 默认为空u 生产用，（本层）可系统维护，用bom主替换类型+生产批量 计算得出ltbatch提前期批量decimalu 可空u 默认为空u 生产用saleforwardprocesslt销售预提前期(天)decimalu 可空u 默认为空u 销售用saleprocesslt销售处理提前期(天)decimalu 可空u 默认为空u 销售用salebackwardprocesslt销售后提前期(天)decimalu 可空u 默认为空u 销售用料品销售相关信息dto全路径名：ufida.u9.isv.item. itemsaleinfodto；业务主键：物料名称中文名称类型说明必赋值ididlongu 可空u 默认为空u 创建时为空u 修改时可赋值,id和物料不能同时为空itemmaster物料itemdtou 非空,无需赋值,系统维护salesdepartment销售部门通用档案dtou 可空u 默认为空salesperson业务员通用档案dtou 可空u 默认为空u 业务员.业务类型=销售业务员minsaleqty最小订货量decimalu 可空u 默认为空maxsaleqty最大订货量decimalu 可空u 默认为空salebatchqty订货批量decimalu 可空u 默认为空limitpricemode销售限价方式int0：定义绝对价格1：按成本定义百分比u 可空u 默认为空limitpriceby限价依据int0：参考成本1：最新结存成本2：最新采购成本u 可空u 默认 = 空u 当销售限价方式=1时输入salelimitcurrency限价币种通用档案dtou 可空u 默认为空minlimitprice最低限价decimalu 可空u 默认为空u 销售限价方式=0时输入u 销售币种/销售单位下的最低限价maxlimitprice最高限价decimalu 可空u 默认为空u 销售限价方式=0时输入u 销售币种/销售单位下的最高限价minlimitpricerate最低限价百分比decimalu 可空u 默认为空u 当销售限价方式=2时有效u 取值范围：0%-%u 最低限价百分比不能高于最高限价百分比maxlimitpricerate最高限价百分比decimalu 可空u 默认为空u 当销售限价方式=2时有效u 取值范围：0%-%salecurrency销售币种通用档案dtou 可空u 默认为空u 销售限价的币种saletaxschedule税组合通用档案dtou 可空u 默认为空supplysource供应来源int0、供应商1、内部组织2、关系企业3、转制令4、当前组织u 可空u 默认为空supplier供应商通用档案dtou 可空u 默认为空u 供应来源 = 0 时非空否则为空supplyorg供应组织通用档案dtou 可空u 默认为空u 供应来源!= 0 时非空否则为空demandtranstype需求转化类型int0、转当前组织采购1、跨组织出货2、转跨组织采购3、转制令4、当前组织出货u 可空u 默认为空u 0、转采购 （注：当前组织的采购）1、出货 （注：如果接单组织和供应组织需要内部核算，则要根据出货单产生内部结算单，进行后续内部结算处理）2、转采购3、转制令4、出货（注：当前组织自己出货）shipmentwarehouse出货地点通用档案dtou 可空u 默认为空uisreturnable可退货boolu 可空u 默认为空isrmaallowmodify退货可改boolu 可空u 默认为空isreturnchecklot退货检查批号boolu 可空u 默认为空isreturnchecksn退货检查序列号boolu 可空u 默认为空ispriceprotectsn检查序列号boolu 可空u 默认为空grossrate毛利率decimalu 可空u 默认为空u =0 and =1isatpcheck可承诺量检查boolu 可空u 默认为空u atp检查=true时，则系统自动进行atp计算 isavailableqtycheck可用量检查boolu 可空u 默认为空u 库存没有启用，此字段则不可用availableqtyrule可用量规则longu 可空u 默认为空 salemindiscount开票最低扣率decimalu 可空u 默认为空familylayer系列件层级int0 产品线1 品牌2 子品牌u 可空u 默认为空familyadscription所属系列件通用档案dtou 可空u 默认为空u 料品形态属性 != 8 系列件时,必空u 系列件层级 = 0 产品线所属系列件为空系列件层级 = 1 产品线所属系列件非空,并且所属系列件系列件层级!= 0 产品线系列件层级 = 2 子品牌所属系列件非空, ,并且所属系列件系列件层级!= 1 品牌isctpctp检查boolu 可空u 默认为空bomorgbom组织通用档案dtou 可空u 默认为空u bom组织工厂组