天力软件在线文档`
精算C1批量导入ERP资料工具操作说明
一 、作用和意义
该工具为天力软件公司开发的所有ERP管理软件提供批量处理资料的功能，将ERP中的资料引入精打细算C1中。该工具的存在为迅速开启商城使用或软件升级提供便捷途径。
二 、操作前提及注意事项
l ERP数据同步C1工具：
http://www.teenysoft.com/download/ftp/C1/jdxs_sync_c1.zip
l ERP数据同步C1工具32位操作系统:
http://www.teenysoft.com/download/ftp/C1/jdxs_sync_c1_32.zip
l 用户在使用该工具前，需要已注册精打细算通行证，并确认在C1中已完成开账操作。
l 需要导入的资料，要事先在ERP资料中设定为“线上商品”。(其他事项参看 4.1 作业)
l 工具文件存储路径不能含中文字符。
l 工具使用系统不同需要下载对应版本的程序，否则系统提示：
l 同步工具支持在线升级，任意版本均可升级到最新版供用户使用。
三 、操作步骤
进入工具后默认打开【首页】。
操作员可以在首页中看到工具运行时长、上次同步时间及同步用时。同时，还可以看到关于同步情况的简单统计数据。
3.1 配置
在第一次使用时，运行jdxs_sync_c1.exe文件开启同步工具。点击同步工具中的 【配置】按钮，进行基础配置。
1.在配置中首先录入此前已申请并通过审核的C1对应版本通行证号码和密码；
注意：
若此操作前并未完成【[操作前提](#_二 操作前提及注意事项)】中所提及的步骤，可以在该界面中通过链接地址直接跳转到相关页面就行操作。
l 通行证链接可以申请精打细算通行证并购买产品（只用商城版，则选择SAAS商城版；使用基础版，则选择SAAS基础版）；
l 精打细算C1后台，需要使用通行证登录后才可见相关功能（例如选择行业，确认行业对应特性）。
2.在配置中录入数据库相关信息，数据库地址、数据库名称和数据库地址端口号（默认1433）等字段为必填项目。
注意：
若客户购买的天力云，由于通行证上本来就存在天力云的相关信息，因此可以直接勾选【天力云服务器】录入对应账套名称（而不用下图红框中的内容）即可快速获取对应信息。
若使用本地数据库或其他云产品存储数据，则在数据库信息框录入对应信息即可。完成该模块信息录入后，都请操作员点击【测试数据库连接】按钮检查数据库连接是否正确。
3. 选择对应ERP产品线，并点击【初始化表和执行存储过程】按钮建立数据对应关系。
注意：【删除中间表】等三个按钮的操作效果类似重建ERP和C1数据对应关系，在需要重新导入数据的情况下可以选择性使用。
4.确认当前使用行业，以及商品所需要管理的最小库存单位
注意：
l 标准化产品单元（SPU）配置字段处，点击【获取特性数据】，选择C1端选择的行业即可。若用户不需要在商城上进行多特性展示，则在此处可以不选择特性。
l ERP数据同步时，erp中的规格字段内容默认导入C1系统的特性1字段中备选，erp中型号字段内容默认导入C1系统的特性2字段中备选。若符合合并规则的商品在自动合并后规格型号不同，则在相同商品下可实现不同商品展示图、价格和库存数据。（类似天猫、京东商城的效果）
l T3中资料以商品编号、名称、计量单位、生产厂家确定商品唯一性（商品合并规则针对不同ERP产品存在差异）。
小结：
以上四个步骤为数据导入前必须进行的基础设置工作，需全部完成并点击【保存】后，再进行数据导入工作。
3.2 同步
完成基础配置后可进行数据同步手动操作或后续自动同步参数设置
1.初次同步进行手动操作时，需要首先点击【登录获取令牌】若通行证和密码验证未通过，则系统提示错误
若系统验证通过，则可进行下一步手动操作：点击【手动同步基本资料】和【手动同步订单单据】按钮。此前若没有操作【登录获取令牌】则系统提示如下图：
注意：
l 此页面中【手动同步基本资料】和【完整同步上架】两个按钮分别对应增量同步数据和完整同步数据两种同步方式。
l 此页面中【手动同步自定任务】按钮对应后续任务设置，在进行基本同步操作时可以不用操作此按钮。（参考章节[4.2 任务]）
l 此页面中【在线升级】是针对该同步工具升级版本用的功能，在使用过程中不会进行新版本提示，只会做版本更新。升级界面如下图：
l 此页面中【重启】和【退出】按钮针对该同步工具进行重启或退出操作，见下图：
2.初次同步进行自动同步设置
a.点击勾选【开机自动运行】选项。需要注意的是，该选项需要提前设置该应用程序的特权等级（右键单击应用程序图标，勾选兼容性中如图示选项即可）。
b.开启【自动交换数据】功能前，需要根据自身情况设置每次同步间隔时间。开启自动交换功能后，时间间隔不允许调整
注意：
自动交换数据功能，对应手动操作内容分别为
小结
同步功能分自动和手动两种，但完全更新只支持手动操作。同步只支持ERP数据向C1中同步，不支持反向同步。
四 、其他操作
4.1 作业
在作业模块中显示的是同步任务中所涉及的所有同步内容对应作业，这些作业可以单独执行。
注意：
l 往来单位联系电话为必填，电话号码只能为13位数字（不能重复），否则资料不会上传；
l 往来单位不上传供应商；
l 职员资料联系电话为必填，电话号码只能为13位数字，电话、姓名不能重复；
l 职员、仓库不上传分类；
l 商品编码不能重复、条码不能重复；
l 价格列表中单位不能重复（商品使用多单位时不能存在重复单位），否则不能上传；
l 商品资料必填项目：商品名称、条码、单位换算比例、单位类型、常用单位；
l C1上删除的商品，不会再次上传；
l C1只支持3级分类，因此ERP中3级分类以上的商品同步后全归类于第3级分类下；
l ERP中往来单位对应的价格方式一、二、三在导入C1后反映为往来单位所属类型A、B、C。
4.2 任务
根据作业列表，选择需要执行的内容；而作业选择的先后顺序即自定任务执行时的先后顺序。在此处保存任务后，同步标签中的【手动同步自定任务】按钮才有对应操作对象。（参考章节[3.2 同步]）
4.3 日志
默认显示最近500行记录，【全部】对应所有操作含成功记录和错误记录，【错误】只显示错误记录，【清空日志】只针对该界面中显示的内容进行清空操作。
注意：
若需要查看所有记录，则可以在文件夹中找到文件jdxs_sync_c1appKettlelog
五 、常见问题
5.1 为何T3规格在手机SKU中可见，但资料对应特性中没有记录？
原因：
这个问题是由于导入资料的特性（T3中的规格或型号）没有与C1中的特性字段（SKU）建立对应关系导致商品资料中的特性无法获取C1中的特性信息。
办法：
A.事前避免。操作员在导入工具中选择特性进行配置时，确认特性中没有具体的内容，防止出现具体内容重复、无法导入特性建立对应关系的情况。
B.事后弥补。操作员在手机端将无效的SKU删除，重新执行特性导入作业和商品资料导入作业；或者重新执行“完全同步资料”。
5.2 为何APP分享工具导入商品会报错
原因：
由于没有开通小程序商城，因此分享商品到商城时会报错（和商品新建途径没有必然联系）
办法：
在C1电脑端访问C1.jdxs.co/saas并在【店铺设置】中申请小程序，进而开通商城。
5.3 为何T3商品有很多条记录但同步工具只能同步几个进去
原因：
部分ERP产品线只支持【线上商品】同步到商城版
办法：
在ERP中检查商品资料，确认商品为线上商品后再进行资料同步操作。
5.4 数据库多实例情况下工具的配置方式****
办法：
1.打开数据库配置工具，菜单中打开【SQL Server网络配置】，启用【TCP/IP】，获取对应端口号。如图：
2.将获取的端口号录入到同步工具中并保存测试链接，如图：
5.5 工具同步资料后进入小程序后看到的LOGO为何与小程序列表中的LOGO不一致
原因：
进入小程序后看到的LOGO来自【商城设置】（与资料同步内容没有必然联系）
办法：
在后台管理端登录后，进入【系统设置】——【商城设置】。上传LOGO图片并保存后重新登录小程序即可。
5.6 同步工具运行报错
原因：
由于安装路径含中文字符，导致运行程序出错
办法：
将安装路径中的中文字符去除，或更换成不含中文字符的路径即可。
5.7 体验小程序时扫码打开看不到内容
原因：
不清楚
办法：
在小程序右上角『···』中点击【开发调试】——【打开调试】，然后刷新页面即可。
附件一 更新功能列表
2023-06-19：（2.0.6.1 版本）
不同步商品分类时，同步无分类为商品默认分类
2023-05-18：（2.0.6.0 版本）
登录后，等待10秒，保证登录能够成功
优化自定义任务执行，不受队列任务限制
增加点三电商平台组合商品同步到ERP功能
数据中台同步优化
单据商品过滤停用
JC同步库存数量错误和单据商品匹配错误
往来单位同步应收应付id更新
解决计量单位重复导致商品同步错误问题
修复单据同步无sku商品没有的问题。
同步往来单位报错id不对问题
2023-01-03：（2.0.5.0 版本）
增加邀请人和运费存储
修复单据同步后，ERP单据过账问题
修复：[“每页多少行必须为大于0的整数,最大200行”]错误
修复判断微信支付或信用额度支付的逻辑，用支付状态判断
更新判断微信支付或信用额度支付的方法，折扣金额 + 支付金额 = 总金额
报价单往来单位分类报价脚本修改
更新冗余同步商品脚本，增加插入数据
修改商品同步标识更新时机，提交C1后更新
T3单据存储过程，去掉删除商品id获取
修复报价单同步sku商品错误
2022-11-29：（2.0.4.0 版本）
对接电商平台数据同步
优化文件读取和sql执行
修复同步成功后不更新日志数据
增加删中间表备份数据库提示
修复删除中间表的语句错误
控制最小同步时间，保证同步次数的有效重启
修改同步时间后自动记录保存
删除中间表数据增加密码校验
优化批量上架，去掉重复行
根据ERP设置，判断同步销售订单草稿还是销售出库单草稿
增加商品冗余同步
2022-08-18：（2.0.3.0 版本）
解决取消自动同步未停止执行任务问题
优化自动同步，使用队列任务执行
优化数据中台，根据配置显示同步标签
2022-08-08：（2.0.2.0 版本）
合并京东商城的单据获取功能
对于双SKU的商品，同步会补全缺失的sku组合，并设置为禁用。
定制文档放入辅助标签页面下。
抽离出精打细算C1标签，为京东同步合并做准备。
更新获取同步失败日志，并显示在数据中台上。
增加定制修改记录页面，用于记录已修改内容。
增加辅助页面，增加商品分类删除接口调用。
优化重启逻辑，避免多次启动。
优化单据同步时间配置文件，单独存放，否则重启可能会导致数据库的配置信息丢失。
优化数据中台，根据配置显示同步标签。
优化自动同步，使用队列任务执行。
2021-11-05：(v1.1.0)
新增首页，显示使用信息
增加资料的同步比例显示
增加资料的合规性检查
增加多SKU多价格的功能
完善修复已知错误
优化药易通V9万条商品同步
增加初始化脚本检查数据库配置
设置只日志打印错误信息
修复批量上架因id为空导致上架中断问题
优化分类上传逻辑
增加药易通V9版本脚本
修复往来单位下职员类型错误
优化同步接口，修复计量单位因空格而超时同步问题
解决商品没有同步型号问题
解决因为商品父分类同步未成功导致子类未同步，从而引起死循环问题
优化同步商品分类逻辑，只同步线上商品的分类（包含父类）
优化同步往来单位分类逻辑，只同步线上往来单位的分类（包含父类）
支持不根据特性合并商品，配置中不选特性即可
修复云服务器测试不成功问题
2021-07-30：(v1.0.0)
增加JC对接导入功能
调整配置界面按钮布局
调整手动同步作业内容
增加删除中间表数据按钮
增加全量时间文件日志
去掉自动同步默认时间
增加同步工具的重启、重建与退出功能
2021-07-12
界面图形化
`
精算C1批量导入ERP资料工具操作说明
一 、作用和意义
该工具为天力软件公司开发的所有ERP管理软件提供批量处理资料的功能，将ERP中的资料引入精打细算C1中。该工具的存在为迅速开启商城使用或软件升级提供便捷途径。
二 、操作前提及注意事项
l ERP数据同步C1工具：
http://www.teenysoft.com/download/ftp/C1/jdxs_sync_c1.zip
l ERP数据同步C1工具32位操作系统:
http://www.teenysoft.com/download/ftp/C1/jdxs_sync_c1_32.zip
l 用户在使用该工具前，需要已注册精打细算通行证，并确认在C1中已完成开账操作。
l 需要导入的资料，要事先在ERP资料中设定为“线上商品”。(其他事项参看 4.1 作业)
l 工具文件存储路径不能含中文字符。
l 工具使用系统不同需要下载对应版本的程序，否则系统提示：
l 同步工具支持在线升级，任意版本均可升级到最新版供用户使用。
三 、操作步骤
进入工具后默认打开【首页】。
操作员可以在首页中看到工具运行时长、上次同步时间及同步用时。同时，还可以看到关于同步情况的简单统计数据。
3.1 配置
在第一次使用时，运行jdxs_sync_c1.exe文件开启同步工具。点击同步工具中的 【配置】按钮，进行基础配置。
1.在配置中首先录入此前已申请并通过审核的C1对应版本通行证号码和密码；
注意：
若此操作前并未完成【[操作前提](#_二 操作前提及注意事项)】中所提及的步骤，可以在该界面中通过链接地址直接跳转到相关页面就行操作。
l 通行证链接可以申请精打细算通行证并购买产品（只用商城版，则选择SAAS商城版；使用基础版，则选择SAAS基础版）；
l 精打细算C1后台，需要使用通行证登录后才可见相关功能（例如选择行业，确认行业对应特性）。
2.在配置中录入数据库相关信息，数据库地址、数据库名称和数据库地址端口号（默认1433）等字段为必填项目。
注意：
若客户购买的天力云，由于通行证上本来就存在天力云的相关信息，因此可以直接勾选【天力云服务器】录入对应账套名称（而不用下图红框中的内容）即可快速获取对应信息。
若使用本地数据库或其他云产品存储数据，则在数据库信息框录入对应信息即可。完成该模块信息录入后，都请操作员点击【测试数据库连接】按钮检查数据库连接是否正确。
3. 选择对应ERP产品线，并点击【初始化表和执行存储过程】按钮建立数据对应关系。
注意：【删除中间表】等三个按钮的操作效果类似重建ERP和C1数据对应关系，在需要重新导入数据的情况下可以选择性使用。
4.确认当前使用行业，以及商品所需要管理的最小库存单位
注意：
l 标准化产品单元（SPU）配置字段处，点击【获取特性数据】，选择C1端选择的行业即可。若用户不需要在商城上进行多特性展示，则在此处可以不选择特性。
l ERP数据同步时，erp中的规格字段内容默认导入C1系统的特性1字段中备选，erp中型号字段内容默认导入C1系统的特性2字段中备选。若符合合并规则的商品在自动合并后规格型号不同，则在相同商品下可实现不同商品展示图、价格和库存数据。（类似天猫、京东商城的效果）
l T3中资料以商品编号、名称、计量单位、生产厂家确定商品唯一性（商品合并规则针对不同ERP产品存在差异）。
小结：
以上四个步骤为数据导入前必须进行的基础设置工作，需全部完成并点击【保存】后，再进行数据导入工作。
3.2 同步
完成基础配置后可进行数据同步手动操作或后续自动同步参数设置
1.初次同步进行手动操作时，需要首先点击【登录获取令牌】若通行证和密码验证未通过，则系统提示错误
若系统验证通过，则可进行下一步手动操作：点击【手动同步基本资料】和【手动同步订单单据】按钮。此前若没有操作【登录获取令牌】则系统提示如下图：
注意：
l 此页面中【手动同步基本资料】和【完整同步上架】两个按钮分别对应增量同步数据和完整同步数据两种同步方式。
l 此页面中【手动同步自定任务】按钮对应后续任务设置，在进行基本同步操作时可以不用操作此按钮。（参考章节4.2 任务）
l 此页面中【在线升级】是针对该同步工具升级版本用的功能，在使用过程中不会进行新版本提示，只会做版本更新。升级界面如下图：
l 此页面中【重启】和【退出】按钮针对该同步工具进行重启或退出操作，见下图：
2.初次同步进行自动同步设置
a.点击勾选【开机自动运行】选项。需要注意的是，该选项需要提前设置该应用程序的特权等级（右键单击应用程序图标，勾选兼容性中如图示选项即可）。
b.开启【自动交换数据】功能前，需要根据自身情况设置每次同步间隔时间。开启自动交换功能后，时间间隔不允许调整
注意：
自动交换数据功能，对应手动操作内容分别为
小结
同步功能分自动和手动两种，但完全更新只支持手动操作。同步只支持ERP数据向C1中同步，不支持反向同步。
四 、其他操作
4.1 作业
在作业模块中显示的是同步任务中所涉及的所有同步内容对应作业，这些作业可以单独执行。
注意：
l 往来单位联系电话为必填，电话号码只能为13位数字（不能重复），否则资料不会上传；
l 往来单位不上传供应商；
l 职员资料联系电话为必填，电话号码只能为13位数字，电话、姓名不能重复；
l 职员、仓库不上传分类；
l 商品编码不能重复、条码不能重复；
l 价格列表中单位不能重复（商品使用多单位时不能存在重复单位），否则不能上传；
l 商品资料必填项目：商品名称、条码、单位换算比例、单位类型、常用单位；
l C1上删除的商品，不会再次上传；
l C1只支持3级分类，因此ERP中3级分类以上的商品同步后全归类于第3级分类下；
l ERP中往来单位对应的价格方式一、二、三在导入C1后反映为往来单位所属类型A、B、C。
4.2 任务
根据作业列表，选择需要执行的内容；而作业选择的先后顺序即自定任务执行时的先后顺序。在此处保存任务后，同步标签中的【手动同步自定任务】按钮才有对应操作对象。（参考章节[3.2 同步](#_3.2 同步)）
4.3 日志
默认显示最近500行记录，【全部】对应所有操作含成功记录和错误记录，【错误】只显示错误记录，【清空日志】只针对该界面中显示的内容进行清空操作。
注意：
若需要查看所有记录，则可以在文件夹中找到文件jdxs_sync_c1appKettlelog
五 、常见问题
5.1 为何T3规格在手机SKU中可见，但资料对应特性中没有记录？
原因：
这个问题是由于导入资料的特性（T3中的规格或型号）没有与C1中的特性字段（SKU）建立对应关系导致商品资料中的特性无法获取C1中的特性信息。
办法：
A.事前避免。操作员在导入工具中选择特性进行配置时，确认特性中没有具体的内容，防止出现具体内容重复、无法导入特性建立对应关系的情况。
B.事后弥补。操作员在手机端将无效的SKU删除，重新执行特性导入作业和商品资料导入作业；或者重新执行“完全同步资料”。
5.2 为何APP分享工具导入商品会报错
原因：
由于没有开通小程序商城，因此分享商品到商城时会报错（和商品新建途径没有必然联系）
办法：
在C1电脑端访问C1.jdxs.co/saas并在【店铺设置】中申请小程序，进而开通商城。
5.3 为何T3商品有很多条记录但同步工具只能同步几个进去
原因：
部分ERP产品线只支持【线上商品】同步到商城版
办法：
在ERP中检查商品资料，确认商品为线上商品后再进行资料同步操作。
5.4 数据库多实例情况下工具的配置方式****
办法：
1.打开数据库配置工具，菜单中打开【SQL Server网络配置】，启用【TCP/IP】，获取对应端口号。如图：
2.将获取的端口号录入到同步工具中并保存测试链接，如图：
5.5 工具同步资料后进入小程序后看到的LOGO为何与小程序列表中的LOGO不一致
原因：
进入小程序后看到的LOGO来自【商城设置】（与资料同步内容没有必然联系）
办法：
在后台管理端登录后，进入【系统设置】——【商城设置】。上传LOGO图片并保存后重新登录小程序即可。
5.6 同步工具运行报错
原因：
由于安装路径含中文字符，导致运行程序出错
办法：
将安装路径中的中文字符去除，或更换成不含中文字符的路径即可。
5.7 体验小程序时扫码打开看不到内容
原因：
不清楚
办法：
在小程序右上角『···』中点击【开发调试】——【打开调试】，然后刷新页面即可。
附件一 更新功能列表
2023-06-19：（2.0.6.1 版本）
不同步商品分类时，同步无分类为商品默认分类
2023-05-18：（2.0.6.0 版本）
登录后，等待10秒，保证登录能够成功
优化自定义任务执行，不受队列任务限制
增加点三电商平台组合商品同步到ERP功能
数据中台同步优化
单据商品过滤停用
JC同步库存数量错误和单据商品匹配错误
往来单位同步应收应付id更新
解决计量单位重复导致商品同步错误问题
修复单据同步无sku商品没有的问题。
同步往来单位报错id不对问题
2023-01-03：（2.0.5.0 版本）
增加邀请人和运费存储
修复单据同步后，ERP单据过账问题
修复：[“每页多少行必须为大于0的整数,最大200行”]错误
修复判断微信支付或信用额度支付的逻辑，用支付状态判断
更新判断微信支付或信用额度支付的方法，折扣金额 + 支付金额 = 总金额
报价单往来单位分类报价脚本修改
更新冗余同步商品脚本，增加插入数据
修改商品同步标识更新时机，提交C1后更新
T3单据存储过程，去掉删除商品id获取
修复报价单同步sku商品错误
2022-11-29：（2.0.4.0 版本）
对接电商平台数据同步
优化文件读取和sql执行
修复同步成功后不更新日志数据
增加删中间表备份数据库提示
修复删除中间表的语句错误
控制最小同步时间，保证同步次数的有效重启
修改同步时间后自动记录保存
删除中间表数据增加密码校验
优化批量上架，去掉重复行
根据ERP设置，判断同步销售订单草稿还是销售出库单草稿
增加商品冗余同步
2022-08-18：（2.0.3.0 版本）
解决取消自动同步未停止执行任务问题
优化自动同步，使用队列任务执行
优化数据中台，根据配置显示同步标签
2022-08-08：（2.0.2.0 版本）
合并京东商城的单据获取功能
对于双SKU的商品，同步会补全缺失的sku组合，并设置为禁用。
定制文档放入辅助标签页面下。
抽离出精打细算C1标签，为京东同步合并做准备。
更新获取同步失败日志，并显示在数据中台上。
增加定制修改记录页面，用于记录已修改内容。
增加辅助页面，增加商品分类删除接口调用。
优化重启逻辑，避免多次启动。
优化单据同步时间配置文件，单独存放，否则重启可能会导致数据库的配置信息丢失。
优化数据中台，根据配置显示同步标签。
优化自动同步，使用队列任务执行。
2021-11-05：(v1.1.0)
新增首页，显示使用信息
增加资料的同步比例显示
增加资料的合规性检查
增加多SKU多价格的功能
完善修复已知错误
优化药易通V9万条商品同步
增加初始化脚本检查数据库配置
设置只日志打印错误信息
修复批量上架因id为空导致上架中断问题
优化分类上传逻辑
增加药易通V9版本脚本
修复往来单位下职员类型错误
优化同步接口，修复计量单位因空格而超时同步问题
解决商品没有同步型号问题
解决因为商品父分类同步未成功导致子类未同步，从而引起死循环问题
优化同步商品分类逻辑，只同步线上商品的分类（包含父类）
优化同步往来单位分类逻辑，只同步线上往来单位的分类（包含父类）
支持不根据特性合并商品，配置中不选特性即可
修复云服务器测试不成功问题
2021-07-30：(v1.0.0)
增加JC对接导入功能
调整配置界面按钮布局
调整手动同步作业内容
增加删除中间表数据按钮
增加全量时间文件日志
去掉自动同步默认时间
增加同步工具的重启、重建与退出功能
2021-07-12
界面图形化
