如何将 Skroutz 与 easySales 对接:跨境卖家完整整合指南

在希腊最大的交易市场 Skroutz 上销售,并从一个后台统一管理。easySales 通过产品供稿把你的目录发布到 Skroutz,自动接收你的 Skroutz 订单,并用你的 Merchant API 令牌把接单、物流跟踪和发票推送回去。本指南将带你完成 Skroutz 的对接、上架产品,并理解订单、物流与开票的运作方式,帮助跨境卖家顺利进入欧洲市场。

为什么要把 Skroutz 与 easySales 对接

Skroutz 是希腊最大的交易市场兼比价平台,在上面销售意味着要把商品刊登、订单和发票都管理得井井有条。easySales 把 Skroutz 和你其他的销售渠道一起纳入同一个后台,让你管理一份目录、一条订单流,而不必在各个界面之间来回切换。

对接完成后,你的 Skroutz 订单会进入 easySales,随时可以开票、用自动化流程处理并发货。你的目录则往另一个方向走:easySales 把你的产品发布到 Skroutz,并持续更新价格和库存,让你只维护一份目录,而不用手动逐条修改每个 Skroutz 刊登。

Skroutz 连接器的运作方式

Skroutz 是一种混合式整合——一部分靠供稿,一部分靠实时 API——所以在开始之前先理解这两者的分工会很有帮助。

  • 你的目录通过产品供稿输出。 easySales 会构建一份 XML 产品供稿,包含你的刊登信息——名称、描述、品牌、EAN、类目、图片、价格、增值税、库存、重量和特性——并按固定周期刷新。Skroutz 读取该供稿来创建和更新你的刊登。
  • 订单通过 webhook 进入。 Skroutz 把每一笔新订单和更新的订单直接推送到 easySales,进入「订单和客户 → 订单」,随时可以开票和跑流程。
  • 订单操作通过你的 Merchant API 令牌返回。 你粘贴到连接中的令牌让 easySales 能对你的 Skroutz 订单执行操作——接单或拒单、发送物流跟踪信息,以及把发票上传回 Skroutz。

由于目录侧依赖供稿,有几点和纯 API 交易市场会有所不同。你在 easySales 中所做的改动不会即时反映到 Skroutz 上——它们会随下一次供稿刷新一起传送。而且在某些环节流程是单向的:easySales 不会从 Skroutz 读回你报价的状态,Skroutz 上已有的刊登也不会被导入到 easySales。

前提条件——开始之前需要准备什么

在第一次同步之前,有几样东西需要就位。

🛒

一个有效的 Skroutz 卖家账号

你需要一个已开通的 Skroutz 卖家账号,能够接收你的产品供稿并向你发送订单。如果你还没有,发邮件到 international-sales@skroutz.gr 进行注册。

📦

已设置重量的产品

Skroutz 报价由你的 easySales 产品构建,而 Skroutz 要求每个产品都有重量——在发布之前以千克为单位设置好。

🔑

你的 Skroutz Merchant API 令牌

Skroutz 会在验证你的产品供稿之后才签发它,所以第一天并不需要——你先对接,稍后再添加令牌。

🧾

一个准备好的发票系列

与你开票软件相匹配的开票系列,让已导入的 Skroutz 订单从一开始就正确编号。

第 1 步——在 easySales 中对接 Skroutz

在 easySales 中,从侧边栏进入「整合方式 → 交易市场」,找到 Skroutz 卡片,点击上面的「连接」。Skroutz 设置表单会打开,包含两个选项卡:「主要设置」(核心配置)和「附加设置」(同步行为)。你会先在主要设置中操作。

easySales 整合方式 → 交易市场页面,Skroutz 卡片及其「连接」按钮被高亮
从「整合方式 → 交易市场」中找到 Skroutz 卡片,点击「连接」以打开设置表单。

在「主要设置」选项卡上,填写 easySales 应如何构建供稿、为报价定价以及处理订单:

  • 连接名称——你为这个连接自定义的标签。仅在 easySales 内部可见。
  • 价格加成——可选的百分比,在向 Skroutz 发布新报价时叠加在产品价格之上。它作用于新创建的报价。
  • 默认运费——应用于 Skroutz 订单运费行的增值税税率。
  • 默认税率——应用于你报价和订单的默认增值税百分比。如果你不是增值税纳税人,请设为 0。
  • API 令牌——你的 Skroutz Merchant API 令牌。暂时留空;Skroutz 会在验证你的产品供稿之后签发,你稍后再回来粘贴(见第 4 步)。
  • 发票系列——分配给已导入的 Skroutz 订单的默认开票系列,与你在开票软件中使用的系列一致。
  • 隐式封装类型——你的包裹默认为「信封」还是「包裹」。
  • 尺寸属性颜色属性——Skroutz 用来读取变体尺寸和颜色的产品特性。映射好这两项,Skroutz 才能把你的变体归入一个家族(见第 3 步)。
  • 从报价中排除的特性——你不希望写入 Skroutz 供稿的任何特性。
  • 在产品描述中显示特性本地语言的产品资料——控制特性和产品文案在 Skroutz 上的呈现方式。
  • 交货天数——随你的报价一起发布的备货时间。
  • 生成运单时完成订单及物流选项——在下方订单部分说明。
easySales Skroutz 主要设置表单,显示连接名称、价格、税率、API 令牌、发票系列和属性字段
在「主要设置」选项卡上,设置你的连接名称、价格加成、税率、发票系列、封装类型和属性映射。在 Skroutz 验证你的供稿之前,把 API 令牌留空。

点击「保存」以创建连接。

第 2 步——上架产品并把供稿发送给 Skroutz

仅仅对接账号并不会自动把你的目录放到 Skroutz 上——你要选择哪些产品上架。

从侧边栏进入「网上商店 → 产品」,选中你想在 Skroutz 上销售的产品,然后在批量操作栏中使用「添加优惠」操作,选择你的 Skroutz 连接。easySales 会为每个产品创建一个 Skroutz 报价,并在你的目录中与之关联。从此这个报价会随你的产品供稿一起传送,其库存和价格与源产品保持绑定。只有处于启用、已同步且已关联到目录产品的报价才会被写入供稿。你已发布的报价会出现在「交易市场 → 优惠」的 Skroutz 选项卡下,你可以在那里查看和编辑。

easySales 网上商店 → 产品页面,已选中产品并显示添加优惠操作中的 Skroutz 连接
从「网上商店 → 产品」中选中你的产品,用「添加优惠」把它们发布到你的 Skroutz 连接。

当你保存连接时,easySales 会生成两个让整合运转起来的供稿。两者都会出现在「整合方式 → 交易市场」的 Skroutz 卡片上:

  • 供稿提供网址——Skroutz 读取以构建和更新你刊登的 XML 产品供稿。
  • Orders URL——Skroutz 推送你订单的地址。
easySales Skroutz 连接卡片,显示生成的供稿提供网址和 Orders URL
保存后,你的 Skroutz 卡片会显示供稿提供网址和 Orders URL——两个都复制并发送给 Skroutz。

easySales 不会自动注册这些网址——你从 Skroutz 卡片复制它们并交给 Skroutz,每一个都要提交到你 Skroutz Merchants 账号里的不同位置:

  • 供稿提供网址——在 Services → XML file 下提交:先验证你的供稿,然后使用 Send XML link。Skroutz 团队会进行额外检查并完成审核。
  • Orders URL——在 Skroutz 上打开 Services → Skroutz Marketplace,向下滚动到 Integration with the online store → Order webhooks(与网店整合 → 订单 webhook):把网址粘贴到 Webhook URL 字段并勾选 Enable,这样 Skroutz 就会开始把你的订单推送到 easySales。
Skroutz Merchants 后台,Services → XML file 页面,显示 How to activate 步骤和 Send XML link 按钮
在你的 Skroutz Merchants 账号中,在 Services → XML file 下验证你的供稿,并用 Send XML link 把它提交给 Skroutz。
Skroutz Merchants Order webhooks 区域,显示 Webhook URL 字段和 Enable 复选框
在 Skroutz 上,在 Order webhooks 下注册你的 Orders URL:把它粘贴到 Webhook URL 字段并勾选 Enable。

正式上线是一个操作步骤,可能需要一点时间,而不是瞬间完成。在 Skroutz 仍在对接你的供稿期间,一个已连接但还没有订单的供稿是正常的。

把变体归入一个家族

如果你的同一款产品有多种尺寸或颜色,Skroutz 可以把这些变体显示为一个家族刊登,而不是各自独立的产品。easySales 完全根据你自己的产品数据——产品家族及其特性——再加上你在连接上设置的一个小映射,来构建这种归组。各个部分是这样配合的:

  • 家族来自你的产品结构。 属于同一组的变体必须在 easySales 中共享一个父产品(同一个变体家族)。当产品在你的源商店中已经归组时,easySales 会自动沿用;否则你要在每个报价上手动设置变体,或通过 Excel 导入设置。不共享父产品的变体会作为独立刊登发送到 Skroutz,而家族刊登的名称取自父产品。
  • 尺寸和颜色的值从产品特性中读取。 每个变体的尺寸——以及颜色——都直接来自该产品自身的特性,例如一个值为「M」的「尺寸」特性,或一个值为「蓝色」的「颜色」特性。你不必为 Skroutz 重新录入;它们是从产品中提取的。
  • 你映射哪个特性是尺寸、哪个是颜色。 在连接的「主要设置」选项卡上,用「尺寸属性」告诉 easySales 哪个特性存放尺寸,用「颜色属性」对应颜色。正是这个映射把你的产品特性转换成 Skroutz 的尺寸和颜色维度。
easySales Skroutz 主要设置,尺寸属性和颜色属性映射下拉框被高亮
在「主要设置」上,用「尺寸属性」和「颜色属性」字段把你的产品特性映射到 Skroutz 的尺寸和颜色。

有两个条件决定一个家族是否真的会形成:

  • 必须映射一个尺寸属性。 家族是围绕尺寸维度构建的——如果你没有映射「尺寸属性」,或某个产品没有对应的值,那么该产品就会作为独立刊登发出,而不会加入家族。单独映射一个「颜色属性」不会创建家族;它只会为已按尺寸归组的变体增加颜色维度。
  • 尺寸或颜色的值不能出现在报价标题里。 家族中的变体共享同一个产品名称,尺寸存放在它自己的字段里,所以不要在标题中写「… – M」或「… 蓝色」——否则 Skroutz 无法干净地把它们归组。

映射属性只是告诉 easySales 要读取哪个特性——你仍然必须在每个产品上填好该特性的值。easySales 绝不会凭空生成尺寸,所以尺寸特性为空的产品会以无尺寸的状态发出,也不会加入家族。这是 Skroutz 供稿中缺少尺寸最常见的原因。如果有多个产品缺少该值,可以在你的 Skroutz 优惠列表中用 Mass edit 批量填写。对于确实没有尺寸的产品,请在该特性上填入字面值 One Size(英文)——Skroutz 期望正是这段文本,easySales 会原样发送。值都就位之后,对于已经归组为变体的产品,easySales 会自动生成尺寸变体(Size Variations)——无需额外设置。

第 3 步——微调同步

「附加设置」选项卡控制连接上线后 easySales 与 Skroutz 的同步方式。

easySales Skroutz 附加设置选项卡,显示发送 MPN 下拉框和当产品有库存时自动启用报价选项
「附加设置」选项卡控制 MPN,以及产品重新有库存时报价如何重新启用。
  • 发送 MPN——选择 easySales 作为产品 MPN(制造商零件号)发送给 Skroutz 的内容。有四个选项:什么都不发、报价的 SKU父 SKU(父产品的 SKU——便于应共享同一个 MPN 的归组变体使用),或某个特定特性的值。如果你选择「特性」,会出现第二个字段,让你选择要发送哪个特性。
  • 当产品有库存时自动启用报价——当产品库存恢复到零以上时,自动重新启用报价。

第 4 步——在 Skroutz 验证供稿后添加你的 API 令牌

这一部分常常让卖家踩坑,所以值得清楚地强调。Skroutz 不会预先把 Merchant API 令牌交给你——他们会在验证了你发送的产品供稿之后才签发。所以顺序是:

  1. 在 easySales 中对接 Skroutz 并上架报价(第 1–2 步)。
  2. 把你的供稿提供网址和 Orders URL 发送给 Skroutz。
  3. Skroutz 批准你的供稿后,在你的 Skroutz Merchants 账号里,在 Products → API 下用 Generate a new API token 生成你的 Merchant API 令牌。Skroutz 同一时间只保留一个有效令牌,所以生成新令牌会替换掉任何之前的密钥。
  4. 回到 easySales,打开你的 Skroutz 连接,把令牌粘贴到主要设置的「API 令牌」字段并保存。
Skroutz Merchants 后台,Products → API 选项卡,显示 Active API token 字段和 Generate a new API token 按钮
在你的 Skroutz Merchants 账号中,进入 Products → API 生成你的 Merchant API 令牌——然后把它粘贴到 easySales 的「API 令牌」字段。

在令牌就位之前,订单仍然可以进来,但 easySales 无法接单,也无法把物流跟踪和发票发送回 Skroutz——这些操作全都用令牌进行身份验证。如果你看到订单进来了却没有被接单,空的 API 令牌是第一个要检查的地方。

Skroutz 的订单、物流和发票如何运作

订单是 Skroutz 中自成一体运转的部分。easySales 不会从 Skroutz 拉取订单——是 Skroutz 把每一笔订单推送到你的 Orders URL,所以配送由 Skroutz 掌控。easySales 会导入每一笔订单,按 EAN 匹配产品,并以欧元计价。一旦你的 API 令牌就位,easySales 会自动在 Skroutz 上接回该订单,并预约一个快递取件时间窗。「延迟取件时间窗」设置决定预约哪个时段:默认开启时,它会选取最晚可用的时间窗;关闭它则会预约最早的那个。

由于配送是推送式的,如果某笔订单始终没能到达 easySales,你可以自己从 Skroutz 重新发送:在你的 Skroutz Merchants 账号中打开该订单,在它的 Webhook 面板里点击 New Request 再推送一次。

Skroutz Merchants 订单详情,显示 Webhook 面板和 New Request 按钮
如果某笔订单没能到达 easySales,在 Skroutz 中打开它,用 Webhook 面板里的 New Request 重新发送。

物流有两种运作方式,你可以按连接选择:

  • 由 Skroutz 提供面单。 打开「从市场平台附加 AWB」,easySales 会附上 Skroutz 为该订单签发的物流凭证,这样你就不用另外生成 AWB。
  • 由你生成 AWB。 像平常一样在 easySales 中生成面单,easySales 会把物流跟踪信息发送回 Skroutz。Skroutz 为此只认可一组固定的快递商——DPD、DHL、GLS、ACS、Speedex、ELTA 和 Geniki Taxydromiki——所以要用其中之一,跟踪信息才能在 Skroutz 上登记。

发票也会被发送回去:当你为一笔 Skroutz 订单生成发票时,easySales 会自动把 PDF 上传到 Skroutz。「生成运单时完成订单」默认开启,所以一旦订单的面单被附上,easySales 也会把订单标记为已完成——如果你更想自己管理这个状态,可以关闭它。

从 Skroutz → easySales 从 easySales → Skroutz
订单(新订单和更新的订单) 产品刊登——名称、描述、品牌、类目
运单面单(AWB),当你让 Skroutz 发货时 EAN、图片、重量和特性
欧元价格(含增值税)和库存可用性
接单/拒单以及物流跟踪更新
发票(上传到 Skroutz)
订单——以及可选的运单面单——流入;你的目录通过产品供稿流出。接单、物流跟踪和发票用你的 Merchant API 令牌推送回去。

你已完成对接——接下来做什么

订单开始进来后,下一步就是自动化:在「处理中 → 流程」下设置流程,随订单进来自动生成发票并处理订单。留意「交易市场 → 优惠」Skroutz 选项卡下的报价,任何未通过验证的都会被标记出来——如果发现异常,请联系客服。

无需信用卡
14 天免费
您可以随时取消

对接 Skroutz,从一个后台面向整个希腊销售

免费试用 easySales 14 天。无需信用卡。

常见问题

Skroutz 会在他们的团队验证了你发送的产品供稿之后才签发 Merchant API 令牌——它不是预先就有的。所以你先在 easySales 中对接 Skroutz、上架报价,并把你的供稿提供网址和 Orders URL 发送给 Skroutz;他们批准供稿后,就会把令牌给你。把它粘贴到连接「主要设置」选项卡的「API 令牌」字段并保存。如果你还没有 Skroutz 卖家账号,发邮件到 international-sales@skroutz.gr 进行注册。

最常见的原因是缺少 API 令牌。easySales 用你的 Merchant API 令牌来接单、发送物流跟踪并把发票上传回 Skroutz,所以如果连接上的「API 令牌」字段为空,订单会进来,但这些操作无法执行。打开你的 Skroutz 连接,把 Skroutz 给你的令牌粘贴到主要设置的「API 令牌」字段并保存——下一次尝试就会成功。

easySales 不会拉取订单——是 Skroutz 把它们推送到你的 Orders URL,所以配送由 Skroutz 掌控。首先确认 Orders URL 已在 Skroutz 上注册:在你的 Skroutz Merchants 账号中,在 Order webhooks 下,Webhook URL 必须已填写且勾选了 Enable。Skroutz 从它自己的服务器推送,所以要确保你这一端的任何网络限制没有拦截它。如果某笔具体订单没能到达,你可以重新发送它:在 Skroutz 上打开该订单,在它的 Webhook 面板里点击 New Request。一个全新的连接也可能只是还没有订单——如果重新发送后近期的订单仍然不出现,请联系客服。

是的。Skroutz 以欧元运营,easySales 也以欧元为你的 Skroutz 供稿定价。如果你复制了一个为罗马尼亚列伊交易市场构建的定价流程,金额可能会被成倍放大,因为一个基于列伊的公式被当作欧元读取了。请确保你应用到 Skroutz 的任何定价规则最终解析为欧元,然后重新发送你的报价,让修正后的价格进入供稿。

只有处于启用、已关联到目录产品且已同步的报价才会被写入 Skroutz 供稿——所以先在「交易市场 → 优惠」的 Skroutz 选项卡下检查报价的状态。Skroutz 还要求每个产品都有重量;没有重量的产品会以 0 发出,可能被拒绝。在产品上或通过 mass edit 以千克为单位设置重量,并确认该报价没有被标记验证错误。

有三点需要对齐。所有变体报价必须共享同一个变体 ID——当它们在你的源站点上已经归组时,easySales 会自动归组,否则你要按报价或通过 Excel 导入设置。尺寸或颜色的值不能写进报价标题里。而且尺寸和颜色特性必须在连接「主要设置」选项卡的「尺寸属性」和「颜色属性」字段中映射好,这样 Skroutz 才知道哪个特性是哪个。

映射尺寸属性只是告诉 easySales 要把哪个特性读取为尺寸——它并不会填入任何值。你供稿里的尺寸直接来自每个产品上该特性的值,easySales 绝不会自动生成它。如果该特性在你的产品上为空,就不会发送尺寸,也不会形成尺寸家族。在你的产品上填好值(从你的 Skroutz 优惠列表用 Mass edit 批量填写),等待下一次供稿刷新,然后把供稿重新发送给 Skroutz。对于没有真实尺寸的产品,填入 One Size(英文)作为值——Skroutz 期望正是这段文本。

不需要——Skroutz 在 easySales 中没有类目映射步骤。每个产品的类目直接取自你的目录,并原样写入供稿。Skroutz 需要完整的类目路径,从父类目到子类目,以 " > " 作为分隔符——例如 Mobile Phones > Bluetooth。请检查你在 easySales 中的产品类目名称是否符合这一格式;如果某个类目不是正确的 " > " 路径,它在 Skroutz 上可能无法被正确分类。

不需要。对于没有 EAN 的产品,easySales 会在供稿的 EAN 字段自动发送一个「-」占位符,所以那个字段上没什么要修的。对于这些产品,发送一个有效的 MPN 尤为重要——在「附加设置」选项卡上设置「发送 MPN」(SKU、父 SKU,或某个存放你制造商编码的特性),这样 Skroutz 仍能识别它们。

你可以让 Skroutz 提供运单面单——打开「从市场平台附加 AWB」,easySales 会附上 Skroutz 为该订单签发的凭证。或者你可以自己在 easySales 中生成 AWB,easySales 会把物流跟踪发送回 Skroutz。为此,Skroutz 只认可一组固定的快递商——DPD、DHL、GLS、ACS、Speedex、ELTA 和 Geniki Taxydromiki——所以要选其中之一,跟踪信息才能在 Skroutz 上登记。

本指南对你有帮助吗?