T1导⼊入好⽣生意使⽤用⼿手册版本号：V2.20190111⾯面向读者：好⽣生意的客户，畅捷通伙伴的服务⼈人员⽬目录：1.名词解释2.⼯工作原理理3.使⽤用步骤及注意事项4.导T1数据的checklist5.商品和往来单位中英⽂文字段对照表⼀一.名称解释：T1导⼊入⼯工具:好⽣生意开发的⼀一个客户端⼯工具，需要从⽹网站下载，下载路路径：好⽣生意新⼿手导航-》数据初始化-》数据搬家-》点击下载⼯工具。该⼯工具的作⽤用是把t1的基础数据（商品、往来单位、库存期初、往来期初、商品价格本、商品历史价格）导⼊入到好⽣生意的帐套⾥里里。该⼯工具仅⽀支持windows系统安装。⼆二.⼯工作原理理：简述：导⼊入⼯工具读取t1数据库后根据要导⼊入数据的类别先⽣生成各⾃自类别的excel⽂文件，(这个时候磁盘io较⼤大，客户端程序会假死状态)，导⼊入客户端再并发调⽤用好⽣生意后台服务上传这些excel⽂文件，插⼊入到好⽣生意数据库⾥里里。三：使⽤用步骤及注意事项：3.0通过以下⽅方式获取T1导⼊入⼯工具：登陆好⽣生意，点击左侧边栏最下⽅方的“新⼿手引导”—>“数据初始化”—>“下载升级⼯工具”，下载后可直接安装，安装只需要三步，如下图1:Page of 1123.1使⽤用畅捷通的账号登陆导⼊入⼯工具，如图2:图23.2登陆成功后，导⼊入⼯工具读取该账号下全部企业信息及企业下的帐套信息。在导⼊入⼯工具⾸首⻚页上⽅方选择好要导⼊入的畅捷通企业和帐套。3.3通过指定t1数据库ip、⽤用户、密码的⽅方式连接t1的数据库。仅⽀支持ip，不不⽀支持域名\机器器名称的⽅方式来指定数据库地址，必须是ip。点击“测试连接”按钮，客户端连接t1的sqlserver数据库。连接成功后会在下⽅方的下拉列列表⾥里里显示t1全部的帐套信息。选择某个帐套，就是把这个t1帐套的数据往好⽣生意的帐套⾥里里导⼊入。数据库连接失败的话，需要检测数据库密码是否正确、请关闭系统防⽕火墙、杀毒软件最好也暂停。⽬目前已经验证t1导⼊入⼯工具⽬目前对12.6到13.0版本的t1的数据库访问都正常，11.1的t1能访问成功但读取不不到t1的帐套信息，解决⽅方法是把11.1的t1的数据备份出来导⼊入到⾼高版本的t1数据库⾥里里再导⼊入。⻅见下图3:Page of 212图33.4点击下⼀一步，务必先选择往来单位和商品，导⼊入往来单位和商品成功后再导⼊入期初和价格。因为如果往来单位和商品没有导⼊入完整，其商品价格、往来期初、库存期初的数据就会因为找不不到商品、往来单位⽽而不不会导进好⽣生意。导⼊入往来单位的逻辑：以t1⾥里里往来单位名称作为唯⼀一约束导进好⽣生意，如果t1的往来单位名称为空或者重复的时候，导⼊入⼯工具后台把往来单位ID作为名称导⼊入到好⽣生意⾥里里。⽀支持往来单位名称重复的数据允许导⼊入，我们⽤用往来单位名称+往来单位id的⽅方式更更新t1⾥里里往来单位的名称，再上传到好⽣生意⾥里里。导⼊入商品的逻辑：以t1⾥里里商品的编码作为唯⼀一约束导进好⽣生意，如果t1的商品编码为空，好⽣生意的后台服务把商品编码为空的商品id作为商品编码插⼊入t1的商品数据库⾥里里，然后再上传到好⽣生意⾥里里；若商品编码重复，好⽣生意后台⾃自动把商品ID插⼊入到商品编码前，并⽤用下划线分割。当遇到商品名称重复的数据允许导⼊入，不不会修改商品名称。若导⼊入的商品有批次管理理和保质期管理理，需要在导⼊入前在好⽣生意系统设置选项设置中勾选批次管理理和保质期管理理。商品价格遇到t1⼩小数点精度⼤大于好⽣生意⼩小数点精度的时候，导⼊入失败。需要⼿手动修改好⽣生意⼩小数点精度。精度⼀一旦调⼤大⽬目前不不⽀支持再调⼩小。Page of 312从t1⾥里里查找出商品和往来单位的条数的逻辑：好⽣生意的开发写的sql语句句来搜索，过滤掉了了停⽤用的往来单位和商品；注意，商品价格本导⼊入没有过滤掉停⽤用商品的价格，因为我们直接使⽤用t1的存储过程sql来查找的价格本，所以价格本导⼊入失败的记录检查下是不不是商品已经停⽤用了了。图43.5点击下⼀一步，选择覆盖还是跳过。默认不不会勾选，若没有勾选时点击下⼀一步会提示⽤用户勾选。下⾯面的覆盖导⼊入会把全部数据重新导⼊入⼀一遍，这种情况适合更更新数据，确保数据跟数据源⼀一致。上⾯面的选项是已存在的数据不不导⼊入，只导⼊入不不存在的数据。这种情况导⼊入速度快。Page of 412图53.6点击下⼀一步，程序⽴立即开始导⼊入。此时导⼊入⼯工具可能会有卡死状态，取决于机器器的配置和数据量量⼤大⼩小。导⼊入3万条以上的商品、并且该商品没有商品编码时，导⼊入过程会很⻓长，⼤大约3个多⼩小时。因为程序要为商品⾃自动⽣生成唯⼀一商品编码。Page of 512图6注意：客户端不不会⾃自动刷新上传进度，需要⼿手⼯工点击获取当前导⼊入进度。导⼊入完毕，在“下载失败记录“列列⾥里里显示“下载失败记录”，双击直接下载到本，打开可以看到每条记录的数据和对应的失败的原因。这个导⼊入⼯工具不不适⽤用XP和MAC系统，在这两个系统上部分功能会不不好⽤用。Page of 612Page of 712提示失败的问题举例例解决⽅方案往来单位失败的原因有：业务错误:字段[mobile]的值⽆无效,消息：Overthemaximumlength:50是由于T1⾥里里的联系⼈人电话和移动电话内容过⻓长了了，需要把部分电话剪切到其他字段⾥里里，⽐比如传真、地址。商品失败的原因有：业务错误:商品内条码不不能重复主计量量和辅计量量的条码不不允许重复业务错误:商品名称及规格型号重复修改下规格，使商品名称和规格不不完全⼀一致业务错误:字段[lastPurchasePrice]的值[0.22500000]⽆无效,消息：valuebiztypeerror,⼩小数点位数超出系统配置:2需要修改下t1⾥里里最新进价⼩小数点数字⻓长度或者在好⽣生意⾥里里系统管理理的通⽤用设置修改下数量量⼩小数位。像0.22500000，⼩小数点位数设为3即可，后⾯面的零忽略略业务错误:商品基本辅助计量量单位换算率不不合法没有按国际公认的换算率设置，⽐比如公⽄斤与⽄斤的换算率是1:2.往来期初失败的原因有：ApBeginning.custVendorCode:往来客户不不存在往来单位没有导⼊入，需要把对应的往来单位先导⼊入再导⼊入往来期初库存期初失败的原因有：productIdcode:productIdcode不不存在与productIdcode对应的商品没有导⼊入商品价格失败的原因有：业务错误:商品已经使⽤用，不不允许修改最新售价、最新进价若⼀一定要修改最新售价、最新进价，需要删除期初和历史价格，再导⼊入最新售价和最新进价业务错误:产品编码或单位名称不不能为空商品编码或往来单位名称为空的数据不不允许导⼊入价格，需要把商品编码、往来单位名称补上再导⼊入价格业务错误:商品与计量量单位不不符合导⼊入要求：计量量单位在当前商品中不不存在检查下计量量单位是否正确匹配历史价格失败的原因有：业务错误:计量量单位不不存在检查下计量量单位是否⼀一致3.7导⼊入完毕后验证⽅方法：往来单位验证⽅方法：先验证好⽣生意⾥里里往来单位的总数是否等于t1⾥里里的总数；然后随机点取⼏几条往来单位查看常⽤用项“往来单位编码、名称、分类、性质、联系⼈人信息”，以及该条往来单位在T1⾥里里设置的数据（⾃自定义项和地区管理理）有没有带过来。商品验证⽅方法：先验证条数是否相等（注意T1⾥里里停⽤用的商品不不会导⼊入到好⽣生意⾥里里）；对⽐比好⽣生意商品⾥里里的“商品编码、名称、分类、规格型号、计量量单位（多计量量单位和换算率）”，是否有“批次管理理、保质期”(这两项需要在导⼊入数据之前在好⽣生意的“系统设置-》选项设置-》销售设置⾥里里勾选”)、是否有⾃自定义项。注意：商品等级价格不不会在导⼊入商品时候全部带过来，商品价格是在导⼊入商品之后再导⼊入商品价格本的时候才会同步到已导⼊入的商品⾥里里。库存期初验证⽅方法：核对总数往来期初验证⽅方法：核对总数价格本验证⽅方法：随机抽取部分样本数据对⽐比价格。可以先在T1⾥里里选择多个等级价格的商品再去好⽣生意⾥里里对⽐比。价格本出现导⼊入失败的情况先查明导⼊入失败的商品在T1⾥里里是否是已停⽤用商品，停⽤用商品价格我们不不导⼊入。历史价格验证⽅方法：随机验证。历史价格出现导⼊入失败的情况先查明导⼊入失败的商品在T1⾥里里是否是已停⽤用商品，停⽤用商品价格我们不不导⼊入。Page of 812四：伙伴去客户现场，需要对客户的数据了了解以下⽅方⾯面，填写好每项checklist，⽅方便便之后的数据导⼊入过程顺利利。Page of 912五：商品和往来单位中英⽂文字段对照表5.1商品中英⽂文列列名对照表英⽂文列列名中⽂文列列名code商品编码name商品名称baseUomBarcode主计量量条码productCategoryName商品分类名称productTypeDescription商品类型valuationMethodEnum计价⽅方式specNo规格型号productBrandName品牌名称madeIn产地taxRate税率(%)taxCategoryCode税收分类编码primaryVendName默认供应商defaultWarehouseName仓库名称comments备注statusEnum状态productLabelList营销标签isMultiUomEnabled启⽤用多计量量baseUomId主计量量单位auxUomId辅计量量单位1auxUomConversionRate辅计量量1换算率auxUomIsFloating辅计量量1是否浮动换算auxUomBarcode辅计量量1条码fromUomId1辅计量量单位2conversionRate1辅计量量2换算率fromUomBarcode1辅计量量2条码英⽂文列列名Page of 10125.2往来单位中英⽂文列列名对照表reportUomName报表辅计量量purchaseUomId采购单位salesUomId销售单位inventoryUomId库存单位secondPurchaseUomId采购单位2secondSalesUomId销售单位2refCostPrice参考成本lastPurchasePrice最新进价minQuantity最低库存maxQuantity最⾼高库存safeQuantity安全库存lotCtrlEnabled批次管理理lotExpCtrlEnabled保质期管理理shelfLife保质期shelfLifeUomEnum保质期单位中⽂文列列名英⽂文列列名英⽂文列列名中⽂文列列名code往来单位编码primaryPartyCategoryName分类名称partyName往来单位名称partyRoleTypeId性质CustVendor.orgUnit.orgUnitName往来单位名称adminByEmployeeId分管⼈人员adminByDepartmentId分管部⻔门description备注pricingLevelEnum客户价格等级英⽂文列列名codePage of 1112defaultDiscount商品折扣（％）isPurIncludingTax采购报价含税CustVendor.orgUnit.legalRepresentative法⼈人代表CustVendor.orgUnit.openingBank开户银⾏行行CustVendor.orgUnit.bankAccountNo账号CustVendor.orgUnit.taxNo纳税号CustVendorContact.address1详细地址CustVendorContact.province省/州CustVendorContact.city城市CustVendorContact.disctrict区CustVendorContact.area街道CustVendorContact.contactName联系⼈人CustVendorContact.qqQQ号CustVendorContact.wechat微信号primaryContactId主联系⼈人paymentTermsEnum收款条件billingDay账期⽇日statusEnum状态CustVendorContact.mobile联系电话CustVendorContact.fax传真号CustVendorContact.email电⼦子邮件CustVendorContact.telephone电话号码pricingMethodEnum定价⽅方法billingPeriod结账周期中⽂文列列名往来单位编码英⽂文列列名codePage of 1212
