Xero를 OneSuite에 연결하기
중복 입력 없이 장부를 최신 상태로 유지하세요. Xero를 연결하면 OneSuite가 청구서를 확정할 때 자동으로 Xero 조직에 복사하고, 청구서가 결제되면 결제 내역을 기록합니다. 덕분에 회계가 항상 OneSuite 청구와 일치합니다.
이 연동이 하는 일
OneSuite가 청구 데이터를 Xero로 대신 전송합니다.
청구서가 자동으로 복사됩니다
OneSuite에서 청구서를 확정하면 Xero 조직에 동일한 청구서가 생성됩니다.
결제가 자동으로 기록됩니다
OneSuite에서 청구서를 결제 완료로 표시하면 선택한 결제 계정으로 Xero 청구서에 결제가 기록됩니다.
변경 사항도 동기화됩니다
이미 복사된 청구서를 수정하면 OneSuite가 변경 사항을 Xero로 다시 전송합니다.
이전 청구서도 필요할 때 복사
발송하지 않았거나 오래된 청구서를 언제든 수동으로 Xero에 보낼 수 있습니다.
주요 기능 및 이점
- 중복 입력 없음 — OneSuite에서 만든 청구서와 결제가 Xero에 자동으로 나타납니다.
- 올바른 계정으로 기표 — 청구서의 각 라인이 선택한 Xero 수익 계정에 기록됩니다(기본값은 200 - Sales).
- 계정 직접 선택 — 청구서 라인에 사용할 수익 계정과 결제가 입금될 계정을 지정할 수 있습니다.
- 클라이언트 추적(선택) — 각 청구서 라인에 클라이언트 이름이 설정된 Xero 추적 카테고리를 자동으로 태그해 클라이언트별 보고에 활용할 수 있습니다.
- 다중 통화 지원 — 청구서 통화가 Xero로 그대로 전달됩니다(조직에서 해당 통화가 활성화되어 있어야 합니다).
- 원클릭 보안 연결 — OAuth 2.0으로 연결하며, 자격 증명은 OneSuite에 저장되지 않습니다.
- 완전한 제어 — 결제 복사와 추적을 켜고 끌 수 있으며, 언제든 연결을 해제할 수 있습니다.
사전 준비
설정을 시작하기 전에 다음 사항을 확인하세요.
플랫폼
OneSuite
- 활성 상태의 OneSuite 비즈니스 계정
- 활성 상태의 OneSuite 구독
- 관리자 또는 설정 접근 권한
- 설정 → 연동 → 회계 접근 권한
연동
Xero
- 활성 상태의 Xero 조직
- 로그인할 수 있는 Xero 계정
- 앱 연결을 승인할 수 있는 권한
- Xero 설정 → 통화에 추가된 청구서 통화(외화는 다중 통화를 지원하는 Xero 요금제가 필요합니다)
설치
다음 네 단계로 Xero 조직을 OneSuite에 연결하세요. 설정에는 약 2분이 걸립니다.
-
연동에서 회계 열기
OneSuite에서 설정 → 연동 → 회계로 이동합니다. Xero 카드를 찾아 연결을 클릭하세요.
팁: 키보드 단축키 ⌘K를 눌러 ‘회계’를 검색하면 더 빠르게 이동할 수 있습니다.
-
Xero에서 OneSuite 승인하기
Xero가 동의 화면을 열어 Onesuite Accounting App이 조직에 연결된다는 사실을 확인시켜 주며, 연락처, 조직 설정, 청구서 및 관련 문서, 결제에 대한 접근 권한을 요청합니다. 권한을 확인하고 ‘조직 데이터’에 표시된 조직을 확인한 뒤 액세스 허용을 클릭하세요.
Xero 자격 증명은 OneSuite에 저장되지 않습니다. 연결에는 OAuth 2.0 토큰을 사용하며, Xero 설정의 연결된 앱에서 언제든지 OneSuite 연결을 해제할 수 있습니다.
-
계정을 선택하고 저장하기
OneSuite의 Xero 설정 페이지로 돌아옵니다. 기본 수익 계정, 결제 계정, 추적 카테고리 동작을 설정한 뒤 설정 저장을 클릭하세요.
OneSuite는 Xero의 표준 수익 계정인 200 - Sales를 미리 선택해 둡니다. 첫 청구서가 복사되기 전에 확인하거나 다른 계정을 선택하세요.
-
연결됨 상태 확인하기
다시 설정 → 연동 → 회계로 돌아오면 Xero 카드에 초록색 연결됨 배지와 함께, 언제든 설정을 다시 열 수 있는 톱니바퀴 아이콘이 표시됩니다.
설정할 수 있는 항목
Xero 설정 페이지에서 다음 항목을 지정할 수 있습니다.
- 기본 수익 계정
- Xero에서는 청구서의 모든 라인이 계정과목표의 한 계정에 기표됩니다. OneSuite는 Xero 품목이나 연락처에 이미 설정된 수익 계정을 사용하며, 설정된 것이 없으면 이 기본 수익 계정에 기록합니다. 따라서 계정이 없어서 복사가 실패하는 일은 없습니다. Xero의 표준 매출 계정은 200 - Sales이며 미리 선택되어 있습니다.
- 기본 결제 계정
- ‘결제 복사 대상’을 선택하고 결제가 입금될 Xero 계정을 지정하거나, ‘Xero로 결제를 복사하지 않음’을 선택해 결제 복사를 완전히 끌 수 있습니다(기본값은 꺼짐). Xero에서 결제용으로 활성화한 계정만 결제를 받을 수 있으므로 목록에는 그런 계정만 표시됩니다. 보통은 은행 계좌입니다.
- 추적 카테고리
- ‘클라이언트를 기준으로 Xero 추적 카테고리 채우기’를 선택하면 각 청구서 라인에 클라이언트 이름이 설정된 Xero 추적 카테고리가 태그됩니다(Xero에 없으면 자동으로 생성됩니다). 원하지 않으면 ‘클라이언트를 기준으로 Xero 추적 카테고리를 채우지 않음’을 선택하세요. 이 기능에는 Xero 조직에 활성 추적 카테고리가 필요합니다(설정 → 고급 → 추적 카테고리).
사용법
연결한 뒤 Xero는 두 가지 방식 중 하나로 동작합니다. 청구서가 조직 연결 전에 생성되었는지, 후에 생성되었는지에 따라 달라집니다.
새 청구서는 자동으로 동기화됩니다
Xero가 연결된 상태에서는 새로 만드는 청구서의 편집 화면의 저장 버튼 옆에 파란색 ‘Xero로 동기화 예정’ 배지가 표시됩니다. 동기화를 실행하는 것은 저장 클릭입니다. 청구서를 저장하면 Xero 조직에 동일한 청구서가 생성됩니다. 이후 결제 완료로 표시하면 선택한 결제 계정에 결제가 기록됩니다. 이미 동기화된 청구서를 수정하고 저장을 다시 클릭하면 변경된 내용도 함께 전송됩니다.
이전 청구서는 수동으로 복사합니다
Xero를 연결하기 전에 만든 청구서는 자동으로 동기화되지 않습니다. 복사하려면 청구서 목록에서 원하는 청구서를 찾아 해당 행의 점 세 개 메뉴(⋮)를 클릭하고 Xero로 복사를 선택하세요.
Xero에서 청구서가 보이는 방식
어느 경로든 결과는 같습니다. Xero 조직에 일반 청구서가 생성되며, 승인되어 결제 대기 상태로 다른 청구서와 마찬가지로 편집할 수 있습니다. 연락처, 청구서 번호, 날짜, 라인 항목, 합계가 모두 채워진 상태로 도착하고, 각 라인은 수익 계정에 기표됩니다.
복사되는 항목
청구서가 복사될 때 OneSuite가 전송하는 내용은 두 경로 모두 다음과 같습니다.
청구서
- 연락처(기존 Xero 연락처와 매칭하거나 필요 시 생성)
- 설명만 있는 라인 항목, 각각 기본 수익 계정에 기표
- 금액, 할인, 청구서 통화
- 만기일
- 클라이언트 이름이 설정된 선택적 추적 카테고리
결제
- 해당 Xero 청구서에 기록
- 선택한 결제 계정에 기표
어디에서 볼 수 있나요
설정 → 연동 → 회계
Xero 조직을 연결·설정·해제하고 현재 연결 상태를 확인할 수 있습니다.
청구서 목록(⋮ 메뉴)
발송하지 않았거나 오래된 청구서를 수동으로 보내는 Xero로 복사 작업입니다.
청구서 상세
해당 청구서의 Xero 동기화 상태와 이력을 확인해 무엇이 언제 복사되었는지 알 수 있습니다.
연결 해제
필요할 때 언제든 연결을 해제하세요.
-
OneSuite에서 연결 해제
설정 → 연동 → 회계로 이동해 Xero 설정을 열고, 오른쪽 상단의 Xero 연결 해제를 클릭한 뒤 확인하세요. 그러면 Xero 조직과의 연결이 즉시 취소됩니다.
문제 해결
자주 발생하는 문제와 해결 방법입니다.