BOS新增单据案例2008.7.29

K/3V11.0BOS新增单据案例

本期概述

 本文档适用于实施、服务人员。  当完成本文档学习之后，您将能够掌握用BOS集成开发工具开发新单据时常用的字

段、ACTION等，并能够开发新单据。

版本信息

 V1.0编写人： 2008年7月29日

 本文件使用须知

著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。 著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。

著作权声明 著作权所有 2008 金蝶软件（中国）有限公司。 所有权利均予保留。

金蝶软件（中国）有限公司 客户服务中心 第 1 页 共 21 页

金蝶知识库文档

目 录

第一章 单据配置的业务背景 .............................................................................................................. 3 第二章 单据配置 .................................................................................................................................. 3 1案例 ................................................................................................................................................... 3 2单据字段配置 ................................................................................................................................... 5 2.1新建业务单据 ........................................................................................................................... 5 2.2 配置业务单据的字段 .............................................................................................................. 6

2.2.1 修改单据名称 .................................................................................................................................. 6 2.2.2 配置“单据编号” .......................................................................................................................... 7 2.2.3 配置“制单人、制单日期、审核人、审核日期”字段 ............................................................... 8 2.2.4 配置“供应商、部门、业务员”字段 ........................................................................................ 11 2.2.5 配置“物料代码、物料名称、规格型号、计量单位、收料仓库、收料仓位”字段 ............. 12 2.2.6 配置“实收数量、已钩稽数量、单价、金额、税率、税额、价税合计”字段 ..................... 14

3 生成凭证配置 ................................................................................................................................ 17 第三章 常见问题 ................................................................................................................................ 19

金蝶软件（中国）有限公司 客户服务中心 第 2 页 共 21 页

金蝶知识库文档

第一章 单据配置的业务背景

客户的需求是多样的，而软件是通用的，K/3预设的单据、流程不一定与客户的需求完全吻合，此时，我们就可以使用BOS集成开发工具新增、配置符合客户业务的单据和流程。

第二章 单据配置

1案例

ABC公司主营业务是生产和销售各种高档卫浴五金、水暖器材等。拥有五个厂区，产品外销欧美、日本等国家和地区，其模式如图1。

图1

为了统一物流管理，解决重复请购、资金占用严重的问题，ABC公司提出了寄存仓的管理模式，与供应商之间通过统一窗口来管理。

如图1所示，供应商将物料寄存到ABC公司指定的物流中心仓库，此时所有权依然属于供应商，ABC公司再根据生产实际需求从物流中心领料，并进行相应的结算处理。

金蝶软件（中国）有限公司 客户服务中心 第 3 页 共 21 页

金蝶知识库文档

图2

我们的BOS解决方案是在原有流程基础上增加一张寄存入库单，这样既与系统原有单据紧密集成，同时又满足了企业的业务需求。

1．寄存入库单字段具体描述如表1：

字段 单据编号 制单人 制单日期 审核人 审核日期 供应商 部门 业务员 备注 物料代码 物料名称 规格型号 计量单位 收料仓库 收料仓位 类型 单据编号 制单人 日期 用户 长日期 核算项目-供应商 核算项目-部门 核算项目-职员 备注 核算项目-物料 字段名 FBillNo FBillerID FDate FCheckerID FCheckDate FSupplyID FDeptID FEmpID FNote FItemID 所在单据体 单据头 单据头 单据头 单据头 单据头 单据头 单据头 单据头 单据头 单据体1 单据体1 单据体1 单据体1 单据体1 单据体1 特殊要求 JCRKD+日期+四位流水号 自动填写操作员的用户名 缺省为当前日期 自动填写操作员的用户名 审核后自动反填审核日期 携带物料属性中的库存计量单位 携带物料属性中的默认仓库 当“收料仓库”不进行仓位管理时，不允许录入。 实收数量 已钩稽数量 单价 数量 数量 单价 FCommitQty FFinishQty FPrice 单据体1 单据体1 单据体1 关联时允许修改 作为扣减字段使用 单价=金额/实收数量 基础资料相关属性-FName 名称 基础资料相关属性-FGgxh 规格型号 计量单位 核算项目-仓库 基础资料-仓位 FUnitID FDCStockID FDCSPID 金蝶软件（中国）有限公司 客户服务中心 第 4 页 共 21 页

金蝶知识库文档

金额 税率 金额 小数 FAmount FTaxRate 单据体1 单据体1 金额=实收数量*单价 取物料属性中的税率 税率=税额/（实收数量*单价） 税额=数量*单价*税率 价税合计=金额+税额 税额 价税合计 小数 小数 FTax FTotal 单据体1 单据体1 表1

2单据字段配置

2.1新建业务单据

在BOS中先单击菜单“视图——项目窗口”，显示出项目窗口后，选中“业务单据”，单击右键，点击“新建业务单据”（如图3），自动进入“新建业务单据”界面（如图4）。

图3

金蝶软件（中国）有限公司 客户服务中心 第 5 页 共 21 页

金蝶知识库文档

图4

新建业务单据：新建一张空白的单据。

复制已有单据模板：如果需要新建的单据，和系统中已有的某张单据比较类似，则选择“复制已有单据模板”。

温馨提醒：选择“复制已有单据模板”时，只能复制新单据，如应收/付系统的单据、进/出口的单据，而不能复制所有的工业单据，即供应链系统的单据。

2.2 配置业务单据的字段 2.2.1 修改单据名称

新建完单据后，第一步需要处理的是修改单据名称为“寄存入库单”。

单击菜单“视图——属性窗口”，调出属性窗口，然后修改“简体名称、繁体名称、英文名称”，如图5。

金蝶软件（中国）有限公司 客户服务中心 第 6 页 共 21 页

金蝶知识库文档

图5

2.2.2 配置“单据编号”

根据案例，我们需要先增加“单据编号”字段。 1． 增加“单据编号”字段

新建单据时，系统会自动生成“单据编号”字段，不允许删除，且一张单据上只能有一个“单据编号”字段。

图6

2．配置单据编码规则

新增单据编码规则后，必定要设置单据编码规则。 在单据空白处，单击右键，调出图7。

金蝶软件（中国）有限公司 客户服务中心 第 7 页 共 21 页

金蝶知识库文档

图7

选择“编码规则设置”，则进入单据编码规则设置界面，如图8。

图8

单据编码规则的设置方式与供应链的所有单据设置相同。

单据编码规则除了在BOS集成开发工具处设置外，还可以在K/3主控台——系统设置——系统设置——仓存管理等子系统——单据设置中设置，界面与图8相同，但是要求BOS单据必须发布到主控台。

2.2.3 配置“制单人、制单日期、审核人、审核日期”字段

1．制单人——制单人

单击菜单视图——工具窗口，调出图9中的“工具箱”。

从工具箱中选择“制单人”，在寄存入库单空白处放开鼠标，则自动生成“制单人”字段。“制单人”字段的内容是系统预设的，不需要做任何配置，保存单据时自动写上操作员的用户名。

金蝶软件（中国）有限公司 客户服务中心 第 8 页 共 21 页

金蝶知识库文档

图9

2．制单日期、审核日期——日期

图10

案例要求“制单日期”在保存时自动记录为系统当天的日期，且不允许修改。因此，我们必须先新增“制单日期”字段，并设置在新增、修改、审核时都锁定，设置为“必录”项。

选择“日期”字段类型，新增“制单日期”字段，然后在属性窗口中，单击“锁定”对应的按钮，选择“新增时、修改时、审核后锁定”，并选择“必录”选项，这样系统就会自动填写“制单日期”。

温馨提醒：“日期”类型仅显示年月日，若要显示到年月日时分秒，则可以选择长

金蝶软件（中国）有限公司 客户服务中心 第 9 页 共 21 页

金蝶知识库文档

日期类型。图11就是两种日期类型的区别。

图11

“审核日期”字段的设置与“制单日期”相同（12与制单人不相同，不能设置为必录，但是要锁定王艳090322），但是要实现在审核后自动填写上“审核日期”，还需要在多级审核流程中设置“业务审核日期”为此字段，如图12。（多级审核的具体设置流程请参见

K/3V11.0 BOS单据多级审核案例及流程 本期概述  本文档适用于实施、服务人员。  当完成本文档学习之后，您将能够了解BOS单据多级审核设置流程、消息配置流程、流转配置及多级审核常见问题等。 版本信息  V1.0 编写人：  本文件使用须知 著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。 著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。 著作权声明 著作权所有 2007 金蝶软件（中国）有限公司 。 所有权利均予保留。 ）

金蝶软件（中国）有限公司 客户服务中心 第 10 页 共 21 页

金蝶知识库文档

图12

3．审核人——用户

“审核人”需要选择“用户”字段类型来设置。“用户”字段的内容是系统预设的，除修改名称外，不需要做任何配置。案例要求执行审核操作时自动填写操作员的用户名，则必须在多级审核流程中设置业务审核人为此字段。

2.2.4 配置“供应商、部门、业务员”字段

图13

从工具箱中选择“核算项目字段库”，再选择对应的核算项目类型，在寄存入库单上放开即可，注意在属性窗口中设置“基础资料相关属性”为“名称”。

根据案例，在属性窗口中修改“职员”为“业务员”，并把这三项都设置为“必录”。

金蝶软件（中国）有限公司 客户服务中心 第 11 页 共 21 页

金蝶知识库文档

“备注”字段：选择工具箱中“常规字段库——备注”即可。

2.2.5 配置“物料代码、物料名称、规格型号、计量单位、收料仓库、收料仓位”字段

1．物料代码、物料名称、规格型号

1）物料代码：从工具箱——核算项目字段库中选择“物料”类型。注意在属性窗口中设置简体中文标题为“物料代码”，基础资料相关属性为“代码”。我们需要设置“物料代码”为必录项，所以需要在“属性窗口”中选择“必录”。

2）物料名称、规格型号：从工具箱——常规字段库中选择“基础资料属性”类型添加字段到单据体中。在属性窗口中修改简体中文标题为“物料名称/规格型号”，来源字段为“物料代码”，携带字段为“物料名称/规格型号”。

温馨提醒：因为很多工业单据都是根据物料代码带出物料名称，因此，为了以后设

置单据转换流程正确，建议采用根据物料代码带出物料名称的方式。若使用根据物料名称带出物料代码的方式，则在单据转换流程中容易发生错误。

增加了物料名称、规格型号后，系统自动在物料代码的值更新事件中添加事件，如图14。

图14

注释：

1）值更新事件：本字段的值发生改变时会发生的事件，若要求物料代码改变时，物料名称、规格型号、计量单位等都随之改变，则需要设置物料代码的值更新事件（如图14）。

2）加载更新事件：打开单据录入界面，不做任何操作，系统就会处理的事件。 2．计量单位

金蝶软件（中国）有限公司 客户服务中心 第 12 页 共 21 页

金蝶知识库文档

从工具箱——常用字段库中选择“计量单位”字段类型，添加到单据体中，在属性窗口中选择“必录”。案例要求计量单位字段自动带出“物料的库存计量单位”字段，因此，需要设置“物料代码的值更新事件”。（因为计量单位是随着“物料代码”的改变而改变的，因此值更新事件要设置在引起变化的字段上，即“物料代码”上。）

图15

值更新事件选择“携带当前字段相关基础资料属性到指定列”，设置如图15。 3．收料仓库、收料仓位

从“核算项目字段库”中选择“仓库”，从“常用字段库”中选择“仓位”。

案例要求“收料仓库”携带物料属性中的默认仓库，因此需要设置物料代码的值更新事件“携带当前字段相关基础资料属性到指定列”，如图16。

图16

案例要求当“收料仓库”不进行仓位管理时，不允许录入。因为仓位是否允许录入是由于“收料仓库”字段的“是否进行仓位管理”决定的，因此，必须设置收料仓库的值更新事件，如图17。

金蝶软件（中国）有限公司 客户服务中心 第 13 页 共 21 页

金蝶知识库文档

图17

2.2.6 配置“实收数量、已钩稽数量、单价、金额、税率、税额、价税合计”字段

1．字段设置

1）实收数量、已钩稽数量：从常规字段库中选择“数量”字段。

因为“已钩稽数量”字段是为设置“单据转换流程”准备的，所以，在任何情况下都不允许修改。因此，在属性窗口中设置锁定属性为“在新增时、修改时、审核后锁定”。

2）单价：从常规字段库中选择“单价”字段。

选择“数量、单价”字段类型加入到单据体中后，在“物料代码”的值更新事件中自动添加了一项控制数量、单价小数位数的事件SetDecimal。此事件可以控制数量、单价字段的小数位取基础资料——物料属性中的数量/单价精度。但是此事件不能配置，删除后也不能手工添加。

假设在此案例中，假设“已钩稽数量”字段不再需要，需要删除，则必须先删除物料代码的SetDecimal事件。然而，此事件中还包含了“实收数量、单价”的精度设置，一旦删除，“实收数量、单价”的精度也不能设置，小数位自动为10位。案例中，我们要求“实收

金蝶软件（中国）有限公司 客户服务中心 第 14 页 共 21 页

金蝶知识库文档

数量、单价”小数位数必须取基础资料——物料属性中的数量/单价精度，此时就必须把“实收数量、单价”两列都删除，再重新添加这两列，才可以在“物料代码”字段中自动添加SetDecimal事件。

图18

温馨提醒：因为数量依赖于计量单位，而计量单位依赖于物料，因此添加数量、单

价字段时，系统要求必须按物料——计量单位——数量/单价的顺序来添加，否则会报错。

3）金额、税额、价税合计：从常规字段库中选择“金额”字段。（只有选择“金额”字段时，才可以在凭证数据来源设置中选择。）

4）税率：从常规字段库中选择“小数”字段。案例要求自动取物料属性中的税率，因此需要设置物料代码的值更新事件“携带当前字段相关基础资料属性到指定列”，目标字段为“单据体1.税率”，源字段为物料属性中的“税率”。

温馨提醒：以上所有的字段我们都要求审核后不允许修改，因此需要在属性窗口中

选择“锁定”，选择“审核后锁定”，否则会出现审核后单据依然可以修改。

2．公式设置 根据案例：

金额 = 实收数量 * 单价 单价 = 金额 / 实收数量 税额 = 实收数量 * 单价 * 税率 税率 = 税额 / （实收数量*单价） 价税合计 = 金额 + 税额

1）因为金额 = 实收数量 * 单价，因此在“实收数量、单价”字段设置值更新事件如图18：

金蝶软件（中国）有限公司 客户服务中心 第 15 页 共 21 页

金蝶知识库文档

图18

因为税额 = 实收数量 * 单价 * 税率，所以还需要设置“实收数量、单价、税率”字段的值更新事件

税率字段带出来的值是以百分数计算的，因此需要除100）。

2）因为当金额变动时要引起单价的变动，因此需要设置“金额”字段的值更新事件为

因为价税合计 = 金额 + 税额，因此还需要设置“金额”字段的值更新事件为

3）因为当税额手工修改时需要系统自动计算税率，因此需要设置“税额”字段的值更新事件为

（因为

因为价税合计 = 金额 + 税额，因此还需要设置“税额”字段的值更新事件为

4）价税合计=金额+税额，且金额=实收数量*单价，税额=实收数量*单价*税率，可以看出“价税合计”是由“实收数量、单价、税率”得到“金额、税额”字段的值，再由“金额、税额”计算得到的。一般情况下，客户都只录入数量、单价，由系统自动计算出金额、税额、价税合计，因此需要由“实收数量、单价”来触发“金额、税额”的值更新事件，由“税率”来触发“税额”的值更新事件，计算出价税合计。当“金额”改变时，“单价”会随之而变，从而导致“税额”改变，最终引起“价税合计”的改变。因此，需要由“金额”来触发“单价”的值更新事件，重新计算出税额、价税合计。因此，为了让“价税合计”自动计算出结果，我们还需要设置“实收数量、单价、税率”的值更新事件如图19。

金蝶软件（中国）有限公司 客户服务中心 第 16 页 共 21 页

金蝶知识库文档

图19

5）因为“金额”字段值发生变化时，首先根据单价 = 金额 / 数量，倒算出单价，而系统会根据 实收属性 * 单价 * 税率 = 税额重新计算税额，从而引起价税合计的变化，因此在“金额”字段的值更新事件中还需要设置“触发字段值更新事件”，被触发的字段就是“单价”字段。此外，价税合计是在金额、税额确定下来后才能计算的，因此金额字段的值更新事件应如图20。

图20

以上三个事件分别对应：

Ⅰ 计算单价，单价 = 金额 / 数量

Ⅱ 触发单价的值更新事件，根据税额 = 实收数量 * 单价 * 税率，计算出税额。 Ⅲ 计算价税合计：价税合计 = 金额 + 税额。因为必须在金额、税额都确定以后才可以计算价税合计，因此要把此项放在最后。

温馨提醒：如图20所示，系统会根据值更新事件的顺序来计算单据上各字段的值，

因此，在设置值更新事件是要注意顺序。

更多值更新事件请参考帮助手册中的“动作设置”篇。

3 生成凭证配置

1．添加“凭证字号”字段

单据要生成凭证，首先必须要添加“凭证字号”字段（从工具箱——常规字段库选择“凭证字号”拖放到寄存入库单上）。

金蝶软件（中国）有限公司 客户服务中心 第 17 页 共 21 页

金蝶知识库文档

因为凭证字号不需要在录入单据时显示，只需要在序时簿显示，因此在属性窗口中选择“可见性”，设置单据录入时不可见，单据序时簿可见，如图21。

图21

2．设置凭证数据来源

单击菜单编辑——凭证数据来源设置，调出图22。

图22

金蝶软件（中国）有限公司 客户服务中心 第 18 页 共 21 页

金蝶知识库文档

1）来源表：必录字段，可以选择当前单据的“单据头、单据体”，图22中的“原币金额字段至单价字段”的可选字段都必须是“来源表”中所选择表的字段。

2）原币金额字段：必录字段，选择该条金额来源的原币金额字段。“凭证模板金额来源”只能选择到此字段所选择的值。

3）币别、汇率字段：默认值为本位币币别。当需要按币别生成凭证时，在此处设置。 4）单位、数量、单价字段：当科目进行“数量金额辅助核算”时，生成的凭证上需要反应单位、数量、单价，则需要在此处选择这三项内容。

5）检验值：非必录字段，默认值为1.0。设定当前金额来源的检验值，用于凭证模板【检查模板平衡性的校验】依据。

温馨提醒：以上所有可以选择的字段都必须在属性窗口中设置为“必录”。

图23

6）会计期间取数依据：必录选项，选择业务单据子系统，用以判断凭证业务期间是否正确。

7）单据业务日期字段：必录选项，显示当前单据所有必录日期字段，选择业务单据日期。

按以上步骤设置完后，就可以参照供应链单据的处理方式：先设置凭证模版，再根据单据生成凭证。

第三章 常见问题

1、录入单据时，第一行所有数据录入完后，按Enter键，光标自动显示在第二行上，保存此单，查看序时簿时显示一条无物料且数量为0的记录，为什么？怎样预防这种情况发生？

金蝶软件（中国）有限公司 客户服务中心 第 19 页 共 21 页

金蝶知识库文档

图24

答：必须在属性窗口中设置单据体的关键字段，如下图即可。

图25

如果单据体中设置了必录项（如物料代码），则按问题描述操作时，系统提示“必须录入物料代码”，若此单只有一条分录，则必须点菜单“编辑——删除一行”删除第二行才可以保存，因此，建议最好设置单据体的关键字段。

2、生成凭证是能否多张单据汇总生成一张凭证？当一张凭证上有多条相同的分录时能否合并？

答：多张单据汇总生成凭证：K/3 V10.4上有补丁处理：PT010885，11.0已经实现。 凭证相同分录汇总不能实现，12.0已经规划。

3、若单据体中各列的顺序不合理，需要调整，怎样处理？怎样删除单据体中的某一列？ 答：双击单据体，系统调出“表格设置界面”，如图26，在此界面拖拽即可调整各字段的顺序。

金蝶软件（中国）有限公司 客户服务中心 第 20 页 共 21 页

金蝶知识库文档

图26

选中某列，单击“删除”按钮即可以删除。

金蝶软件（中国）有限公司 客户服务中心 第 21 页 共 21 页