市场平台

如何把 Okazii 连接到 easySales:完整设置指南

如何把 Okazii 连接到 easySales:完整设置指南

把 Okazii 连接到 easySales:连接设置、你的供稿提供网址以及如何在 Okazii 上配置它、哪些优惠才真正进入 feed,以及订单、发票和 AWB 如何回传。

Okazii 整合的运作方式

Okazii 的连接方式和大多数交易市场都不一样,先弄清楚这一点,后面能省下很多困惑。

你的优惠永远不会被推送到 Okazii。 easySales 会生成一个 XML 文件,也就是 feed,并把它发布在一个私有地址上。Okazii 按照它自己的节奏来抓取这个文件,并导入里面的内容。你的产品、价格和库存只走这一条路。

订单则从相反方向回来,走 Okazii 的 API,使用你 Okazii 账户里的令牌。easySales 还会把每笔订单的发票和 AWB 运单号送回去。

所以整个设置分成两半:一半在 easySales 里,一半在 Okazii 后台里。缺了任何一半都不行。

开始之前

一个 Okazii 卖家账户

要能进入店铺管理区域,因为这套设置有一半是在那里做的。

你的 Okazii API 令牌

在 Okazii 后台的店铺管理里,API 设置那一处。只复制其中的数字部分。没有它,easySales 一笔订单也读不到。

准备好可以卖的产品

每个产品都需要名称、SKU、至少一张图片、不低于 0.10 的价格,以及大于零的库存。缺任何一项,产品都进不了 feed——见下文的校验说明。

关于增值税的决定

连接上的 默认税率 就是告诉 easySales 你的 Okazii 价格含不含增值税的地方。保存之前先想清楚。

第 1 步 — 在 easySales 里连接 Okazii

进入 配置 → 整合方式 → 交易市场,搜索 Okazii 并打开它的卡片。

easySales 的交易市场页面筛选到 Okazii,显示已连接的 Okazii 卡片、罗马尼亚国旗和一个编辑操作。
配置 → 整合方式 → 交易市场 里的 Okazii。

填写右侧的表单。

Okazii 连接表单的上半部分,显示连接名称、新订单自定义状态、价格加成、默认运费、默认税率和发票系列。
表单的前半部分。默认税率决定你的价格是否含增值税发出。
字段 该填什么
连接名称 必填。你自己给这个 Okazii 账户起的名字。连了不止一个账户时,这些名字就是各个标签页。
新订单自定义状态 选填。用一个你自己的状态来接收每一笔进来的 Okazii 订单。
价格加成 必填。创建优惠时在产品价格之上加的百分比。它在那一刻就被写进优惠里,所以之后再改这个值,不会给已经存在的优惠重新定价。
默认运费 这里填的是税率,不是运费金额:它是应用在导入订单运费行上的增值税率。
默认税率 必填,而且比看上去重要得多——见下文。
发票系列 必填。为 Okazii 订单创建发票时使用的系列。每笔订单仍然可以单独修改。
隐式封装类型 信封包裹,作为这些订单 AWB 上的默认值。
描述类型 决定 feed 里带的是你自己的产品描述,还是根据产品特性生成的描述。Okazii 不接受 HTML。
API 令牌 必填。来自你的 Okazii 账户,在店铺管理里的 API 设置中——只复制其中的数字部分。
连接表单

表单余下的部分决定你的产品在 feed 里如何被描述。

Okazii 连接表单的下半部分,显示隐式封装类型、描述类型、API 令牌、尺寸属性、颜色属性、将特性插入 feed,以及当产品有库存时自动启用报价。
表单的后半部分。让订单导入跑起来的正是 API 令牌。
  • 尺寸属性颜色属性 告诉 easySales 你的哪些产品特性代表尺码和颜色,这样同款的多个变体会被合并成 Okazii 上的一条商品,而不是好几条。
  • 将特性插入 feed 会把每一项产品特性都写进文件里。
  • 当产品有库存时自动启用报价 会在产品重新有货时自动把优惠重新打开。

第 2 步 — 复制你的供稿提供网址

连接保存之后,左边一栏会显示 供稿提供网址。它的样子类似 https://app.easy-sales.com/feed/12345/487213904/okazii.xml,每一个已连接的 Okazii 账户都有自己的一条。

easySales 中 Okazii 连接页面的左栏,显示供稿提供网址,以及带有重新发送全部和同步订单的选项行。
供稿提供网址就是你要交给 Okazii 的那个地址。每个已连接的账户都有自己的一条。

重新生成网址添加账户(用来连接第二个 Okazii 账户,它有自己的设置和自己的供稿提供网址)都在卡片的 菜单里。

easySales 中 Okazii 卡片上打开的三点菜单,显示添加账户、文件、重新生成网址和注册。
卡片菜单。添加账户用来连接第二个 Okazii 账户;重新生成网址会替换掉你的 feed 地址。

第 3 步 — 让 Okazii 指向这个 feed

这一半在 Okazii 后台里完成,它的界面是罗马尼亚语的。

  1. 打开 Meniu → Administrează Magazin(菜单 → 管理店铺),或者 Setări → Magazin → Administrare(设置 → 店铺 → 管理)。
  2. 进入 Administrează articole → Import Produse(管理商品 → 导入产品),选择 Import Automat(自动导入)。
  3. 把你的供稿提供网址粘贴到 Adaugă URL-ul Feedului(添加 feed 网址)里。
  4. 勾选 Elimină din okazii produsele care nu apar în feed(把没有出现在 feed 里的产品从 Okazii 上移除)。
  5. Salvează Opțiunile(保存选项)保存。

第 4 步 — 创建你的优惠

Okazii 上的优惠是从你在 easySales 里已有的产品创建出来的。打开 产品,选中你要的产品,用工具栏里的 在...上添加优惠,或者在单独一行上用 添加报价,然后选择 Okazii。

你的哪些优惠才真正到得了 Okazii

几乎每一个「Okazii 只导入了我的一小部分产品」的问题,背后都是这个。一条优惠只有在下面 四项全部 成立时,才会被写进 feed 文件:

条件 在哪里能看到
优惠是 已启用 优惠行上的状态开关。
优惠和产品 已连结 优惠名称下方的「已连结」那一行。
该产品的 库存 大于零 优惠名称下方的「库存」那一行。
优惠 没有阻断性错误 「错误」这一列。
四项全部成立,优惠才在 feed 里

这四项在 交易市场 → 优惠 → Okazii 里一眼就能看到。

easySales 优惠页面的 Okazii 标签页,显示六条优惠及其图片、名称、已连结的 SKU、库存、价格、状态开关,以及一条写着 1006 Missing product images 的错误。
决定一条优惠能否到达 Okazii 的所有因素都在这个页面上:状态、已连结的产品、库存和错误。

没有通过校验的优惠会被关闭,原因显示在 错误 这一列里。

错误 要修什么
1000 Missing product name 产品没有名称。
1001 Missing product sku 产品没有 SKU。
1004 Invalid product price 销售价格低于 0.10。
1005 Invalid images data 优惠的图片格式不可用。请在产品上重新保存图片。
1006 Missing product images 产品完全没有图片。这是最常见的一种。
会把优惠挡在 feed 之外的错误

一处改动多久才会显示出来

easySales 最多每小时重建一次 feed 文件,而且通常要等 Okazii 读取过上一个版本之后才重建。之后 Okazii 还得再跑一次它自己的导入。实际情况是,一条新加的优惠通常要等 Okazii 抓取两次文件之后才出现,所以请预留几个小时,别指望立刻看到。

类别

优惠上的 类别 只是一段纯文本,在创建时从产品所属的第一个类别取一次。easySales 不保存 Okazii 的类别树,所以从你的类别名称到 Okazii 自己类别的对应关系,是在 Okazii 里完成的,位置在 Administrare Articole → Administrare Catalog(商品管理 → 目录管理)。

要修改 easySales 发送的这段文本,就在 easySales 里改:在优惠本身上改(交易市场 → 优惠 → Okazii → 编辑),或者要一次改很多条时用 大量编辑 → 编辑类别和特性。类别在优惠创建的那一刻被记录下来,之后不会再刷新,所以后来改产品的类别并不会改变 feed 里的内容。

订单

新的 Okazii 订单大约每分钟被取一次,另外每天还有几次范围更宽的补抓。如果你需要回溯更久,连接页面上有 选项 → 同步订单,它接受最长 30 天的时间范围。

内容 方向 怎么传
产品、价格、库存 easySales → Okazii XML feed,由 Okazii 来抓取。
订单 Okazii → easySales Okazii 的 API,使用你的 API 令牌。
发票 PDF easySales → Okazii 发票创建后自动发送。
AWB 运单号 easySales → Okazii 在你生成运单时发送。生成运单同时会把订单在 easySales 里标记为已完结。
订单状态 不传 状态从不回传。
Okazii 上已有的商品 不传 它们从不会被导入 easySales。
easySales 和 Okazii 之间都传些什么

订单不再进来的时候

如果没有任何错误提示,订单却始终不来,先检查连接上的 API 令牌。在令牌成为必填项之前保存的连接看上去完全正常——它显示为已连接,feed 也照常工作——但一笔订单都不会被取回,而且没有任何提示。

然后,针对某个没有出现在 Okazii 上的产品,按这份清单逐条排查:

  • 这条优惠是 已启用 的吗?
  • 它和产品 已连结 了吗?
  • 那个产品的库存大于零吗?
  • 这条优惠是否显示了错误?
  • Okazii 那边填的供稿提供网址是最新的那条吗?

Okazii 面向罗马尼亚市场

常见问题

不是直接发送。easySales 生成一个 XML feed 文件,并发布在你的供稿提供网址上;Okazii 抓取这个文件并导入其中的内容。你的优惠不会通过任何 API 推送到 Okazii,所以必须先在 Okazii 那边把供稿提供网址正确设置好,东西才会出现。

配置 → 整合方式 → 交易市场,然后打开 Okazii 的连接。供稿提供网址显示在左边一栏,就在选项那一行的上方。如果你连了不止一个 Okazii 账户,每个连接都有自己的一条。

一个产品要进入 feed,必须满足:优惠是已启用的、它和产品已连结、该产品库存大于零、并且优惠没有阻断性错误。缺货的、被停用的、没连结的和被拒的优惠会被完全排除在文件之外——这通常就是 Okazii 导入的数量远小于你看到的优惠数量的原因。

easySales 是把这个产品从 feed 里移除,而不是发一个数量为零的值。只有当 Okazii 的自动导入被设置为移除不再出现在 feed 里的产品时,Okazii 才会把商品下架——也就是「Elimină din okazii produsele care nu apar în feed」这个选项。如果没有勾选,商品会带着旧库存继续挂在上面。

easySales 最多每小时重建一次 feed 文件,而且通常要等 Okazii 读过上一个版本之后才重建,所以一条新加的优惠通常需要 Okazii 抓取两次文件。请预留几个小时,别指望立刻看到。

需要你 Okazii 账户里的 API 令牌,并保存在连接上。没有它,一笔订单都不会被导入,而且不会有任何错误提示——连接照样显示为已连接,feed 也照常工作。有了它,订单大约每分钟被检查一次。

不会。在 easySales 里把订单标为已完结、已完成或已取消,对 Okazii 没有任何影响。有两样东西会回传:发票 PDF,在它生成之后;以及 AWB 运单号和对应的快递,在你生成运单之后。

Cargus、FanCourier、DPD、GLS、SameDay 和 Prioripost。用其它任何快递时,easySales 仍会生成运单,但 Okazii 会拒收这个运单号,你得自己到 Okazii 后台里填写。

先解决原因——最常见的是 API 令牌——然后在 Okazii 卡片上按恢复连接。单独把连接表单再保存一次并不会重新启动订单导入。注意:这种状态下停的只有订单;feed 仍在正常提供,所以在没有订单进来的同时,你的优惠在 Okazii 上依然是上架的。

不会。Okazii 的优惠只会来自你的 easySales 产品;你原本就有的商品不会被读回来。

是产品所属第一个类别的名称,以纯文本形式发送。easySales 不保存 Okazii 的类别树——你要在 Okazii 里把自己的类别名称对应到 Okazii 的类别上,位置在 Administrare Articole → Administrare Catalog(商品管理 → 目录管理)。要改 easySales 发送的这段文本,可以编辑优惠,或者用大量编辑 → 编辑类别和特性。它在优惠创建时被记录,之后不会再刷新。

可以。用卡片 ⋮ 菜单里的添加账户。每个连接都有自己的名称、自己的设置和自己的供稿提供网址,所以你要往每个 Okazii 账户里填不同的地址。

本指南对你有帮助吗?