アップデートのお知らせ

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

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

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

  • 受注カスタム項目


アップデート実施日時

2022年12月 13日午前12:00頃より実施いたします。

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

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

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

  1. 受注(orders)


1.1 出荷(logistics) 項目追加

納品日の取得(GET)、更新(PATCH)、追加(POST)が可能になります。

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


リクエスト、レスポンスサンプル

{
  "logistic": {
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
      "arrival_date": "2022-08-02",
      "status": "未発送"
  }
}



1.2 会員(customers) 項目追加

月毎の注文限度額の取得(GET)、更新(PATCH)、追加(POST)が可能になります。

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


リクエスト、レスポンスサンプル

{
    "customer": {
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
        "credit_limit": 100,
        "cutoff_date": null,
        ~~~~~~~~~~~~
        一部省略
        ~~~~~~~~~~~~
    }
}



1.3 商品オプション(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)の一部の項目が更新可能

受注カスタム項目の更新(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": "銀行振込",
    ~~~~~~~~~~~~
    一部省略
    ~~~~~~~~~~~~
}