API連携オプション 仕訳データ自動連携の初期設定

概要

• 「API連携オプション」（有料）のお申込が必要です。
• APIを通じて、「楽楽請求」の「計上仕訳データ」「支払仕訳データ」の作成、および取得、作成状況の確認ができます。
  ※API連携を行うための連携プログラム（システム構築）は「楽楽請求」外に貴社側でご用意いただく必要があります。
  （サンプルプログラムはご提供可能です。）
• HTTPヘッダに「楽楽請求」が発行するAPIトークンを埋め込むことで認証を実現します。
  
  

「楽楽請求」できること

APIトークンの管理

• APIトークンの発行

• APIのアクセス制限（アクセスを許可するIPアドレスの登録）

APIトークン

APIトークンとは

「楽楽請求」のAPIの利用時に認証用キーとして使用する文字列です。
APIトークンは、「楽楽請求」の管理者権限のみ発行できます。

APIトークンの発行

「設定」タブ＞「システム設定」＞「API連携設定」画面にて「生成」をクリックすることで「APIトークン」が発行されます。
※「システム設定」の操作には管理者権限が必要です。
APIトークンは生成直後のみ表示されます。
もし紛失した場合は再生成を実施ください。

APIトークンの再生成

「再生成」ボタンをクリック後に表示される「APIトークンの再生成」画面で「再生成」をクリックすることで、APIトークンが再生成されます。
※上記記載の通り再生成した場合、APIトークンは上書きされ過去生成されていたAPIトークンは利用できなくなります。

APIトークンの削除

「削除」ボタンをクリック後に表示される「APIトークンの削除」画面で「削除」をクリックすることで、APIトークンが削除され、APIが使用できない状態になります。

APIのアクセス制限

API専用の接続を許可するIPアドレスを制限することが可能です。

設定手順

1. 「設定」タブ＞「システム設定」＞「セキュリティ設定」をクリック
   ※「システム設定」の操作には管理者権限が必要です。
2. 「APIのアクセス制限」項目を「制限する」を選択
3. 許可するIPアドレスを入力
4. 「保存」をクリック
   

リクエスト方法

APIへのリクエストを行う際の基本的な情報は以下の通りです。

計上仕訳データ作成API

• 通信方式：HTTPS

• メソッド：POST

• 文字コード：UTF-8

• URL：https://【ドメイン】/【テナント】/api/v1/invoice_journals/output
  ※詳細については、別途記載されている「URL例」をご参照ください。
• ヘッダ：X-SK-apitoken:{APIトークン}
  ※上記のAPIトークンを含むリクエストヘッダを必ず指定してください。
  ※APIトークンは、別途記載されている「APIトークンの発行」をご確認ください。

■URL例
https://app.rakurakuseikyu.jp/xxxxxx/api/v1/invoice_journals/output

◆app.rakurakuseikyu.jp　→利用するドメイン
◆xxxxxxx　　　　　　　　→利用するテナント
◆api/v1　　　　　　　　   →APIバージョンの指定
◆invoice_journals/output→API名

リクエスト

• ヘッダ

  ヘッダ	値	必須
  X-SK-apitoken	{APIトークン}	〇
  Content-Type	application/json	〇

   

• ボディ

（例）
curl -i -X 'POST' \ 
  'https://【ドメイン】/【テナント】api/v1/invoice_journals/output' \
  -H 'X-SK-apitoken: {APIトークン}'\
  -H 'Content-Type: application/json' \
  -d '{ 
        "isItemNameOutputted": true 
    }'

レスポンス

• ボディ

(例)
HTTP/1.1 200 
....

{
    "invoiceJournalOutputId": 1
}

計上仕訳データ作成状況確認API

• 通信方式：HTTPS

• メソッド：GET

• 文字コード：UTF-8

• URL：https://【ドメイン】/【テナント】/api/v1/invoice_journals/output/【invoiceJournalOutputId】

リクエスト

• ヘッダ

• パスパラメータ

（例）
curl -i -X 'GET' \
  https://【ドメイン】/【テナント】api/v1/masters/import/1 \
  -H 'X-SK-apitoken: {APIトークン}'\

レスポンス

• ボディ

（例）
HTTP/1.1 200 
....

{
    "status": 3,
    "finishedAt": "2026-01-22T12:30:50",
    "employee": {
        "code": "code1"
        "name": "営業太郎"
        "isDeleted": true
    },
    "outputFileSummaries": [
        {
            "journalOutputSettingName": "計上仕訳出力設定A",
            "expiredAt": "2026-02-28T23:59:59",
            "isDownloaded": false
        },
    ]
  }

計上仕訳データダウンロードAPI

• 通信方式：HTTPS

• メソッド：GET

• 文字コード：UTF-8

• URL：https://【ドメイン】/【テナント】/api/v1/invoice_journals/output/【invoiceJournalOutputId】/download

リクエスト

• ヘッダ

（記事ID：6010）