如何将 wFirma 与 easySales 连接：完整设置指南
从 easySales 在 wFirma 中开具发票，并从 wFirma 仓库读取库存：API 密钥、发票类型和系列、按 SKU 匹配产品、高级选项以及 wFirma 返回的消息。
连接 wFirma 能为你带来什么
将 wFirma 连接为开票软件后，easySales 会直接在你的 wFirma 账户中为订单开具发票——包含买方、产品、运费和折扣——并将其与订单关联。你可以在订单中打开发票 PDF，并记录其付款。wFirma 还可以作为你的库存源：easySales 会把某个 wFirma 仓库的库存读取到你的产品中。
开始之前，有两点需要了解：
- 默认情况下，每个产品都必须存在于 wFirma 中，且其代码与 SKU 相同。 easySales 会把发票的每一行记到 wFirma 中对应的产品上，wFirma 随即从库存中扣减。只要有一个产品在 wFirma 中不存在，整张发票都无法开具。如果你不在 wFirma 中管理产品和库存，请开启 开具发票而不减少库存——见第 4 步。
- 由 wFirma 为发票编号。 easySales 不发送编号：wFirma 会为每张发票分配你在连接中所选系列的下一个编号。
开始之前
一个 wFirma 账户
包含你要使用的发票系列。
访问密钥和密钥
在 wFirma 中创建——见第 1 步。
你的产品在 wFirma 中
代码与 easySales 中的 SKU 相同——除非你开具发票时不减少库存。
第 1 步 — 在 wFirma 中创建 API 密钥
- 登录 wFirma，打开 Ustawienia » Bezpieczeństwo » Aplikacje » Klucze API。
- 为 easySales 添加一个新的 API 密钥。
- 复制 访问密钥 和 密钥（secret key）。wFirma 只显示一次密钥——在保存连接之前请妥善保留。
第 2 步 — 在 easySales 中连接 wFirma
进入 整合方式 → 计费软件，搜索 wfirma，在 WFirma 卡片上点击 连接——如果之前连接过，则点击 编辑。
填写表单，选择 发票类型，然后点击 取得详细资料。随后会出现 发票系列 字段，列出你在 wFirma 中该类型的系列：选择一个并点击 保存。
| 字段 | 填写内容 |
|---|---|
| 连接名称 |
一个便于你识别的名称，例如 wFirma – Faktura VAT。
|
| 公司 ID | 你的公司在 wFirma 中的 ID。 |
| 访问密钥 | 第 1 步中的访问密钥。 |
| 密钥 | 第 1 步中的密钥（secret key）。 |
| 发票类型 | easySales 开具的单据：增值税发票、收银机收据、形式发票、销售凭证/非财政收据、差额和不含增值税的变体，以及其他类型。 |
| 发票系列 | 点击 取得详细资料 后：发票编号所依据的 wFirma 系列。 |
重新打开已保存的连接时，请再次点击 取得详细资料，以查看和更改系列。
第 3 步 — 每种单据类型一个连接
一个连接只开具一种类型的单据。如果你为一些订单开具发票、为另一些订单开具收据或形式发票，请为每种类型创建一个连接：打开连接，点击 取得详细资料，再点击 克隆，然后在副本中选择另一种 发票类型 及其系列。按单据为每个连接命名，例如 wFirma – Faktura VAT 和 wFirma – Paragon。
系列下方是模板——写入发票描述的文本，由订单信息组成，例如订单 ID 或标签编号。
第 4 步 — 高级选项
点击模板下方的 显示高级选项。大多数选项可以保持原样，但第一项请在开具第一张发票之前决定。
| 选项 | 作用 |
|---|---|
| 开具发票而不减少库存 | 关闭：每一行都会记到代码与 SKU 相同的 wFirma 产品上，wFirma 随即从库存中扣减。开启：各行以纯文本发送，wFirma 的库存不变——如果你的产品并非全部在 wFirma 中，请使用此选项。 |
| 使用订单日期作为发票开具日期 | 以订单日期而非当天日期开具发票。 |
| 发票项目显示模式 | 以 产品名称 或 SKU 作为每一行的文本。 |
| 运费名称来源 |
静态 使用你在 运费名称 中输入的名称——留空则为 Transport；配送备注 使用订单的配送备注，订单没有备注时使用静态名称。
|
| 发票中的折扣 | 行项目 将每项折扣单独添加为一行；按比例 将折扣分摊到各产品上。 |
| 将赠品作为单独的折扣显示 | 将价格为 0 的产品显示为两行：先是其全价，然后是等额的折扣。 |
| 移除特殊字符 | 去除买方名称和地址中的特殊字符。 |
| 开票时生成保修 | 根据你选择的模板，随发票一起开具保修凭证。 |
发票上包含哪些内容
- 买方：客户的税号决定买方类型。波兰 NIP 或不带国家前缀的号码作为 NIP 发送；带欧盟国家前缀的号码作为欧盟增值税号发送；没有号码则为个人买方。如果 wFirma 中已有相同 NIP 的买方，则会沿用该买方。
- 明细行：每个产品及其含税价、增值税税率和数量，然后是运费（金额大于 0 时）以及订单的折扣。
- 币种：订单的币种。
- 已付款订单：已付款的订单会以已付款状态开票。之后将发票标记为已付款时，付款会记录到 wFirma 中。
- PDF：从订单中打开发票时，会从 wFirma 下载。
将 wFirma 用作库存源
要从 wFirma 仓库读取库存，请先保存上面的开票连接。然后进入 整合方式 → 库存源，在 WFirma 卡片上点击 连接。
- 输入一个便于你识别的 仓库名称。
- 在 开票软件账户 中，选择你的 wFirma 开票连接——库存源会使用它的密钥。
- 点击 取得详细资料，在 仓库 中选择要读取的 wFirma 仓库，然后点击 保存。
easySales 大约每半小时读取一次该 wFirma 仓库中每个产品的库存，并按代码与你的产品匹配：代码与某个产品 SKU 相同的 wFirma 产品，会把自己的库存赋给该产品。库存只会被读取——easySales 从不更改 wFirma 中的库存。要使用它，请将此来源设置为某个高级仓库的库存源。
发票被拒绝时
你在订单上最可能看到的消息：
| 消息 | 处理方法 |
|---|---|
| No good id found for product: … | wFirma 中没有代码与该产品 SKU 相同的产品。请在 wFirma 中以该代码添加产品，或开启 开具发票而不减少库存。 |
| WFirma Error: ERROR, Stan magazynowy nie może być ujemny. | wFirma 中订单上某个产品的库存不足。请在 wFirma 中办理入库，或开启 开具发票而不减少库存。 |
| WFirma Error: ERROR, Nieprawidłowy NIP. … | 客户的税号不是有效的波兰 NIP。请在订单中更正后重新开具发票。 |
| WFirma Error: Authentication error. Please check your access key, secret key, and app key. | 密钥或公司 ID 有误。请在 wFirma 中创建新的密钥，并填入连接中。 |
| The Invoice Series field is required. | 点击 取得详细资料，选择 发票系列 并保存。 |