TaxJar 集成允许 ERPNext 用户根据客户、公司和交货地址自动计算税费。
如何设置 TaxJar?
TaxJar 账户和 API 令牌:
您需要从您的账户中获取 API 令牌才能设置 TaxJar。
- 首先根据您的需求创建一个 TaxJar 账户。
- 登录您的账户仪表板,点击 账户 按钮,然后在下拉选项列表中点击 TaxJar API。
- 您现在将看到您的 API 令牌,配置 ERPNext TaxJar 集成时需要用到这些令牌。
在 TaxJar 中添加 Nexus 和州:
什么是 Nexus?
您无需在每个州都注册以向客户收取销售税。您只需向居住在您拥有 Nexus 的州的客户收取销售税!
“Nexus” 是一种与某个州的特定联系,这种联系足以要求您遵守该州的销售税法。
我如何知道我在哪里拥有 Nexus?
您通常会在您所在的所在州拥有 Nexus。
有关更多详细信息,请务必阅读 TaxJar 官方网站上关于 Nexus 的页面!
添加州:
请按照 TaxJar 官方网站上此处提供的关于在您的仪表板中添加/删除州的详细说明,请从头到尾遵循他们的指示,这将帮助您完美地设置一切。
在 ERPNext 上设置 TaxJar:
在桌面端点击“TaskJar”图标。这将重定向到 TaxJar 工作区。
带有 TaxJar 桌面图标的 Frappe 桌面
点击“TaxJar 设置”。这是您在 ERPNext 中配置 TaxJar 集成的地方。
TaxJar 工作区
填写
TaxJar 设置表单视图
沙盒模式:
TaxJar 提供了一个用于自动化测试和开发的沙盒环境。生成沙盒 API 令牌后,将您的 API 客户端指向沙盒环境:https://api.sandbox.taxjar.com]。请注意,沙盒交易不会反映在您的 TaxJar 仪表板中。要在开发期间进行故障排除,请使用 TaxJar API 日志。
日志记录:
- 当在 TaxJar 设置 中勾选“启用 TaxJar 日志记录”时,TaxJar 请求/响应/跳过/错误将写入 TaxJar API 日志和文件日志中。
- 当未勾选“启用 TaxJar 日志记录”时,税务逻辑仍会运行,但不会写入新的 TaxJar 日志条目。
TaxJar API 日志列表视图
请求和响应数据存储在日志中,
TaxJar API 日志表单视图
设置令牌和科目:
- 启用税费计算,创建 TaxJar 交易:
- 您需要启用这些选项以进行自动税费计算,这些交易将出现在您的 TaxJar 账户交易页面上,您可以在那里跟踪它们并分析税费明细。
- 一旦您进行了一些交易,它们将自动出现在您的 TaxJar 交易 页面上:
- 您可以查看所有已进行的交易以及详细的税费明细。
- 按照上述说明从您的 TaxJar 账户复制 API 令牌,并将其粘贴到 实时 API 密钥 和 沙盒 API 密钥字段 中。
- 您需要为税费和运费设置两个科目,根据需要选择科目,一旦所有内容配置完毕,点击保存即可开始使用!
设置正确的地址
为使集成无缝运行,请确保您已为公司、客户、供应商等创建了正确的地址。
注意:
- 创建地址时,请确保在 州/省 字段中输入正确的州。TaxJar 要求州使用两个字母的格式,例如,纽约被视为 NY,但并非必须以该方式输入,系统会自动将其转换为两个字母的州代码。
地址表单视图 - 您可以勾选 首选账单地址 和 首选送货地址 复选框,以在不同发票中自动填充这些字段,避免麻烦。
- 确保您已正确填写 城市/城镇、州/省、国家、邮政编码 字段。
- 您可能需要禁用默认设置的任何税费(如果有)。
TaxJar 实战!
在此示例中,我们有一家位于 纽约 的公司,我们正在向同一州内的客户开具销售发票。
如您所见,基于州和邮政编码的税费和费用会在保存时自动应用。