电商
它到底能做什么
一键配对
标准的 WooCommerce 授权流程会自动开出 API 密钥和 Webhook——不用复制密钥的仪式,也没有 Webhook 检查清单。
深度导入
图片、分类树、原价与促销价及其生效时段、GTIN、标签、追加销售与交叉销售、变体的价格和图片——商品目录是整个搬过来的,而不是一副只有名称和价格的骨架。
真正的写回
在这边改商品可以写回 Woo——由逐项操作的开关管着,还带彩排模式,所以在任何东西真的变动之前,你先看得到会变什么。
字段级的归属权
每一类数据你都可以单独选:归 Woo、归这边,或者双向同步。归属在别处的字段会以只读方式呈现,并在界面上写明原因——不会出现两个主人的混乱。
一本冲突台账
失败或冲突的同步会落进一本看得见的台账,可以处理完再重试——绝不会变成盘库时才发现的一次静默覆盖。
订单也进这条流
Woo 订单会带着来源标记出现,和来自聊天商城、AI 与 API 的订单并排——所有入口共用同一份订单事实。
技术细节
多数集成跳过的那部分同步工程
一次疑心很重的配对握手
连接链接 15 分钟后失效,回调在做别的任何事之前就先被标记为已消费,因此不可能被人拿旧凭据重放——而真正使用的商店地址,是你自己输入的那个,绝不是回调声称的那个。
从设计上就不怕重试
Woo 每次重试都会给投递重新编号,所以去重刻意忽略这些编号,改以消息内容为键。出站方向上,幂等键放在订单自己的元数据里,靠搜索重新找回来——因为真正危险的情况是:写入成功了,响应却丢了。
关联留到第二趟处理
追加销售和交叉销售过来时只是一串商店 ID,指向的商品可能还不存在——所以它们要等商品目录落地之后,在第二趟里才被解析;分类树则单独拉取,因为商品数据里只写了叶子节点的名字。
币种只读一次,读对为止
Woo 只在订单上给出币种,从不在商品上给——所以商店币种是在导入目录之前,从商店自己的设置里读一次,而不是逐行去猜。
一张保守的状态映射表
履约状态只在两边术语真正对得上的地方才做映射;“已退货”的订单绝不会被硬翻过去——它会作为一条订单备注送到人手里。状态备注发布时会关掉客户通知,免得 Woo 又给你的客户发一封邮件。
你手敲的内容说了算
在这边被人手动改过的字段,绝不会被一次导入覆盖掉——同步尊重人的判断,并在每个条目的来源卡片上写明这一点。
接入设置
连接方式
配对商店
点击连接,在你的 WooCommerce 后台点确认——密钥和 Webhook 都会替你配好。
选定归属权
按数据类别逐一选定谁说了算:Woo、ConnectWiz,还是双向。
先彩排,再上线
写回操作先在彩排模式里跑一遍;差异看着没问题,再切到正式。
搭配更好用
能与什么搭配
安全与保证
无聊但管用的保证
密钥自动下发,不用粘贴
wc-auth 流程让你的商店在服务端把密钥交给我们——加密存储,也就没有那套让人有机会泄露的复制粘贴仪式。
每个 Webhook 都要验证
入站投递用我们按商店单独生成的密钥做 HMAC 签名,并以恒定时间比对——伪造的“商品更新”在门口就被弹回去。
对你的商店很客气
已验签但我们暂不处理的投递,照样回成功,因为 Woo 在连续五次失败后会停用一个 Webhook——怪东西由我们吞下,而不是让你的商店对我们死心。
出站有 SSRF 防护
每一次对你商店地址的调用都要过一道出站防护——恶意的“商店地址”无法被拿去探测内网。
不加粉饰的细则
边界,写清楚
不做支付处理
订单会同步;扣款仍然归你的商店和支付服务商——假装不是这样,正是平台把自己做成半个蹩脚银行的路径。
媒体随归属权走
凡是内容字段归 Woo 所有的地方,在这边就是只读的,这是刻意的设计——归属权约定的意义,正在于它同样约束我们。
2,000 件商品的上限
一次导入最多带 2,000 件商品——这是明说的工程边界。更大的商品目录是一场关于扩容的谈话,我们宁愿坦率地谈,也不愿让它悄无声息地超时。
订单是读取,不是复制
商店订单直接实时显示在联系人上(缓存一分钟,取最近十条),而不是被复制进第二本台账——这是一个刻意的单一事实来源决定,写在这里。