Pixiu 내역 가져오기
📋 개요
이 가이드는 Pixiu에서 내보낸 거래 내역(CSV)을 코알라 가계부로 가져오는 방법을 안내합니다.
코알라 가계부는 현재 Pixiu CSV 내보내기 파일만 지원합니다(CSV 전용).
📱 1단계: Pixiu에서 내역 내보내기
Pixiu는 버전에 따라 메뉴명이 조금 다를 수 있지만 흐름은 같습니다. “데이터 내보내기/내역 내보내기”에서 기간을 선택한 뒤 CSV로 저장하세요.
단계 1: 내보내기 메뉴 찾기
- Pixiu 앱을 엽니다
- 我的로 이동합니다
- 数据导出 / 导出账单(표기 다를 수 있음)을 찾습니다
단계 2: 기간 선택
- 기간(예: 최근 1개월/최근 3개월)을 선택합니다
- 확인 후 내보내기를 시작합니다
💡 팁:
- 한 번에 3개월 이내로 내보내는 것을 권장합니다(파일이 커지면 파싱이 느려질 수 있습니다).
- 데이터가 많다면 여러 파일로 나눠서 내보낸 뒤 순서대로 가져오세요.
단계 3: CSV로 저장
- 내보내기 형식은 CSV를 선택합니다
- 파일을 기기에 저장합니다(공유 → 파일에 저장 등)
- 저장 위치를 기억해 둡니다
📱 2단계: 코알라 가계부로 가져오기
단계 1: 가져오기 화면 열기
- 코알라 가계부 앱을 엽니다
- 하단의 설정을 탭합니다
- 내역 가져오기를 찾아 들어갑니다
단계 2: 가져오기 소스 선택
- 가져오기 소스를 탭합니다
- Pixiu를 선택합니다
⚠️ 중요: 반드시 Pixiu를 선택해야 합니다. 소스를 잘못 선택하면 검증이 실패하거나 필드가 잘못 읽힐 수 있습니다.
단계 3: 파일 선택
- 파일 경로를 탭합니다
- Pixiu에서 내보낸 CSV를 선택합니다
- 파일명이 표시되는지 확인합니다
단계 4: 장부 연결
- 장부 연결을 탭합니다
- 가져올 장부를 선택합니다
단계 5: 파싱 및 미리보기
- 우측 상단의 파싱을 탭합니다
- 파싱 성공 시 미리보기 화면으로 이동합니다
- 미리보기에서 건별 편집이 가능하며, 길게 누르면 다중 선택으로 일괄 삭제할 수 있고, “가져오기” 시 “유효한 데이터만 가져오기”를 선택할 수 있습니다
단계 6: 가져오기 실행
- 확인이 끝나면 가져오기를 탭합니다
- 완료될 때까지 기다립니다
📋 Pixiu CSV 형식(참고)
코알라 가계부는 Pixiu CSV를 아래 기준으로 인식합니다.
- 헤더 행은 파일 앞쪽 몇 줄 안에 있어야 하며, 시스템이 헤더 이름으로 열을 자동 인식합니다(열 순서와 무관)
- 구분자는 쉼표
,입니다(표준 CSV) - 아래 표는 Pixiu 내보내기에서 흔히 쓰이는 필드와 의미입니다. 헤더 이름이 대응되면 순서가 달라도 인식됩니다
필드 정의
| 필드 | 설명 |
|---|---|
| 날짜 | yyyy-MM-dd / yyyy/MM/dd 지원. 연도는 2016 이상이어야 하며, 아니면 유효하지 않은 날짜로 처리됩니다 |
| 상위 카테고리(수입지출 대분류) | 코알라 가계부의 상위 카테고리명 매칭에 사용됩니다 |
| 거래 분류 | “支出”(지출) 또는 “收入”(수입) 키워드를 포함해야 합니다. “收入”이 포함되면 수입으로, 그 외는 지출로 가져옵니다 |
| 하위 카테고리 | 코알라 가계부의 하위 카테고리명 매칭에 사용됩니다 |
| 유입 금액 | 수입 금액 열(- 포함 가능, 가져오기 시 부호는 제거됩니다) |
| 유출 금액 | 지출 금액 열(- 포함 가능, 가져오기 시 부호는 제거됩니다) |
| 통화 코드 | CNY / USD 등. 비어 있으면 장부 기본 통화를 사용합니다 |
| 계좌 | 계좌명(이름으로 매칭, 없으면 가져오기 중 생성될 수 있음) |
| 태그 | 여러 태그는 쉼표로 구분(,), 중국어 쉼표 ，도 지원 |
| 메모 | 메모 텍스트 |
코알라 가계부로의 매핑(개요)
- 날짜 → 날짜
- 유형 → 수입/지출
- 상위+하위 카테고리 → 카테고리(매칭 실패 시 미리보기에서 "미완성"으로 표시됨)
- 유입/유출 금액 → 금액(유형에 따라 참조 열이 결정됨)
- 계좌 → 계좌
- 태그 → 태그(이름으로 매칭/생성 후 연결)
- 메모 → 메모
- 통화 코드 → 통화(코드로 매칭, 실패 시 장부 통화로 대체)
⚠️ 유의사항
- 자동 중복 제거 없음: 같은 파일을 두 번 가져오면 중복 내역이 생성됩니다. 동일 기간을 반복해서 가져오지 않도록 주의하세요.
- 카테고리 매칭: “상위+하위” 이름으로 매칭합니다. 매칭되지 않으면 미리보기에서 수정 후 가져오세요.
- 계좌 유효성: 계좌명이 비어 있거나 기호만 있는 경우 무효로 처리되어 보완이 필요할 수 있습니다.
- 인코딩: UTF-8/GBK를 지원합니다. 글자가 깨지면 UTF-8로 다시 내보내거나 인코딩을 변환해 다시 시도하세요.
🔧 자주 묻는 질문
Q1: “헤더를 찾을 수 없음” 또는 열을 인식할 수 없음?
A: 시스템은 헤더 이름으로 열을 인식합니다. 흔한 원인:
- Pixiu에서 내보낸 CSV가 아니거나, 헤더 이름이 변경됨
- Excel/WPS에서 2차 편집하면서 헤더를 바꾸거나 열을 삭제/추가함
- 호환되지 않는 CSV로 저장(예: 세미콜론 구분)
- 헤더 이름이 “날짜/거래 분류/금액” 등의 필드에 대응되지 않음
Q2: 금액이 0이 되거나 이상합니다.
확인:
- “유형” 열에 “支出/收入” 키워드가 포함되어 있는지(유입/유출 중 어떤 열을 읽을지 결정)
- 해당 금액 열이 숫자 형식인지(
-는 허용, 가져오기 시 제거)
Q3: 카테고리가 매칭되지 않습니다.
미리보기에서 단건으로 올바른 카테고리를 선택해 주세요. 또는 코알라 가계부에 Pixiu 내보내기와 같은 이름의 카테고리를 먼저 만든 뒤 다시 파싱하세요.
마지막 업데이트: 2026년 9월