> ## 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에 있습니다. 두 시스템의 내용이 다르면 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) | — | **프로덕션**(`api.rillet.com`) 또는 **샌드박스**(`sandbox.api.rillet.com`). |
| **자회사 ID**(Subsidiary ID) | 아니요 | 다중 법인 Rillet 원장에서 Alforse가 전기하는 자회사(법인)입니다. |
| **웹훅 토큰**(Webhook token) | 아니요 | 비밀 값입니다. 이 값을 설정하기 전에는 Rillet 지불 내역이 Alforse에 다시 기록되지 않습니다. |

## 동기화 설정

연결 자체를 담는 **설정** 옆에, 각 회계 연동에는 네 개의 탭이 있습니다.

### 계정 매핑

각 Alforse 전기 계정을 공급자 계정과목표의 계정 코드와 짝지웁니다. 전기된 전표는 짝지은 계정으로 전달됩니다. **AI로 제안**(Suggest with AI)과 **코드로 일치**(Match by code)가 매핑의 대부분을 채우며, 매핑되지 않고 남은 항목은 직접 완료합니다.

### 차원

Alforse 차원을 공급자의 추적 슬롯에 할당합니다. Xero와 QuickBooks는 각각 두 개를 제공합니다. Rillet은 다르게 작동합니다. 모든 차원이 각 라인에 담겨 전달되고 Rillet이 일치하는 필드를 직접 설정하므로 슬롯 편집기는 적용되지 않습니다.

### 전기

| 옵션 | 결정하는 내용 |
| - | - |
| **출처 유형** | 항상 동기화할 전기 전표 유형입니다. 유형에 **매일 요약**을 켜면 전표마다 하나가 아니라 하루에 공급자 항목 하나를 보냅니다. |
| **AR / AP 표현** | 미수금과 미지급금을 각각 설정합니다. **문서**는 송장 또는 청구서 자체를 보내고, **끔 — 동기화 외부에서 처리**는 제외합니다. |
| **장부 잠금일** | 사용자가 고르는 날짜입니다. Alforse는 이보다 이른 날짜의 새 항목을 보내지 않으므로 원장에서 마감된 기간은 마감된 상태로 유지됩니다. |

### 동기화 활동

[동기화 모니터링](#monitoring-the-sync)을 참조하십시오.

## 동기화 모니터링

### 동기화 활동 탭

작업마다 한 행이 있으며 **상태**, **개체**, **방향**, **트리거**, **시도**, **마지막 시도**, **오류**를 표시합니다. 사용할 수 있는 작업은 다음과 같습니다.

| 작업 | 용도 |
| - | - |
| 상태 필터 | 목록을 좁힙니다. |
| **재시도** / **건너뛰기** | 실패한 작업을 다시 시도하거나 건너뜁니다. |
| **다시 보내기** | 완료된 작업을 다시 보냅니다. |
| **모두 다시 시도** | 모든 실패 건을 한 번에 다시 시도합니다. |
| **CSV 내보내기** | 상태 필터와 일치하는 모든 작업을 문서 번호, 공급자 ID, 전체 오류와 함께 다운로드합니다. |

발신 실행이 끝났는데도 실패 건이 남아 있으면 앱 내 알림이 표시됩니다.

### 동기화 대조(Tie-Out) 보고서

매주 대사 작업이 **회계 → 보고서 → 동기화 대조**(Sync Tie-Out)를 채웁니다. 각 행은 회계 기간, 계정, 연동의 조합 하나이며 **Alforse 전기**(Alforse Posted), **동기화됨**(Synced), **공급자**(Provider)의 세 잔액을 나란히 보여 주고, 차이는 **내부**(Internal)와 **외부 차이**(External Delta)로 표시합니다.

TIP

**작업과 잔액**

동기화 활동은 "이 레코드에 무슨 일이 있었는가?"에 답합니다. 대조 보고서는 "이 계정과 기간의 원장이 일치하는가?"에 답합니다. 동기화 활동에서 연동의 대조 요약으로 바로 이동할 수 있습니다.

## 문제 해결

| 증상 | 원인 | 해결 방법 |
| - | - | - |
| **동기화**가 켜지지 않습니다 | **계정 매핑**의 **필수** 계정에 매핑이 없습니다 | 매핑한 다음 **동기화**를 켜십시오 |
| 원장에 고객 또는 공급업체가 중복되었습니다 | 동기화 전에 기존 원장 레코드를 연결하지 않았습니다 | 첫 동기화 전에 **고객 및 공급업체 가져오기**를 실행하십시오 |
| Rillet 지불 내역이 Alforse에 도착하지 않습니다 | 연결에 **웹훅 토큰**이 없습니다 | 토큰을 입력하십시오 |
| 원장에 전표가 없습니다 | 출처가 `Manual`이거나 **장부 잠금일**보다 이전 날짜입니다 | 출처와 잠금일을 확인하고 **동기화 활동**에서 해당 작업을 찾으십시오 |

## 환율

별도의 환율 연동에는 설정이 없습니다. 켜기만 하면 통화 환율이 매일 UTC 자정에 갱신됩니다.

NOTE

환율은 **exchangeratesapi.io**에서 가져오며 각 회사의 기준 통화로 표시됩니다.

## 관련 문서

**송장**

동기화가 원장으로 보내는 매출 및 매입 송장입니다.

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

**회계 레퍼런스**

연동이 미러링하는 Alforse 전기 내용입니다.

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


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