顧客登録
const url = 'https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-oms/customers';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name01":"山田","name02":"太郎","kana01":"ヤマダ","kana02":"タロウ","companyName":"株式会社サンプル","companyDepartment":"営業部","country":"日本","zip01":"100","zip02":"0001","pref":"13","addr01":"千代田区千代田1-1","addr02":"テストビル8F","tel01":"03","tel02":"1234","tel03":"5678","telSecond01":"090","telSecond02":"1111","telSecond03":"2222","fax01":"03","fax02":"9999","fax03":"8888","sex":"1","job":"3","birth":"1990-01-23","point":"100","mailmagaFlg":"1","email01":"sub1@example.com","email02":"sub2@example.com","email03":"sub3@example.com","email04":"sub4@example.com","email05":"sub5@example.com","email01EmailType":"1","email02EmailType":"1","email03EmailType":"2","email04EmailType":"2","email05EmailType":"3","email01MailmagaFlg":"1","email02MailmagaFlg":"1","email03MailmagaFlg":"1","email04MailmagaFlg":"1","email05MailmagaFlg":"1","email01ErrorFlg":"0","email02ErrorFlg":"0","email03ErrorFlg":"0","email04ErrorFlg":"0","email05ErrorFlg":"0","email01EcShopId":"1","email02EcShopId":"1","email03EcShopId":"2","email04EcShopId":"2","email05EcShopId":"3","mailFlag1":"1","mailFlag2":"1","mailFlag3":"1","mailFlag4":"0","mailFlag5":"0","mailFlag6":"1","dmFlag":"1","blackFlag":"0","lightNote":"簡易メモ","note":"備考","note01":"備考1","note02":"備考2","note03":"備考3","note04":"備考4","note05":"備考5","wishNote":"贈答ボックス希望","wishRyoushuType":"1","wishNouhinType":"2","wishHassoTimeId":"3","wishHassoMemo":"翌日配送希望","wishHassoDelivId":"1","wishNoteAttention":"不在時は電話希望","userFlag1":"1","userFlag2":"2","userFlag3":"3","mark1":"1","mark2":"0","mark3":"1","customerType":"2","parentCustomerId":"10001","friendCampaignId":"20001","customerCharge":"10","memberSalesChargeId":"20","b2cSalesChannelId":["1","2"],"b2cSalesChannelId2":["3","4"],"b2cSalesChannelId3":["5","6"],"bbcMemberCode":"1","memberStaffId":"1"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-oms/customers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name01": "山田", "name02": "太郎", "kana01": "ヤマダ", "kana02": "タロウ", "companyName": "株式会社サンプル", "companyDepartment": "営業部", "country": "日本", "zip01": "100", "zip02": "0001", "pref": "13", "addr01": "千代田区千代田1-1", "addr02": "テストビル8F", "tel01": "03", "tel02": "1234", "tel03": "5678", "telSecond01": "090", "telSecond02": "1111", "telSecond03": "2222", "fax01": "03", "fax02": "9999", "fax03": "8888", "sex": "1", "job": "3", "birth": "1990-01-23", "point": "100", "mailmagaFlg": "1", "email01": "sub1@example.com", "email02": "sub2@example.com", "email03": "sub3@example.com", "email04": "sub4@example.com", "email05": "sub5@example.com", "email01EmailType": "1", "email02EmailType": "1", "email03EmailType": "2", "email04EmailType": "2", "email05EmailType": "3", "email01MailmagaFlg": "1", "email02MailmagaFlg": "1", "email03MailmagaFlg": "1", "email04MailmagaFlg": "1", "email05MailmagaFlg": "1", "email01ErrorFlg": "0", "email02ErrorFlg": "0", "email03ErrorFlg": "0", "email04ErrorFlg": "0", "email05ErrorFlg": "0", "email01EcShopId": "1", "email02EcShopId": "1", "email03EcShopId": "2", "email04EcShopId": "2", "email05EcShopId": "3", "mailFlag1": "1", "mailFlag2": "1", "mailFlag3": "1", "mailFlag4": "0", "mailFlag5": "0", "mailFlag6": "1", "dmFlag": "1", "blackFlag": "0", "lightNote": "簡易メモ", "note": "備考", "note01": "備考1", "note02": "備考2", "note03": "備考3", "note04": "備考4", "note05": "備考5", "wishNote": "贈答ボックス希望", "wishRyoushuType": "1", "wishNouhinType": "2", "wishHassoTimeId": "3", "wishHassoMemo": "翌日配送希望", "wishHassoDelivId": "1", "wishNoteAttention": "不在時は電話希望", "userFlag1": "1", "userFlag2": "2", "userFlag3": "3", "mark1": "1", "mark2": "0", "mark3": "1", "customerType": "2", "parentCustomerId": "10001", "friendCampaignId": "20001", "customerCharge": "10", "memberSalesChargeId": "20", "b2cSalesChannelId": [ "1", "2" ], "b2cSalesChannelId2": [ "3", "4" ], "b2cSalesChannelId3": [ "5", "6" ], "bbcMemberCode": "1", "memberStaffId": "1" }'顧客を登録します。
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
お名前(姓)
お名前(名)
お名前(フリガナ・姓)
お名前(フリガナ・名)
会社名
部署名
国名(国名で指定、内部でIDに変換)
郵便番号1
郵便番号2
都道府県ID
住所1
住所2
電話番号1
電話番号2
電話番号3
電話番号2-1
電話番号2-2
電話番号2-3
FAX1
FAX2
FAX3
性別ID
職業ID
生年月日(YYYY-MM-DD形式)
ポイント
メールマガジンフラグ 1:受け取る、3:受け取らない
メールアドレス1
メールアドレス2
メールアドレス3
メールアドレス4
メールアドレス5
メールアドレス1種類(1:PC、2:スマホ、3:ガラケー)
メールアドレス2種類(1:PC、2:スマホ、3:ガラケー)
メールアドレス3種類(1:PC、2:スマホ、3:ガラケー)
メールアドレス4種類(1:PC、2:スマホ、3:ガラケー)
メールアドレス5種類(1:PC、2:スマホ、3:ガラケー)
メールアドレス1メルマガ(1:受け取る、3:受け取らない)
メールアドレス2メルマガ(1:受け取る、3:受け取らない)
メールアドレス3メルマガ(1:受け取る、3:受け取らない)
メールアドレス4メルマガ(1:受け取る、3:受け取らない)
メールアドレス5メルマガ(1:受け取る、3:受け取らない)
メールアドレス1送信エラーフラグ
メールアドレス2送信エラーフラグ
メールアドレス3送信エラーフラグ
メールアドレス4送信エラーフラグ
メールアドレス5送信エラーフラグ
メールアドレス1ショップID
メールアドレス2ショップID
メールアドレス3ショップID
メールアドレス4ショップID
メールアドレス5ショップID
サンクスメール送信可否フラグ
入金確認メール送信可否フラグ
発送完了メール送信可否フラグ
フォローメール送信可否フラグ
ステップメール送信可否フラグ
メルマガ送信可否フラグ
DMフラグ
顧客識別フラグID
簡易メモ
備考
顧客備考1
顧客備考2
顧客備考3
顧客備考4
顧客備考5
指定-ひとことコメント
指定-領収書(1:同梱、2:WEB)
指定-納品書(1:同梱、2:WEB)
指定-お届け時刻
指定-送り状記事欄
指定-配送業者
指定-伝達事項
ユーザーフラグ1 ID
ユーザーフラグ2 ID
ユーザーフラグ3 ID
マーク1
マーク2
マーク3
会員種別
紹介者顧客ID
紹介キャンペーンコード
カスタマー担当者ID
営業担当者ID
B2C販路区分IDを配列で指定します。
- 各要素は文字列として扱います。
- 空文字要素や空白を含む要素も指定可能ですが、登録時には除去されます。
- 重複要素も指定可能ですが、登録時には一意化した上で保存されます。
B2C販路区分ID2を配列で指定します。
- 各要素は文字列として扱います。
- 空文字要素や空白を含む要素も指定可能ですが、登録時には除去されます。
- 重複要素も指定可能ですが、登録時には一意化した上で保存されます。
B2C販路区分ID3を配列で指定します。
- 各要素は文字列として扱います。
- 空文字要素や空白を含む要素も指定可能ですが、登録時には除去されます。
- 重複要素も指定可能ですが、登録時には一意化した上で保存されます。
BBC加盟店コード
BBC加盟店スタッフID
Example
{ "name01": "山田", "name02": "太郎", "kana01": "ヤマダ", "kana02": "タロウ", "companyName": "株式会社サンプル", "companyDepartment": "営業部", "country": "日本", "zip01": "100", "zip02": "0001", "pref": "13", "addr01": "千代田区千代田1-1", "addr02": "テストビル8F", "tel01": "03", "tel02": "1234", "tel03": "5678", "telSecond01": "090", "telSecond02": "1111", "telSecond03": "2222", "fax01": "03", "fax02": "9999", "fax03": "8888", "sex": "1", "job": "3", "birth": "1990-01-23", "point": "100", "mailmagaFlg": "1", "email01": "sub1@example.com", "email02": "sub2@example.com", "email03": "sub3@example.com", "email04": "sub4@example.com", "email05": "sub5@example.com", "email01EmailType": "1", "email02EmailType": "1", "email03EmailType": "2", "email04EmailType": "2", "email05EmailType": "3", "email01MailmagaFlg": "1", "email02MailmagaFlg": "1", "email03MailmagaFlg": "1", "email04MailmagaFlg": "1", "email05MailmagaFlg": "1", "email01ErrorFlg": "0", "email02ErrorFlg": "0", "email03ErrorFlg": "0", "email04ErrorFlg": "0", "email05ErrorFlg": "0", "email01EcShopId": "1", "email02EcShopId": "1", "email03EcShopId": "2", "email04EcShopId": "2", "email05EcShopId": "3", "mailFlag1": "1", "mailFlag2": "1", "mailFlag3": "1", "mailFlag4": "0", "mailFlag5": "0", "mailFlag6": "1", "dmFlag": "1", "blackFlag": "0", "lightNote": "簡易メモ", "note": "備考", "note01": "備考1", "note02": "備考2", "note03": "備考3", "note04": "備考4", "note05": "備考5", "wishNote": "贈答ボックス希望", "wishRyoushuType": "1", "wishNouhinType": "2", "wishHassoTimeId": "3", "wishHassoMemo": "翌日配送希望", "wishHassoDelivId": "1", "wishNoteAttention": "不在時は電話希望", "userFlag1": "1", "userFlag2": "2", "userFlag3": "3", "mark1": "1", "mark2": "0", "mark3": "1", "customerType": "2", "parentCustomerId": "10001", "friendCampaignId": "20001", "customerCharge": "10", "memberSalesChargeId": "20", "b2cSalesChannelId": [ "1", "2" ], "b2cSalesChannelId2": [ "3", "4" ], "b2cSalesChannelId3": [ "5", "6" ], "bbcMemberCode": "1", "memberStaffId": "1"}Responses
Section titled “Responses”登録成功
object
顧客ID
会社名
部署名
お名前(姓)
お名前(名)
お名前(フリガナ・姓)
お名前(フリガナ・名)
国ID
郵便番号1
郵便番号2
都道府県ID
住所1
住所2
電話番号1
電話番号2
電話番号3
電話番号2-1
電話番号2-2
電話番号2-3
FAX1
FAX2
FAX3
メールアドレス1
メールアドレス2
メールアドレス3
メールアドレス4
メールアドレス5
メールアドレス1種類
メールアドレス2種類
メールアドレス3種類
メールアドレス4種類
メールアドレス5種類
メールアドレス1メルマガ
メールアドレス2メルマガ
メールアドレス3メルマガ
メールアドレス4メルマガ
メールアドレス5メルマガ
メールアドレス1送信エラーフラグ
メールアドレス2送信エラーフラグ
メールアドレス3送信エラーフラグ
メールアドレス4送信エラーフラグ
メールアドレス5送信エラーフラグ
メールアドレス1ショップID
メールアドレス2ショップID
メールアドレス3ショップID
メールアドレス4ショップID
メールアドレス5ショップID
性別ID
職業ID
生年月日(YYYY-MM-DD HH:MM:SS形式)
サンクスメール送信可否フラグ
入金確認メール送信可否フラグ
発送完了メール送信可否フラグ
フォローメール送信可否フラグ
ステップメール送信可否フラグ
メルマガ送信可否フラグ
メルマガフラグ
DMフラグ
ポイント
顧客識別フラグ
簡易メモ
備考
顧客備考1
顧客備考2
顧客備考3
顧客備考4
顧客備考5
指定-ひとことコメント
指定-領収書
指定-納品書
指定-お届け時刻
指定-送り状記事欄
指定-配送業者
指定-伝達事項
ユーザーフラグ1
ユーザーフラグ2
ユーザーフラグ3
顧客ステータス
マーク1
マーク2
マーク3
登録日時
更新日時
会員種別
紹介者顧客ID
紹介キャンペーンコード
初回購入日
最終購入日
最終ログイン日時
購入回数
累計購入金額
在籍日数
休眠日数
顧客CPMセグメント
RFMランク
RFMグループID
(CPM1)初回購入日
(CPM1)最終購入日
(CPM1)購入回数
(CPM1)累計購入金額
(CPM1)在籍日数
(CPM1)休眠日数
(CPM1)顧客CPMセグメント
(CPM2)初回購入日
(CPM2)最終購入日
(CPM2)購入回数
(CPM2)累計購入金額
(CPM2)在籍日数
(CPM2)休眠日数
(CPM2)顧客CPMセグメント
(CPM3)初回購入日
(CPM3)最終購入日
(CPM3)購入回数
(CPM3)累計購入金額
(CPM3)在籍日数
(CPM3)休眠日数
(CPM3)顧客CPMセグメント
(CPM4)初回購入日
(CPM4)最終購入日
(CPM4)購入回数
(CPM4)累計購入金額
(CPM4)在籍日数
(CPM4)休眠日数
(CPM4)顧客CPMセグメント
(CPM5)初回購入日
(CPM5)最終購入日
(CPM5)購入回数
(CPM5)累計購入金額
(CPM5)在籍日数
(CPM5)休眠日数
(CPM5)顧客CPMセグメント
他システム顧客コード
次回ランク条件金額
営業担当者ID
カスタマー担当者ID
Examples
{ "customerId": "64", "companyName": "株式会社テスト", "companyDepartment": "営業部", "name01": "山田", "name02": "太郎", "kana01": "ヤマダ", "kana02": "タロウ", "countryId": "392", "zip01": "100", "zip02": "0001", "pref": "13", "addr01": "千代田区千代田", "addr02": "1-1", "tel01": "03", "tel02": "1234", "tel03": "5678", "telSecond01": "03", "telSecond02": "1234", "telSecond03": "5678", "fax01": null, "fax02": null, "fax03": null, "email01": null, "email02": null, "email03": null, "email04": null, "email05": null, "email01EmailType": null, "email02EmailType": null, "email03EmailType": null, "email04EmailType": null, "email05EmailType": null, "email01MailmagaFlg": null, "email02MailmagaFlg": null, "email03MailmagaFlg": null, "email04MailmagaFlg": null, "email05MailmagaFlg": null, "email01ErrorFlg": "0", "email02ErrorFlg": "0", "email03ErrorFlg": "0", "email04ErrorFlg": "0", "email05ErrorFlg": "0", "email01EcShopId": null, "email02EcShopId": null, "email03EcShopId": null, "email04EcShopId": null, "email05EcShopId": null, "sex": "1", "job": "1", "birth": "1990-01-15 00:00:00", "mailFlag1": "1", "mailFlag2": "1", "mailFlag3": "1", "mailFlag4": "1", "mailFlag5": "1", "mailFlag6": "1", "mailmagaFlg": "1", "dmFlag": "1", "point": "0", "blackFlag": "0", "lightNote": "簡易メモ", "note": "備考テスト", "note01": null, "note02": null, "note03": null, "note04": null, "note05": null, "wishNote": null, "wishRyoushuType": null, "wishNouhinType": null, "wishHassoTimeId": null, "wishHassoMemo": null, "wishHassoDelivId": null, "wishNoteAttention": null, "userFlag1": "0", "userFlag2": "0", "userFlag3": "0", "status": "2", "mark1": "0", "mark2": "0", "mark3": "0", "createAt": "2026-05-12T08:05:56+09:00", "updateAt": "2026-05-12T08:05:56+09:00", "customerType": "2", "parentCustomerId": null, "friendCampaignId": null, "firstBuyAt": null, "lastBuyAt": null, "lastLoginAt": null, "buyTimes": "0", "buyTotal": "0", "enrollmentDay": "0", "dormantDay": "0", "cpm0Rank": "0", "rfmRank": "0", "rfmGroupId": "0", "cpm1FirstBuyAt": null, "cpm1LastBuyAt": null, "cpm1BuyTimes": "0", "cpm1BuyTotal": "0", "cpm1EnrollmentDay": "0", "cpm1DormantDay": "0", "cpm1Rank": "0", "cpm2FirstBuyAt": null, "cpm2LastBuyAt": null, "cpm2BuyTimes": "0", "cpm2BuyTotal": "0", "cpm2EnrollmentDay": "0", "cpm2DormantDay": "0", "cpm2Rank": "0", "cpm3FirstBuyAt": null, "cpm3LastBuyAt": null, "cpm3BuyTimes": "0", "cpm3BuyTotal": "0", "cpm3EnrollmentDay": "0", "cpm3DormantDay": "0", "cpm3Rank": "0", "cpm4FirstBuyAt": null, "cpm4LastBuyAt": null, "cpm4BuyTimes": "0", "cpm4BuyTotal": "0", "cpm4EnrollmentDay": "0", "cpm4DormantDay": "0", "cpm4Rank": "0", "cpm5FirstBuyAt": null, "cpm5LastBuyAt": null, "cpm5BuyTimes": "0", "cpm5BuyTotal": "0", "cpm5EnrollmentDay": "0", "cpm5DormantDay": "0", "cpm5Rank": "0", "jponCustomerCode": null, "nextCustomerRankBuyTotal": null, "memberSalesChargeId": null, "customerCharge": null}- 指定された項目が不正な場合
- 新規登録時にcustomerIdが指定された場合
- 生年月日の形式が不正な場合
- 指定された国が存在しない場合
- 指定された性別が存在しない場合
- 指定された職業が存在しない場合
- 指定された都道府県が存在しない場合
- 指定された顧客識別フラグが存在しない場合
- 指定されたユーザーフラグが存在しない場合
- メールマガジンフラグが不正な場合
- DMフラグが不正な場合
- マークが不正な場合
- メールアドレス種類が不正な場合
- メールアドレスメルマガフラグが不正な場合
- メールアドレスエラーフラグが不正な場合
- 指定されたメールアドレスショップIDが存在しない場合
- 購入時領収書指定が不正な場合
- 購入時納品書指定が不正な場合
- 指定された販路区分が存在しない場合
- 指定された営業担当者IDが存在しない場合
- 指定されたカスタマー担当者IDが存在しない場合
- 指定された会員種別が存在しない場合
- 指定されたBBC加盟店コードが存在しない場合
- 指定されたBBC加盟店スタッフIDが存在しない場合
object
Examples
{ "type": "about:blank", "title": "BadRequest", "detail": [ "指定された項目が不正です: invalidKey" ], "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "新規登録時に顧客IDは指定できません", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "生年月日の形式が不正です", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する性別が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する職業が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する都道府県が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する国が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する顧客識別フラグが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するユーザーフラグ1が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するメールマガジンフラグが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するDMフラグが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するマーク1が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するメールアドレス01種類が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するメールアドレス01メルマガフラグが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するメールアドレス01エラーフラグが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するメールアドレス01ショップIDが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する購入時領収書指定が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する購入時納品書指定が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する販路区分(値)が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する営業担当者IDが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するカスタマー担当者IDが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当する会員種別が見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するBBC加盟店コードが見つかりませんでした", "status": 400}{ "type": "about:blank", "title": "BadRequest", "detail": "該当するBBC加盟店スタッフIDが見つかりませんでした", "status": 400}サーバー内部エラー
object
Examples
{ "type": "about:blank", "title": "InternalServerError", "status": 500}