金蝶知识库文档K/3V11.0BOS新增单据案例本期概述�本文档适用于实施、服务人员。�当完成本文档学习之后，您将能够掌握用BOS集成开发工具开发新单据时常用的字段、ACTION等，并能够独立开发新单据。版本信息�V1.0编写人：刘胜霞2008年7月29日�V2.0审核人：唐静2008年9月2日�本文件使用须知著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。著作权声明著作权所有2008金蝶软件（中国）有限公司。所有权利均予保留。金蝶软件（中国）有限公司客户服务中心第1页共20页金蝶知识库文档目录第一章单据配置的业务背景..............................................................................................................3第二章单据配置..................................................................................................................................31案例...................................................................................................................................................32单据字段配置...................................................................................................................................52.1新建业务单据...........................................................................................................................52.2配置业务单据的字段..............................................................................................................62.2.1修改单据名称..................................................................................................................................62.2.2配置“单据编号”..........................................................................................................................72.2.3配置“制单人、制单日期、审核人、审核日期”字段...............................................................82.2.4配置“供应商、部门、业务员”字段........................................................................................112.2.5配置“物料代码、物料名称、规格型号、计量单位、收料仓库、收料仓位”字段.............112.2.6配置“实收数量、已钩稽数量、单价、金额、税率、税额、价税合计”字段.....................143生成凭证配置................................................................................................................................17第三章常见问题................................................................................................................................19金蝶软件（中国）有限公司客户服务中心第2页共20页金蝶知识库文档第一章单据配置的业务背景客户的需求是多样的，而软件是通用的，K/3预设的单据、流程不一定与客户的需求完全吻合，此时，我们就可以使用BOS集成开发工具新增、配置符合客户业务的单据和流程。第二章单据配置1案例ABC公司主营业务是生产和销售各种高档卫浴五金、水暖器材等。拥有五个厂区，产品外销欧美、日本等国家和地区，其模式如图1。图1为了统一物流管理，解决重复请购、资金占用严重的问题，ABC公司提出了寄存仓的管理模式，与供应商之间通过统一窗口来管理。如图1所示，供应商将物料寄存到ABC公司指定的物流中心仓库，此时所有权依然属于供应商，ABC公司再根据生产实际需求从物流中心领料，并进行相应的结算处理。金蝶软件（中国）有限公司客户服务中心第3页共20页金蝶知识库文档图2我们的BOS解决方案是在原有流程基础上增加一张寄存入库单，这样既与系统原有单据紧密集成，同时又满足了企业的业务需求。1．寄存入库单字段具体描述如表1：字段类型字段名所在单据体特殊要求单据编号单据编号FBillNo单据头JCRKD+日期+四位流水号制单人制单人FBillerID单据头自动填写操作员的用户名制单日期日期FDate单据头缺省为当前日期审核人用户FCheckerID单据头自动填写操作员的用户名审核日期长日期FCheckDate单据头审核后自动反填审核日期供应商核算项目-供应商FSupplyID单据头部门核算项目-部门FDeptID单据头业务员核算项目-职员FEmpID单据头备注备注FNote单据头物料代码核算项目-物料FItemID单据体1物料名称基础资料相关属性-FName单据体1规格型号基础资料相关属性-FGgxh单据体1计量单位计量单位FUnitID单据体1携带物料属性中的库存计量单位收料仓库核算项目-仓库FDCStockID单据体1携带物料属性中的默认仓库收料仓位基础资料-仓位FDCSPID单据体1当“收料仓库”不进行仓位管理时，不允许录入。实收数量数量FCommitQty单据体1关联时允许修改已钩稽数量数量FFinishQty单据体1作为扣减字段使用单价单价FPrice单据体1单价=金额/实收数量金蝶软件（中国）有限公司客户服务中心第4页共20页金蝶知识库文档金额金额FAmount单据体1金额=实收数量*单价税率小数FTaxRate单据体1取物料属性中的税率税率=税额/（实收数量*单价）税额小数FTax单据体1税额=数量*单价*税率价税合计小数FTotal单据体1价税合计=金额+税额表12单据字段配置2.1新建业务单据在BOS中先单击菜单“视图——项目窗口”，显示出项目窗口后，选中“业务单据”，单击右键，点击“新建业务单据”（如图3），自动进入“新建业务单据”界面（如图4）。图3金蝶软件（中国）有限公司客户服务中心第5页共20页金蝶知识库文档图4新建业务单据：新建一张空白的单据。复制已有单据模板：如果需要新建的单据，和系统中已有的某张单据比较类似，则选择“复制已有单据模板”。温馨提醒：选择“复制已有单据模板”时，只能复制新单据，如应收/付系统的单据、进/出口的单据，而不能复制所有的工业单据，即供应链系统的单据。2.2配置业务单据的字段2.2.1修改单据名称新建完单据后，第一步需要处理的是修改单据名称为“寄存入库单”。单击菜单“视图——属性窗口”，调出属性窗口，然后修改“简体名称、繁体名称、英文名称”，如图5。金蝶软件（中国）有限公司客户服务中心第6页共20页金蝶知识库文档图52.2.2配置“单据编号”根据案例，我们需要先增加“单据编号”字段。1．增加“单据编号”字段新建单据时，系统会自动生成“单据编号”字段，不允许删除，且一张单据上只能有一个“单据编号”字段。图62．配置单据编码规则新增单据编码规则后，可以设置单据编码规则。在单据空白处，单击右键，调出图7。金蝶软件（中国）有限公司客户服务中心第7页共20页金蝶知识库文档图7选择“编码规则设置”，则进入单据编码规则设置界面，如图8。图8单据编码规则的设置方式与供应链的所有单据设置相同。单据编码规则除了在BOS集成开发工具处设置外，还可以在K/3主控台——系统设置——系统设置——仓存管理等子系统——单据设置中设置，界面与图8相同，但是要求BOS单据必须发布到主控台。2.2.3配置“制单人、制单日期、审核人、审核日期”字段1．制单人——制单人单击菜单视图——工具窗口，调出图9中的“工具箱”。从工具箱中选择“制单人”，在寄存入库单空白处放开鼠标，则自动生成“制单人”字段。“制单人”字段的内容是系统预设的，不需要做任何配置，保存单据时自动写上操作员的用户名。金蝶软件（中国）有限公司客户服务中心第8页共20页金蝶知识库文档图92．制单日期、审核日期——日期图10案例要求“制单日期”在保存时自动记录为系统当天的日期，且不允许修改。因此，我们必须先新增“制单日期”字段，并设置在新增、修改、审核时都锁定，设置为“必录”项。选择“日期”字段类型，新增“制单日期”字段，然后在属性窗口中，单击“锁定”对应的按钮，选择“新增时、修改时、审核后锁定”，并选择“必录”选项，这样系统就会自动填写“制单日期”。温馨提醒：“日期”类型仅显示年月日，若要显示到年月日时分秒，则可以选择长金蝶软件（中国）有限公司客户服务中心第9页共20页金蝶知识库文档日期类型。图11就是两种日期类型的区别。图11“审核日期”字段的设置与“制单日期”相同，但是要实现在审核后自动填写上“审核日期”，还需要在多级审核流程中设置“业务审核日期”为此字段，如图12。（多级审核的具体设置流程请参见BOS单据多级审核案例及流程.doc）图123．审核人——用户“审核人”需要选择“用户”字段类型来设置。“用户”字段的内容是系统预设的，除修改名称外，不需要做任何配置。案例要求执行审核操作时自动填写操作员的用户名，则必须在多级审核流程中设置业务审核人为此字段。金蝶软件（中国）有限公司客户服务中心第10页共20页金蝶知识库文档2.2.4配置“供应商、部门、业务员”字段图13从工具箱中选择“核算项目字段库”，再选择对应的核算项目类型，在寄存入库单上放开即可，注意在属性窗口中设置“基础资料相关属性”为“名称”。根据案例，在属性窗口中修改“职员”为“业务员”，并把这三项都设置为“必录”。“备注”字段：选择工具箱中“常规字段库——备注”即可。2.2.5配置“物料代码、物料名称、规格型号、计量单位、收料仓库、收料仓位”字段1．物料代码、物料名称、规格型号1）物料代码：从工具箱——核算项目字段库中选择“物料”类型。注意在属性窗口中设置简体中文标题为“物料代码”，基础资料相关属性为“代码”。我们需要设置“物料代码”为必录项，所以需要在“属性窗口”中选择“必录”。2）物料名称、规格型号：从工具箱——常规字段库中选择“基础资料属性”类型添加字段到单据体中。在属性窗口中修改简体中文标题为“物料名称/规格型号”，来源字段为“物料代码”，携带字段为“物料名称/规格型号”。温馨提醒：因为很多工业单据都是根据物料代码带出物料名称，因此，为了以后设置单据转换流程正确，建议采用根据物料代码带出物料名称的方式。若使用根据物料名称带出物料代码的方式，则在单据转换流程中容易发生错误。增加了物料名称、规格型号后，系统自动在物料代码的值更新事件中添加事件，如图金蝶软件（中国）有限公司客户服务中心第11页共20页金蝶知识库文档14。图14注释：1）值更新事件：本字段的值发生改变，并且光标从本字段离开时会发生的事件，若要求物料代码改变时，物料名称、规格型号、计量单位等都随之改变，则需要设置物料代码的值更新事件（如图14）。2）加载更新事件：单据加载（如新增、保存、修改等）时，不做任何操作，系统就会处理的事件。2．计量单位从工具箱——常用字段库中选择“计量单位”字段类型，添加到单据体中，在属性窗口中选择“必录”。案例要求计量单位字段自动带出“物料的库存计量单位”字段，因此，需要设置“物料代码的值更新事件”。（因为计量单位是随着“物料代码”的改变而改变的，因此值更新事件要设置在引起变化的字段上，即“物料代码”上。）图15金蝶软件（中国）有限公司客户服务中心第12页共20页金蝶知识库文档值更新事件选择“携带当前字段相关基础资料属性到指定列”，设置如图15。3．收料仓库、收料仓位从“核算项目字段库”中选择“仓库”，从“常用字段库”中选择“仓位”。案例要求“收料仓库”携带物料属性中的默认仓库，因此需要设置物料代码的值更新事件“携带当前字段相关基础资料属性到指定列”，如图16。图16案例要求当“收料仓库”不进行仓位管理时，不允许录入。因为仓位是否允许录入是由于“收料仓库”字段的“是否进行仓位管理”决定的，因此，必须设置收料仓库的值更新事件，如图17。图17金蝶软件（中国）有限公司客户服务中心第13页共20页金蝶知识库文档2.2.6配置“实收数量、已钩稽数量、单价、金额、税率、税额、价税合计”字段1．字段设置1）实收数量、已钩稽数量：从常规字段库中选择“数量”字段。因为“已钩稽数量”字段是为设置“单据转换流程”准备的，所以，在任何情况下都不允许修改。因此，在属性窗口中设置锁定属性为“在新增时、修改时、审核后锁定”。2）单价：从常规字段库中选择“单价”字段。选择“数量、单价”字段类型加入到单据体中后，在“物料代码”的值更新事件中自动添加了一项控制数量、单价小数位数的事件SetDecimal。此事件可以控制数量、单价字段的小数位取基础资料——物料属性中的数量/单价精度。但是此事件不能配置，删除后也不能手工添加。假设在此案例中，假设“已钩稽数量”字段不再需要，需要删除，则必须先删除物料代码的SetDecimal事件。然而，此事件中还包含了“实收数量、单价”的精度设置，一旦删除，“实收数量、单价”的精度也不能设置，小数位自动为10位。案例中，我们要求“实收数量、单价”小数位数必须取基础资料——物料属性中的数量/单价精度，此时就必须把“实收数量、单价”两列都删除，再重新添加这两列，才可以在“物料代码”字段中自动添加SetDecimal事件。图18温馨提醒：因为数量依赖于计量单位，而计量单位依赖于物料，因此添加数量、单价字段时，系统要求必须按物料——计量单位——数量/单价的顺序来添加，否则会报错。3）金额、税额、价税合计：从常规字段库中选择“金额”字段。4）税率：从常规字段库中选择“小数”字段。案例要求自动取物料属性中的税率，因此需要设置物料代码的值更新事件“携带当前字段相关基础资料属性到指定列”，目标字段为“单据体1.税率”，源字段为物料属性中的“税率”。2．公式设置根据案例：金蝶软件（中国）有限公司客户服务中心第14页共20页金蝶知识库文档金额=实收数量*单价单价=金额/实收数量税额=实收数量*单价*税率税率=税额/（实收数量*单价）价税合计=金额+税额1）因为金额=实收数量*单价，因此在“实收数量、单价”字段设置值更新事件如图18：图18因为税额=实收数量*单价*税率，所以还需要设置“实收数量、单价、税率”字段的值更新事件（因为税率字段带出来的值是已经乘100后的值，因此需要除100）。2）因为当金额变动时要引起单价的变动，因此需要设置“金额”字段的值更新事件为因为价税合计=金额+税额，因此还需要设置“金额”字段的值更新事件为3）因为当税额手工修改时需要系统自动计算税率，因此需要设置“税额”字段的值更新事件为因为价税合计=金额+税额，因此还需要设置“税额”字段的值更新事件为4）价税合计=金额+税额，且金额=实收数量*单价，税额=实收数量*单价*税率，可以看出“价税合计”是由“实收数量、单价、税率”得到“金额、税额”字段的值，再由“金金蝶软件（中国）有限公司客户服务中心第15页共20页金蝶知识库文档额、税额”计算得到的。一般情况下，客户都只录入数量、单价，由系统自动计算出金额、税额、价税合计，因此需要由“实收数量、单价”来触发“金额、税额”的值更新事件，由“税率”来触发“税额”的值更新事件，计算出价税合计。当“金额”改变时，“单价”会随之而变，从而导致“税额”改变，最终引起“价税合计”的改变。因此，需要由“金额”来触发“单价”的值更新事件，重新计算出税额、价税合计。因此，为了让“价税合计”自动计算出结果，我们还需要设置“实收数量、单价、税率”的值更新事件如图19。图195）因为“金额”字段值发生变化时，首先根据单价=金额/数量，倒算出单价，而系统会根据实收数量*单价*税率=税额重新计算税额，从而引起价税合计的变化，因此在“金额”字段的值更新事件中还需要设置“触发字段值更新事件”，被触发的字段就是“单价”字段。此外，价税合计是在金额、税额确定下来后才能计算的，因此金额字段的值更新事件应如图20。图20以上三个事件分别对应：Ⅰ计算单价，单价=金额/数量Ⅱ触发单价的值更新事件，根据税额=实收数量*单价*税率，计算出税额。Ⅲ计算价税合计：价税合计=金额+税额。因为必须在金额、税额都确定以后才可以计算价税合计，因此要把此项放在最后。温馨提醒：如图20所示，系统会根据值更新事件的顺序来计算单据上各字段的值，因此，在设置值更新事件是要注意顺序。金蝶软件（中国）有限公司客户服务中心第16页共20页金蝶知识库文档更多值更新事件请参考帮助手册中的“动作设置”篇。3生成凭证配置1．添加“凭证字号”字段单据要生成凭证，首先必须要添加“凭证字号”字段（从工具箱——常规字段库选择“凭证字号”拖放到寄存入库单上）。因为凭证字号不需要在录入单据时显示，只需要在序时簿显示，因此在属性窗口中选择“可见性”，如图21。图212．设置凭证数据来源单击菜单编辑——凭证数据来源设置，调出图22。金蝶软件（中国）有限公司客户服务中心第17页共20页金蝶知识库文档金蝶软件（中国）有限公司客户服务中心第18页共20页图221）来源表：必录字段，可以选择当前单据的“单据头、单据体”，图22中的“原币金额字段至单价字段”的可选字段都必须是“来源表”中所选择表的字段。2）原币金额字段：必录字段，选择该条金额来源的原币金额字段。制作凭证模板时，“金额来源”只能选择到此字段所选择的值。3）币别、汇率字段：默认值为本位币币别。当需要按币别生成凭证时，在此处设置。4）单位、数量、单价字段：当科目进行“数量金额辅助核算”时，生成的凭证上需要反应单位、数量、单价，则需要在此处选择这三项内容。5）检验值：非必录字段，默认值为1.0。设定当前金额来源的检验值，用于凭证模板【检查模板平衡性的校验】依据。温馨提醒：以上所有可以选择的字段都必须在属性窗口中设置为“必录”。图23金蝶知识库文档6）会计期间取数依据：必录选项，选择业务单据子系统，用以判断凭证业务期间是否正确。7）单据业务日期字段：必录选项，显示当前单据所有必录日期字段，选择业务单据日期。按以上步骤设置完后，就可以参照供应链单据的处理方式：先设置凭证模版，再根据单据生成凭证。第三章常见问题1、录入单据时，第一行所有数据录入完后，按Enter键，光标自动显示在第二行上，保存此单，查看序时簿时显示一条无物料且数量为0的记录，为什么？怎样预防这种情况发生？图24答：必须在属性窗口中设置单据体的关键字段，如下图即可。图25如果单据体中设置了必录项（如物料代码），则按问题描述操作时，系统提示“必须录金蝶软件（中国）有限公司客户服务中心第19页共20页金蝶知识库文档入物料代码”，若此单只有一条分录，则必须点菜单“编辑——删除一行”删除第二行才可以保存，因此，建议最好设置单据体的关键字段。2、若单据体中各列的顺序不合理，需要调整，怎样处理？怎样删除单据体中的某一列？答：双击单据体，系统调出“表格设置界面”，如图26，在此界面拖拽即可调整各字段的顺序。图26选中某列，单击“删除”按钮即可以删除。金蝶软件（中国）有限公司客户服务中心第20页共20页
