Download OpenAPI specification:Download
MEEQ ユーザが利用可能なAPIの仕様書です。リクエスト送信時にAPIライセンスキーを x-api-key ヘッダーに指定して送信してください。
アカウント情報を検索する。
accountId | string = 10 characters アカウント情報ID:半角英数字10桁 |
staffLastName | string [ 1 .. 32 ] characters 姓(漢字):全角文字1~32桁 |
staffFirstName | string [ 1 .. 32 ] characters 名(漢字):全角文字1~32桁 |
departmentName | string [ 1 .. 64 ] characters 部署名(漢字):全角文字1~64桁 |
string <email> [ 1 .. 256 ] characters メールアドレス:メールアドレス形式かつ1~256桁 | |
accountRole | Array of strings Items Enum: "parent" "manager" "ope" "viewer" アカウントロール:parent:代表権限、manager:管理権限、ope:オペレーター権限、viewer:閲覧権限 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 :asc:昇順、desc:降順 |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "customerId": "stringstri",
- "accountId": "stringstri",
- "companyName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "departmentName": "string",
- "email": "user@example.com",
- "accountRole": "parent"
}
], - "totalSize": 0
}
アカウント情報を追加する。
アカウント変更情報
staffLastNameKana required | string [ 1 .. 32 ] characters 姓(カナ):全角カナ1~32桁 |
staffFirstNameKana required | string [ 1 .. 32 ] characters 名(カナ):全角カナ1~32桁 |
staffLastName required | string [ 1 .. 32 ] characters 姓(漢字):全角文字1~32桁 |
staffFirstName required | string [ 1 .. 32 ] characters 名(漢字):全角文字1~32桁 |
departmentNameKana | string [ 1 .. 64 ] characters 部署名(カナ):全角カナ1~64桁 |
departmentName | string [ 1 .. 64 ] characters 部署名(漢字):全角文字1~64桁 |
email required | string <email> [ 1 .. 256 ] characters メールアドレス:メールアドレス形式かつ1~256桁 |
password required | string パスワード:8文字以上、複雑なパスワード(大文字、小文字、数字、特殊文字(アルファベット以外)のうち少なくとも3つを含むパスワードまたはパスフレーズ) |
accountRole required | string Enum: "manager" "ope" "viewer" アカウントロール:manager:管理権限、ope:オペレーター権限、viewer:閲覧権限(parent:代表権限は選べない) |
required | object (Notification) メール通知情報 |
{- "staffLastNameKana": "string",
- "staffFirstNameKana": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "departmentNameKana": "string",
- "departmentName": "string",
- "email": "user@example.com",
- "password": "string",
- "accountRole": "manager",
- "notificationConfig": {
- "account": "on",
- "auth": "on",
- "sim": "on",
- "group": "on",
- "payment": "on",
- "inquiry": "on",
- "eltres": "on",
- "ad": "on",
- "other": "on"
}
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
デバイスロックを設定するAPIです。
デバイスロック設定情報
deviceLockRule | string [ 1 .. 253 ] characters デバイスロックルール |
currentDeviceLockImeiFlag required | boolean 現在IMEIデバイスロック設定 (true:設定、false:非設定) |
required | Array of objects (targetDeviceList) 対象SIM回線リスト |
{- "deviceLockRule": "string",
- "currentDeviceLockImeiFlag": true,
- "targetDeviceList": [
- {
- "simDeviceId": "SD001"
}
]
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
デバイスロックを解除するAPIです。
デバイスロック解除情報
required | Array of objects (targetDeviceList) 対象SIM回線リスト |
{- "targetDeviceList": [
- {
- "simDeviceId": "SD001"
}
]
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グループ情報を検索する
groupName | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
billingId | string = 10 characters 請求先情報ID |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "groupId": "SG00000001",
- "groupName": "回線グループA",
- "billingId": "BL00000001"
}, - {
- "groupId": "SG00000002",
- "groupName": "回線グループB",
- "billingId": "BL00000001"
}, - {
- "groupId": "SG00000003",
- "groupName": "回線グループC",
- "billingId": "BL00000002"
}
], - "totalSize": 3
}
グループを編集する。グループ名の変更と、所属するSIMの付け替えが可能。
groupId required | string = 10 characters グループ情報ID |
グループ編集情報
groupName | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
Array of objects (simDeviceId) グループ内SIM機器情報リスト (SIM機器情報ID) |
{- "groupName": "string",
- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
]
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グループを追加する。
グループ追加情報
groupName required | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
Array of objects (simDeviceId) SIM機器情報ID:半角英数字10桁 |
{- "groupName": "string",
- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
]
}
{- "groupId": "stringstri"
}
アラート設定詳細を取得する。アラート設定はグループと1対1になる。グループの追加時にアラート設定をすべてoffで登録する。そのため、リリース時には、既存のグループに対になるアラート設定を追加しなければならない。を想定しています。
groupId required | string = 10 characters SIM回線グループ情報ID |
{- "usageRemainAlert": {
- "notification": "on",
- "mail": "on",
- "usageNotification": "on",
- "remainNotification": "on",
- "usageLimit": 0,
- "remainLimit": 0
}, - "activationLimitAlertInfo": {
- "notification": "on",
- "mail": "on",
- "notificationLimit": 0
}
}
アラート設定を編集する。アラート設定はグループと1対1になる。グループの追加時にアラート設定をすべてoffで登録する。そのため、リリース時には、既存のグループに対になるアラート設定を追加しなければならない。を想定していたため、編集実行時にはすでにレコードが存在していると考え、PUTにしています。
groupId required | string = 10 characters グループ情報ID |
アラート設定編集情報
object (UsageRemainAlert) 利用量残量アラート通知情報 | |
object (UsageRemainAlert) アクティベーション期限アラート通知情報 |
{- "usageRemainAlertInfo": {
- "notification": "on",
- "mail": "on",
- "usageNotification": "on",
- "remainNotification": "on",
- "usageLimit": 0,
- "remainLimit": 0
}, - "activationLimitAlertInfo": {
- "notification": "on",
- "mail": "on",
- "notificationLimit": 0
}
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMグループ情報を検索する
groupName | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
billingId | string = 10 characters 請求先情報ID |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "globalsimGroupId": "GS00000001",
- "groupName": "グローバル回線グループA",
- "billingId": "BL00000001",
- "usageAlertLineCount": 1,
- "activationAlertLineCount": 0
}, - {
- "globalsimGroupId": "GS00000002",
- "groupName": "グローバル回線グループB",
- "billingId": "BL00000001",
- "usageAlertLineCount": 0,
- "activationAlertLineCount": 0
}, - {
- "globalsimGroupId": "GS00000003",
- "groupName": "グローバル回線グループC",
- "billingId": "BL00000002",
- "usageAlertLineCount": 10,
- "activationAlertLineCount": 0
}
], - "totalSize": 3
}
グローバルSIMグループ詳細を取得する
globalsimGroupId required | string = 10 characters グローバルSIM回線グループ情報ID |
{- "groupName": "回線グループA",
- "usageAlertLineCount": 0,
- "activationAlertLineCount": 0,
- "globalsimGroupList": [
- {
- "globalsimDeviceId": "stringstri",
- "globalsimLineId": "string",
- "msisdn": "string",
- "iccId": "string"
}
]
}
グローバルSIMグループを編集する。グループ名の変更と、所属するSIMの付け替えが可能。
globalsimGroupId required | string = 10 characters グローバルSIMグループ情報ID |
グローバルSIMグループ編集情報
groupName | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
Array of objects (globalsimLineId) グループ内グローバルSIM回線情報リスト (グローバルSIM回線情報ID) |
{- "groupName": "string",
- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
]
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMグループを追加する。
グローバルSIMグループ追加情報
groupName required | string [ 1 .. 64 ] characters グループ名:全角文字1~64桁 |
Array of objects (globalsimLineId) グループ内グローバルSIM回線情報リスト (グローバルSIM回線情報ID) |
{- "groupName": "string",
- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
]
}
{- "globalsimGroupId": "GR00000001"
}
アラート設定詳細を取得する。アラート設定はグループと1対1になる。グループの追加時にアラート設定をすべてoffで登録する。そのため、リリース時には、既存のグループに対になるアラート設定を追加しなければならない。を想定しています。
globalsimGroupId required | string = 10 characters グローバルSIM回線グループ情報ID |
{- "usageAlert": {
- "notification": "on",
- "mail": "on",
- "usageNotification": "on",
- "usageLimit": 0
}, - "activationAlert": {
- "notification": "on",
- "mail": "on",
- "notificationLimit": 0
}
}
アラート設定を編集する。アラート設定はグループと1対1になる。グループの追加時にアラート設定をすべてoffで登録する。そのため、リリース時には、既存のグループに対になるアラート設定を追加しなければならない。を想定していたため、編集実行時にはすでにレコードが存在していると考え、PUTにしています。
globalsimGroupId required | string = 10 characters グローバルSIMグループ情報ID |
グローバルSIMグループアラート設定編集情報
object (UsageRemainAlert) 利用量アラート通知情報 | |
object (UsageRemainAlert) アクティベーション期限アラート通知情報 |
{- "usageAlertInfo": {
- "notification": "on",
- "mail": "on",
- "usageNotification": "on",
- "usageLimit": 0
}, - "activationAlertInfo": {
- "notification": "on",
- "mail": "on",
- "notificationLimit": 0
}
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
{- "result": [
- {
- "globalsimTypeId": "L000000001",
- "globalsimTypeName": "カード型",
- "amount": 1,
- "globalsimType": "card"
}, - {
- "globalsimTypeId": "L000000002",
- "globalsimTypeName": "チップ型リール",
- "amount": 250,
- "globalsimType": "reelStandard"
}
]
}
使用可能なグローバルSIMプランマスタの一覧を表示する。
globalsimPlanId | string = 10 characters グローバルSIMプランID:半角英数字10桁 |
globalsimPlanCode | string [ 1 .. 11 ] characters グローバルSIMプランコード:半角英数1~11桁 |
globalsimPlanName | string [ 1 .. 128 ] characters グローバルSIMプラン名:全角文字1~128桁 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "globalsimPlanId": "SP00000001",
- "customerId": null,
- "globalsimPlanCode": "SPC0001",
- "globalsimPlanName": "SIMプランA"
}, - {
- "globalsimPlanId": "SP00000002",
- "customerId": null,
- "globalsimPlanCode": "SPC0002",
- "globalsimPlanName": "SIMプランB"
}, - {
- "globalsimPlanId": "SP00000003",
- "customerId": "CU00000001",
- "globalsimPlanCode": "SPC0003",
- "globalsimPlanName": "SIMプランC"
}
], - "totalSize": 0
}
プランマスタの一覧を表示する。
simPlanId | string = 10 characters SIMプランID:半角英数字10桁 |
simPlanCode | string [ 1 .. 11 ] characters SIMプランコード:半角英数1~11桁 |
simPlanName | string [ 1 .. 128 ] characters SIMプラン名:全角文字1~128桁 |
simCarrier | string Enum: "docomo" "kddi" "softbank" キャリア(docomo:DoCoMo、kddi:KDDI、softbank:SoftBank) |
apnName | string [ 1 .. 13 ] characters APN名:半角文字1~13桁 |
simType | string Enum: "prePaid" "postPaid" SIM種別(prePaid:プリペイド、postPaid:ポストペイド) |
useClosed | string Enum: "off" "on" 閉域利用有無(off:利用しない、on:利用する) |
originalFlag | string Enum: "on" "off" 独自プラン選択フラグ (on:独自プランのみ、off:絞り込みなし) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "simPlanId": "SP00000001",
- "customerId": null,
- "simPlanCode": "SPC0001",
- "simPlanName": "SIMプランA",
- "simCarrier": "docomo",
- "originalFlag": "true",
- "apnName": "APN_閉域"
}, - {
- "simPlanId": "SP00000002",
- "customerId": null,
- "simPlanCode": "SPC0002",
- "simPlanName": "SIMプランB",
- "simCarrier": "kddi",
- "apnName": "APN_閉域2",
- "originalFlag": "false"
}, - {
- "simPlanId": "SP00000003",
- "customerId": "CU00000001",
- "simPlanCode": "SPC0003",
- "simPlanName": "SIMプランC",
- "simCarrier": "softbank",
- "apnName": "APN_閉域",
- "originalFlag": "true"
}
], - "totalSize": 0
}
指定したSIMプランIDが選択可能なチャージプランを一覧取得する
simPlanId required | string = 10 characters SIMプランID:半角英数字10桁 |
{- "result": [
- {
- "simPlanChargeId": "stringstri",
- "chargePlanCode": "string",
- "chargePlanName": "string"
}
], - "totalSize": 1
}
SIMプランオプションマスター一覧を取得する。
simPlanOptionId | string = 10 characters SIMプランオプションID:半角英数字10桁 |
simPlanOptionCode | string [ 1 .. 11 ] characters SIMプランオプションコード:半角英数字1~11桁 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "simPlanOptionId": "OP00000001",
- "simPlanOptionCode": "SOP001"
}, - {
- "simPlanOptionId": "OP00000002",
- "simPlanOptionCode": "SOP002",
- "customerId": "CU00000001"
}
], - "totalSize": 2
}
売上明細一覧を取得する
departmentName | string [ 1 .. 64 ] characters 部署名(漢字):全角文字1~64桁 |
staffLastName | string [ 1 .. 32 ] characters 担当者姓(漢字):全角文字1~32桁 |
staffFirstName | string [ 1 .. 32 ] characters 担当者名(漢字):全角文字1~32桁 |
salesDateFrom | string <yyyy-MM-dd> 売上年月日(from) |
salesDateTo | string <yyyy-MM-dd> 売上年月日 (To) |
billingStatus | string Enum: "unclaimed" "billed" "none" 請求状態(unclaimed:未請求、billed:請求済、none:請求なし) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "customerId": "CU00000001",
- "companyName": "会社名",
- "salesDate": "2021-01-01",
- "purpose": "事務手数料",
- "price": 2000,
- "count": 1,
- "amount": 2000,
- "amountTax": 2200,
- "priceUsd": 200,
- "exchangeRate": 112.11,
- "taxable": "tax"
}, - {
- "customerId": "CU00000001",
- "companyName": "会社名",
- "salesDate": "2021-01-03",
- "purpose": "事務手数料",
- "price": 2000,
- "count": 2,
- "amount": 4000,
- "amountTax": 4400,
- "priceUsd": 200,
- "taxable": "tax"
}
], - "totalSize": 2
}
グローバルSIMサービス申請一覧を取得する。リクエスト、レスポンスパラメータとして、申請顧客アカウント名が利用可能である。
entryId | string = 10 characters 申請ID:半角英数字10桁 |
accountId | string = 10 characters 申請顧客アカウント情報ID:半角英数字10桁 |
accountName | string [ 0 .. 65 ] characters 申請顧客アカウント名:全角文字3~65桁 |
globalsimOrderType | string Enum: "globalsimOrderActivation" "globalsimOrderAutoActivation" "globalsimOrderLimitOverActivation" "globalsimOrderEntry" "globalsimOrderQuit" "globalsimOrderSleepAwake" "globalsimOrderStopRestart" "globalsimPlanEdit" グローバルSIM申請種別 (globalsimOrderActivation:グローバルSIM手動アクティベーション、globalsimOrderAutoActivation:グローバルSIM自動アクティベーション、globalsimOrderLimitOverActivation:グローバルSIM期間経過アクティベーション、globalsimOrderEntry:グローバルSIM新規発注、globalsimOrderQuit:グローバルSIM解約、globalsimOrderSleepAwake:グローバルSIM利用休止・利用再開、globalsimOrderStopRestart:グローバルSIM一時停止・一時停止再開、globalsimPlanEdit:グローバルSIMプラン変更) |
requestStatus | string Enum: "end" "reject" "partialEnd" "waiting" 申請ステータス (end:完了、reject:却下、partialEnd:部分完了、waiting:申請依頼中) |
createDateFrom | string <yyyy-MM-dd> 申請日(from) |
createDateTo | string <yyyy-MM-dd> 申請日(to) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "entryId": "EN00000001",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderEntry",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00",
- "activationLimitDate": "2021-03-31"
}, - {
- "entryId": "EN00000002",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderQuit",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000003",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderSleepAwake",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000004",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderStopRestart",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000005",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimPlanEdit",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000006",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderActivation",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000007",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderAutoActivation",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000008",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "globalsimOrderType": "globalsimOrderLimitOverActivation",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}
], - "totalSize": 8
}
グローバルSIM回線情報を検索する。通信量は「等しい」選択時はFrom、Toの両方、「以上」選択時はFrom、「以下」選択時はToに値を入れてリクエストを想定
iccId | string [ 1 .. 64 ] characters 製造番号/ICCID :半角英数字1~64桁 |
globalsimStatus | string Enum: "reserved" "uninitialized" "using" "stoped" "sleep" "quitAccepted" "quitted" "cancel" "forceQuitted" グローバルSIMステータス:(reserved:発注済、uninitialized:未アクティベーション、using:利用中、stoped:停止中、sleep:休止中、quitAccepted:解約登録済み、quitted:解約、cancel:キャンセル、forceQuitted:強制解約 |
msisdn | string [ 1 .. 15 ] characters MSISDN:半角数字1~15桁 |
lineName | string [ 1 .. 64 ] characters グローバルSIM回線名:全角文字1~64桁 |
globalsimGroupId | string = 10 characters グローバルSIM回線グループID:半角英数字10桁 |
groupName | string [ 1 .. 64 ] characters グローバルSIM回線グループ名:全角文字1~64桁 |
globalsimPlanId | string = 10 characters グローバルSIMプランID:半角英数字10桁 |
globalsimPlanName | string [ 1 .. 128 ] characters グローバルSIMプラン名:全角文字1~128桁 |
globalsimTypeId | string = 10 characters グローバルSIM種別ID |
accountId | string = 10 characters アカウント情報ID:半角英数字10桁 |
staffLastName | string [ 1 .. 32 ] characters 姓(漢字):全角文字1~32桁 |
staffFirstName | string [ 1 .. 32 ] characters 名(漢字):全角文字1~32桁 |
globalsimLineId | string = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
globalsimDeviceId | string = 10 characters グローバルSIM機器情報ID:半角英数字10桁 |
simEntryDateFrom | string <yyyy-MM-dd> SIM発注日(from) |
simEntryDateTo | string <yyyy-MM-dd> SIM発注日(to) |
quittedRecordHidden | string Enum: "off" "on" 解約レコード非表示(off:表示(省略時表示)on:非表示)。30日超過した解約済SIMは表示対象としません。 |
trackNO | string 伝票番号 |
imsi | string [ 1 .. 16 ] characters imsi:半角数字16桁 |
trafficUsedFrom | number 通信量(From):単位はKB |
trafficUsedTo | number 通信量(To):単位はKB |
activationLimitDateFrom | string <yyyy-MM-dd> アクティベーション期限(From) |
activationLimitDateTo | string <yyyy-MM-dd> アクティベーション期限(To) |
usageAlert | string 利用量アラート (on:警告、off:-) |
activationAlert | string アクティベーション期限アラート (on:警告、off:-) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "customerId": "CU00000001",
- "entryId": "EN00000001",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "globalsimLineId": "L000000001",
- "globalsimDeviceId": "SD00000001",
- "simEntryDate": "2020-12-01",
- "globalsimType": {
- "globalsimTypeInfo": {
- "globalsimTypeId": "L000000001",
- "globalsimTypeName": "カード型",
- "globalsimType": "string"
}
}, - "iccId": "T889812000000000000",
- "globalsimStatus": "reserved",
- "orderStatus": "accept",
- "msisdn": 9001234567,
- "groupName": "回線グループ名",
- "globalsimPlanId": "SP00000001",
- "globalsimPlanName": "プラン名",
- "imsi": 12345,
- "trackNO": 33333,
- "trafficUsed": 2000,
- "activationLimitDate": "2022-03-09",
- "usageAlert": "on",
- "activationAlert": "on"
}
], - "totalSize": 1
}
グローバルSIM回線の詳細情報を取得する
globalsimLineId required | string = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
{- "customerId": "CU00000001",
- "accountId": "ID00000001",
- "simEntryDate": "2021-01-01",
- "activationLimitDate": "2022-01-05",
- "activationDate": "2021-01-05",
- "lineName": "回線名称",
- "groupName": "回線グループA",
- "iccId": "ICCID00000000000001",
- "msisdn": 9001234567890,
- "globalsimPlanName": "SIMプランA",
- "globalsimType": {
- "globalsimTypeInfo": {
- "globalsimTypeId": "string",
- "globalsimTypeName": "string",
- "userGlobalsimTypeName": "string",
- "amount": 0,
- "globalsimType": "string"
}
}, - "globalsimStatus": "reserved",
- "orderStatus": "string",
- "entryId": "stringstri",
- "globalsimLineId": "L000000001",
- "globalsimDeviceId": "SD00000001",
- "trackNO": 33333333,
- "imsi": 53232
}
グローバルSIMを発注申込する。
グローバルSIM新規発注申請
zipCode required | string = 7 characters 郵便番号:半角数字7桁 |
addressPrefectures required | string [ 1 .. 8 ] characters 住所(都道府県):全角文字1~8桁 |
addressCity required | string [ 1 .. 64 ] characters 住所(市区町村):全角文字1~64桁 |
addressTown required | string [ 1 .. 128 ] characters 住所(町名/番地):全角文字1~128桁 |
addressOptional | string [ 1 .. 96 ] characters マンション/ビル名・部屋番号:全角文字1~96桁 |
contactTel required | string [ 10 .. 11 ] characters 連絡先電話番号:半角数字10~11桁 |
daytimeContactTel | string [ 10 .. 11 ] characters 日中連絡先電話番号:半角数字10~11桁 |
companyName required | string [ 1 .. 64 ] characters 配送先会社名:全角文字1~64桁 |
departmentName required | string [ 1 .. 52 ] characters 配送先部署名:全角文字1~52桁 |
staffLastName required | string [ 1 .. 32 ] characters 配送先担当者姓(漢字):全角文字1~32桁 |
staffFirstName required | string [ 1 .. 32 ] characters 配送先担当者名(漢字):全角文字1~32桁 |
preferredDeliveryDate | string <yyyy-MM-dd> 配送希望日 |
actualDeliveryTimezone | string Enum: "00" "08" "12" "14" "16" "18" "19" 配送時間帯(00:指定なし、08:午前中、12:12:00~14:00、14:14:00~16:00(午後)、16:16:00~18:00、18:18:00~20:00、19:19:00~21:00) (配送希望日がある場合必須,ない場合はなし) |
deliveryBoxFlg required | string Enum: "off" "on" 宅配ボックス利用可否(off:利用しない、on:利用する) |
simNumber required | integer [ 1 .. 999 ] SIM枚数 (1000未満の値が設定可能) |
amount | integer [ 1 .. 999 ] 数量 (1000未満の値が設定可能。グローバルSIM種別によって上限が異なる) |
simCarrier | string Value: "jt" キャリア(jt:JT) |
globalsimTypeId required | string = 10 characters グローバルSIM種別ID |
globalsimPlanId required | string = 10 characters グローバルSIMプランID:半角英数字10桁 |
belongGroupId | string = 10 characters 属するグループID。既存のグループに属する場合に設定する。新規の場合は未設定。「新規グループ名」とどちらかの設定が必要。:半角英数字10桁 |
newGroupName | string [ 1 .. 64 ] characters 新規グループ名。新規のグループに属する場合に設定する。既存の場合は未設定。「属するグループID」とどちらかの設定が必要。:全角文字1~64桁 |
{- "zipCode": "strings",
- "addressPrefectures": "string",
- "addressCity": "string",
- "addressTown": "string",
- "addressOptional": "string",
- "contactTel": "stringstri",
- "daytimeContactTel": "stringstri",
- "companyName": "string",
- "departmentName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "preferredDeliveryDate": "string",
- "actualDeliveryTimezone": "00",
- "deliveryBoxFlg": "off",
- "simNumber": 1,
- "amount": 1,
- "simCarrier": "jt",
- "globalsimTypeId": "stringstri",
- "globalsimPlanId": "stringstri",
- "belongGroupId": "stringstri",
- "newGroupName": "string"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMの利用休止・利用再開をする
グローバルSIM利用休止・利用再開申請情報
required | Array of objects (globalsimLineId) = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
operationType required | string Enum: "sleep" "awake" オペレーション区分(sleep:利用休止,awake:利用再開) |
sleepReason required | string Enum: "waitingStart" "season" "longStop" "other" "resumed" 利用休止理由 (waitingStart:利用開始待ち、season:季節要因による一時休止、longStop:長期休止、other:その他 利用再開の場合、resumed:ユーザ申請) |
globalsimPlanId | string = 10 characters グローバルSIMプランID。利用再開時は設定が必要。利用休止の場合は未設定:半角英数字10桁 |
{- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
], - "operationType": "sleep",
- "sleepReason": "waitingStart",
- "globalsimPlanId": "stringstri"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMの一時停止・一時停止再開申請をする
グローバルSIM一時停止・一時停止再開申請情報
required | Array of objects (globalsimLineId) = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
operationType required | string Enum: "stop" "restart" オペレーション区分(stop:一時停止,restart:一時停止再開) |
stopRestartReason required | string Enum: "losted" "paused" "resumed" 一時停止・一時停止再開(利用停止の場合、losted:ユーザ申請(紛失等)、paused:ユーザ申請(休止) 利用再開の場合、resumed:ユーザ申請) |
{- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
], - "operationType": "stop",
- "stopRestartReason": "losted"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMの解約申請をする
グローバルSIM解約申請情報
required | Array of objects (globalsimLineId) = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
estimatedQuitDate required | string <yyyy-MM-dd> 解約予定日 |
quitReasonType required | string Enum: "sideGrade" "price" "qualityService" "qualitySupport" "serviceEnd" "other" 解約理由区分(sideGrade:他社乗り換え、price:料金不満、qualityService:品質不満(サービス・通信)、qualitySupport:品質不満(サポート)、serviceEnd:サービス終了、other:その他) |
{- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
], - "estimatedQuitDate": "string",
- "quitReasonType": "sideGrade"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
グローバルSIMのプランを変更申請する。プラン変更希望日は翌月1日をシステムで自動設定する。
グローバルSIMプラン変更申請情報
required | Array of objects (globalsimLineId) = 10 characters グローバルSIM回線情報ID:半角英数字10桁 |
globalsimPlanId required | string = 10 characters グローバルSIMプランID |
{- "globalsimLineIdList": [
- {
- "globalsimLineId": "stringstri"
}
], - "globalsimPlanId": "stringstri"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIM回線情報を検索する。通信量・データ残量は「等しい」選択時はFrom、Toの両方、「以上」選択時はFrom、「以下」選択時はToに値を入れてリクエストを想定
iccId | string [ 1 .. 64 ] characters 製造番号/ICCID :半角英数字1~64桁 |
status | string Enum: "reserved" "uninitialized" "using" "stoped" "quitAccepted" "quitted" "cancel" "forceQuitted" "limitedQuitted" SIMステータス:(reserved:発注済、uninitialized:未アクティベーション、using:利用中、stoped:停止中、quitAccepted:解約登録済み、quitted:解約、cancel:キャンセル、forceQuitted:強制解約、limitedQuitted:有効期限切れ解約) |
tel | string [ 11 .. 14 ] characters 電話番号:半角数字11~14桁 |
lineName | string [ 1 .. 64 ] characters SIM回線名:全角文字1~64桁 |
simClosedPlanName | string [ 1 .. 128 ] characters SIM閉域プラン名:全角文字1~128桁 |
bandName | string [ 1 .. 128 ] characters 帯域名:全角文字1~128桁 |
groupId | string = 10 characters SIM回線グループID:半角英数字10桁 |
groupName | string [ 1 .. 64 ] characters SIM回線グループ名:全角文字1~64桁 |
simPlanId | string = 10 characters SIMプランID:半角英数字10桁 |
simPlanName | string [ 1 .. 128 ] characters SIMプラン名:全角文字1~128桁 |
simCarrier | string Enum: "docomo" "kddi" "softbank" キャリア(docomo:DoCoMo、kddi:KDDI、softbank:SoftBank) |
accountId | string = 10 characters アカウント情報ID:半角英数字10桁 |
staffLastName | string [ 1 .. 32 ] characters 姓(漢字):全角文字1~32桁 |
staffFirstName | string [ 1 .. 32 ] characters 名(漢字):全角文字1~32桁 |
simLineId | string [ 9 .. 10 ] characters SIM回線情報ID:半角英数字9~10桁 |
simDeviceId | string = 10 characters SIM機器情報ID:半角英数字10桁 |
simEntryDateFrom | string <yyyy-MM-dd> SIM発注日(from) |
simEntryDateTo | string <yyyy-MM-dd> SIM発注日(to) |
simType | string Enum: "prePaid" "postPaid" SIM種別(prePaid:プリペイド、postPaid:ポストペイド) |
activationLimitDateFrom | string <yyyy-MM-dd> アクティベーション有効期限日(From) |
activationLimitDateTo | string <yyyy-MM-dd> アクティベーション有効期限日(To) |
useClosed | string Enum: "off" "on" 閉域利用有無(off:利用しない、on:利用する) |
ipAddress | string <ipv4> IPアドレス |
privateIpAddress | string <ipv4> プライベート固定IPアドレス(閉域用) |
dateLimitStatus | string Enum: "normal" "dateLimit" "totalLimit" "timer" "charge" "unknown" 通信制御ステータス:(normal:通常、dateLimit:n日間規制中、totalLimit:総量規制中、timer:タイマー起動中、charge:チャージ利用中、unknown:不明) |
quittedRecordHidden | string Enum: "off" "on" 解約レコード非表示(off:表示(省略時表示)on:非表示)。30日超過した解約済SIMは表示対象としません。 |
trackNO | string 伝票番号 |
packetShareId | string パケットシェアID:半角英数字10桁 |
imei | string [ 1 .. 50 ] characters imei:半角数字16桁(念のため最大桁数50とする。) |
imsi | string [ 1 .. 50 ] characters imsi:半角数字16桁(念のため最大桁数50とする。) |
deviceLockFlag | boolean デバイスロック設定 (true:あり、false:なし) |
deviceLockRule | string [ 1 .. 253 ] characters デバイスロックルール |
trafficUsedFrom | number 通信量(from)単位はB |
trafficUsedTo | number 通信量(to)単位はB |
dataRemainFrom | number データ残量(from)単位はB |
dataRemainTo | number データ残量(to)単位はB |
usageAlert | string 利用量アラート (on:警告、off:-) |
remainAlert | string 残量アラート (on:警告、off:-) |
activationLimitAlert | string アクティベーション期限アラート (on:警告、off:-) |
yearlyPaymentId | string = 10 characters 年払い情報ID:半角英数字10桁 |
yearlyPaymentName | string [ 1 .. 128 ] characters 年払い名:- ※仕様変更により本パラメータの指定はご利用できません。次期バージョンで本パラメータは削除される予定です。 |
fiveGOptionStatus | string Enum: "on" "off" 5Gオプション有無:(on:○、off:×) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "customerId": "CU00000001",
- "entryId": "EN00000001",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "simLineId": "L000000001",
- "simDeviceId": "SD00000001",
- "simEntryDate": "2020-12-01",
- "iccId": "T889812000000000000",
- "status": "reserved",
- "orderStatus": "reserved",
- "tel": "09001234567",
- "lineName": "回線名",
- "bandName": "帯域名",
- "groupName": "回線グループ名",
- "simPlanId": "SP00000001",
- "simPlanName": "プラン名",
- "simCarrier": "softbank",
- "simSize": "mini",
- "activationDate": "2020-12-10",
- "apn": "APN名",
- "connectionId": "aaaaaaaaaa",
- "ipAddress": "192.168.0.1",
- "dateLimitStatus": "normal",
- "simType": "postPaid",
- "useClosed": "off",
- "userClosedName": "帯域名1",
- "packetShareId": "PA001",
- "imei": 12345,
- "imsi": 123456,
- "deviceLockFlag": true,
- "deviceLockRule": 12345,
- "trafficUsed": 2000,
- "dataRemain": 3000,
- "usageAlert": "on",
- "remainAlert": "on",
- "activationLimitAlert": "on",
- "yearlyPaymentName": "年払いA",
- "yearlyPaymentUsing": "off",
- "lastBillingMonth": "2022-05",
- "fiveGOptionStatus": "off",
- "simChangeOrdering": "off",
- "fiveGOptionChangeOrdering": "off"
}, - {
- "customerId": "CU00000001",
- "entryId": "EN00000002",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "simLineId": "L00000002",
- "simDeviceId": "SD00000002",
- "simEntryDate": "2020-12-01",
- "iccId": "T889812000000000001",
- "status": "using",
- "orderStatus": "reserved",
- "tel": "09001234567",
- "lineName": "回線名",
- "bandName": "帯域名",
- "groupName": "回線グループ名",
- "simPlanId": "SP00000001",
- "simPlanName": "プラン名",
- "simCarrier": "kddi",
- "activationDate": "2020-12-10",
- "apn": "APN名",
- "dateLimitStatus": "normal",
- "simType": "postPaid",
- "useClosed": "on",
- "userClosedName": "帯域名2",
- "packetShareId": "PA002",
- "imei": 12345,
- "deviceLockFlag": true,
- "deviceLockRule": 12345,
- "salesStaff": "営業担当2",
- "trafficUsed": 2000,
- "dataRemain": 3000,
- "usageAlert": "off",
- "remainAlert": "off",
- "activationLimitAlert": "off",
- "yearlyPaymentName": "年払いB",
- "yearlyPaymentUsing": "off",
- "lastBillingMonth": "2022-05",
- "fiveGOptionStatus": "off",
- "simChangeOrdering": "off",
- "fiveGOptionChangeOrdering": "off"
}, - {
- "customerId": "CU00000001",
- "entryId": "EN00000003",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "simLineId": "L00000003",
- "simDeviceId": "SD00000003",
- "simEntryDate": "2020-12-01",
- "iccId": "T889812000000000002",
- "status": "reserved",
- "orderStatus": "reserved",
- "tel": "09001234567",
- "lineName": "回線名",
- "bandName": "帯域名",
- "groupName": "回線グループ名",
- "simPlanId": "SP00000001",
- "simPlanName": "プラン名",
- "simCarrier": "docomo",
- "activationDate": "2020-12-10",
- "apn": "APN名",
- "connectionId": "aaaaaaaaaa",
- "dateLimitStatus": "normal",
- "simType": "prePaid",
- "useClosed": "off",
- "userClosedName": "帯域名3",
- "packetShareId": "PA003",
- "imei": 12345,
- "deviceLockFlag": false,
- "deviceLockRule": 12345,
- "salesStaff": "営業担当3",
- "trafficUsed": 0,
- "dataRemain": 1000,
- "usageAlert": "off",
- "remainAlert": "off",
- "activationLimitAlert": "off",
- "yearlyPaymentName": "年払いC",
- "yearlyPaymentUsing": "off",
- "lastBillingMonth": "2022-05",
- "fiveGOptionStatus": "on",
- "simChangeOrdering": "off",
- "fiveGOptionChangeOrdering": "off"
}, - {
- "customerId": "CU00000001",
- "mvnoServiceNo": "meeq202012010002",
- "entryId": "EN00000002",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "simLineId": "L00000002",
- "simDeviceId": "SD00000004",
- "simEntryDate": "2020-12-01",
- "startDate": "2020-12-01",
- "endDate": "2099-03-31",
- "iccId": "T889812000000000001",
- "status": "using",
- "orderStatus": "reserved",
- "tel": 9001234567,
- "lineName": "回線名",
- "simClosedPlanId": "CP00000002",
- "simClosedPlanName": "管理者閉域名",
- "bandName": "帯域名",
- "groupName": "回線グループ名",
- "simPlanId": "SP00000001",
- "simPlanName": "プラン名",
- "simCarrier": "kddi",
- "activationDate": "2020-12-10",
- "apn": "APN名",
- "dateLimitStatus": "normal",
- "simType": "postPaid",
- "useClosed": "on",
- "userClosedName": "帯域名2",
- "packetShareId": "PA002",
- "imei": 12345,
- "deviceLockFlag": true,
- "deviceLockRule": 12345,
- "salesStaff": "営業担当2",
- "trafficUsed": 2000,
- "dataRemain": 3000,
- "usageAlert": "off",
- "remainAlert": "off",
- "activationLimitAlert": "off",
- "yearlyPaymentName": "年払いB",
- "yearlyPaymentUsing": "off",
- "lastBillingMonth": "2022-05",
- "fiveGOptionStatus": "off",
- "simChangeOrdering": "on",
- "fiveGOptionChangeOrdering": "off"
}, - {
- "customerId": "CU00000001",
- "mvnoServiceNo": "meeq202012010002",
- "entryId": "EN00000002",
- "accountId": "UA00000001",
- "companyName": "会社名",
- "staffLastName": "姓",
- "staffFirstName": "名",
- "simLineId": "L00000002",
- "simDeviceId": "SD00000005",
- "simEntryDate": "2020-12-01",
- "startDate": "2020-12-01",
- "endDate": "2099-03-31",
- "iccId": "T889812000000000001",
- "status": "using",
- "orderStatus": "reserved",
- "tel": 9001234567,
- "lineName": "回線名",
- "simClosedPlanId": "CP00000002",
- "simClosedPlanName": "管理者閉域名",
- "bandName": "帯域名",
- "groupName": "回線グループ名",
- "simPlanId": "SP00000001",
- "simPlanName": "プラン名",
- "simCarrier": "kddi",
- "activationDate": "2020-12-10",
- "apn": "APN名",
- "dateLimitStatus": "normal",
- "simType": "postPaid",
- "useClosed": "on",
- "userClosedName": "帯域名2",
- "packetShareId": "PA002",
- "imei": 12345,
- "deviceLockFlag": true,
- "deviceLockRule": 12345,
- "salesStaff": "営業担当2",
- "trafficUsed": 2000,
- "dataRemain": 3000,
- "usageAlert": "off",
- "remainAlert": "off",
- "activationLimitAlert": "off",
- "yearlyPaymentName": "年払いB",
- "yearlyPaymentUsing": "off",
- "lastBillingMonth": "2022-05",
- "fiveGOptionStatus": "off",
- "simChangeOrdering": "off",
- "fiveGOptionChangeOrdering": "on"
}
], - "totalSize": 3,
- "simChargedCount": 0
}
SIM回線の詳細情報を取得する
simDeviceId required | string = 10 characters SIM機器情報ID:半角英数字10桁 |
{- "customerId": "CU00000001",
- "accountId": "ID00000001",
- "simEntryDate": "2021-01-01",
- "activationDate": "2021-01-05",
- "activationLimitDate": "2022-01-05",
- "lineName": "回線名称",
- "groupName": "回線グループA",
- "iccId": "ICCID00000000000001",
- "simTel": "09001234567890",
- "simPlanName": "SIMプランA",
- "simCarrier": "softbank",
- "simSize": "nano",
- "apnName": "APN_閉域",
- "connectionId": "connectionId",
- "password": "password",
- "ipAddress": "192.168.0.1",
- "privateIpAddress": "192.168.0.1",
- "simStatus": "reserved",
- "dateLimitStatus": "normal",
- "orderStatus": "string",
- "entryId": "stringstri",
- "simLineId": "L000000001",
- "simDeviceId": "SD00000001",
- "fiveGOptionStatus": "off",
- "simType": "prePaid",
- "useClosed": "off",
- "trackNO": "33333333",
- "imei": 53232,
- "imsi": 532532,
- "deviceLockFlag": true,
- "deviceLockRule": 53232,
- "activationExpirationExtendCount": 1
}
SIMサービス申請詳細を取得する。レスポンスパラメータとして、申請顧客アカウント名が利用可能である。
entryId required | string = 10 characters 申請ID:半角英数字10桁 |
{- "simOrder": {
- "entryId": "EN00000001",
- "accountName": "アカウント名",
- "accountId": "ID00000001",
- "companyName": "会社名",
- "simOrderType": "simPlanEdit",
- "requestStatus": "end"
}, - "simOrderEntry": {
- "zipCode": "strings",
- "addressPrefectures": "string",
- "addressCity": "string",
- "addressTown": "string",
- "addressOptional": "string",
- "contactTel": "stringstri",
- "daytimeContactTel": "stringstri",
- "companyName": "string",
- "departmentName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "preferredDeliveryDate": "string",
- "preferredDeliveryTimezone": "00",
- "deliveryBoxFlg": "off",
- "simNumber": 0,
- "simCarrier": "docomo",
- "simSize": "mini",
- "simPlanName": "SIMプランB",
- "trackNO": "33333333",
- "option": [
- "simGlobalIpOptionEntry"
]
}, - "simOrderActivation": {
- "startDate": "string",
- "simDeviceIdList": [
- {
- "simDeviceId": "string",
- "iccId": "string",
- "simTel": "string"
}
], - "simPlanId": "stringstri",
- "simPlanName": "string",
- "simOptionPlanList": [
- {
- "simPlanOptionId": "string",
- "simPlanOptionName": "string"
}
]
}, - "simOrderCharge": {
- "simOrderChargeInfoList": [
- {
- "simDeviceId": "stringstri",
- "iccId": "string",
- "simTel": "stringstrin",
- "simPlanChargeId": "stringstri",
- "chargePlanName": "string"
}
]
}, - "simOrderQuit": {
- "simDeviceIdList": [
- {
- "simDeviceId": "string",
- "iccId": "string",
- "simTel": "string"
}
], - "quitDate": "string",
- "quitReasonType": "sideGrade"
}, - "simOrderStopRestart": {
- "simDeviceIdList": [
- {
- "simDeviceId": "string",
- "iccId": "string",
- "simTel": "string"
}
], - "operationType": "stop",
- "stopRestartReason": "losted"
}, - "simOrderDeviceChange": {
- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri",
- "iccId": "string",
- "simTel": "stringstrin",
- "simCarrier": "docomo",
- "simSize": "mini",
- "trackNO": "33333333"
}
], - "zipCode": "strings",
- "addressPrefectures": "string",
- "addressCity": "string",
- "addressTown": "string",
- "addressOptional": "string",
- "contactTel": "stringstri",
- "daytimeContactTel": "stringstri",
- "companyName": "string",
- "departmentName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "preferredDeliveryDate": "string",
- "preferredDeliveryTimezone": "00",
- "deliveryBoxFlg": "off",
- "changeReason": "lost"
}, - "simPlanEdit": {
- "simDeviceIdList": [
- {
- "simDeviceId": "SD00000001"
}
], - "planChangeDate": "2021-02-01",
- "simPlanName": "SIMプランB"
}, - "simIpAddresChange": {
- "result": [
- {
- "simDeviceId": "stringstri",
- "iccId": "string",
- "simTel": "stringstrin",
- "ipAddress": "192.168.0.1",
- "processStatus": "successed"
}
], - "totalSize": 0
}, - "simGlobalIpOptionEntry": {
- "simPlanOptionUseList": [
- {
- "simDeviceId": "string",
- "iccId": "string",
- "simTel": "string",
- "option": "off"
}
]
}, - "simFiveGOptionEntry": {
- "simPlanOptionUseList": [
- {
- "simDeviceId": "string",
- "iccId": "string",
- "simTel": "string",
- "option": "off"
}
]
}, - "packetShareQuitEntry": {
- "packetShareName": "パケットシェア名A",
- "limitScale": "B",
- "dataLimit": 0,
- "networkType": "internet"
}, - "deviceLockEntry": {
- "deviceLockRule": 53232,
- "deviceLockedDate": "2021-01-01 10:00:00",
- "targetDeviceListOfEntry": [
- {
- "iccId": "string",
- "imei": 53232,
- "deviceLockRule": 53232,
- "processStatus": "successed"
}
]
}, - "deviceUnLockEntry": {
- "deviceLockRule": 53232,
- "deviceUnLockedDate": "2021-01-01 10:00:00",
- "targetDeviceListOfEntry": [
- {
- "iccId": "string",
- "imei": 53232,
- "deviceLockRule": 53232,
- "processStatus": "successed"
}
]
}
}
SIMサービス申請一覧を取得する。リクエスト、レスポンスパラメータとして、申請顧客アカウント名が利用可能である。
entryId | string = 10 characters 申請ID:半角英数字10桁 |
accountId | string = 10 characters 申請顧客アカウント情報ID:半角英数字10桁 |
accountName | string [ 0 .. 65 ] characters 申請顧客アカウント名:全角文字3~65桁 |
simOrderType | string Enum: "simOrderEntry" "simOrderActivation" "simOrderAutoActivation" "simOrderCharge" "simOrderQuit" "simOrderStopRestart" "simOrderDeviceChange" "simIpAddresChange" "simGlobalIpOptionEntry" "simFiveGOptionEntry" "simPlanEdit" "quitPacketShare" "deviceLock" "deviceUnLock" "dataPlatformEntry" SIM申請種別 (simOrderEntry:SIM新規発注、simOrderActivation:SIM回線手動アクティベーション、simOrderAutoActivation:SIM回線自動アクティベーション、simOrderCharge:SIMチャージ、simOrderQuit:SIM解約、simOrderStopRestart:SIM利用停止再開、simOrderDeviceChange:SIM交換、simIpAddresChange:IPアドレス変更、simGlobalIpOptionEntry:グローバル固定IPアドレスオプション追加、simFiveGOptionEntry:5Gオプション追加、simPlanEdit:SIMプラン変更 、quitPacketShare:パケットシェア解約、deviceLock:デバイスロック設定申請、deviceUnLock:デバイスロック解除申請) |
requestStatus | string Enum: "end" "reject" "partialEnd" "waiting" "constructionWaiting" 申請ステータス (end:完了、reject:却下、partialEnd:部分完了、waiting:申請依頼中、constructionWaiting:工事待機中) |
createDateFrom | string <yyyy-MM-dd> 申請日(from) |
createDateTo | string <yyyy-MM-dd> 申請日(to) |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "entryId": "EN00000001",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderEntry",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00",
- "activationLimitDate": "2021-03-31"
}, - {
- "entryId": "EN00000002",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderActivation",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000003",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderCharge",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000004",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderQuit",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000005",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderStopRestart",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000006",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderDeviceChange",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000007",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simIpAddressEdit",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000008",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simPlanEdit",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN00000010",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simFiveGOptionEntry",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}, - {
- "entryId": "EN000000011",
- "accountId": "ID00000001",
- "accountName": "アカウント名",
- "companyName": "会社名",
- "simOrderType": "simOrderAutoActivation",
- "requestStatus": "waiting",
- "createDate": "2021-01-01T00:00:00.000+09:00"
}
], - "totalSize": 8
}
SIM回線位置セッション情報を取得する。
simDeviceId required | string = 10 characters SIM機器情報ID:半角英数字10桁 |
sortKey | string ソートキー:ソートしたい返却項目の変数名を設定する。 例 以下の項目を設定した場合のSQLの例。 ソートキー(sortKey)に'XXXX'(カラム名)、ソート順(sortOrder)に'asc'、一覧取得開始ページ(page)に'3'、一覧取得件数(listSize)に'30'を設定した場合 「ORDER BY XXXX asc LIMIT 30 OFFSET (3 - 1) * 30 -1」 |
sortOrder | string Enum: "asc" "desc" ソート順 (asc:昇順、desc:降順) |
page | integer 一覧取得開始ページ |
listSize | integer 一覧取得件数 |
{- "result": [
- {
- "sessionDateTime": "2021-12-01 10:00:00",
- "event": "CREATED",
- "latitudeDEG": 12.3456,
- "longitudeDEG": 123.4567,
- "imei": 5243243
}, - {
- "sessionDateTime": "2021-12-03 10:00:00",
- "event": "CREATED",
- "latitudeDEG": 12.3456,
- "longitudeDEG": 123.4567,
- "imei": 5243249
}
], - "totalSize": 2
}
SIMのチャージ申請をする
SIMチャージ申請情報
required | Array of objects (simDeviceId) = 10 characters SIM機器情報ID:半角英数字10桁 |
chargePlanCode required | string [ 1 .. 11 ] characters チャージプランコード:半角英数字1~11桁 |
{- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
], - "chargePlanCode": "string"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIMを発注申込する。
SIM新規発注申請
zipCode required | string = 7 characters 郵便番号:半角数字7桁 |
addressPrefectures required | string [ 1 .. 8 ] characters 住所(都道府県):全角文字1~8桁 |
addressCity required | string [ 1 .. 64 ] characters 住所(市区町村):全角文字1~64桁 |
addressTown required | string [ 1 .. 128 ] characters 住所(町名/番地):全角文字1~128桁 |
addressOptional | string [ 1 .. 96 ] characters マンション/ビル名・部屋番号:全角文字1~96桁 |
contactTel required | string [ 10 .. 11 ] characters 連絡先電話番号:半角数字10~11桁 |
daytimeContactTel | string [ 10 .. 11 ] characters 日中連絡先電話番号:半角数字10~11桁 |
companyName required | string [ 1 .. 64 ] characters 配送先会社名:全角文字1~64桁 |
departmentName required | string [ 1 .. 52 ] characters 配送先部署名:全角文字1~52桁 |
staffLastName required | string [ 1 .. 32 ] characters 配送先担当者姓(漢字):全角文字1~32桁 |
staffFirstName required | string [ 1 .. 32 ] characters 配送先担当者名(漢字):全角文字1~32桁 |
preferredDeliveryDate | string <yyyy-MM-dd> 配送希望日 |
actualDeliveryTimezone | string Enum: "00" "08" "12" "14" "16" "18" "19" 配送時間帯(00:指定なし、08:午前中、12:12:00~14:00、14:14:00~16:00(午後)、16:16:00~18:00、18:18:00~20:00、19:19:00~21:00) (配送希望日がある場合必須,ない場合はなし) |
deliveryBoxFlg required | string Enum: "off" "on" 宅配ボックス利用可否(off:利用しない、on:利用する) |
simNumber required | integer [ 1 .. 999 ] SIM枚数 (1000未満の値が設定可能) |
simCarrier required | string Enum: "docomo" "kddi" "softbank" キャリア(docomo:DoCoMo、kddi:KDDI、softbank:SoftBank) |
simPlanId required | string = 10 characters SIMプランID:半角英数字10桁 |
belongGroupId | string = 10 characters 属するグループID。既存のグループに属する場合に設定する。新規の場合は未設定。「新規グループ名」とどちらかの設定が必要。:半角英数字10桁 |
newGroupName | string [ 1 .. 64 ] characters 新規グループ名。新規のグループに属する場合に設定する。既存の場合は未設定。「属するグループID」とどちらかの設定が必要。:全角文字1~64桁 |
useGlobalIpOption | string Enum: "off" "on" グローバル固定IPアドレスオプション利用有無(off:利用しない、on:利用する) |
{- "zipCode": "strings",
- "addressPrefectures": "string",
- "addressCity": "string",
- "addressTown": "string",
- "addressOptional": "string",
- "contactTel": "stringstri",
- "daytimeContactTel": "stringstri",
- "companyName": "string",
- "departmentName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "preferredDeliveryDate": "string",
- "actualDeliveryTimezone": "00",
- "deliveryBoxFlg": "off",
- "simNumber": 1,
- "simCarrier": "docomo",
- "simPlanId": "stringstri",
- "belongGroupId": "stringstri",
- "newGroupName": "string",
- "useGlobalIpOption": "off"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIMの交換を申請する
SIM交換申請情報
required | Array of objects (simDeviceId) = 10 characters SIM機器情報ID:半角英数字10桁 |
zipCode required | string = 7 characters 郵便番号:半角数字7桁 |
addressPrefectures required | string [ 1 .. 8 ] characters 住所(都道府県):全角文字1~8桁 |
addressCity required | string [ 1 .. 64 ] characters 住所(市区町村):全角文字1~64桁 |
addressTown required | string [ 1 .. 128 ] characters 住所(町名/番地):全角文字1~128桁 |
addressOptional | string [ 1 .. 96 ] characters マンション/ビル名・部屋番号:全角文字1~96桁 |
contactTel required | string [ 10 .. 11 ] characters 連絡先電話番号:半角数字10~11桁 |
daytimeContactTel | string [ 10 .. 11 ] characters 日中連絡先電話番号:半角数字10~11桁 |
companyName required | string [ 1 .. 64 ] characters 配送先会社名:全角文字1~64桁 |
departmentName required | string [ 1 .. 52 ] characters 配送先部署名:全角文字1~52桁 |
staffLastName required | string [ 1 .. 32 ] characters 配送先担当者姓(漢字):全角文字1~32桁 |
staffFirstName required | string [ 1 .. 32 ] characters 配送先担当者名(漢字):全角文字1~32桁 |
preferredDeliveryDate | string <yyyy-MM-dd> 配送希望日 |
actualDeliveryTimezone | string Enum: "00" "08" "12" "14" "16" "18" "19" 配送時間帯(00:指定なし、08:午前中、12:12:00~14:00、14:14:00~16:00(午後)、16:16:00~18:00、18:18:00~20:00、19:19:00~21:00) 配送希望日がある場合必須,ない場合はなし |
deliveryBoxFlg required | string Enum: "off" "on" 宅配ボックス利用可否(off:利用しない、on:利用する) |
changeReason required | string Enum: "lost" "sizeSwitched" "other" 交換理由(lost:紛失交換(SIMサイズ切り替えを行わない場合)。sizeSwitched:SIMサイズ切替(SIMサイズ切り替えを行う場合)、other:その他) |
{- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
], - "zipCode": "strings",
- "addressPrefectures": "string",
- "addressCity": "string",
- "addressTown": "string",
- "addressOptional": "string",
- "contactTel": "stringstri",
- "daytimeContactTel": "stringstri",
- "companyName": "string",
- "departmentName": "string",
- "staffLastName": "string",
- "staffFirstName": "string",
- "preferredDeliveryDate": "string",
- "actualDeliveryTimezone": "00",
- "deliveryBoxFlg": "off",
- "changeReason": "lost"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIM回線のグローバル固定IPアドレスオプションを変更する。本APIはリアルタイムにグローバル固定IPのON、OFFの制御を行い、払い出したIPをレスポンスとして返却する。レスポンスのIPリストは、simPlanOptionUseListのoptionをonにしたもののIPリストを返却する。確保に成功した場合はIPを、失敗した場合をnullで返す。simPlanOptionUseListのoptionをoffにするなどの場合は返却しない。
グローバル固定IPアドレスオプション変更有無
required | Array of objects (SimPlanOptionUseEditRequest) SIMプランオプション利用情報リスト |
{- "simPlanOptionUseList": [
- {
- "simDeviceId": "stringstri",
- "option": "off"
}
]
}
{- "simGlobalIpOptionEditInfoList": [
- {
- "simDeviceId": "SD00000001",
- "ipAddress": "255.255.255.192"
}, - {
- "simDeviceId": "SD00000002",
- "ipAddress": null
}
]
}
SIM回線のIPアドレスを変更する
SIM回線IPアドレス変更
simDeviceId required | string = 10 characters SIM機器情報ID:半角英数字10桁 |
ipAddress required | string <ipv4> IPアドレス |
{- "simDeviceId": "stringstri",
- "ipAddress": "192.168.0.1"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIMのプランを変更申請する。プラン変更希望日は翌月1日をシステムで自動設定する。
SIMプラン変更申請情報
required | Array of objects (simDeviceId) = 10 characters SIM機器情報ID:半角英数字10桁 |
simPlanId required | string = 10 characters SIMプランID |
{- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
], - "simPlanId": "stringstri"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIMの解約申請をする
SIM解約申請情報
required | Array of objects (simDeviceId) = 10 characters SIM機器情報ID:半角英数字10桁 |
estimatedQuitDate required | string <yyyy-MM-dd> 解約予定日 |
quitReasonType required | string Enum: "sideGrade" "price" "qualityService" "qualitySupport" "serviceEnd" "other" 解約理由区分(sideGrade:他社乗り換え、price:料金不満、qualityService:品質不満(サービス・通信)、qualitySupport:品質不満(サポート)、serviceEnd:サービス終了、other:その他) |
{- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
], - "estimatedQuitDate": "string",
- "quitReasonType": "sideGrade"
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}
SIMの利用停止・再開申請をする
SIM利用停止・再開申請情報
required | Array of objects (simDeviceId) = 10 characters SIM機器情報ID:半角英数字10桁 |
operationType required | string Enum: "stop" "restart" オペレーション区分(stop:利用停止,restart:利用再開) |
stopRestartReason required | string Enum: "losted" "paused" "resumed" 利用停止・再開理由(利用停止の場合、losted:ユーザ申請(紛失等)、paused:ユーザ申請(休止) 利用再開の場合、resumed:ユーザ申請) |
{- "simDeviceIdList": [
- {
- "simDeviceId": "stringstri"
}
], - "operationType": "stop",
- "stopRestartReason": "losted"
}
{- "count": 10,
- "failedcount": 1
}
SIM回線の5Gオプションを変更する
5Gオプション変更有無
required | Array of objects (SimPlanOptionUseEditRequest) SIMプランオプション利用情報リスト |
{- "simPlanOptionUseList": [
- {
- "simDeviceId": "stringstri",
- "option": "off"
}
]
}
{- "errorCode": "string",
- "errorMessage": "string",
- "parameterErrorList": [
- {
- "name": "string",
- "reason": "string"
}
]
}