如何将 Fakturownia 连接到 easySales：完整设置指南
将 Fakturownia 连接到 easySales：域名和 API 令牌、部门和仓库、发票类型和语言、高级选项、更正发票以及 Fakturownia 返回的消息。
连接 Fakturownia 能带来什么
把 Fakturownia 作为计费软件连接后，easySales 会直接在你的 Fakturownia 账户中为订单开具发票——发票上包含客户、产品、运费和折扣——并把发票关联到订单。之后你可以在订单里打开发票、登记付款、开具更正发票，以及作废或删除发票。如果需要，每张发票还会在 Fakturownia 中同时生成一张 WZ 仓库单据。
动手之前，有两点需要了解：
- 发票号码由 Fakturownia 生成。 easySales 既不发送号码，也不发送系列；Fakturownia 会按照你在 Fakturownia 中的编号设置，为每张发票分配其所属部门的下一个号码。
- 表单分两步展开。 先填写域名和令牌，然后点击 取得详细资料；之后才会出现部门、仓库、发票设置和 保存 按钮。
开始之前
一个 Fakturownia 账户
能够访问 Ustawienia（设置），以便在其中创建 API 令牌。
Fakturownia 中的仓库
仓库是必填字段。仓库属于 Obsługa magazynów（仓库管理）功能，你可以在 Ustawienia → Ustawienia konta → Twoje konto 中开启。
在 Fakturownia 中设置好编号
Fakturownia 会为每张发票编号，所以请在开具第一张发票前检查其编号设置。
第 1 步 — 找到你的域名并创建 API 令牌
- 登录 Fakturownia。你的域名就是地址栏中的名称：在
https://mojsklep.fakturownia.pl中，域名是mojsklep。 - 打开 Ustawienia → Ustawienia konta → Integracja（设置 → 账户设置 → 集成），在 Kod autoryzacyjny API（API 授权码）下点击 Zobacz APITokeny（查看 API 令牌）。
- 点击 Dodaj nowy token（添加新令牌），填写描述，例如
easySales，然后保存。 - 复制令牌。下一步你要把它粘贴到 easySales 中。
第 2 步 — 在 easySales 中连接 Fakturownia
进入 整合方式 → 计费软件，搜索 fakturownia，在 Fakturownia 卡片上点击 连接——如果之前连接过，则点击 编辑。
填写前三个字段，然后点击 取得详细资料：
| 字段 | 填写内容 |
|---|---|
| 连接名称 |
一个便于你在多个连接中识别的名称，例如 Fakturownia webshop。
|
| 域 |
只填写你的 Fakturownia 账户名——mojsklep，而不是 https://mojsklep.fakturownia.pl。
|
| 代币 | 第 1 步中创建的 API 令牌。 |
取得详细资料 会向 Fakturownia 验证令牌，并从中读取你的部门、仓库和类别。重新打开已保存的连接时，表单又只显示前三个字段：点击 取得详细资料 即可查看并修改其余设置。
第 3 步 — 部门、仓库和发票设置
| 字段 | 作用 |
|---|---|
| 部门 | 开具发票所属的 Fakturownia 部门（公司）。必填。 |
| 仓库 | 发票使用的 Fakturownia 仓库。必填。 |
| 类别 | 发票归入的 Fakturownia 类别。可选。 |
| 语言 | 发票的语言。选择两种语言可开具双语发票；留空则为波兰语。 |
| 发票类型 | 为每个订单开具的单据类型——默认为 Faktura VAT，也可以选择其他类型，例如 Paragon 或 Rachunek。 |
| 计量单位 |
每一行上写的单位，默认为 szt（件）。如果产品有自己的单位，则使用产品的单位。
|
| 开票时生成 WZ 仓库出库单 | 每开具一张发票，同时在 Fakturownia 所选仓库中生成一张 WZ 仓库出库单。 |
它们下方是模板——写入发票备注的文字，由订单信息（例如订单 ID 或平台）组成。完成后点击 保存。
如果要为第二家公司或另一个部门开票，请打开连接，点击 取得详细资料，再点击 克隆。easySales 会保存一份副本，名称后面带有“(cloned)”。打开副本，点击 取得详细资料，重命名，选择另一个部门并保存。
第 4 步 — 高级选项
点击模板下方的 显示高级选项，打开其余设置。这些设置你都可以保持原样，以后再改。
| 选项 | 作用 |
|---|---|
| 付款类型 | 写在每张发票上的付款类型，例如 Transfer 或 Card。留空则保留 Fakturownia 自己的默认值。 |
| 根据订单的付款方式确定付款类型 | 改为按订单的付款方式设置付款类型，规则由你添加；不符合任何规则的订单使用 付款类型。 |
| 兑换货币、兑换类型 | 添加按你所选银行（例如 NBP 或 ECB）的汇率换算成另一种货币后的金额。 |
| 销售日期 | 销售日期取订单日期还是发票开具日期。 |
| 运费行名称来源、运费行名称 | 运费行的名称：固定文本，或订单的配送备注。留空则保留电商平台发送的名称。 |
| 将运费行开具为服务 | 把运费行关联到你选择或创建的 Fakturownia 服务类商品。 |
| 移除特殊字符 | 从发票上的客户姓名和地址中移除特殊字符。 |
| 开票时生成保修、将发票与保修合并 | 每张发票同时生成一份保修单据，并将两者一起下载。 |
| 从发票中排除折扣 | 发票上不包含订单的折扣行。 |
发票上包含哪些内容
- 客户：公司客户为公司名称和增值税号；个人客户为账单姓名，拆分为名和姓。同时附上账单地址和电子邮箱。
- 明细行：每个产品及其含税价格、增值税税率、数量，并以 SKU 作为产品代码；随后是运费和订单的折扣。
- 日期：开票日期为开具发票的当天；销售日期为订单日期，除非你通过 销售日期 更改。
- 货币：订单的货币。
- 已付款订单：已经付款的订单会按已付款开票。
付款、更正和发票 PDF
- 登记付款：把订单的发票标记为已付款，就会在 Fakturownia 中登记这笔付款。
- 更正发票：订单上的红冲（storno）操作会开具一张 Faktura korekta（更正发票），冲销整张发票；从退货发起时，只更正退回的产品。
- 作废和删除：作废会在 Fakturownia 中将发票标记为已拒绝，删除则会将其移除。无论哪种方式，随发票开具的 WZ 单据也会一并移除。
- PDF：从订单打开发票时，发票会从 Fakturownia 下载，所以你看到的始终是 Fakturownia 中保存的文件。
发票被拒绝时
Fakturownia 的回复会以波兰语显示在订单上。最常见的有：
| 消息 | 处理方法 |
|---|---|
| Invalid Credentials | 由 取得详细资料 显示：令牌错误，或属于另一个 Fakturownia 账户。请在你所填写域名对应的账户中创建一个新令牌。 |
| Department is required | 部门 列表为空。请检查 域，然后再次点击 取得详细资料。 |
| {"buyer_last_name":["- nie może być puste"]} | 个人客户的账单姓名只有一个词。请在订单的账单姓名中补上姓氏，然后重新开具发票。 |
| {"buyer_tax_no":["- błędna cyfra kontrolna NIP"]} | 客户的增值税号不是有效的 NIP（波兰税号）。请在订单中更正。 |