00:052026年10月22日 星期四2 阅读

Shopify自2027-01版API起支持草稿订单自定义行项目设置产品类别

据悉,自 GraphQL Admin API 版本 2027-01 起,可以为草稿订单和订单编辑中的自定义行项目分配 Shopify 标准产品分类中的类别,该类别与产品一样决定项目的税务处理。对于使用 Managed Taxes 的商店,产品类别是设置自定义行项目税务处理的唯一输入。

在草稿订单中,Draft Order Line Item Input.product Category Id 可设置自定义行项目的产品类别,可用于 draft Order Create、draft Order Update 和 draft Order Calculate;提供 variant Id 时该字段被忽略。Draft Order Line Item.product Category 和 Calculated Draft Order Line Item.product Category 返回自定义行项目的类别,对产品变体行项目返回 null。

在订单编辑中,order Edit Add Custom Item 接受新的 product Category Id 参数,Calculated Line Item.product Category 返回计算后行项目的类别。如果 product Category Id 与当前分类中的类别不匹配,该变更将返回用户错误。

税务方面,使用 Managed Taxes 的商店由 product Category Id 设定税务处理,taxable 输入被忽略;没有类别的自定义行项目视为未分类,按标准税率征税。其他商店中 taxable: false 表示项目不征税,项目被征税时 Shopify 使用其类别计算税款。自定义行项目上的 taxable 输入已弃用,改用 product Category Id。

此前的是或否 taxable 标志无法表达降低税率或特定类别豁免,也不记录征税或豁免的原因;产品类别可让税款计算对自定义行项目应用正确规则,并记录税务处理的原因。

使用方法为通过 taxonomy 查询查找类别 ID,例如 query { taxonomy { categories(search: "t-shirts", first: 5) { nodes { id fullName } } } },再将 ID 作为 product Category Id 传入 draft Order Create、draft Order Update、draft Order Calculate 或 order Edit Add Custom Item,并从 product Category 读取已保存的类别。

来源:shopify.dev点击跳转

版权提示:本文由公开报道整理,仅供参考,不代表 DigSoho 观点。如与原文不符,以原文为准。版权问题请发邮件至 digsoho@163.com ,附上本页链接。

# 跨境资讯# 平台动态
扫码打开本篇