我的发票失败，提示 "Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient"，问题出在哪？

该连接把“用作产品的库存来源”设成了“是”，所以每张发票都会从 Oblio 仓库出库——而 Oblio 中所列产品的库存不足。你可以在 Oblio 修正库存（并检查连接上的仓库名称是否指向正确的仓库、拼写完全一致），也可以在不维护 Oblio 仓库的情况下把该设置改为“否”。这是 Oblio 发票失败最常见的原因。

easySales 需要哪个令牌——我的 Oblio 密码吗？

不是。Oblio 会在账户设置页签发单独的 API 密钥，那才是令牌。“用户名（电子邮件）”填写注册该 Oblio 账户的邮箱地址。如果设置页没有令牌，说明你的 Oblio 套餐不含 API 访问。

订单上显示 "Introdu o serie de document valida."，但序列看起来是对的。

这条消息来自 easySales，意思是该序列在你的 Oblio 账户中不存在。easySales 发送的是订单来源平台或店铺上配置的序列，而 Oblio 只接受它已有的序列。请在 Oblio 创建，或在 easySales 改成 Oblio 已知的序列。

需要定期重新连接 Oblio 吗？

不需要。easySales 用邮箱和令牌换取会话，并在过期时自行续期。如果订单上出现 "The access token provided has expired"，重新开票即可——除非你在 Oblio 更换了令牌，否则不必改动连接。

仓库名称必须与什么一致？

必须与 Oblio 中仓库的名称逐字一致——该字段区分大小写，标签上也写明了。工作站名称同理，必须对应 Oblio 中的一个工作点。请从 Oblio 复制，不要手动输入。

怎样让 Oblio 把付款记为收据？

在“显示高级选项”中把付款类型设为收据，并在连接的收据系列中填入一个 Oblio 中已存在的序列。当 easySales 把订单标记为已付款时，收款就会记在该序列上。如果付款类型留空，easySales 会按订单的付款方式选择类型。

同一个订单会不会开出两张发票？

在“显示高级选项”中打开“启用幂等键”。easySales 会把订单号随发票一起发送，Oblio 不会为已处理过的请求再生成第二份单据。如果账户被有意设置为允许一个订单多张发票，该选项不会出现。

计费软件里的 Oblio 连接和库存源里的有什么区别？

前者开具发票。后者把 Oblio 的库存读入 easySales，是一个独立连接，有自己的税号、令牌和邮箱。它们之间没有共享，所以在 Oblio 更换令牌后两个都要更新。

订单退货时 easySales 会开红字发票吗？

会。订单退货会向 Oblio 申请针对原发票的红字发票，因此红字单据会按与发票相同的序列规则在 Oblio 中生成。

客户不是罗马尼亚人，为什么发票是罗马尼亚语？

因为“显示高级选项”中的发票语言已设置，并对所有发票生效。清空它，easySales 就会使用订单来源店铺或平台的语言（前提是 Oblio 支持该语言）。

功能

如何将 Oblio 连接到 easySales：完整配置指南

由 easySales 团队撰写 · 更新于 11 九月 2026 · 阅读 1 分钟

把 Oblio 连接到 easySales：三项凭据、库存来源真正的作用、发票与收据序列、仅属于 Oblio 的高级选项，以及每种拒绝提示的含义。

连接 Oblio 能带来什么

连接 Oblio 后，easySales 会为订单开具发票、发送给客户、标记为已收款、作废或冲红，还能让 Oblio 的库存保持同步——你完全不需要打开 Oblio。

本指南覆盖整个连接，也包括那个决定发票能否开出的设置。

开始之前

✓

一个开通 API 访问的 Oblio 账户

令牌在 Oblio 账户设置页签发。如果那里没有令牌，说明套餐不含 API 访问，连接会以 You are not allowed to use this API. 失败。

✓

与 Oblio 中一致的 CIF

公司注册号会与你 Oblio 账户中的公司核对，而不只是校验格式。

✓

已在 Oblio 中创建的发票序列

easySales 发送订单携带的序列。可能用到的每个序列都必须先存在于 Oblio，否则不会开票。

✓

关于库存的决定

开票时是否从 Oblio 仓库出库。若是，仓库必须准确——Oblio 库存不足会直接卡住发票。

第 1 步 — 打开计费软件页面

进入 整合方式 → 计费软件，搜索 oblio。

easySales 的计费软件页面按 Oblio 筛选，显示已连接的 Oblio 卡片和编辑按钮。 — 整合方式 → 计费软件中的 Oblio 卡片。

在 Oblio 卡片上点击连接。如果已经有连接，点击编辑。

第 2 步 — 三项凭据

easySales 中的 Oblio 连接表单，显示连接名称、公司注册号码、用户名（电子邮件）、代币、设为“是”的库存来源、仓库名称、工作站名称和收据系列。 — 连接表单。三个带星号的字段就是 Oblio 所需的全部；其余决定发票的样子。

字段	含义
连接名称	你自己为这个连接起的名称。它永远不会传给 Oblio。
公司注册号码	开票公司的罗马尼亚 CIF，须与 Oblio 中的完全一致。每次请求都以 `cif` 发送；Oblio 不认识的公司会返回 `The company with cif … does not exist`。
用户名（电子邮件）	Oblio 账户的邮箱地址。Oblio 用它作为 API 客户端标识。
代币	Oblio 账户设置中的 API 密钥，不是你的 Oblio 密码。

三个必填字段

第 3 步 — 保存前先决定库存怎么处理

用作产品的库存来源 是这张表单上影响最大的字段——罗马尼亚语界面把它说得最清楚：开票时从仓库出库。

第 4 步 — 序列、工作站和其余设置

字段	作用
用作产品的库存来源	选“是”会让每张发票同时从 Oblio 仓库出库。参见上面的警告。
仓库名称	货物出库的 Oblio 仓库。可选、区分大小写；只要启用了出库或你有多个仓库，实际上就必须填写。
工作站名称	开具单据的 Oblio 工作点。可选、区分大小写。
收据系列	当款项以收据方式收取时 Oblio 使用的序列。其他收款类型下会被忽略。
发送价格更新	把 easySales 的价格变动发送到 Oblio 中对应的产品。必填——不作答表单无法保存。
使用产品描述	在发票行上使用产品描述，而不仅是名称。
模板	打印在发票上的备注。

连接的其余部分

Oblio 表单下半部分：发送价格更新、使用产品描述，以及带变量按钮的模板框和保存按钮。 — 必须先填写“发送价格更新”，连接才能保存。

模板决定该连接开出的每张发票上打印的备注。上方的按钮会插入订单中的值——订单号、平台、备注、运单号、快递名称、付款方式。

第 5 步 — 高级选项

这里没有必填项，但其中四项只属于 Oblio，还有一项能防止重复发票。

Oblio 连接的高级选项：发票语言、发行人CNP、发行人姓名、到期日和付款类型。 — 高级选项的前半部分。

选项	作用
发票语言	为所有发票强制一种语言。留空时，easySales 会使用订单来源店铺或平台的语言（前提是 Oblio 支持）。
发行人CNP 和发行人姓名	作为开票人打印在发票上。罗马尼亚 CNP 会按 13 位校验。
到期日	发票开具后多少天到期。
付款类型	强制 Oblio 记录的收款类型——收据、税控小票、银行卡、付款委托等。留空时 easySales 会依据订单的付款方式推断。选择收据时会使用上面的收据系列。
选择产品名称	发票行上使用哪个名称：产品自身的名称，还是订单中的名称。
自动检测区域	当订单未包含布加勒斯特分区时，根据地址推断。
生成唯一的折扣代码	仅 Oblio。把每笔折扣作为独立的编码行发送，而不是合并。
设置反向税	仅 Oblio。将发票标记为反向征收。
仅为 0% 税发送增值税名称	仅 Oblio。只在零税率行上发送免税名称，而不是每一行。
启用幂等键	仅 Oblio。防止重复请求为同一订单生成第二张发票。

值得设置的高级选项

Oblio 更多高级选项：选择产品名称、自动检测区域、生成唯一的折扣代码、设置反向税、仅 0% 税发送增值税名称，以及启用幂等键。 — 四个仅属于 Oblio 的选项，以及防止重复发票的幂等键。

把 Oblio 作为库存来源

上面的连接负责开票。让 easySales 的库存与 Oblio 保持一致，则是 另一个独立连接，有自己的凭据。

Oblio 库存来源连接表单，包含连接名称、税号、令牌、邮箱和仓库名称。 — 库存来源是独立连接，拥有同样凭据的独立副本。

进入 整合方式 → 库存源，在 Oblio 卡片上点击连接，填写同样的税号、令牌和邮箱，再加上读取库存的仓库。

当 Oblio 拒绝发票时

消息原样来自 Oblio，并显示在订单上。库存是最常见的原因。

Oblio 的提示	该怎么做
`Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient:`	Oblio 中所列产品的库存不足。请在 Oblio 修正库存，或在不维护 Oblio 仓库的情况下关闭用作产品的库存来源。
`Produsul "…" nu are stoc suficient.`	同样的问题，只针对一个产品。
`Concurrent requests timeout. Please make one request at a time.`	Oblio 同时收到了你账户的多个请求。没有任何丢失；发票可以重新开具。
`Too Many Requests, check back later`	Oblio 对你账户的请求限流，会自行恢复。
`The access token provided has expired`	Oblio 提前结束了会话。请重新开票——旧会话过期后 easySales 会创建新的。
`Internal error. Please try again later.` / 空响应或 504	Oblio 没有响应。你这边没有问题；稍后重试。
`You are not allowed to use this API.`	该 Oblio 账户的套餐不包含 API 访问权限。
`The company with cif … does not exist`	连接上的公司注册号码不是该 Oblio 账户中的公司。
`Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, …`	某个产品在 Oblio 中的类型不被此处接受。请在 Oblio 修改产品类型。
`Introdu o serie de document valida.`	这条来自 easySales 而不是 Oblio：订单上的序列在你的 Oblio 账户中不存在。

Oblio 拒绝的含义

红字发票、作废与收款

操作	在 Oblio 中发生什么
把订单标记为已付款	发票在 Oblio 中按付款类型收款，或按订单付款方式推断出的类型收款。以收据收款时会使用收据系列。
订单退货	easySales 会向 Oblio 申请针对原发票的红字发票。
作废发票	Oblio 作废该单据；号码仍视为已使用，这是应有的处理。
删除发票	仅在 Oblio 仍允许时可行——否则请改为作废。

这个连接还会做什么