取引先登録

POST

/customers

curl --request POST \
  --url https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-b2b/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "statusCode": 3, "registrationStatus": 4, "companyName": "株式会社スマレジ", "lastName": "すまれじ", "firstName": "太郎", "lastNameFurigana": "スマレジ", "firstNameFurigana": "タロウ", "countryCode": 392, "zipCode": "5555555", "prefectureCode": 13, "address01": "大阪市中央区", "address02": "大繁盛物産ビル 65F", "address03": null, "telephoneNumber": "00011112222", "faxNumber": "00033334444", "email": "sample@example.com", "genderCode": 2, "birthOn": "2024-05-05", "invitationAt": "2025-06-02T03:03:33+09:00", "registrationAt": "2025-06-02T03:03:33+09:00", "note": "備考用のメモです", "isLineLink": 0, "pricingMethodCode": 1, "defaultPriceRate": 0, "regularShippingFeeNoTax": "0", "regularShippingFeeTaxRate": 10, "campaignShippingFeeCondition": null, "campaignShippingFeeNoTax": null, "campaignShippingFeeTaxRate": 10 }'

• サンドボックス
• 本番

取引先情報を登録します。

Authorizations

• AppAccessToken
  ec-b2b.customers:write

Request Body^required

Media typeapplication/json

CustomerRequest

object

statusCode

ステータス

• 1: 仮会員
• 2: メルマガ会員
• 3: 本会員
• 4: 否認済

integer

Allowed values: 1 2 3 4

registrationStatus

登録状況

• 1: 未承認
• 2: 承認
• 3: 否認
• 4: 管理者登録

integer

Allowed values: 1 2 3 4

companyName

会社名

string

<= 255 characters

lastName

名前(姓)

string

<= 50 characters

firstName

名前(名)

string

<= 50 characters

lastNameFurigana

名前フリガナ(姓)

string

<= 50 characters

firstNameFurigana

名前フリガナ(名)

string

<= 50 characters

countryCode

CountryCode

国コード（ISO 3166-1 numeric）

• 392: 日本

国コード一覧（ISO 3166-1 numeric）

integer

zipCode

郵便番号

string

<= 8 characters

prefectureCode

PrefectureCode

都道府県コード（JIS X 0401）

More information

integer

>= 1 <= 47

address01

住所1

string

<= 255 characters

address02

住所2

string

nullable <= 255 characters

address03

住所3

string

nullable <= 255 characters

telephoneNumber

電話番号(ハイフン無し)

string

<= 13 characters

faxNumber

FAX番号(ハイフン無し)

string

<= 13 characters

email

メールアドレス

string format: email

<= 255 characters

genderCode

性別

• 1: 男性
• 2: 女性
• 3: 不明

integer

Allowed values: 1 2 3

birthOn

生年月日

string format: date

nullable

invitationAt

招待日時[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

registrationAt

会員登録日時[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

note

備考

string

nullable <= 5000 characters

isLineLink

LINE ID連携

• 0: 未連携
• 1: 連携済

integer

Allowed values: 0 1

pricingMethodCode

ロット価格指定

• 1: 指値
• 2: 掛け率

integer

Allowed values: 1 2

defaultPriceRate

ロット価格掛け率

integer

regularShippingFeeNoTax

送料条件-通常送料（税抜）

string

regularShippingFeeTaxRate

送料条件-通常送料の税率

integer

campaignShippingFeeCondition

送料条件-キャンペーン送料条件

integer

nullable

campaignShippingFeeNoTax

送料条件-キャンペーン送料（税抜）

string

nullable

campaignShippingFeeTaxRate

送料条件-キャンペーン送料の税率

integer

Examples

Exampledefault

{
  "statusCode": 3,
  "registrationStatus": 4,
  "companyName": "株式会社スマレジ",
  "lastName": "すまれじ",
  "firstName": "太郎",
  "lastNameFurigana": "スマレジ",
  "firstNameFurigana": "タロウ",
  "countryCode": 392,
  "zipCode": "5555555",
  "prefectureCode": 13,
  "address01": "大阪市中央区",
  "address02": "大繁盛物産ビル 65F",
  "address03": null,
  "telephoneNumber": "00011112222",
  "faxNumber": "00033334444",
  "email": "sample@example.com",
  "genderCode": 2,
  "birthOn": "2024-05-05",
  "invitationAt": "2025-06-02T03:03:33+09:00",
  "registrationAt": "2025-06-02T03:03:33+09:00",
  "note": "備考用のメモです",
  "isLineLink": 0,
  "pricingMethodCode": 1,
  "defaultPriceRate": 0,
  "regularShippingFeeNoTax": "0",
  "regularShippingFeeTaxRate": 10,
  "campaignShippingFeeCondition": null,
  "campaignShippingFeeNoTax": null,
  "campaignShippingFeeTaxRate": 10
}

Responses

201

登録成功

Media typeapplication/json

CustomerResponse

object

id

取引先ID

string format: uuid

statusCode

ステータス

• 1: 仮会員
• 2: メルマガ会員
• 3: 本会員
• 4: 否認済

integer

Allowed values: 1 2 3 4

registrationStatus

登録状況

• 1: 未承認
• 2: 承認
• 3: 否認
• 4: 管理者登録

integer

Allowed values: 1 2 3 4

companyName

会社名

string

<= 255 characters

lastName

名前(姓)

string

<= 50 characters

firstName

名前(名)

string

<= 50 characters

lastNameFurigana

名前フリガナ(姓)

string

<= 50 characters

firstNameFurigana

名前フリガナ(名)

string

<= 50 characters

countryCode

CountryCode

国コード（ISO 3166-1 numeric）

• 392: 日本

国コード一覧（ISO 3166-1 numeric）

integer

zipCode

郵便番号

string

<= 8 characters

prefectureCode

PrefectureCode

都道府県コード（JIS X 0401）

More information

integer

>= 1 <= 47

address01

住所1

string

<= 255 characters

address02

住所2

string

nullable <= 255 characters

address03

住所3

string

nullable <= 255 characters

telephoneNumber

電話番号(ハイフン無し)

string

<= 13 characters

faxNumber

FAX番号(ハイフン無し)

string

<= 13 characters

email

メールアドレス

string format: email

<= 255 characters

genderCode

性別

• 1: 男性
• 2: 女性
• 3: 不明

integer

Allowed values: 1 2 3

birthOn

生年月日

string format: date

nullable

invitationAt

招待日時[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

registrationAt

会員登録日時[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

note

備考

string

nullable <= 5000 characters

isLineLink

LINE ID連携

• 0: 未連携
• 1: 連携済

integer

Allowed values: 0 1

pricingMethodCode

ロット価格指定

• 1: 指値
• 2: 掛け率

integer

Allowed values: 1 2

defaultPriceRate

ロット価格掛け率

integer

regularShippingFeeNoTax

送料条件-通常送料（税抜）

string

regularShippingFeeTaxRate

送料条件-通常送料の税率

integer

campaignShippingFeeCondition

送料条件-キャンペーン送料条件

integer

nullable

campaignShippingFeeNoTax

送料条件-キャンペーン送料（税抜）

string

nullable

campaignShippingFeeTaxRate

送料条件-キャンペーン送料の税率

integer

updatedAt

更新日時：登録時・更新時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

Examples

Exampledefault

{
  "id": "12345678-1234-1234-1234-1234567890ab",
  "statusCode": 3,
  "registrationStatus": 4,
  "companyName": "株式会社スマレジ",
  "lastName": "すまれじ",
  "firstName": "太郎",
  "lastNameFurigana": "スマレジ",
  "firstNameFurigana": "タロウ",
  "countryCode": 392,
  "zipCode": "5555555",
  "prefectureCode": 13,
  "address01": "大阪市中央区",
  "address02": "大繁盛物産ビル 65F",
  "address03": null,
  "telephoneNumber": "00011112222",
  "faxNumber": "00033334444",
  "email": "sample@example.com",
  "genderCode": 2,
  "birthOn": "2024-05-05",
  "invitationAt": "2025-06-02T03:03:33+09:00",
  "registrationAt": "2025-06-02T03:03:33+09:00",
  "note": "備考用のメモです",
  "isLineLink": 0,
  "pricingMethodCode": 1,
  "defaultPriceRate": 0,
  "regularShippingFeeNoTax": "0",
  "regularShippingFeeTaxRate": 10,
  "campaignShippingFeeCondition": null,
  "campaignShippingFeeNoTax": null,
  "campaignShippingFeeTaxRate": 10,
  "updatedAt": "2025-06-09T14:15:40+09:00"
}

400

• 入力チェックエラーの場合
• 指定された都道府県コードが不正な場合
• 指定された国コードが不正な場合
• メールアドレスの形式が不正な場合

Media typeapplication/json

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "request_json:[lastName]は50文字以下で指定してください。",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "request_json:[prefectureCode]は1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47に該当する値を指定してください。",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "request_json:[countryCode]は392, 352, 372, 31, 4, 840, 850, 16, 784, 12, 32, 533, 8, 51, 660, 24, 28, 20, 887, 826, 86, 92, 376, 380, 368, 364, 356, 360, 876, 800, 804, 860, 858, 218, 818, 233, 748, 231, 232, 222, 36, 40, 248, 512, 528, 288, 132, 831, 328, 398, 634, 581, 124, 266, 120, 270, 116, 807, 580, 324, 624, 196, 192, 531, 300, 296, 417, 320, 312, 316, 414, 184, 304, 162, 308, 191, 136, 404, 384, 166, 188, 174, 170, 178, 180, 682, 239, 882, 678, 652, 894, 666, 674, 663, 694, 262, 292, 832, 388, 268, 760, 702, 534, 716, 756, 752, 729, 744, 724, 740, 144, 703, 705, 690, 226, 686, 688, 659, 670, 654, 662, 706, 90, 796, 764, 410, 158, 762, 834, 203, 148, 140, 156, 788, 408, 152, 798, 208, 276, 768, 772, 214, 212, 780, 795, 792, 776, 566, 520, 516, 10, 570, 558, 562, 732, 540, 554, 524, 574, 578, 334, 48, 332, 586, 336, 591, 548, 44, 598, 60, 585, 600, 52, 275, 348, 50, 626, 612, 242, 608, 246, 64, 74, 630, 234, 238, 76, 250, 254, 258, 260, 100, 854, 96, 108, 704, 204, 862, 112, 84, 604, 56, 616, 70, 72, 535, 68, 620, 344, 340, 584, 446, 450, 175, 454, 466, 470, 474, 458, 833, 583, 710, 728, 104, 484, 480, 478, 508, 492, 462, 498, 504, 496, 499, 500, 400, 418, 428, 440, 434, 438, 430, 642, 442, 646, 426, 422, 638, 643に該当する値を指定してください。",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "request_json:[email]は有効なメールアドレスを指定してください。",
  "status": 400
}

409

指定されたメールアドレスが既に登録されている場合

Media typeapplication/json

object

type

required

string

title

required

string

detail

string

status

integer

Example

{
  "type": "about:blank",
  "title": "Conflict",
  "detail": "request_json:[email]はこの項目の値は既に存在しています。違う値を指定してください。",
  "status": 409
}