Page 1
API申請
1
API 申請利用マニュアル
目次
【API 申請と一括電子申請の違い】 ............................................................................................................................................... 2
【API 申請の初期設定】 ....................................................................................................................................................................... 3
【API 電子申請をする】 ....................................................................................................................................................................... 7
【API 電子申請後の進捗管理】 ......................................................................................................................................................... 9
【申請済案件の管理について】 ..................................................................................................................................................... 12
【電子証明書の切り替え】 ............................................................................................................................................................... 13
Page 2
API申請
2
【API 申請と一括電子申請の違い】
API 申請 一括電子申請
申請の作成方法 同じ
リスト機能 なし。 「手続き」タブの[一括電子
申請リスト]に有り。
申請の送信方法 ろうむ inOne が直接 API に申請情報を送
信します。
・申請の送信が完了してから、次の申請を
行なう必要があります。送信者が複数名
いらっしゃる会社様の場合は、申請のタ
イミングが被らないように注意してくだ
さい。
・API 申請の利用者が多い時期や申請に添
付するファイルの容量が大きい場合は、
申請が送れなかったり、送信に時間がか
かる場合があります。
通常時は、3 秒~5分程度。
e-Gov サイトで、申請ファイ
ルを貼り付け、送信します。
送信番号から申請
した従業員の特定
特定出来かねます。
自社で「どの送信番号で誰の申請を行なったのか」管理してください。
エラーや公文書
の取得
ろうむ inOne 上で確認。
※e-Gov サイトでは確認できません。
e-Gov サイトで確認。
お問い合わせ先 申請の送信後のエラーにつきましては、e-Govかクリックスのサポートセ
ンターにご確認ください。到達番号確認後は、提出先にご確認ください。
Page 3
API申請
3
【API 申請の初期設定】
■利用者 ID 登録をする。
データを共有している場合は、利用者 ID は社内で1つだけ発行してください。
データを共有していない場合は、各々で利用者 ID 登録を行ってください。
※ウイルスチェックソフトにより、通信がブロックされる場合があります。ブロックされている場合には、
可能であれば、一時的にウイルスチェックソフトを停止するなどの操作をお試しください。ウイルスチェ
ックソフトに関しては、社内のシステム担当者やソフト会社のサポートセンターなどにご確認ください。
※ネットワーク環境でプロキシサーバをご利用の場合は、API 電子申請が利用できない場合があります。
不明の場合は社内のシステム担当者にご確認ください。
※API 電子申請をご利用できない環境の場合には、通常の電子申請や紙での申請をご利用ください。
1 「手続き」タブで、『API 申請を利用する』のチェ
ックを入れ、[電子申請進捗管理]をクリックし
ます。
2 「送信案件一覧」画面を表示します。
[利用者 ID 登録・証明書識別情報登録]をクリッ
クします。
Page 4
API申請
4
3 [利用者 ID]に 8文字以上 12文字以下の半角英
数字を入力してください。
[利用者 ID 登録]をクリックします。
※ID は任意です。記号は利用できません。1文字以上
の異なる文字を使用してください(同じ文字列のみ
の登録はできません)
また、既に登録されている ID と同じ IDを登録する
ことはできません。
※ID はメモをとるなど、ご自身で管理してください。
※左図では例として、利用者 IDを『Clicks01』にし
ています。
4 メッセージが表示されます。
[OK]をクリックします。
5 「Windowsセキュリティ」画面で、社会保険労務
士電子証明書を選択し、[OK]をクリックしま
す。
※@ろうむ、人事給与プロの場合は、
「Windows セキュリティ」ではなく「電子署名」画面が
表示されますので、「電子署名ファイル」の[参照]をク
リックし、社会保険労務士電子証明書を選択し、「秘密
鍵」を入力し、[署名実行]をクリックしてください。
Page 5
API申請
5
6 メッセージが表示されたら、[OK]をクリックし
ます。
※6の画面が表示されず、「利用者 ID の登録に失敗しまし
た。~」のメッセージが表示された場合は、3(P4)の
手順からやり直し、別の利用者 ID を入力して登録を行っ
てください。
7 [利用者認証テスト]をクリックします。
8 メッセージを表示し、[OK]をクリックします。
9 「Windowsセキュリティ」画面で、電子証明書を
選択し、[OK]をクリックします。
Page 6
API申請
6
※@ろうむ、人事給与プロの場合は、
Windows セキュリティ」ではなく「電子署名」画面が表示
されますので、「電子署名ファイル」の[参照]をクリック
し、社会保険労務士電子証明書を選択し、「秘密鍵」を入
力し、[署名実行]をクリックしてください。
10 メッセージを表示し、[OK]をクリックしま
す。
※10の画面が表示されず、「利用者認証に失敗しまし
た。」のメッセージが表示された場合は、7(P5)から
やり直してください。
11 [閉じる]をクリックします。
12 「送信案件一覧」画面に戻りましたら、[閉じ
る]をクリックします。
以上で、利用者 ID 登録は終了となります。
Page 7
API申請
7
【API 電子申請をする】
1 [手続き]タブの『API申請を利用する』にチェ
ックが入っていることを確認し、各々の申請を行
います。
各種届出画面の操作は、リンクの「社会保険電子
申請マニュアル」や「雇用保険電子申請マニュア
ル」を参照ください。
2 手続代行証明書を選択する画面まで進み、
[一括電子申請へ]をクリックします。
3 基本情報設定画面を表示し、[一括電子申請 API 送
信]をクリックします。
4 「申請完了」のメッセージが表示されるまで、お待
ちください。
※「申請完了」のメッセージが表示されるまで、他の作業を行わないでください。
申請が完了する前に次の申請を行ってしまうと、送信がされずに申請完了しません。
Page 8
API申請
8
■『一括電子申請(API)が完了しました。』のメッセージが
出ない場合
○ファイルの容量が重い。
~~~ e-Gov からのご案内より、下記抜粋 ~~~~~~~~~~~~~~~~~
1 申請あたりの送信可能容量は合計「99MB まで」となっておりますが、電子申請の利用にあた
って以下の事項に御留意くださいますようお願いいたします。
・1 申請あたりの送信可能容量:下限なし~合計 99MB まで
・1 ファイルあたりの送信可能容量:下限なし~50MB 以下
1 つのファイルサイズが 50MB を超える場合は、お手数ですが 1 ファイル当たり 50MB 以下に
なるようにファイルを分割して申請を行っていただきますようお願いいたします。
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
参考 URL:http://www.e-gov.go.jp/shinsei/news/egov/info/news20151222-1.html
○ネットワークの通信状況が不安定
~ウィルス対策ソフトなどのセキュリティが、電子申請の送信を妨害している。
15 分経っても申請が完了しないといった状況が続く場合には、ウイルスチェックソフトなどにブロックされ
ていないか確認ください。可能であれば、ウイルスチェックソフトを停止してお試しください。
○繁忙期で API 側のサーバーがパンクしている。
申請する方が少ない深夜などに申請を行なってください。
改善されなかったり、お急ぎの場合は API 申請ではなく、通常の電子申請や紙での申請をご利用ください。
○作成したデータの内容に返戻エラーが多く、チェックに時間がかかっている。
受付前に返戻されるエラーのチェックに時間がかかっていることにより、通信エラーとなる場合がありま
す。作成したデータの内容に入力漏れや誤りがないか確認してください。
Page 9
API申請
9
【API 電子申請後の進捗管理】
[手続き]タブで、「API 申請を利用する」のチェック
が入っていることを確認し、[電子申請進捗管理]を
クリックします。
○「送信番号」と「送信日時」が印字されていない場合
[送信日時]を入力し、[送信案件取得]をクリックします。
○「送信番号」と「送信日時」のみ印字されている場合
[送信日時]を入力し、[送信案件取得]をクリックします。
[エラー]の数字がゼロな場合は、API にて処理待ちになっております。
表示が何も変わらない場合は、時間をおいて再度状態をご確認ください。
○「送信番号」と「送信日時」と「エラー」に数字(ゼロ以外の整数)が表示されている場合
申請に失敗しています。
エラー欄の数字をクリックすると、エラー内容を表示し
ますので、ご確認ください。エラー部分を修正して、再
度申請をやり直してください。
Page 10
API申請
10
○「申請内容」「到達状況」「到達番号」が表示されている場合。
API の処理でエラーがなく、申請が進んでいます。
申請案件をクリックし、ブルーになった状態で、[申請案件取得]をクリックします。
「送信番号○○○○の申請案件一覧情報を取得しま
す。」のメッセージが表示されますので、[はい]をクリ
ックします。
「到達番号」をクリックすると、状況確認画面を表示しますので、進捗状況をご確認の上、公文書
及びコメントなどを取得ください。
※繁忙期で受付が混み合っており、処理に時間がかかるために公文書の取得まで時間がかかる場合がありま
す。
~公文書の取り方~
公文書取得の際にご利用いただくブラウザを、IE(インターネットエクスプローラー)に設定してく
ださい。IE 以外のブラウザをご利用の場合には、公文書の画面がうまく表示されない場合がありま
す。(国の行政機関から発行された電子公文書・コメント通知を取得する際の動作確認環境が IE
となっています)
※ブラウザの設定方法については、それぞれの PC で行ってください。設定方法については、社内のシステ
ム担当者などにご相談ください。
1 到達状況が「審査終了」まで進みましたら、[公文
書・コメント一覧]をクリックします。
2 「公文書ファイル」の[○○○○xml]をクリッ
クします。
「フォルダ」の[開く]をクリックします。
Page 11
API申請
11
3 xmlファイルを表示します。ファイルを開いて、
公文書の印刷を行ってください。
4 「取得終了」をクリックすると、「取得完了申請手続
きをしますか」と表示しますので、[はい]をクリッ
クします。
※e -Gov サイトから申請した案件は、API 申請画面には表示しません。
※API 申請で送信した案件については都度、[電子申請進捗管理]を開いて到達状況を確認してください。
(API 申請は通常、受付後に連絡がくることはありきません)
※取り下げを行なう場合は、提出先にご連絡ください。
到達状況によっては、[公文書・コメント一覧]に[取下ボタン]が表示されますが、現在利用出来ない
機能となっております、ご了承ください。
※API 申請では、1件毎に送信を行ってください。リスト保存して、複数の申請をまとめて送信する機能は
対応しておりません。([一括電子申請リスト]を利用して送信する場合は、[手続き]タブの『API 申
請を利用する』のチェックを外してください)
Page 12
API申請
12
【申請済案件の管理について】
○備考欄
『どの会社のどの従業員の申請を行なったか?』は、自社で管理していただく事になります。
「備考」は、メモ代わりにお使いください。(例:『㈱クリックス 労務 太郎 再申請』)
[備考検索]より、「備考」に入れたワードを検索することが可能です。
○表示設定
公文書を取り終わり、表示する必要がなくなった申請案件は、「表示設定」から、[非表示にす
る]に設定できます。
非表示にした申請を確認したい場合は、[全表示]をクリックしてください。
[指定表示]をクリックすると、非表示したものは表示されません。
【パソコンの切り替え・追加】
○親機のパソコン(サーバー)を変える。(破棄する)
→ろうむ inOne の使用状況によってご案内が異なる為、サポートセンターにご相談ください。
○API 申請を行なっていた子機のパソコンを廃棄する。
→対象となるパソコンで行なった API 申請の公文書をすべて取得した上で廃棄してください。
※申請したパソコン以外から、公文書を取得することができません。
○新しく、子機として使用するパソコンを追加する。
→既存のデータ(Arins.mdb)に接続する場合は、作業は不要です。
Page 13
API申請
13
【電子証明書の切り替え】
[電子申請進捗管理]の[利用者 ID 登録・証明書識別情報登録]の利用者 ID 登録時に使用した電
子証明書の有効期限が切れる場合は、新しい電子証明書を登録し直す必要があります。
※「○電子証明書の有効期限が既に切れている場合」と「○電子証明書の有効期限がまだ残っている場
合」の2パターンがあります。現在の状況に合わせて操作してください。
○電子証明書の有効期限が既に切れている場合
1 [電子申請進捗管理]の[利用者 ID 登録・証明書
識別情報登録]をクリックします。
[識別情報更新]をクリックします。
2 [OK]をクリックします。
3 「Windowsセキュリティ」画面で、有効期限が切
れた古い社会保険労務士電子証明書を選択し、
[OK]をクリックします。
4 [OK]をクリックします。
Page 14
API申請
14
5 「Windowsセキュリティ」画面で、新しい社会保
険労務士電子証明書を選択し、[OK]をクリック
します。
6 「利用者 ID 登録」画面に戻ります。戻るまで、
お待ちください。
7 [OK]をクリックします。
8 [利用者認証テスト]をクリックします。
※8 の作業後、左図が表示されたら、[OK]をクリック
します。
Page 15
API申請
15
9 「Windowsセキュリティ」画面で、新しい社会
保険労務士電子証明書を選択し、[OK]をクリ
ックします。
10 [OK]をクリックします。
電子証明書の有効期限が既に切れている場合の作業は以上です。
○電子証明書の有効期限がまだ残っている場合
1 [電子申請進捗管理]の[利用者 ID 登録・証明書
識別情報登録]をクリックします。
[識別情報追加]をクリックします。
2 [OK]をクリックします。
3 「Windowsセキュリティ」画面で、新しい社会保
険労務士電子証明書を選択し、[OK]をクリック
します。
Page 16
API申請
16
4 [OK]をクリックします。
5 「Windowsセキュリティ」画面で、有効期限が残
っている古い社会保険労務士電子証明書を選択し、
[OK]をクリックします。
6 「利用者 ID 登録」画面に戻ります。戻るまで、
お待ちください。
7 [OK]をクリックします。
8 [利用者認証テスト]をクリックします。
※8 の作業後、左図が表示されたら、[OK]をクリ
ックします。
Page 17
API申請
17
9 「Windowsセキュリティ」画面で、新しい社会
保険労務士電子証明書を選択し、[OK]をクリ
ックします。
10 [OK]をクリックします。
電子証明書の有効期限が残っている場合の作業は以上です。
【特殊機能・特殊表示】
[電子申請進捗管理]の[利用者 ID 登録・証明書識別
情報登録]の[識別情報削除]と[アクセスキー削除]
は、サポートから指示があった場合のみ操作します。
※サポート部の指示がない場合は、使用しないでください。
「送信案件一覧」画面の[SID]と[項番]は、ろうむ inOne の内部処理に関する表示です。
操作の必要はありません。
201903 改訂版