託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

API仕様書概要

インターネット申込（各種申込WEB）
WebAPI
仕様書概要
小売電気事業者さま専用（電気工事会社さまはWebAPIサービスを利用できません）

2020/4/1 作成

1/７

作成者
関西電力送配電託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

API仕様書概要

目 次
1. 機能概要
2. 通信仕様
3. 制限事項

2/7

作成者
関西電力送配電託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

作成者
関西電力送配電API仕様書概要

1. 機能概要
日本語名
1 各種WEB申込件名一覧

番号

2 各種WEB申込状況

3 各種WEB新規申込（弊社設備）

4 各種WEB新規申込（お客さま設備）機能
主なリクエスト項目
申込件名の一覧をAPIで一括 申込受付番号
作業工程取得する。
登録年月日
訪問希望年月日
選択項目
供給地点特定番号
弊社メッセージ有無
任意の申込受付番号に対する 申込受付番号
申込情報を取得する。

主なレスポンス項目
要求成否ステータス
受付メッセージ
申込件名一覧

弊社設備に関する調査依頼・ ログインID
問合せ情報の登録を行う。
選択項目コード
設備項目区分
内容種別コード
訪問希望年月日
供給地点特定番号
供給地点住所
お客さま設備に関する調査依 ログインID
頼・問合せ情報の登録を行う。 選択項目コード
設備項目区分
内容種別コード
訪問希望年月日
供給地点特定番号
供給地点住所

要求成否ステータス
受付メッセージ
申込受付番号

3/7

要求成否ステータス
受付メッセージ
弊社からのメッセージ※選択項目コード、設備項
目区分によりレスポンス項
目は異なる

要求成否ステータス
受付メッセージ
申込受付番号

備考託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

作成者
関西電力送配電API仕様書概要

日本語名
機能
主なリクエスト項目
5 各種WEB新規申込（停電） 停電に関する調査依頼・問合 ログインID
せ情報の登録を行う。
選択項目コード
設備項目区分
訪問希望年月日
供給地点特定番号
供給地点住所
需要者名
6 各種WEB新規申込（その その他受付、供給地点特定番 ログインID
他受付）
号調査に関する調査依頼・問 選択項目コード
合せ情報の登録を行う。
設備項目区分
内容種別コード
訪問希望年月日
供給地点特定番号
供給地点住所
7 各種WEB新規申込（メ接続送電サービスメニュー変 ログインID
ニュー変更）
更に関する申込み情報の登録 選択項目コードを行う。
設備項目区分
変更希望年月日
接続送電サービスメニュー
供給地点特定番号
需要者名

番号

4/7

主なレスポンス項目
要求成否ステータス
受付メッセージ
申込受付番号

要求成否ステータス
受付メッセージ
申込受付番号

要求成否ステータス
受付メッセージ
申込受付番号

備考託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

API仕様書概要

作成者
関西電力送配電

2. 通信仕様
No.

API名

12
3
4
5
6
7

各種WEB申込件名一覧
各種WEB申込状況
各種WEB新規申込（弊社設備）
各種WEB新規申込（お客さま設備）
各種WEB新規申込（停電）各種WEB新規申込（その他受付）
各種WEB新規申込（メニュー変更）

HTTPリクエスト ※２
HTTPレスポンス ※５
通信 ※３ メソッド
Content-Type ※４Content-Type
SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231MoshikomiKenmeiIchiranYokyuServiceProvider
H231MoshikomiJokyoYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231ShinkiMoshikomiHeishaSetsubiYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231ShinkiMoshikomiOkyakusamaSetsubiYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231ShinkiMoshikomiTeidenYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231ShinkiMoshikomiSonotaUketsukeYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
H231ShinkiMoshikomiMenuHenkoYokyuServiceProvider SOAP/HTTPS POST multipart/related; type="text/xml text/xml; charset=UTF-8
サービス名 ※１

※１
以下URLの後ろにサービス名を追加したものが、各APIのURLとなります。
https://k-www4.kepco.co.jp/kakusyuapi/services/
例：各種WEB申込件名一覧
https://k-www4.kepco.co.jp/kakusyuapi/services/H231MoshikomiKenmeiIchiranYokyuServiceProvider※２
SOAPメッセージのヘッダ部に、以下の設定が必要となります。
IDrequestID
serviceID
ipAddress
timeStamploginID
password

名称
リクエストＩＤ
サービスID
呼出元IPアドレス
タイムスタンプ
ログインIDパスワード

説明
Webサービスの呼び出し側のリクエストを一意に識別する為の通番
Webサービスにおいて提供される各サービスID
サービス呼び出し元の小売事業者のサーバのIPアドレス
サービス呼び出し元のタイムスタンプ
ログイン時のＩＤ番号
ログイン時のパスワード

5/7

託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

API仕様書概要※３
SOAPは、WEBサービスを呼び出す通信方式です。
トランスポートプロトコルはHTTPSとし、SOAPメッセージであるXMLを送受信する通信です。
HTTPS（Hypertext Transfer Protocol Secure）※SSL（Secure Sockets Layer）/TLS（Transport Layer Security）による暗号化通信※４
文字列の送受信はXML（Extensible Markup Language）※５
以下に、代表的なHTTPステータスコードを記載します。
HTTPステータスコード

200
400
403
404
500503

名称
正常リクエスト内容が不正アクセス不可URL誤り
サービスの内部処理でエラー発生
サービス利用不可

説明
IFにない項目を送信した
アクセス権がないかアクセスが禁止されている
サービス名誤りサービスの内部処理でエラー発生
サービスがメンテナンス中

6/7

作成者
関西電力送配電託送業務システム
システム名
サブシステム名 各種申込WEBサブシステム

API仕様書概要

作成者
関西電力送配電３. 制限事項
No.

1

制限事項
利用可能時間帯： 全日 終日（サービス停止時間帯を除く）
サービス停止時間帯 ： 毎週日曜日 1:00～3:00

備考※以下いずれかの方法による事前通知により、メンテナンス時間を設けさせて頂く事がございます・各種申込WEBの申込メイン画面のお知らせ情報
・弊社からのメール連絡

2

各小売事業者からのアクセス集中による各種申込WEBサブシステムへの高負荷を防ぐため、1社からのリクエスト頻度は、「1リクエスト/秒」以下を目標とする。
小売事業者は上記を超えないよう自社システムを構築することとする。

3

弊社の承諾なしに本書（ＡＰＩ仕様書）の転載、複製を禁じます。

7/7