市场平台

如何将 Infinity 连接到 easySales:完整配置指南

如何将 Infinity 连接到 easySales:完整配置指南

把 Infinity 平台连接到 easySales:VTEX 应用密钥、为什么参考 ID 决定报价能否创建、分类映射、关联已有报价,以及每种错误的含义。

连接 Infinity 能带来什么

连接 Infinity 后,easySales 会把你的产品发布到该平台、同步价格和库存、导入订单,并通过你的开票软件为订单开票——都在你用于其他渠道的同一批界面里完成。

开始之前

一个 Infinity 卖家账户

Infinity 运行在 VTEX 上,集成对接的是你自己的 Infinity 账户——你需要已经在那里销售或已获批准。

带角色的应用密钥

在你的 Infinity 账户中生成:一个应用密钥和一个应用令牌。没有角色的密钥会以“无人”身份认证,所有调用都会失败。

你的账户名称

Infinity 后台地址的第一段——easysales429.myvtex.com 中的 easysales429

先映射分类,再发送报价

没有 Infinity 分类的报价无法创建。分类和分类映射是报价停滞的两大原因,合计超过其他所有原因。

第 1 步 — 在 Infinity 中创建应用密钥

Infinity 运行在 VTEX 上,所以凭据是一对 VTEX 应用密钥:在你自己的 Infinity 账户中生成的密钥和令牌,而不是用户名和密码。

在 Infinity 后台打开账户设置,找到 应用密钥。为 easySales 创建一个密钥,赋予它读写产品和订单所需的角色,然后生成。你会得到两个值——应用密钥应用令牌——两个都需要。

你还需要 账户名称:Infinity 后台地址的第一段。在 https://easysales429.myvtex.com 中,账户名称是 easysales429

第 2 步 — 在 easySales 中连接

进入 整合方式 → 交易市场,搜索 infinity

easySales 的交易市场页面按 Infinity 筛选,显示处于已连接状态的 Infinity 卡片。
整合方式 → 交易市场 中的 Infinity 卡片。

在 Infinity 卡片上点击 连接。表单有两个标签页:主要设置附加设置

easySales 中的 Infinity 连接表单,显示连接名称、新订单自定义状态、价格加成、默认运费、发票系列、增值税付款人和作为参考 ID 发送。
主要设置。作为参考 ID 发送是保存前需要想清楚的字段。
字段 作用
连接名称 你自己为这个连接起的名称,永远不会传给 Infinity。
新订单自定义状态 可选。把导入的 Infinity 订单放到你自定义的状态上,而不是默认状态。
价格加成 发送前在产品价格上加的百分比。100 RON 的产品加 10% 会发送 110 RON。
默认运费 Infinity 订单运费行使用的增值税率。
发票系列 为 Infinity 订单开具发票时使用的序列。
增值税付款人 公司需要收取增值税则选“是”,否则选“否”。这个选择决定随报价发送的税率。
作为参考 ID 发送 内部 ID 或 SKU——Infinity 为每条报价存储的参考。选择之前请看下面的步骤。
账户名称 Infinity 后台地址的第一段:在 easysales429.myvtex.com 中是 easysales429
应用密钥应用令牌 在你的 Infinity 账户中生成的应用密钥。两者都必填。
连接表单逐字段说明
Infinity 表单的凭据部分:账户名称、应用密钥和应用令牌。
来自 Infinity 账户的三个值:后台地址中的账户名称,以及应用密钥与令牌。

第 3 步 — 在发送任何内容之前先确定参考 ID

作为参考 ID 发送 是旧文档从未提及的字段,而它决定了你的报价能否被创建。

第 4 步 — 附加设置

Infinity 连接的附加设置标签页:发送价格、发送库存,以及当产品有库存时自动启用报价。
附加设置决定报价存在之后 easySales 继续推送什么。
设置 作用
向市场平台发送报价价格 把 easySales 的价格变动发送到 Infinity。如果价格在 Infinity 侧管理,请关闭。
向市场平台发送报价库存 把 easySales 的库存变动发送到 Infinity。
当产品有库存时自动启用报价 当产品库存从零变为有货时自动重新启用报价。默认关闭;如果经常缺货再补货,值得打开。
附加设置

第 5 步 — 先映射分类,再发送报价

报价只有在拥有 Infinity 分类后才会离开 easySales。分类问题是报价卡住的最大原因:产品没有 Infinity 分类,或者它所在的分类从未被映射。

打开 市场 → 分类目录,选择 Infinity,把你的产品所在分类映射到 Infinity 的分类。然后检查 重量——它是仅次于这两项的常见原因。

第 6 步 — 你已经在 Infinity 上的报价

如果连接之前你已经在 Infinity 销售,这些报价会被导入 市场 → 优惠 的 Infinity 标签页,并且是 未关联 状态。把报价关联到 easySales 中的产品,价格和库存更新才能流转过去。

easySales 优惠列表的 Infinity 标签页,显示报价、关联产品、价格、库存、启用或停用状态以及错误列。
优惠列表的 Infinity 标签页。每条报价都会显示关联的产品以及阻塞它的原因。

第 7 步 — 发送新产品

产品 页面按 没有优惠 → Infinity 筛选,只看还没上架的产品,然后对想发布的产品使用 添加报价

easySales 产品页面打开“没有优惠”筛选器,列出各个平台,其中包括 Infinity Demo Store。
发送产品前先按 没有优惠 → Infinity 筛选,避免同一产品发送两次。

订单与发票

新的 Infinity 订单会像其他渠道一样导入 订单。连接上的两项设置决定它们的走向:发票系列 决定其发票使用的序列,新订单自定义状态则可以让它们落在你自定义的状态而非默认状态。

当连接停止工作时

你看到的 该怎么做
缺少分类 / 缺少分类映射 产品没有 Infinity 分类,或所在分类尚未映射。在 市场 → 分类目录 中映射。两者合计造成了大部分卡住的报价。
重量无效 Infinity 不接受该产品的重量。请在产品上更正。
标题过长(最多 120 个字符) 缩短产品名称,或发送到该平台的名称。
描述不能为空 为产品补充描述。
缺少产品品牌 产品没有品牌,而 Infinity 要求填写。
缺少必填特性 该 Infinity 分类要求产品没有的特性。请在报价编辑界面补齐。
产品被平台拒绝 Infinity 拒绝了这条报价。详情显示在报价上,通常是他们那边的目录规则。
A product with external id "…" already exists. 该报价已经在 Infinity 上。请把导入的报价关联到你的产品,而不是再发送一条。
Cannot authenticate request: failed to authenticate with provided credentials 应用密钥已失效——被删除或角色被移除。请在 Infinity 生成新的并更新连接。
Price Variation Not Allowed: BasePrice Variation: Price exceeds allowed limits Infinity 限制一次调价的幅度。请分多次小幅调整,或在他们那边放宽限制。
最常见的 Infinity 错误含义

常见问题

该产品已经以这个参考存在于 Infinity 上,几乎总是因为你在接入 easySales 之前就在那里销售。不要重试——进入 市场 → 优惠,打开 Infinity 标签页,找到导入的报价并关联到你的产品。之后价格和库存更新就会流向已有的那条报价。这是 Infinity 最常见的失败。

SKU 是通常的选择,因为它与卖家在 Infinity 上已使用的一致。更重要的是在首批报价发出前就选定:之后再改,easySales 会重写该连接上所有已有报价的参考。

先检查 Infinity 中的应用密钥。被删除或被移除角色的密钥会让每次调用都以认证错误告终,而报价只是停在原处。然后看 easySales 中的 Infinity 卡片:如果连接因反复失败而被停用,会出现带有“恢复连接”按钮的提示条。

它清除停用标记,让同步继续。它不会修复导致失败的原因——如果凭据或数据仍然有问题,连接会再次自动关闭。请先解决根因。

三大原因几乎总是相同的:没有 Infinity 分类、没有分类映射、重量无效。先在 市场 → 分类目录 完成映射,再顺着优惠列表的错误列逐条处理——每次修正都会在下一次发送时生效。

基础是产品价格。连接上的价格加成会为该平台在此基础上加一个百分比,你也可以在优惠列表中按单条报价覆盖价格。关闭发送价格后,easySales 将完全不再推送价格。

这个字段已经不在表单里了。Infinity 订单的配送时间目前不由连接保存。

这出现在罗马尼亚增值税率变化之前创建的连接上:它们仍保存着旧税率,而该字段已不再提供这个选项。重新选择“是”或“否”再保存——该字段为必填,在此之前其他内容也无法保存。

如果你在附加设置标签页打开“当产品有库存时自动启用报价”,就不需要。关闭时,缺货期间被停用的报价会一直停用,直到你自己启用。

使用连接上设置的发票系列。它必须是你的开票软件已知的序列——否则发票会在开具时失败,而不是在订单导入时。

本指南对你有帮助吗?