如何将 iFirma 连接到 easySales：完整设置指南

连接 iFirma 能带来什么

iFirma（ifirma.pl）是一款波兰在线会计与开票软件。连接到 easySales 后，它为你的订单开具发票：easySales 发送买方和订单的每一行，iFirma 创建并编号一张波兰国内增值税发票（faktura krajowa），发票 PDF 保存在订单上。在接受发票的平台上，例如 Allegro，发票也会发送到平台。

开始之前，有三点需要了解：

• easySales 需要 "faktura" API 密钥，以及你的 iFirma 登录信息。 iFirma 有四个 API 密钥，只使用名为 faktura 的那个。你在 iFirma 中生成它，然后连同你登录 iFirma 所用的电子邮件地址一起粘贴到 easySales。
• 保存时不会检验密钥。 用户名或密钥填错，要到开具第一张发票时才会显现，所以连接后请立即开具一张测试发票。
• 更正在 iFirma 中进行。 在 easySales 中作废或删除发票，只会把它从订单上移除；发票仍保留在 iFirma 中，你需要在那里更正或作废。

开始之前

第 1 步 — 在 iFirma 中生成 "faktura" API 密钥

1. 登录 ifirma.pl，进入 Konfiguracja → Rozszerzenia i integracje → API（配置 → 扩展与集成 → API）。
2. 点击 Aktywuj dostęp podstawowy（激活基础访问）。
3. 在名为 faktura 的密钥旁点击 wygeneruj（生成），然后复制密钥。

第 2 步 — 在 easySales 中连接 iFirma

进入 整合方式 → 计费软件，搜索 ifirma，在 iFirma 卡片上点击 连接——如果之前连接过，则点击 编辑。

第 3 步 — 发票备注

模板 是写入每张发票备注（Uwagi）中的文字。点击按钮即可加入订单信息——订单 ID、平台、标签号、付款方式——也可以输入你自己的文字。

显示高级选项 会展开更多设置：将赠品作为单独的折扣、从买方信息中移除特殊字符、每张发票附带保修单，以及发票上不显示折扣。

点击 保存，然后从某个订单开具一张测试发票。

开具发票

• 从订单开具：在订单的 发票 区域，点击 创建发票，然后选择 iFirma。
• 批量开具：在订单列表中选中订单，打开 操作，选择 生成发票，再选择 iFirma。每个订单都会得到各自的发票。
• 自动开具：在 流程 中，添加 创建发票 操作并选择你的 iFirma 连接。

iFirma 收到的内容：

• 买方：公司或客户名称、账单地址、电子邮件和电话。
• 行项目：每个产品及其在订单中的数量、含税价格和增值税税率，运费作为单独一行。
• 日期：开票日期是你开具发票的当天，销售日期是订单日期。
• 编号：发票由 iFirma 编号。

KSeF

对于 iFirma 发票，easySales 不会向 KSeF 发送任何内容：由 iFirma 按照它自己的 KSeF 设置发送。在 iFirma 的 KSeF → Konfiguracja KSeF（KSeF 配置）中，你可以选择通过 API 开具的发票是自动发送到 KSeF，还是按需发送。

iFirma 拒绝发票时

原因会显示在订单上：