【リリース済み】「受注データを作成」で顧客IDを指定することで顧客に紐づく受注を作成できるように変更します

2025/10/24

アップデート情報

2025年10月30日(木) 15:00頃リリース済み

概要

受注データを作成エンドポイントにて、リクエストボディで会員登録済みの顧客ID（customer.id）を指定しても全てゲスト顧客として受注および顧客が作成されていましたが、会員登録済みの顧客※である場合に指定の顧客に紐づく受注を作成できるように変更します。

※ 会員登録済みの顧客は下記で確認できます

カラーミーショップ管理画面内の顧客ページにて「ユーザー登録: 有」と表示される顧客
カラーミーショップ API 顧客データの各種エンドポイントにて取得できるデータ内で「"member": true」の顧客

変更の詳細

「受注データを作成」エンドポイントのリクエスト時、リクエストボディ内のcustomerオブジェクトの指定による挙動が下記のように変更されます。
※ 例示するJSONは一部省略されています

1. 会員登録済みの顧客IDのみを指定した場合

会員登録済みの顧客IDを指定した場合、指定の顧客に紐づく受注が作成されます。
レスポンスの customer オブジェクトは、既存の顧客情報が含まれて返却されます。

リクエスト例01

{
  "sale": {
    "customer": {
      "id": 1028030
    },
    ...
}

レスポンス例01

{
  "sale": {
    "customer": {
      "id": 1028030,
      "account_id": "PA01234567",
      "name": "ペパボ太郎",
      "furigana": "ペパボタロウ",
      "postal": "1508512",
      "pref_id": 13,
      "pref_name": "東京都",
      "address1": "渋谷区桜丘町26-1",
      "address2": "セルリアンタワー",
      "mail": "example01@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234",
      "member": true,
      "sales_count": 3,
      "receive_mail_magazine": true,
      "make_date": 1465784944,
      "update_date": 1494496809,
      ...
    },
    ...
}

2. 会員登録済みの顧客IDおよび、その他顧客情報（e.g. 顧客氏名 `name`）を指定した場合

指定の顧客に紐づく受注が作成されます。
その他指定された顧客情報については、更新や整合性の確認等は行われず既存の顧客情報が優先されます。

リクエスト例02

{
  "sale": {
    "customer": {
      "id": 1028030,
      "name": "ペパボ次郎",
      "furigana": "ペパボジロウ",
      "postal": "8100001",
      "pref_id": 40,
      "address1": "福岡県福岡市中央区天神2丁目7番21号",
      "address2": "天神プライム"
      "mail": "example02@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234",
    },
    ...
}

レスポンス例02

{
  "sale": {
    "customer": {
      "id": 1028030,
      "account_id": "PA01234567",
      "name": "ペパボ太郎",
      "furigana": "ペパボタロウ",
      "postal": "1508512",
      "pref_id": 13,
      "pref_name": "東京都",
      "address1": "渋谷区桜丘町26-1",
      "address2": "セルリアンタワー",
      "mail": "example01@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234",
      "member": true,
      "sales_count": 3,
      "receive_mail_magazine": true,
      "make_date": 1465784944,
      "update_date": 1494496809,
      ...
    },
    ...
}

3. 会員登録をしていない顧客IDを指定した場合

この場合、一律でエラーが返却されます。

リクエスト例03

{
  "sale": {
    "customer": {
      "id": 998273,
      "name": "ペパボ次郎",
      "furigana": "ペパボジロウ",
      "postal": "8100001",
      "pref_id": 40,
      "address1": "福岡県福岡市中央区天神2丁目7番21号",
      "address2": "天神プライム"
      "mail": "example02@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234"
    },
    ...
}

4. 顧客IDを指定せず、その他顧客情報を指定した場合

これまでの「受注データを作成」エンドポイントと同様の挙動となります。
（ゲスト顧客とそれに紐づく受注が作成されます）

リクエスト例04

{
  "sale": {
    "customer": {
      "name": "ペパボ次郎",
      "furigana": "ペパボジロウ",
      "postal": "8100001",
      "pref_id": 40,
      "address1": "福岡県福岡市中央区天神2丁目7番21号",
      "address2": "天神プライム"
      "mail": "example02@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234"
    },
    ...
}

レスポンス例04

{
  "sale": {
    "customer": {
      "id": 998273,
      "account_id": "PA01234567",
      "name": "ペパボ次郎",
      "furigana": "ペパボジロウ",
      "postal": "8100001",
      "pref_id": 40,
      "address1": "福岡県福岡市中央区天神2丁目7番21号",
      "address2": "天神プライム"
      "mail": "example02@example.com",
      "tel": "03-1234-1234",
      "tel_mobile": "080-1234-1234",
      "make_date": 1465784944,
      "update_date": 1494496809,
      ...
    },
    ...
}

変更予定日時

~~2025年10月29日(水) 15:30以降順次~~
2025年10月30日(木) 15:00頃リリース済み

既存利用者さまへの影響

本変更における不具合等の発生は非常に少ないものと想定しております。
前述の例を参照いただき、アプリケーションの実装等をご確認いただけますと幸いです。