> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 会計

> Xero、QuickBooks Online、Rillet を接続して、得意先、仕入先、アイテム、請求書、請求、自動 GL 仕訳を外部元帳に反映し、為替レートを毎日更新します。

帳簿を **Xero**、**QuickBooks Online**、**Rillet** で管理している場合、会計連携は Alforse が転記した内容をその元帳にコピーし、入金を取り込みます。経理担当者は一度設定し、その後は同期の状態確認と残高の突合のために戻ってきます。Business プラン（または Partner）が必要です。

Paid

## データの流れ

### Alforse から元帳へ

**同期**をオンにすると、次のレコードがプロバイダーに送信されます。

* 得意先と仕入先
* アイテム
* 売上請求書と請求書（買掛）
* 自動 GL 仕訳。自動の転記はすべて反映されますが、ソースが `Manual` の仕訳は Alforse にとどまります。

NOTE

**仕訳は自動的に連動します**

追加の操作は不要です。**同期**がオンである限り、自動の GL 転記はそれぞれプロバイダーに届きます。スキップされるのは `Manual` ソースの仕訳だけです。

データの所有者は Alforse です。2 つのシステムの内容が食い違う場合は、Alforse 側が優先されます。各レコードは元帳側の対応レコードへの固定リンクを保持するため、再送信しても新規作成ではなく対応レコードの更新になります。

### 元帳から Alforse へ

プロバイダーで記録された入金は取り込まれます。それぞれ Alforse の入金となり、支払対象の請求書に対する請求書消込が作成され、その後 Alforse の総勘定元帳に転記されます。

| プロバイダー | 入金を Alforse に取り込む | Alforse で行った入金を受け付ける |
| - | - | - |
| Xero | はい | いいえ |
| QuickBooks Online | はい | いいえ |
| Rillet | はい | はい |

## 接続のセットアップ

Xero と QuickBooks Online は **OAuth** で接続します。Rillet は会社ごとに固有の **API キー**で接続します。

### プロバイダーに接続する

Xero または QuickBooks Online では OAuth のサインインを完了します。Rillet では、[Rillet の接続フィールド](#rillet-connection-fields)に記載の値を入力します。

### 同期がオフの間に設定する

新規の接続では**同期**がオフのため、作業中に何も送信されません。勘定科目マッピング、ディメンション、転記オプションを設定します（[同期設定](#sync-settings)を参照）。元帳にすでに得意先と仕入先がありますか？ その場合は今すぐ **Import customers & vendors**（得意先と仕入先をインポート）を実行します。同期がオフでも動作し、既存のレコードを紐づけるため、最初の同期では重複せずに更新されます。

### 同期をオンにする

連携の上部にある**同期**スイッチを使います。**勘定科目マッピング**で**必須**と示されたすべての勘定科目がマッピングされるまで、オンにできません。後でオフにすると同期は一時停止します。同じ組織に再接続した場合、スイッチは以前の位置を保持します。

### 既存のレコードを送信する

元帳にまだ対応レコードがないレコードは、**Push customers, vendors & items**（得意先、仕入先、アイテムを送信）で送信できます（Xero と Rillet）。それ以降は、変更が継続的に反映されます。

### Rillet の接続フィールド

| フィールド | 必須 | 説明 |
| - | - | - |
| **APIキー** | はい | 接続を認証します。シークレットとして保存されます。 |
| **Environment**（環境） | — | **Production**（`api.rillet.com`）または **Sandbox**（`sandbox.api.rillet.com`）。 |
| **Subsidiary ID**（子会社 ID） | いいえ | 複数エンティティの Rillet 元帳で、Alforse が転記する子会社（エンティティ）。 |
| **Webhook token** | いいえ | シークレット。設定するまで、Rillet の入金は Alforse に書き戻されません。 |

## 同期設定

接続そのものを保持する**設定**のほかに、各会計連携には 4 つのタブがあります。

### 勘定科目マッピング

Alforse の各転記勘定科目を、プロバイダーの勘定科目表の勘定コードと対応付けます。転記された仕訳は、対応付けた勘定科目に送られます。**AIで提案**と**コードで一致**でマップの大半が埋まり、残りの未マッピングの分を仕上げます。

### ディメンション

Alforse のディメンションを、プロバイダーのトラッキングスロットに割り当てます。Xero と QuickBooks はそれぞれ 2 つ提供しています。Rillet は動作が異なります。すべてのディメンションが各明細に付いて送られ、対応するフィールドは Rillet 側が自動でセットアップするため、スロットエディターは該当しません。

### 転記

| オプション | 決める内容 |
| - | - |
| **ソースタイプ** | 常に同期する転記済み仕訳の種類。種類ごとに**毎日のサマリー**をオンにすると、仕訳ごとではなく 1 日 1 件のプロバイダーエントリが送信されます。 |
| **売掛金/買掛金の表示** | 売掛金と買掛金を別々に設定します。**ドキュメント**は請求書そのものを送信し、**オフ — 同期外で処理**は対象から外します。 |
| **Books lock date**（帳簿ロック日） | 選択した日付。それより前の日付の新しいエントリは送信されないため、元帳でクローズ済みの期間はクローズされたままになります。 |

### 同期アクティビティ

[同期の監視](#monitoring-the-sync)を参照してください。

## 同期の監視

### 同期アクティビティタブ

1 つの操作が 1 行で、**ステータス**、**エンティティ**、**方向**、**トリガー**、**試行**、**最後の試行**、**エラー**が表示されます。使用できるアクションは次のとおりです。

| アクション | 用途 |
| - | - |
| ステータスフィルター | 一覧を絞り込みます。 |
| **再試行** / **スキップ** | 失敗した操作をもう一度試すか、スキップします。 |
| **再送信** | 完了した操作をもう一度送信します。 |
| **すべてを再試行** | すべての失敗を一度に再試行します。 |
| **CSVをエクスポート** | ステータスフィルターに一致するすべての操作を、文書番号、プロバイダー ID、完全なエラーとともにダウンロードします。 |

送信処理が完了しても失敗が残っている場合は、アプリ内通知が届きます。

### 同期一致レポート

毎週、照合処理が **会計 → レポート → 同期一致**を更新します。各行は会計期間、勘定科目、連携の組み合わせ 1 つに対応し、**Alforse転記済み**、**同期済み**、**プロバイダー**の 3 つの残高を並べて表示します。差異があれば**社内**と**社外差分**として表示されます。

TIP

**操作と残高**

同期アクティビティは「このレコードに何が起きたか」に答えます。同期一致は「この勘定科目と期間で元帳が一致しているか」に答えます。同期アクティビティから、その連携の同期一致サマリーへ移動できます。

## トラブルシューティング

| 症状 | 原因 | 対処 |
| - | - | - |
| **同期**をオンにできない | **勘定科目マッピング**で**必須**の勘定科目がマッピングされていません | マッピングしてから**同期**をオンにします |
| 得意先または仕入先が元帳で重複する | 同期の前に、既存の元帳レコードを紐づけていませんでした | 最初の同期の前に **Import customers & vendors** を実行します |
| Rillet の入金が Alforse に届かない | 接続に **Webhook token** がありません | トークンを入力します |
| 仕訳が元帳にない | ソースが `Manual` であるか、**Books lock date** より前の日付です | ソースとロック日を確認し、**同期アクティビティ**で該当の操作を探します |

## 為替レート

独立した為替レート連携には設定がありません。オンにすると、通貨レートが毎日 UTC の午前 0 時に更新されます。

NOTE

レートは **exchangeratesapi.io** から取得され、各会社の基準通貨で表されます。

## 関連

**請求書**

同期が元帳に送信する売上請求書と仕入請求書です。

[Open](https://docs.alforse.com/ja/docs/reference/invoices.md)

**会計リファレンス**

連携が反映する Alforse の転記です。

[Open](https://docs.alforse.com/ja/docs/reference/accounting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.