linkfox-temu-order-eu
管理 Temu 欧洲站订单,支持订单列表与详情、常规及敏感收货地址、供货价与金额对账、可合并发货订单组、定制商品内容、SN/IMEI 和二手鉴真信息上传及相关文件下载。适用于已授权店铺的欧洲站订单处理和发货准备;不适用于美国站或全球站订单、商品维护、定价、取消、退货退款和实际发货履约。
SKILL.mdskills/linkfox-temu-order-eu/SKILL.md
GitHubTemu 欧洲站订单管理
适用范围
适用
查看和处理已授权 Temu 欧洲站店铺的订单,准备发货所需的地址、定制内容和核验资料。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 查欧洲店铺待发货订单,再看某单详情 | 订单列表与详情。 |
| 获取这笔订单的收货地址 | 常规地址;业务需要时查询敏感地址。 |
| 核对供货价、收入和消费者实付 | 订单金额与 ERP 对账。 |
| 哪些订单可以合并发货 | 可合并发货父订单组。 |
| 下载这笔订单的定制内容 | 定制文字、图文、SVG 或压缩包。 |
| 上传这些商品的 SN、IMEI 或二手鉴真编码 | 订单核验信息上传。 |
边界
美国站和全球站订单分别使用 linkfox-temu-order-us、linkfox-temu-order-global。商品维护、定价、取消、退货退款、实际发货分别使用 linkfox-temu-manage-product-eu、linkfox-temu-price-eu、linkfox-temu-cancel-order-eu、linkfox-temu-returns-refunds-eu、linkfox-temu-fulfillment-eu。发品可参考 linkfox-temu-add-product-us,使用前需核实适用站点,不将其视为 EU 发品能力。
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
订单列表查询 V2(bg.order.list.v2.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.list.v2.get |
references/apis/bg-order-list-v2-get.md |
scripts/eu_order_list_v2_get.py |
读取对应订单数据。 |
订单详情查询 V2(bg.order.detail.v2.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.detail.v2.get |
references/apis/bg-order-detail-v2-get.md |
scripts/eu_order_detail_v2_get.py |
读取对应订单数据。 |
订单收货地址查询 V2(bg.order.shippinginfo.v2.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.shippinginfo.v2.get |
references/apis/bg-order-shippinginfo-v2-get.md |
scripts/eu_order_shippinginfo_v2_get.py |
读取对应订单数据。 |
订单收货地址解密查询(bg.order.decryptshippinginfo.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.decryptshippinginfo.get |
references/apis/bg-order-decryptshippinginfo-get.md |
scripts/eu_order_decryptshippinginfo_get.py |
读取对应订单数据。 |
订单金额/供货价查询(bg.order.amount.query) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.amount.query |
references/apis/bg-order-amount-query.md |
scripts/eu_order_amount_query.py |
读取对应订单数据。 |
订单金额查询 V2(temu.order.amount.v2.query) |
POST /temu/proxy -> path:/openapi/router;type:temu.order.amount.v2.query |
references/apis/temu-order-amount-v2-query.md |
scripts/eu_order_amount_v2_query.py |
读取对应订单数据。 |
订单金额查询 V3(temu.order.amount.v3.query) |
POST /temu/proxy -> path:/openapi/router;type:temu.order.amount.v3.query |
references/apis/temu-order-amount-v3-query.md |
scripts/eu_order_amount_v3_query.py |
读取对应订单数据。 |
可合并发货订单组列表(bg.order.combinedshipment.list.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.combinedshipment.list.get |
references/apis/bg-order-combinedshipment-list-get.md |
scripts/eu_order_combinedshipment_list_get.py |
读取对应订单数据。 |
订单定制商品内容批量查询(bg.order.customization.get) |
POST /temu/proxy -> path:/openapi/router;type:bg.order.customization.get |
references/apis/bg-order-customization-get.md |
scripts/eu_order_customization_get.py |
读取对应订单数据。 |
订单核验信息上传(temu.local.order.verification.upload) |
POST /temu/proxy -> path:/openapi/router;type:temu.local.order.verification.upload |
references/apis/temu-local-order-verification-upload.md |
scripts/eu_order_verification_upload.py |
上传订单核验信息。 |
| 加签文件下载 | POST /temu/fileDownload -> path:请求中的 url |
references/api.md |
scripts/temu_eu_file_download.py、scripts/temu_file_download.py |
下载 Temu 加签资源。 |
前置条件
先确定目标店铺、区域和操作范围,具备 LinkFox 密钥及目标店铺的 Temu 授权。Temu 授权需在卖家后台手动完成;获取、保存与按店铺读取令牌见 授权说明 和 授权流程。通用转发入口 scripts/temu_eu_proxy.py、scripts/temu_proxy.py 复用同一网关。接口参数、默认值、使用限制和脚本兼容约定见 接口参考,官方菜单与文档线索见 Partner EU 目录。
订单处理流程
- 按用户指定的状态、时间或父订单范围查询列表,再按需读取详情。
- 发货准备时读取常规收货地址,检查返回的地址及履约限制;确需明文敏感信息时再查解密地址。
- ERP 对账时按店铺所在国/区域选取适用金额版本:V1 查询供货价;欧洲含税价对账优先 V3,需要细粒度税费拆分时用 V2。按父单与子单关系对齐。
- 需要合并发货时查询可合并父单组,再按需获取组内地址;合并确认和面单操作转交履约技能。
- 定制订单先从列表或详情取得子订单,再读取定制内容;需要素材时按接口参考中的下载要求处理。
- 需要核验的订单按实际商品准备 SN、IMEI 或二手鉴真编码,在用户授权范围内上传,再交由履约流程发货。取消、退货退款使用对应技能。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 调用约束:同一会话、同一参数组合默认只调用一次,脚本不启用响应缓存。失败或空结果时,不得自动更换筛选条件、翻页或连续试探;需要扩大查询范围时,先向用户说明后续查询范围。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-order-eu-<接口标识>-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total)和响应中存在的costToken等字段、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
不消耗算力 (限时)。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 区分订单标识:父订单对应整笔订单,子订单对应具体商品;定制内容和核验信息按子订单对齐,不能混用。
- 区分金额口径:供货价、卖家收入与消费者实付分别展示;V2 拆分税费,V3 侧重含税价。金额展示注明币种与单位,计算公式及空值语义见对应接口文档。
- 展示订单状态和限制:先列目标店铺、区域、查询范围和分页情况,再展示父子订单、商品、需履约数量、时间与告警。保留地址变更、自提、指定物流、主站合并和资质上传提示的业务含义。
- 保护敏感信息:解密地址含姓名、电话和详细地址,只在授权的订单处理范围内使用;业务展示脱敏,不额外复制到诊断日志或公开渠道。按输出策略保存的完整响应也须妥善保护。
- 区分读取与写入:核验上传会改变订单资料;根据用户指定的订单和内容操作,结果不确定时先核实,避免重复上传。
- 保留数据与解释失败:按接口参考区分网关、转发和 Temu 业务结果,保留原始响应与告警;空列表只表示当前条件无匹配数据。不得把未接入的合并确认或面单能力描述为已完成。
- 遵循实际缓存行为:业务脚本调用公共调用器时始终传入
--no-cache,不读写响应缓存;本地令牌存储与响应缓存分开,具体运行约定见接口参考。 - 维护接口目录:后续有新的 Partner 文档时,在本技能的接口目录、分接口文档、薄封装和清单中同步维护。
使用示例
查看待发货订单并准备地址
用户:查欧洲店铺的待发货订单,查看指定订单的详情和收货限制。
先查订单列表,再读取用户指定订单的详情与常规地址,展示限制及后续履约所需信息。
核对订单金额
用户:核对这笔欧洲订单的收入和消费者实付。
按店铺区域与对账口径选取金额版本,展示父单汇总和子单明细,注明税费口径、币种和告警。
获取定制内容或上传核验资料
用户:下载这个定制商品的文件,并为指定订单上传我提供的序列号。
从详情核对子订单,取得定制内容与下载资源;核对用户指定的核验资料后上传,说明每一步的实际返回结果。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。