如何把 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 并打开它的卡片。
填写右侧的表单。
| 字段 | 该填什么 |
|---|---|
| 连接名称 | 必填。你自己给这个 Okazii 账户起的名字。连了不止一个账户时,这些名字就是各个标签页。 |
| 新订单自定义状态 | 选填。用一个你自己的状态来接收每一笔进来的 Okazii 订单。 |
| 价格加成 | 必填。创建优惠时在产品价格之上加的百分比。它在那一刻就被写进优惠里,所以之后再改这个值,不会给已经存在的优惠重新定价。 |
| 默认运费 | 这里填的是税率,不是运费金额:它是应用在导入订单运费行上的增值税率。 |
| 默认税率 | 必填,而且比看上去重要得多——见下文。 |
| 发票系列 | 必填。为 Okazii 订单创建发票时使用的系列。每笔订单仍然可以单独修改。 |
| 隐式封装类型 | 信封 或 包裹,作为这些订单 AWB 上的默认值。 |
| 描述类型 | 决定 feed 里带的是你自己的产品描述,还是根据产品特性生成的描述。Okazii 不接受 HTML。 |
| API 令牌 | 必填。来自你的 Okazii 账户,在店铺管理里的 API 设置中——只复制其中的数字部分。 |
表单余下的部分决定你的产品在 feed 里如何被描述。
- 尺寸属性 和 颜色属性 告诉 easySales 你的哪些产品特性代表尺码和颜色,这样同款的多个变体会被合并成 Okazii 上的一条商品,而不是好几条。
- 将特性插入 feed 会把每一项产品特性都写进文件里。
- 当产品有库存时自动启用报价 会在产品重新有货时自动把优惠重新打开。
第 2 步 — 复制你的供稿提供网址
连接保存之后,左边一栏会显示 供稿提供网址。它的样子类似 https://app.easy-sales.com/feed/12345/487213904/okazii.xml,每一个已连接的 Okazii 账户都有自己的一条。
重新生成网址 和 添加账户(用来连接第二个 Okazii 账户,它有自己的设置和自己的供稿提供网址)都在卡片的 ⋮ 菜单里。
第 3 步 — 让 Okazii 指向这个 feed
这一半在 Okazii 后台里完成,它的界面是罗马尼亚语的。
- 打开 Meniu → Administrează Magazin(菜单 → 管理店铺),或者 Setări → Magazin → Administrare(设置 → 店铺 → 管理)。
- 进入 Administrează articole → Import Produse(管理商品 → 导入产品),选择 Import Automat(自动导入)。
- 把你的供稿提供网址粘贴到 Adaugă URL-ul Feedului(添加 feed 网址)里。
- 勾选 Elimină din okazii produsele care nu apar în feed(把没有出现在 feed 里的产品从 Okazii 上移除)。
- 用 Salvează Opțiunile(保存选项)保存。
第 4 步 — 创建你的优惠
Okazii 上的优惠是从你在 easySales 里已有的产品创建出来的。打开 产品,选中你要的产品,用工具栏里的 在...上添加优惠,或者在单独一行上用 添加报价,然后选择 Okazii。
你的哪些优惠才真正到得了 Okazii
几乎每一个「Okazii 只导入了我的一小部分产品」的问题,背后都是这个。一条优惠只有在下面 四项全部 成立时,才会被写进 feed 文件:
| 条件 | 在哪里能看到 |
|---|---|
| 优惠是 已启用 的 | 优惠行上的状态开关。 |
| 优惠和产品 已连结 | 优惠名称下方的「已连结」那一行。 |
| 该产品的 库存 大于零 | 优惠名称下方的「库存」那一行。 |
| 优惠 没有阻断性错误 | 「错误」这一列。 |
这四项在 交易市场 → 优惠 → Okazii 里一眼就能看到。
没有通过校验的优惠会被关闭,原因显示在 错误 这一列里。
| 错误 | 要修什么 |
|---|---|
1000 Missing product name
|
产品没有名称。 |
1001 Missing product sku
|
产品没有 SKU。 |
1004 Invalid product price
|
销售价格低于 0.10。 |
1005 Invalid images data
|
优惠的图片格式不可用。请在产品上重新保存图片。 |
1006 Missing product images
|
产品完全没有图片。这是最常见的一种。 |
一处改动多久才会显示出来
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。 |
订单不再进来的时候
如果没有任何错误提示,订单却始终不来,先检查连接上的 API 令牌。在令牌成为必填项之前保存的连接看上去完全正常——它显示为已连接,feed 也照常工作——但一笔订单都不会被取回,而且没有任何提示。
然后,针对某个没有出现在 Okazii 上的产品,按这份清单逐条排查:
- 这条优惠是 已启用 的吗?
- 它和产品 已连结 了吗?
- 那个产品的库存大于零吗?
- 这条优惠是否显示了错误?
- Okazii 那边填的供稿提供网址是最新的那条吗?