Order#subtotal_priceのドキュメントの表記が異なる

[_CRM]

Webhook経由(orders/fulfilled)で注文情報を取得しています。

送られてくるデータの中で、subtotal_priceのデータを使用しています。

webhook側のdocumentを見るとsubtotal_priceは税金を含まないと記述されており、その定義を元に実装していました。しかし、送られてくるデータを見ると税込金額で送られてくるようです。

そこで、Shopify AdminAPI GraphQL のドキュメントを確認したところ、taxesIncludedがtrueの場合には税込金額がsubtotal_priceには渡されると書かれています

ここからが質問なのですが、webhook側で渡されてくるOrder#subtotal_priceもAdminAPIの同様にtaxesIncludedがtrueの場合には税込金額がtrueの場合には税込金額が送られてくるという認識であっていますでしょうか？

また、その場合ドキュメントの修正を依頼したいのですが、どこか提案できるフォームなどはありますでしょうか？

ご確認よろしくお願いいたします

参照

webhook側のsubtotal_priceの仕様↓

https://shopify.dev/docs/api/admin-rest/2023-04/resources/webhook#event-topics-orders-fulfilled

上記リンクのResource: Orderを参照

上記リンク内に記述されているsubtotal_priceの定義↓

The price of the order in the shop currency after discounts but before shipping, duties, taxes, and tips.

Shopify AdminAPI GraphQL側のOrder#subtotal_priceのdocument

https://shopify.dev/docs/api/admin-graphql/2023-04/objects/Order#field-order-subtotalpriceset

また、AdminAPI側のOrder#subtotal_price定義

The sum of the prices for all line items after discounts and before returns, in shop and presentment currencies. If taxesIncluded is true, then the subtotal also includes tax.

[Qcoltd · Accepted solution]

興味があり調査してみました。

> ここからが質問なのですが、webhook側で渡されてくるOrder#subtotal_priceもAdminAPIの同様にtaxesIncludedがtrueの場合には税込金額がtrueの場合には税込金額が送られてくるという認識であっていますでしょうか？

合っているかと思います。

taxesIncludedのtrue/falseが

ストア管理画面 > 設定 > 関税と税金

にある「税込価格にする」をON/OFFするかで切り替わる前提なのですが、

上記のチェックボックスをONの状態と、OFFの状態で、

同一商品の注文のフルフィルメントを試してみたところ、

Webhookのorders/fulfilledのsubtotal_priceはどちらも同じ金額を示しました。

(※ 両者でtotal_priceは異なりましたので、上記のチェックボックスの設定で、内税/外税が切り替わったのは間違いなく、subtotal_priceは両者とも同じ、という結果でした。)

質問者様が調査された通りかと思われます。

> また、その場合ドキュメントの修正を依頼したいのですが、どこか提案できるフォームなどはありますでしょうか？

2つほど候補があるように思いました。

(1) Shopifyサポートに問い合わせる

https://help.shopify.com/ja/support/support-type

(2) shopifyのgithubに記載がある連絡先に問い合わせる

https://github.com/Shopify

ご参考まで。

(キュー田辺)