05 履约与渠道

1. 代发适配器

class Fulfiller(Protocol):
    name: str
    def sync_catalog(self) -> list[CatalogItem]: ...
    def quote(self, sku: str, country: str, qty: int) -> Quote: ...          # 成本 + 运费 + 时效
    def submit(self, item: OrderItem, print_file_url: str, ship_to: Address,
               gift: GiftInfo | None) -> str: ...                             # 返回代发平台订单号
    def parse_webhook(self, headers: dict, body: bytes) -> list[FulfillEvent]: ...
    def request_reprint(self, fulfiller_order_id: str, reason: str, photos: list[str]) -> None: ...

2. Printify（海外，P1）

2.1 售后规则（自动执行）

3. 国内实物（P3）

• 候选：面向跨境卖家的柔性定制供应链平台（如 SDS、S2BDIY 等）。第 12 周前确认：是否支持国内收货、是否开放下单和物流查询接口、结算方式、打样质量
• 满足条件的接入 Fulfiller；不满足则国内只卖电子版，不做人工代发
• 1688 工厂作为备选，只有在它们提供可用的开放接口或 ERP 对接时才考虑

4. 闲鱼卡密（国内电子版，P3）

沿用 v1 的"方案 A"：

1. 后台生成兑换码（格式 PX-{套餐短码}-{4位}-{4位}-{校验2位}，带 HMAC 校验位），导出 CSV
2. 导入闲管家的卡密库存，买家付款后自动发送"兑换链接 + 兑换码"
3. 买家在小程序里兑换 → 进入定制流程（与小程序直接购买的流程相同，只是跳过付款）
4. 库存低于 20 张时告警；闲鱼退款后，在后台作废对应的码（开放平台接入后可自动作废）
5. 兑换页不放微信号、二维码等联系方式

不使用任何非官方的闲鱼自动化工具（封号风险）。

5. 小程序（国内，P3）

• 与网页版共用业务接口（/api/pix/v1），区域为 cn
• 登录：微信登录；支付：实物用微信支付 JSAPI；电子版在 iOS 端必须用微信"小程序虚拟支付"（core.billing 的 wechat_virtual），Android 端以微信当期规则为准
• 页面公示：所用模型名称和备案号（来自网关的 cn_allowlist）
• 通知：微信订阅消息（交付、物流）

6. Etsy（P3，需先确认可行性）

在开发之前必须确认以下几点，任意一项不满足就不做：

• ☐ 能否在不违反 Etsy 规则的前提下，自动收集买家的照片（例如 Etsy 下单时的个性化字段是否支持上传照片，或者官方允许的方式）
• ☐ Etsy 开放接口能否读取订单、个性化信息并回填发货
• ☐ AI 披露：商品描述写明 AI 生成，归类为"Designed by"
• ☐ 数字预览：Etsy 买家下单前无法使用我们的实时预览，转化率可能明显偏低，需要测算

如果照片收集必须靠买家发消息，就意味着需要人工，与零人工的原则冲突，这种情况下不做 Etsy。

7. 官网（海外主渠道，P1）