アップデートのお知らせ

####Bカート本体のアップデートにて追加されていた下記項目につきまして、BカートAPIでも扱えるように致します。

  • 納品日
  • 月毎の注文限度額
  • 商品オプションの価格設定

####また下記項目に関しましては取得のみ可能となっておりましたが、更新できるように致します。

  • 受注カスタム項目

###アップデート実施日時 2022年12月 13日午前12:00頃より実施いたします。

###1.新しい項目が追加されるエンドポイント

  1. 出荷(logistics)
  2. 会員(customers)
  3. 商品オプション(product_set_options)

###2.一部の項目が更新可能になるエンドポイント

  1. 受注(orders)


###1.1 出荷(logistics) 項目追加{#logistics} 納品日の取得(GET)、更新(PATCH)、追加(POST)が可能になります。

キー名 Bカートでの名称 説明
arrival_date 納品日 日付

####リクエスト、レスポンスサンプル
{
  "logistic": {
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
      "arrival_date": "2022-08-02",
      "status": "未発送"
  }
}


###1.2 会員(customers) 項目追加{#customers} 月毎の注文限度額の取得(GET)、更新(PATCH)、追加(POST)が可能になります。

キー名 Bカートでの名称 説明
credit_limit 月毎の注文限度額 整数

####リクエスト、レスポンスサンプル
{
    "customer": {
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
        "credit_limit": 100,
        "cutoff_date": null,
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
    }
}


###1.3 商品オプション(product_set_options) 項目追加{#product_set_options} 価格設定の取得(GET)が可能になります。

キー名 Bカートでの名称 説明
input_choices[price] 価格 整数

####リクエスト、レスポンスサンプル
{
    "product_set_option": {
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
        "input_type": "select",
        "input_choices": [
            {
                "view_name": "red",
                "value": 1,
                "price": 100
            }
        ],
        "input_rules": null,
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
    }
}


###2.1 受注(orders)の一部の項目が更新可能{#orders} 受注カスタム項目の更新(PATCH)が可能になります。

キー名 Bカートでの名称 説明
customs 受注カスタム項目 配列
customs[field_id] 受注カスタム項目ID 整数
customs[value] 文字列

####レスポンス、リクエストサンプル ``` { ~~~~~~~~~~~~ 一部省略 ~~~~~~~~~~~~ "customer_address3": "ダイマルヤ四条烏丸ビル5F", "customs": [ { "field_id": 11, "value": "受注カスタム1" }, { "field_id": 12, "value": "受注カスタム2" }, { "field_id": 13, "value": "受注カスタム3" } ], "payment": "銀行振込", ~~~~~~~~~~~~ 一部省略 ~~~~~~~~~~~~ } ```