如何将 inFakt 与 easySales 连接:完整设置指南
从 easySales 在 inFakt 中开具订单发票:API 密钥、检查连接、编号、KSeF、文件标记,以及 inFakt 拒绝发票时该怎么做。
连接 inFakt 能为你带来什么
inFakt 是面向波兰企业的在线开票和记账服务。连接 inFakt 后,你在 easySales 中为订单开具的发票会在你的 inFakt 账户中创建,发票 PDF 会回到订单上——如果订单来自 marketplace,还会继续发送到该 marketplace。
开始之前,有三点需要了解:
- 保存时不会检查 API 密钥。 保存后请重新打开连接:如果 文件标记 (JPK_V7) 列表能从 inFakt 加载出来,说明密钥有效。
- 发票需要稍等片刻。 easySales 会把每张发票发送到 inFakt,在 inFakt 创建完成之前,订单上显示 发票处理中;发票编号和 PDF 会在不久之后出现。
- 发票由 inFakt 编号,除非你在连接中启用 easySales 编号。
开始之前
一个 inFakt 账户
用于你在波兰的公司。
一个 inFakt API 密钥
在 Ustawienia → API 中生成,具有读取和写入发票的权限。
你的 inFakt 登录邮箱
你登录 inFakt 所用的电子邮件。
inFakt 中的 KSeF(如果你使用)
在勾选 KSeF 选项之前,你的 inFakt 账户需已启用 KSeF 集成。
第 1 步 — 在 inFakt 中生成 API 密钥
在 inFakt 中打开 Ustawienia → API,添加一个新密钥:填写描述,输入你的 inFakt 密码,并选择权限范围(zakres uprawnień)——easySales 需要读取和写入发票的权限。点击 Wygeneruj,然后复制密钥。
第 2 步 — 在 easySales 中连接 inFakt
进入 整合方式 → 计费软件,搜索 infakt 并进行连接。
| 字段 | 填写内容 |
|---|---|
| 连接名称 | 一个便于你识别的名称。 |
| 代币 | 你在 inFakt 中生成的 API 密钥。 |
| 用户名(电子邮件) | 你登录 inFakt 所用的电子邮件。 |
| 文件标记 (JPK_V7) | 添加到此连接每张发票上的标记,例如用于境外 B2C 销售的 WSTO_EE。如果没有适用于你所有发票的标记,请留空;如需不同的标记,请克隆该连接。 |
| 自动将发票发送至 KSeF | 勾选后,inFakt 在创建每张发票后会立即将其转发至 KSeF。 |
| 启用编号序列 | 关闭时,inFakt 按其自身格式为每张发票编号(Ustawienia → Faktury → Numeracja)。开启时,easySales 根据你在此添加的序列指定序列和编号——此时请只从 easySales 开具发票,以免编号冲突。 |
| 模板 | 打印在每张发票上的备注,由订单信息组成,例如订单 ID 或标签号。 |
点击 保存,关闭连接后再重新打开。如果 文件标记 (JPK_V7) 列表加载成功,说明 easySales 可以与 inFakt 通信;如果该字段显示 InFakt Error: The API key you provided is invalid.,请生成新密钥并重新保存。
开具发票
在订单页面通过 创建发票 并选择 inFakt 连接来开具发票,或者通过自动化流程自动开具。每张发票一次只针对一个订单开具。
- 发票使用订单的币种,开票日期为当天,销售日期为订单日期。
- 每个订单行会成为一条发票行,包含名称、净价和增值税税率;运费单独成为一行。
- 发票行不会与 inFakt 中的商品匹配,inFakt 中的库存也不会变化。
- 已付款的订单会以已付款状态开具。
被标记为公司的买家必须在订单上有税号(NIP),否则 inFakt 会拒绝该发票。如需更正发票,请在 inFakt 中开具更正发票。
出现问题时
| 消息 | 处理方法 |
|---|---|
| InFakt Error: The API key you provided is invalid. | 在 inFakt 中生成新密钥(Ustawienia → API),粘贴到 代币 中并保存。 |
| InFakt Error: Please select a client. | 买家被标记为公司,但没有税号。请在订单上添加 NIP,或将买家标记为个人,然后重新开具发票。 |
| The invoice series … is not configured on this inFakt connection… | 在开启 启用编号序列 的情况下,请将该序列添加到连接中,或关闭 easySales 编号。 |
| Bulk invoice not available for inFakt. | inFakt 发票请一次针对一个订单开具,可在订单页面开具,也可通过自动化流程开具。 |