来源中的信息
发生了什么
从 GraphQL Admin API 2027-01 版本开始，商家可以为草稿订单和订单编辑中的自定义行项目分配 Shopify Standard Product Taxonomy 中的产品类别。
草稿订单可通过 DraftOrderLineItemInput.productCategoryId 设置分类，并可在 draftOrderCreate、draftOrderUpdate 和 draftOrderCalculate 中使用；如果同时提供 variantId，该字段会被忽略。
订单编辑中的 orderEditAddCustomItem 新增 productCategoryId 参数；如果该 ID 不匹配当前分类体系中的类别，mutation 会返回用户错误。
对于使用 Managed Taxes 的商店，产品类别是决定自定义行项目税务处理的唯一输入；本更新的市场适用范围标注为全球。
经营影响
为什么重要
自定义行项目过去容易成为订单税务信息中的非标准节点；现在分类可以进入草稿订单和订单编辑流程，使税务处理依赖的商品属性更接近标准商品流程。
这项变化主要影响通过 API 创建报价、人工补项、订单修改或自动化订单处理的商家，而不是所有普通商品变体订单。
分类 ID 失效会直接产生用户错误，因此分类映射的维护将成为订单自动化稳定性的一部分。
编辑观察
分析判断
税务计算会从订单中的“自定义描述”进一步依赖结构化分类，机制上意味着自定义行项目不再只是金额和文字的组合；对使用 Managed Taxes 的商家，决策重点应从事后核对税额转向在生成草稿订单或添加补充项目之前确定分类，证据仅支持其对产品类别和税务输入的描述，未说明具体税率或税额变化。
分类被纳入订单编辑链路后，销售、客服和后台自动化之间的错误会更容易表现为 API 用户错误或不一致的税务处理，而不是单纯的商品展示问题；商家应优先检查涉及自定义项目的报价、补单和改价流程，证据没有提供错误发生频率、损失规模或因果效果。
是否立即改造取决于商家是否使用相关 API、是否创建自定义行项目以及是否启用 Managed Taxes；对符合这些条件的商家，下一步观察点应是 2027-01 版本切换后的分类校验和订单计算结果，对不符合条件的商家则应先监控实际使用场景，输入未提供更细的商家分群或迁移期限。
适用范围
对卖家的影响
使用 Managed Taxes 且通过 API 生成草稿订单或修改订单的商家，需要把自定义行项目的分类选择视为税务流程的一部分，而非仅用于目录整理。
销售或客服可以添加自定义项目的工作流可能需要提供可验证的分类来源，否则有效的金额和描述仍可能无法顺利完成订单计算或提交。
依赖固定分类 ID 的集成需要考虑当前分类体系变化带来的校验失败；输入未说明 Shopify 是否提供自动迁移或分类 ID 稳定性保证。
行动建议
现在应该做什么
- 1
盘点自定义行项目的 API 使用场景
this-week列出草稿订单创建、更新、计算以及订单编辑中添加自定义项目的调用，区分哪些流程提供 variantId，哪些流程真正需要 productCategoryId。
- 2
建立分类 ID 的校验清单
this-week为自定义行项目维护分类映射，并在提交前检查分类是否仍属于当前 Standard Product Taxonomy；将用户错误记录到现有订单自动化监控中。
- 3
跟踪 GraphQL Admin API 2027-01 的切换影响
monitor关注相关接口在版本切换后的实际返回值、计算结果和分类读取行为；重点观察使用 Managed Taxes 的草稿订单与订单编辑流程。
暂时不要做什么
- 不要把这项能力泛化为所有订单或所有税务配置都必须立即修改；输入只确认其适用于自定义行项目、相关 API 流程及使用 Managed Taxes 的税务处理。
- 不要在未核对当前分类体系的情况下批量写入 productCategoryId，也不要假设分类 ID 不变或 Shopify 会自动替换失效 ID。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
Starting with GraphQL Admin API version 2027-01, you can assign a category from Shopify's Standard Product Taxonomy to custom line items in draft orders and order edits. The category controls the item's tax treatment in the same way it does for products. For stores using Managed Taxes, the product category is the only input that sets a custom line item's tax treatment. What's new You can now set and read product categories on custom line items in draft orders and order edits: Draft orders DraftOrderLineItemInput.productCategoryId sets the product category of a custom line item. You can use it with draftOrderCreate, draftOrderUpdate and draftOrderCalculate. It's ignored when variantId is provided. DraftOrderLineItem.productCategory and CalculatedDraftOrderLineItem.productCategory return the category of a custom line item. They return null for product variant line items. Order edits orderEditAddCustomItem accepts a new productCategoryId argument. CalculatedLineItem.productCategory returns the category of the calculated line item. If productCategoryId doesn't match a category in the current taxonomy, the mutation returns a user error. How the category affects tax | Store | Tax treatme
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年10月21日 14:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.