# JDL 가이드

## 개요

JDL (株式会社日本デジタル研究所)은 일본의 대표적인 회계 소프트웨어 및 세무 시스템 제공 업체입니다. 주로 세무사 사무소와 기업의 회계 업무를 지원합니다.

- **공식 사이트**: https://www.jdl.co.jp/
- **주요 제품**: JDL IBEX 시리즈 (회계, 급여, 원장 등)

## 주요 제품

### 1. JDL IBEX 회계 시리즈
- **JDL IBEX 회계**: 설치형 회계 소프트웨어
- **JDL IBEX 회계 net**: 클라우드 회계 소프트웨어
- **JDL IBEX 출납장 net**: 간편 회계 소프트웨어

### 2. JDL IBEX 재무
- 본격적인 재무 관리 시스템
- 회계사무소용 전문 소프트웨어

### 3. JDL AI 시리즈
- **JDL AI-OCR PLUS**: AI를 활용한 증빙 자동 입력
- **JDL AI 분개**: AI 기반 자동 분개 기능

## API 제공 여부

JDL은 **직접적인 REST API를 공개하지 않습니다**. 대신 다음과 같은 데이터 연동 방법을 제공합니다:

### 1. CSV 가져오기/내보내기
- CSV 형식으로 데이터 가져오기 및 내보내기 지원
- JDL IBEX 출납장 net CSV 입출력 옵션 (연 1,300엔)

### 2. JDL 은행 API 서비스
- 금융기관 API를 통한 거래 명세 자동 수집
- AI 분개와 연동하여 자동 계정과목 예측

### 3. Web POSTBOX
- 회계사무소와의 데이터 교환 도구
- 안전한 데이터 송수신

### 4. 회계사무소 연계
- 고문 회계사무소와의 직접 데이터 연계

## freee에서 JDL로 데이터 이동

### freee의 JDL 형식 출력 기능

freee는 JDL 형식으로 분개장을 출력할 수 있습니다.

#### 출력 절차

1. freee 관리 화면 로그인
2. 회계 > 분개장 선택
3. 기간 및 조건 설정
4. [가져오기/내보내기] 클릭
5. "CSV/PDF 내보내기 (구)" 선택
6. 출력 형식: **JDL** 선택
7. CSV 파일 다운로드

#### 대응 형식

- **JDL IBEX 회계 net** 대응
- **JDL IBEX 출납장 net** 대응

### JDL로 가져오기

#### 1. JDL IBEX 회계 net

```
1. JDL IBEX 회계 net 로그인
2. 데이터 > CSV 가져오기 선택
3. freee에서 내보낸 CSV 파일 선택
4. 가져오기 실행
5. 데이터 검증 및 확인
```

#### 2. JDL IBEX 출납장 net

```
1. CSV 입출력 옵션 가입 필요 (연 1,300엔)
2. 데이터 연동 > CSV 가져오기
3. CSV 파일 업로드
4. 데이터 매핑 확인
5. 가져오기 완료
```

### 주의사항

1. **보조과목 매핑**: freee의 계정과목과 JDL의 계정과목 코드 매핑 필요
2. **데이터 형식**: CSV 형식이 완전히 일치하지 않을 수 있음
3. **수동 조정**: 일부 거래는 수동 조정이 필요할 수 있음
4. **사전 설정**: JDL에 계정과목, 보조과목, 거래처 등 사전 등록 필요

## Google Apps Script로 JDL 연동

JDL은 공개 API가 없으므로, CSV를 통한 간접 연동만 가능합니다.

### 1. freee에서 JDL 형식 CSV 생성

```javascript
// code.gs

// freee API로 분개 데이터 조회 후 JDL CSV 형식으로 변환
function exportFreeeToJDLFormat() {
  // freee에서 거래 데이터 가져오기 (freee_api_usage.md 참조)
  const deals = getFreeeDeals('2025-10-01', '2025-10-31');

  if (!deals || deals.length === 0) {
    Logger.log('데이터가 없습니다.');
    return;
  }

  // JDL CSV 형식으로 변환
  const jdlData = convertToJDLFormat(deals);

  // CSV 파일 생성
  const csvContent = createJDLCSV(jdlData);

  // Google Drive에 저장
  const fileName = 'JDL_Import_' + Utilities.formatDate(new Date(), 'JST', 'yyyyMMdd') + '.csv';
  DriveApp.createFile(fileName, csvContent, MimeType.CSV);

  Logger.log('JDL CSV 파일이 생성되었습니다: ' + fileName);
}
```

### 2. freee 데이터를 JDL 형식으로 변환

```javascript
// freee 거래 데이터를 JDL CSV 형식으로 변환
function convertToJDLFormat(deals) {
  const jdlData = [];

  deals.forEach(deal => {
    // JDL 형식으로 매핑
    // 실제 JDL CSV 형식에 맞게 조정 필요
    const row = {
      date: deal.issue_date,           // 날짜
      debitAccount: deal.details[0].account_item_name,  // 차변 계정과목
      debitAmount: deal.details[0].amount,              // 차변 금액
      creditAccount: deal.details[1].account_item_name, // 대변 계정과목
      creditAmount: deal.details[1].amount,             // 대변 금액
      description: deal.description || '',              // 적요
      partnerName: deal.partner_name || ''              // 거래처명
    };

    jdlData.push(row);
  });

  return jdlData;
}
```

### 3. JDL CSV 파일 생성

```javascript
// JDL CSV 형식으로 파일 생성
function createJDLCSV(data) {
  // JDL CSV 헤더 (실제 JDL 형식에 맞게 조정 필요)
  const header = [
    '日付',
    '借方科目コード',
    '借方科目名',
    '借方金額',
    '貸方科目コード',
    '貸方科目名',
    '貸方金額',
    '摘要',
    '取引先'
  ];

  const rows = [header];

  data.forEach(row => {
    rows.push([
      row.date,
      '', // 차변 계정과목 코드 (JDL에서 설정 필요)
      row.debitAccount,
      row.debitAmount,
      '', // 대변 계정과목 코드 (JDL에서 설정 필요)
      row.creditAccount,
      row.creditAmount,
      row.description,
      row.partnerName
    ]);
  });

  // CSV 문자열 생성
  return rows.map(row => row.join(',')).join('\n');
}
```

### 4. freee 분개장 자동 내보내기

```javascript
// freee API를 사용하지 않고 freee 화면에서 직접 내보내기
// (freee에서 JDL 형식 내보내기 기능 사용)

function downloadFreeeJournalForJDL() {
  // 이 방법은 freee 웹 UI를 통해 수동으로 수행해야 합니다
  // 1. freee 로그인
  // 2. 회계 > 분개장
  // 3. [가져오기/내보내기] > CSV/PDF 내보내기
  // 4. 형식: JDL 선택
  // 5. 다운로드

  Logger.log('freee 웹 UI에서 JDL 형식으로 내보내기를 수행하세요.');
  Logger.log('자동화하려면 freee API를 사용하여 데이터를 가져온 후 JDL 형식으로 변환합니다.');
}
```

### 5. Google Drive에서 JDL CSV 관리

```javascript
// Google Drive의 JDL CSV 파일 목록 조회
function listJDLCSVFiles() {
  const folder = DriveApp.getFoldersByName('JDL_Exports').next();
  const files = folder.getFilesByType(MimeType.CSV);

  const fileList = [];
  while (files.hasNext()) {
    const file = files.next();
    fileList.push({
      name: file.getName(),
      id: file.getId(),
      created: file.getDateCreated(),
      size: file.getSize()
    });
  }

  Logger.log(`${fileList.length}개의 JDL CSV 파일이 있습니다.`);
  return fileList;
}

// 최신 JDL CSV 파일 가져오기
function getLatestJDLCSV() {
  const files = listJDLCSVFiles();

  if (files.length === 0) {
    Logger.log('JDL CSV 파일이 없습니다.');
    return null;
  }

  // 생성일 기준 정렬
  files.sort((a, b) => b.created - a.created);

  const latestFile = DriveApp.getFileById(files[0].id);
  Logger.log('최신 파일: ' + latestFile.getName());

  return latestFile;
}
```

### 6. JDL 가져오기 준비 체크리스트

```javascript
// JDL 가져오기 전 확인사항
function checkJDLImportReadiness() {
  const checklist = {
    accountMapping: false,  // 계정과목 매핑 완료
    subsidiarySetup: false, // 보조과목 설정 완료
    partnerSetup: false,    // 거래처 등록 완료
    csvFormat: false        // CSV 형식 확인 완료
  };

  // 체크리스트 출력
  Logger.log('=== JDL 가져오기 체크리스트 ===');
  Logger.log(`1. 계정과목 매핑: ${checklist.accountMapping ? '완료' : '미완료'}`);
  Logger.log(`2. 보조과목 설정: ${checklist.subsidiarySetup ? '완료' : '미완료'}`);
  Logger.log(`3. 거래처 등록: ${checklist.partnerSetup ? '완료' : '미완료'}`);
  Logger.log(`4. CSV 형식 확인: ${checklist.csvFormat ? '완료' : '미완료'}`);

  return checklist;
}
```

## freee와 JDL 연동 워크플로우

### 권장 워크플로우

```
1. freee에서 회계 데이터 관리
   ↓
2. 월말 정산 시 freee에서 JDL 형식 CSV 내보내기
   ↓
3. (선택) Google Apps Script로 데이터 가공
   ↓
4. JDL IBEX 회계 net으로 CSV 가져오기
   ↓
5. 세무사 사무소에서 JDL로 최종 확인 및 신고
```

### 자동화 가능 범위

1. **자동화 가능**:
   - freee API로 데이터 조회
   - JDL 형식 CSV 생성
   - Google Drive에 저장

2. **수동 작업 필요**:
   - freee에서 JDL 형식 직접 내보내기 (더 안정적)
   - JDL로 CSV 가져오기
   - 데이터 검증 및 조정

## JDL 은행 API 서비스

JDL은 자체적으로 은행 API 서비스를 제공합니다.

### 기능

- 금융기관 API를 통한 거래 명세 자동 수집
- AI-OCR PLUS와 연동하여 자동 분개
- AI가 계정과목 자동 예측

### 대응 금융기관

- 일본 주요 은행
- 신용금고
- 신용조합
- 기타 제휴 금융기관

### 비용

- 기본 서비스 이용료
- 금융기관별 연동 수수료 (별도 확인 필요)

## 주의사항

1. **API 미제공**: JDL은 공개 REST API를 제공하지 않음
2. **CSV 의존**: 데이터 연동은 주로 CSV 가져오기/내보내기로 수행
3. **형식 차이**: freee와 JDL의 CSV 형식이 완전히 일치하지 않을 수 있음
4. **수동 작업**: 일부 데이터 조정 및 검증은 수동으로 수행 필요
5. **세무사 확인**: 최종 데이터는 세무사의 확인 필요

## Gemegg 프로젝트에서의 JDL 활용

### 제안된 연동 방식 (PDF 5페이지 참조)

> "税理士へのデータ連携も容易：freeeから仕訳帳をCSV出力し、JDLへ簡単に取り込み可能"

### 권장 프로세스

1. **일상 업무**: freee에서 거래 입력 및 관리
2. **월차 정산**: freee에서 분개 완료 (익월 10일까지)
3. **세무사 전달**: freee에서 JDL 형식 CSV 출력
4. **세무사 작업**: JDL로 CSV 가져오기 및 최종 확인
5. **세무 신고**: JDL에서 신고서 작성 및 제출

## 참고 링크

- JDL 공식 사이트: https://www.jdl.co.jp/
- JDL IBEX 회계 net: https://www.jdlibex.net/ac-net/
- JDL 은행 API 서비스: https://www.jdl.co.jp/bank-api/
- freee에서 JDL로 출력: https://support.freee.co.jp/hc/ja/articles/204614914