摘要
Target Plus 市场 API 适用于 Target 美国市场的受邀卖家:产品目录和变体系列、每个配送中心的价格、库存、带确认和履行的订单、退货和争议、报告以及 Target 项目分类法。API 密钥、卖家 ID 和卖家令牌。
引导式设置
2 分钟将 Target Plus 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Target Plus,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Target Plus 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Target Plus,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Target Plus
Target Plus 市场 API 适用于 Target 美国市场的受邀卖家:产品目录和变体系列、每个配送中心的价格、库存、带确认和履行的订单、退货和争议、报告以及 Target 项目分类法。API 密钥、卖家 ID 和卖家令牌。
设置
设置大约需要 10 分钟。你需要合作伙伴门户账户的管理员。
- 卖家 ID:在 Target Plus 合作伙伴门户 (https://plus.target.com) 中打开 Business Info, Basic Info,将 SMS ID 复制到
TARGET_PLUS_SELLER_ID。 - 卖家令牌:打开 Partner Settings, API Tokens 并创建一个令牌。只有管理员可以执行此操作,令牌只显示一次:直接复制到
TARGET_PLUS_SELLER_TOKEN。 - API 密钥:
x-api-key随你的 Target Plus API 访问而来,来自注册合作伙伴应用的 Target 开发者门户(查找 API Management 或 Apps and Keys)。将其复制到TARGET_PLUS_API_KEY。确切的屏幕名称可能因账户而异;如果找不到密钥,请联系你的 Target Plus 合作伙伴联系人以启用 API 访问。
每次调用都会发送三个头部 x-api-key、x-seller-id 和 x-seller-token;卖家 ID 也会进入每个卖家路径。分类法调用只需要 API 密钥。
从哪里开始:target_plus_list_distribution_centers(它也验证凭证),然后是 target_plus_list_orders,订单状态为 ["RELEASED_FOR_SHIPMENT", "ACKNOWLEDGED_BY_SELLER"] 的订单尚未发货,以及 target_plus_list_products 用于目录。
订单:target_plus_list_orders、target_plus_get_order、target_plus_get_order_address、target_plus_list_order_addresses。订单 ID 是订单号和发货建议号通过破折号连接的 (1028521085032-1635740801)。状态:PENDING、RELEASED_FOR_SHIPMENT、ACKNOWLEDGED_BY_SELLER、PARTIALLY_SHIPPED、SHIPPED、CANCELED、REFUNDED。使用 target_plus_update_order_status 确认订单(ACKNOWLEDGED_BY_SELLER),然后使用 target_plus_create_order_fulfillments 报告每个已发货的包裹(order_line_number、quantity、shipped_date、tracking_number 和来自 target_plus_list_shipping_methods 的 shipping_method 名称)。target_plus_list_order_fulfillments 显示已记录的内容,target_plus_update_order_fulfillments 通过履行 ID 进行更正。target_plus_update_order_line(以理由取消单位)默认关闭:取消无法撤销,并且会影响卖家。卖家无法设置 REFUNDED;退款通过 Target Plus 运营团队处理。地址是买家的个人数据:仅用于发货。
产品:target_plus_list_products、target_plus_get_product、target_plus_create_product、target_plus_update_product、target_plus_upsert_variation_family、target_plus_list_product_catalog_errors、target_plus_unlist_product(默认关闭)。一个产品有一个 Target Plus ID、你的 SKU(external_id)、一旦 Target 分配的 TCIN,以及作为名称/值对的字段。每次创建或更新都会添加一个新产品版本(product_status 为 latest=true),Target 会验证(validation_status 为 INITIATED、VALIDATED、ERROR、REVIEW、BLOCKED)并列出(listing_status 为 PENDING、APPROVED、REJECTED);current=true 的版本是正在销售的版本。子产品(VC)仅存在于具有一个父级(VAP)的变体系列内。提交后,阅读 target_plus_list_product_catalog_errors 以获取 field_name、reason 和 partner_action。
产品需要哪些字段:使用 target_plus_list_taxonomies 查找项目类型(类型 ITEM_TYPE、名称),使用 target_plus_list_attribute_assignments 列出其属性(taxonomy_id;required=true 标记为必填),使用 target_plus_list_attributes 查找属性,使用 target_plus_list_attribute_values 查找允许的值。target_plus_get_catalog_item 通过 TCIN 读取 Target 项目。在列出新项目类型或品牌之前,检查 target_plus_list_legalizations(你被批准销售的内容)和 target_plus_list_protected_legalizations(任何合作伙伴不得销售的内容)。
价格、库存和物流(无新产品版本):target_plus_get_product_price 和 target_plus_update_product_price(list_price 为必填,offer_price 最多为 list_price,map_price;以美元计)。库存按配送中心保持:target_plus_get_product_quantities、target_plus_get_product_quantity、target_plus_update_product_quantity(绝对值,允许为 0)和 target_plus_bulk_update_product_quantities(一个产品在多个中心,每个至少 1;返回 207,带有每个条目的状态)。target_plus_get_product_logistics 和 target_plus_update_product_logistics 处理 fulfillment.is_add_on、fulfillment.two_day_shipping_eligible、shipping_exclusion 和 seller_return_policy(来自 target_plus_list_return_policies 的退货政策 ID);更新是异步处理的,因此请读取状态为 PROCESSED 和反馈。
退货和争议(只读):target_plus_list_product_returns、target_plus_get_product_return、target_plus_search_product_returns(按追踪号码、车牌、退货订单号、日期)、target_plus_list_return_disputes、target_plus_get_return_dispute、target_plus_list_return_policies。争议在合作伙伴门户中提交;退款和退款金额仅供参考。
报告:target_plus_create_report_request(类型、格式、start_date、end_date)异步构建文件;轮询 target_plus_get_report_request 直到状态为 COMPLETE,并提供用户的 download_url。target_plus_list_report_requests 列出它们;请求保留 5 天。target_plus_terminate_report_request 默认关闭。PAYOUT_RECONCILIATION 报告仅读取支付数据。
设置数据:target_plus_list_distribution_centers(库存工具的 ID,带有发货节点)、target_plus_list_ship_nodes(承运人、服务级别、截止时间)。
分页:大多数列表接受 page(从 1 开始)和 per_page;Target 自身的默认值为 10,深度分页在 10,000 个结果处停止,因此按日期缩小以获取更多。它们的 X-Total-Count 和 Link 头部在 _headers 中返回,_pagination 命名下一个页面,直到最后一个页面。target_plus_list_products、target_plus_list_product_catalog_errors 和 target_plus_search_product_returns 使用 after_id 分页:传递最后一行的 ID。
格式和陷阱:日期为 UTC 的 ISO 8601;范围过滤器(order_date、last_modified、return_date)接受一个区间 start/end,例如 2026-11-01T00:00:00Z/2026-11-14T23:59:59Z。价格以美元计。错误以 {"message": ..., "errors": [...]} 的形式返回。Target 不在规格中发布速率限制;在 429 时请等待后再重试。连接器从不移动资金:它无法退款、支付或购买标签。
先决条件:TARGET_PLUS_API_KEY、TARGET_PLUS_SELLER_ID、TARGET_PLUS_SELLER_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,选择 Target Plus 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
target_plus_list_products | 列出你的 Target Plus 产品目录:按产品 ID、external_id(你的 SKU)、tcin、relationship_type(SA 独立、VAP 父级、VC… |
target_plus_get_product | 通过其 Target Plus 产品 ID 读取一个产品:external_id、tcin、relationship_type、parent_id、字段、价格、数量等… |
target_plus_create_product | 从你的 SKU 及其属性创建一个独立产品(relationship_type SA)或父级(VAP)。新版本开始为 PENDING… |
target_plus_update_product | 提交现有产品的新版本:发送 external_id、relationship_type 和完整字段集。Target 添加一个新… |
target_plus_upsert_variation_family | 一次调用创建或更新一个变体系列:恰好一个父级(VAP)及其子级(VC)。现有产品获得新版本… |
target_plus_unlist_product | 取消列出一个产品:其当前版本变为 UNLISTED,该项目在 target.com 上停止销售,直到提交新版本… |
target_plus_list_product_catalog_errors | 列出最新产品状态有错误的产品:id、external_id、tcin、parent_id 和每个状态 listing_status… |
target_plus_get_product_price | 读取产品价格:list_price、offer_price 和 map_price(最低广告价格)以美元计,以及 last_updated。只读 |
target_plus_update_product_price | 以美元设置产品价格:list_price 为必填;offer_price(销售价格,最多为 list_price)和 map_price 为可选… |
target_plus_get_product_quantities | 读取每个配送中心的产品可用数量:每个条目 distribution_center_id、quantity、last_modified 和… |
target_plus_get_product_quantity | 读取一个配送中心的产品可用数量:quantity、last_modified 和 last_modified_by。只读 |
target_plus_update_product_quantity | 设置一个配送中心的产品可用数量(绝对数,0 停止从那里销售)。返回存储的… |
target_plus_bulk_update_product_quantities | 一次设置一个产品在多个配送中心的数量。每个数量必须至少为 1(使用… |
target_plus_get_product_logistics | 读取产品的物流属性(fulfillment.is_add_on、fulfillment.two_day_shipping_eligible、shipping_exclusion… |
target_plus_update_product_logistics | 更新产品的物流属性而不创建新产品版本。发送字段作为名称/值对,名称… |
target_plus_list_orders | 列出你的 Target Plus 订单,按状态、编号、TCIN、发货节点或日期过滤:按订单 ID(订单号-发货建议号)… |
target_plus_get_order | 读取一个订单:状态、日期(订单、请求发货和交付)、服务级别、scac、发货节点、配送中心和每个… |
target_plus_get_order_address | 读取一个订单的发货地址:first_name、last_name、address1、address2、city、state、postal_code、country_code 和… |
target_plus_list_order_addresses | 列出你的订单的发货地址,每个订单 ID 一条条目,带有 shipping_address(名称、街道、城市、州、邮政编码、国家代码… |
target_plus_update_order_status | 确认一个订单:将其状态设置为 ACKNOWLEDGED_BY_SELLER,以确认你将发货。发货通过… |
target_plus_update_order_line | 更新订单行,主要用于取消单位:设置 order_line_status(每个状态的数量,例如 1 CANCELED 和 2 SHIPPED)和… |
target_plus_list_order_fulfillments | 列出为一个订单记录的履行(发货):按履行 ID、order_line_number、quantity、shipped_date、shipping_method… |
target_plus_create_order_fulfillments | 报告已发货的订单单位及其追踪:每个订单行和包裹一个项目,带有 order_line_number、quantity、shipped_date… |
target_plus_update_order_fulfillments | 更正已报告的订单履行(错误的追踪号码、方法、日期或数量)。每个项目重复完整… |
target_plus_list_shipping_methods | 列出 Target Plus 在履行中接受的发货方法:按方法 shipping_method(发送的名称,例如 USPSPriorityMail)… |
target_plus_list_product_returns | 列出你的产品的退货:按退货 ID、order_id、order_number、tcin、external_id、quantity、return_date、return_reason、is_online… |
target_plus_get_product_return | 读取一个产品退货:订单、tcin、SKU、数量、退货日期、退货原因、处置、入库追踪和 tracking_data(追踪… |
target_plus_search_product_returns | 按退货订单号、追踪号码、车牌、提单、位置或退货日期搜索退货,例如匹配一个… |
target_plus_list_return_disputes | 列出你的退货争议:按争议 ID、case_number、order_id、return_order_number、product_return_id、dispute_reason、quantity… |
target_plus_get_return_dispute | 读取一个退货争议:原因、描述、数量、判断、最终回应、回应、chargeback_amount 和 seller_refund_amount 在… |
target_plus_list_return_policies | 列出你的退货政策:按政策 ID、状态(ACTIVE、INACTIVE)、return_address、物理和财务处置 ID… |
target_plus_create_report_request | 请求报告,例如 ORDERS、INVENTORY、ITEM_ERRORS、BULK_PRODUCT_DATA、RETURN_ORDERS_EXTERNAL、PAYOUT_RECONCILIATION 或 SALES_METRICS… |
target_plus_list_report_requests | 列出你过去 5 天的报告请求:按请求 ID、类型、格式、状态(PENDING、PROCESSING、COMPLETE、CANCELED)、start_date… |
target_plus_get_report_request | 读取一个报告请求:状态(PENDING、PROCESSING、COMPLETE、CANCELED)、download_url 一旦 COMPLETE、反馈及任何错误、类型… |
target_plus_terminate_report_request | 终止报告请求:尚未 COMPLETE 的请求变为 CANCELED。返回 204,无正文。默认关闭 |
target_plus_list_distribution_centers | 列出你的配送中心:按中心 ID、名称、地址、时区、运营天数(工作时间、关闭天数)、two_day_state_codes… |
target_plus_list_ship_nodes | 列出一个配送中心的发货节点:按节点 ID、名称、承运人(ID、shipping_account)、服务级别(ID、cut_off_time… |
target_plus_list_legalizations | 列出你的合法化:Target 已批准你销售的项目类型和品牌(primary_attribute、paired_attributes)。在这里检查… |
target_plus_list_protected_legalizations | 列出受保护的合法化:外部合作伙伴不得在 Target Plus 上销售的品牌和项目类型。分页。只读 |
target_plus_list_taxonomies | 搜索 Target 产品分类法:按节点 ID、名称、类型(ITEM_TYPE、PRODUCT_TYPE、PRODUCT_SUBTYPE、MERCHANDISE_TYPE)、parent_id… |
target_plus_list_attribute_assignments | 列出分配给分类节点的属性(例如项目类型):按分配 attribute_id、attribute、required… |
target_plus_list_attributes | 搜索产品属性:按属性 ID、名称、标签、描述、类型、attribute_group、最小和最大值、标签(变体… |
target_plus_list_attribute_values | 搜索属性的允许值(例如 Target 接受的颜色或材料):按值 ID、名称、描述和… |
target_plus_get_catalog_item | 通过 TCIN 读取 Target 目录项目:product_title、brand、item_type 和 item_type_name、产品类型和子类型、商品类型、部门… |
示例提示
- “哪些 Target Plus 订单已释放待发货且尚未确认?”
- “显示产品 1234567 在每个配送中心的库存。”
- “哪些产品有目录错误,Target 说哪里出错了?”
- “将产品 1234567 的价格设置为 39.99 美元。”
- “请求上个月的销售报告,并告诉我何时准备好。”
下一步
这份指南对你有帮助吗?