2月 21, 2026

TaxLine Channelにおける責任あるREST-APIの改善

2月 21, 2026

TaxLine Channel Liable REST-APIの改善：EC事業者への税金負担明確化

ShopifyのREST Order APIsは、開発者やEC事業者にとって重要なツールの一つです。特に、税金の計算と扱いに関する部分は、各事業者が法令遵守と正確なビジネス運営を行う上で重要な役割を果たしています。

しかし、これまでのREST Order APIでは、TaxLineオブジェクトのchannel_liableフィールドの扱いに一部問題がありました。具体的には、このフィールドがアプリから指定された値を正確に反映していないという問題がありました。

技術的ソリューションの提案

2024-01バージョンのREST Order APIsから、この問題が解消されます。channel_liableフィールドは、アプリから指定された値を正しく反映するようになりました。これにより、RESTとGraphQLのエンドポイント間での挙動が一致し、開発者はより一貫した開発環境を手に入れることができます。

更に、channel_liableフィールドは、販売税の課税責任が誰にあるかを開発者が事業者に伝えるためのものです。これにより、事業者は自身が負担すべき税金が明確になり、適切な税金処理が可能になります。

channel_liableは以下の値を持つことができます：

true：チャネルが税金の支払い責任を持つ
false：チャネルが税金の支払い責任を持たない

もしchannel_liableフィールドが指定されていない場合、デフォルト値としてfalseが設定されます。

実装手順とコード例

以下に、channel_liableフィールドの設定方法を示します。


// Orderの作成
POST /admin/api/2024-01/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "商品名",
        "price": "商品価格",
        "quantity": "商品数量",
        "tax_lines": [
          {
            "title": "消費税",
            "price": "税金額",
            "rate": "税率",
            "channel_liable":"true/false"   // ここで値を設定
          }
        ]
      }
    ]
  }
}