摘要
refurbed 卖家 API 适用于翻新电子产品的卖家:订单和订单项(接受、带追踪和 IMEI 的运输)、退款干运行、运输标签、发票、退货、支持票、带库存和价格的报价、市场价格、产品查找、运输配置文件和承运人。来自 refurbed 的 API 令牌。
引导式设置
2 分钟将 refurbed 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 refurbed,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
refurbed 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → refurbed,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
refurbed
refurbed 卖家 API 适用于翻新电子产品的卖家:订单和订单项(接受、带追踪和 IMEI 的运输)、退款干运行、运输标签、发票、退货、支持票、带库存和价格的报价、市场价格、产品查找、运输配置文件和承运人。来自 refurbed 的 API 令牌。
设置
设置大约需要 5 分钟。你需要 plus refurbed 的回答。
- 使用 supplier.refurbed.com/api-token-request 的表单请求 API 令牌(或询问你的客户经理或 [email protected])。refurbed 会发送一个看起来像 UUID 的令牌。
- 将其粘贴到
REFURBED_API_TOKEN中,安装并运行refurbed_list_orders。连接器将其作为Authorization: Plain发送,后面跟着令牌。 - 未使用的令牌在 2 个月后过期;然后请求一个新的。有些调用还必须由 refurbed 为你的账户启用(运输标签、新电池报价)。
API 运行在 https://api.refurbed.com。refurbed 还会根据请求为每个卖家提供一个沙盒(supplier.refurbed.com/sandbox-request),地址类似于 https://grpc-<name>.qa.refurbed.io,带有测试订单;自托管安装可以将此连接器的副本指向那里。
从哪里开始:使用状态为 NEW 的 refurbed_list_orders 显示待处理的订单;refurbed_get_order 和 refurbed_list_order_items 显示订单项。使用 refurbed_accept_order_item 接受,然后使用 refurbed_ship_order_item 发货(追踪链接,或来自 refurbed_list_available_carriers 的承运人 slug 加上追踪号码,以及 item_identifiers 中的 IMEI 或序列号)。refurbed_batch_update_order_item_states 一次最多处理 50 个;refurbed_update_order_item 后续更改追踪、标识符、备注或瑞士海关数据;refurbed_get_order_item 读取一个订单项。
订单项状态:NEW 转为 ACCEPTED、REJECTED 或 CANCELLED;ACCEPTED 转为 SHIPPED 或 CANCELLED;SHIPPED 可以变为 RETURNED。跳过一个步骤会失败,错误代码为 9(无法将状态从 new 更改为 shipped)。REJECTED 和 CANCELLED 是最终状态,不会退款:refurbed_reject_order_item 安装时关闭,refurbed 希望你先通过票据告知客户。订单状态是根据其项计算的。不要使用已弃用的字段 parcel_tracking_number、parcel_tracking_carrier 和单个 item_identifier。
退款:此连接器从不退款。refurbed_calculate_item_refund 和 refurbed_calculate_order_refund 是干运行,显示退款金额;退款本身在卖家界面中完成(需要一个开放的票据)。
标签、发票、退货、票据:refurbed_list_shipping_labels 提供新标签链接;refurbed_create_shipping_label(关闭)在 refurbed 的运输协议中创建一个真实标签。refurbed_get_order_invoice 链接你上传的发票。refurbed_list_returns 列出带有 refurbed 退货标签的退货;当包裹到达时将项目设置为 RETURNED。refurbed_list_tickets 和 refurbed_get_ticket 读取客户票据。
报价:refurbed_list_offers、refurbed_get_offer、refurbed_create_offer(使用 refurbed_get_instance 查找产品,使用 refurbed_list_shipping_profiles 查找配置文件)、refurbed_update_offer 和 refurbed_batch_update_offers 用于库存和价格。通过 SKU 识别报价:报价 ID 在报价重新创建时会更改。库存为 0 时暂停;refurbed_delete_offer 关闭。每个市场的固定价格:refurbed_list_market_offers、refurbed_create_market_offer、refurbed_update_market_offer、refurbed_delete_market_offer(关闭);仅 refurbed_list_markets 的站点市场接受它们。仅接受新报价的保修 M12;等级为 AA、A、B 或 C。
其他查找:refurbed_list_merchant_addresses(标签的发件人地址 ID)和 refurbed_get_currency(汇率;设置检查使用它)。
API 的工作原理:每个调用都是一个 POST 请求,JSON 主体发送到 /refb.merchant.v1.<Service>/<Method>。字段名称为 snake_case;ID 是以字符串形式发送和返回的整数("3496079");货币是带小数点的字符串("199.99",拒绝逗号);时间为 UTC 的 RFC 3339;枚举按名称发送。通过 SKU 或 ID 提供报价,永远不要同时提供两者。列表分页使用游标:在 has_more 为 true 时,将最后一个 ID 作为 starting_after 传递,最多 100 行。批处理最多处理 1 到 50 个项目,并为每个项目回答一个状态。
限制和错误:默认情况下每秒 10 个请求(头部 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset);超过此限制会收到 429 RESOURCE_EXHAUSTED。错误响应 code 和 message 以及 gRPC 代码:3 无效参数,5 未找到,6 已存在,7 权限被拒绝,9 失败的前提条件,16 未经身份验证。
条款:refurbed 的 API 条款允许集成商代表卖家行动,但每个操作必须可追溯到卖家,API 数据不得转售或用于基准测试或市场情报。
写入:先确认。 接受、发货、追踪、库存和价格更改会影响实时账户。在每次调用之前,向用户显示更改内容并等待确认。
先决条件:REFURBED_API_TOKEN
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 refurbed 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
refurbed_list_orders | 列出订单,默认按最新排序:id、released_at、state(NEW、ACCEPTED、SHIPPED、FULFILLED、CANCELLED 等)、标签(例如… |
refurbed_get_order | 读取一个订单及其所有项:状态、标签、客户电子邮件、运输和发票地址(带增值税号码)、总额和结算… |
refurbed_list_order_items | 列出一个订单的项:id、名称、状态、sku、总额、佣金、税收、报价数据(报价 ID、等级、保修、运输… |
refurbed_get_order_item | 按其 ID 读取一个订单项(不是订单 ID):状态、sku、价格和佣金、报价数据、追踪链接和承运人… |
refurbed_accept_order_item | 接受一个 NEW 订单项(状态 ACCEPTED):你确认将发货。返回更新后的项 |
refurbed_ship_order_item | 将一个 ACCEPTED 订单项标记为 SHIPPED 及其追踪:完整的 parcel_tracking_url,或 parcel_carrier_tracking_number(承运人 slug 和… |
refurbed_update_order_item | 更改一个订单项而不更改其状态:替换追踪链接或承运人追踪号码,添加标识符(IMEI、序列号)… |
refurbed_batch_update_order_item_states | 一次在一个调用中更改最多 50 个订单项的状态(接受或发货多个)。每次更新都有单个调用的字段;响应… |
refurbed_reject_order_item | 拒绝(NEW 项)或取消(NEW 或 ACCEPTED 项)一个订单项。最终且无法撤销;它不会自动退款给客户… |
refurbed_calculate_item_refund | 干运行:显示退款一个订单项的含义(total_paid、total_refunded、refunded、refurbed 和商户份额)而不… |
refurbed_calculate_order_refund | 干运行:显示退款所有可退款订单项的总额,而不退款任何内容 |
refurbed_list_shipping_labels | 列出为一个订单创建的运输标签:id、打印机 PDF 链接(大约在一小时后过期,再次调用以获取新链接)、追踪… |
refurbed_create_shipping_label | 为一个订单在 refurbed 的运输协议中创建一个运输标签(今天是 DHL Express)。每次调用都会创建一个新的真实标签及其… |
refurbed_get_order_invoice | 获取你为一个订单上传的发票的下载链接(有效 24 小时)。当没有时返回 NOT_FOUND |
refurbed_list_returns | 列出使用 refurbed 退货标签的退货:id、order_id、order_item_id、instance_name、标识符、状态(INITIATED、IN_TRANSIT… |
refurbed_list_tickets | 列出客户支持票据:id、状态(OPEN、PENDING、SOLVED、CLOSED)、主题、紧急程度、客户、订单和订单项… |
refurbed_get_ticket | 读取一个支持票据及其消息、主题、状态、订单引用和备注 |
refurbed_list_offers | 列出你的报价:id、sku、instance_id 和 instance_name、状态(OK、UNVERIFIED、PENDING_REVIEW、REJECTED 和拒绝原因)、等级… |
refurbed_get_offer | 按 SKU 或 ID 读取一个报价:状态、等级、保修、库存、运输配置文件、税收、参考价格和市场价格… |
refurbed_create_offer | 为一个产品创建一个报价:instance_id(refurbed_get_instance),或 gtin 或 mpn(报价在 refurbed 检查之前为 UNVERIFIED… |
refurbed_update_offer | 按 SKU 或 ID 更改一个报价:库存、参考价格和最低价格、等级、保修、运输配置文件或税收;仅提供的字段… |
refurbed_batch_update_offers | 在一个调用中更改最多 50 个报价(库存和价格更新)。每个条目都有标识符以及 refurbed_update_offer 的字段;响应… |
refurbed_delete_offer | 按 SKU 或 ID 删除一个报价。无法撤销;要暂停报价,请使用 refurbed_update_offer 将库存设置为 0。安装时关闭 |
refurbed_list_market_offers | 列出一个报价的每个市场价格:market_code、是否为站点市场、设置或计算价格和最低价格、货币… |
refurbed_create_market_offer | 在一个站点市场中为一个报价设置固定价格,而不是从参考价格计算的价格。当市场已存在时返回 ALREADY_EXISTS… |
refurbed_update_market_offer | 更改一个市场中报价的固定价格。通过 sku 或 offer_id 和 market_code 提供报价 |
refurbed_delete_market_offer | 移除一个市场中报价的固定价格;价格将恢复为从参考价格计算的价格。安装时关闭 |
refurbed_get_instance | 通过 GTIN、MPN 或 ID 查找一个 refurbed 产品(实例):ID 和名称。创建报价时使用 ID 作为 instance_id。没有产品… |
refurbed_list_shipping_profiles | 列出你的运输配置文件:id、名称、源国家、目的市场及其费用和交货时间,以及每个配置文件使用的报价数量… |
refurbed_list_available_carriers | 列出 refurbed 可以追踪的承运人:名称和 slug。使用 slug 作为承运人,在使用追踪号码而不是链接发货时。缓存… |
refurbed_list_markets | 列出 refurbed 市场:代码(例如 de、at、fr)、名称、类型、currency_code 和 is_site(具有自己 refurbed 网站的市场,固定… |
refurbed_list_merchant_addresses | 列出你的地址:id、类型(DELIVERY 或 RETURN)、公司、街道、城镇、邮政编码和国家。ID 是发件人的地址… |
refurbed_get_currency | 读取一种货币及其汇率。不需要卖家数据;用于检查令牌是否有效 |
示例提示
- “哪些 refurbed 订单项等待接受?”
- “用 DHL 追踪 00340434161234567890 和 IMEI 356789012345678 发货订单项 9123456。”
- “我在 iPhone 14 128 GB 上每个市场的报价是多少?”
- “本周有哪些退货?”
- “退款订单项 9123456 的金额是多少?”
下一步
这份指南对你有帮助吗?