JSON 파일에 담기는 내용
파일은 여러 페이지로 이루어진 하나의 문서를 나타냅니다. 추가한 이미지마다 페이지가 하나씩 생기고, 정한 순서대로 들어갑니다. 모든 페이지에 같은 기본 정보가 들어가고, 그 밖의 세부 정보는 어떤 모드로 읽었는지에 따라 달라집니다.
- 모든 페이지: 파일 이름에서 가져온 제목, 인식에 쓴 모드, 텍스트
- 표 페이지: 편집기에 보이는 표와 똑같은 행 목록. 각 행은 셀의 목록입니다.
- 영수증·인보이스 페이지: 항목 목록(각각 key, 읽기 쉬운 label, value)과 품목 목록
- 코드 페이지: Python이나 SQL처럼 알아낸 프로그래밍 언어가 있다면 그 이름
내보내기에는 편집기에서 마지막으로 손본 결과가 그대로 쓰이므로, 다운로드 전에 고친 내용이 파일에 반영됩니다.
영수증을 읽은 JSON 예시(일부)
영수증 모드로 읽은 페이지는 다음과 같습니다. 항목과 품목은 몇 개만 남기고 줄였습니다.
{
"title": "lunch-receipt",
"createdAt": "2026-10-03T12:30:00.000Z",
"pages": [
{
"title": "lunch-receipt",
"mode": "receipt",
"text": "Corner Cafe\nFlat white 2 3.50 7.00\n...",
"receipt": {
"kind": "receipt",
"currency": "USD",
"fields": [
{ "key": "merchant", "label": "Business", "value": "Corner Cafe" },
{ "key": "date", "label": "Date", "value": "03/14/2026" },
{ "key": "tax", "label": "Tax", "value": "1.12" },
{ "key": "total", "label": "Total", "value": "15.12" }
],
"items": [
{ "description": "Flat white", "qty": "2", "unitPrice": "3.50", "amount": "7.00" },
{ "description": "Chicken wrap", "qty": "1", "unitPrice": "7.00", "amount": "7.00" }
]
}
}
]
}
전체 구조를 가장 빨리 확인하는 방법은 이 페이지의 영수증 샘플을 읽은 뒤 JSON으로 다운로드해 보는 것입니다.
이미지 JSON 변환이 유용한 경우
- 경비 처리 파이프라인. 영수증을 한꺼번에 읽어 검토한 뒤 JSON 파일 하나로 내보내고, 직접 만든 스크립트로 날짜와 합계를 장부나 스프레드시트로 옮기세요. 깔끔한 영수증 사진을 찍는 요령은 영수증 OCR 페이지에 있습니다.
- 데이터 입력. 인쇄된 서식, 가격표, 인보이스의 값을 다른 시스템에 넣어야 할 때는 텍스트 덩어리보다 이름 붙은 항목이 연결하기 훨씬 쉽습니다.
- 테스트 데이터. 영수증, 표, 스캔한 텍스트를 다루는 기능을 개발한다면, 실제 OCR이 낼 법한 오류까지 담긴 결과를 파서와 검증 코드의 테스트 데이터(fixture)로 쓸 수 있습니다.
- 구조를 살린 보관. 텍스트와 함께 모드와 항목을 남겨 두면 오래된 스캔본을 나중에 다시 처리하기가 쉬워집니다.
스프레드시트의 행과 열이 필요한 것이라면 이미지 엑셀 변환이 더 적은 단계로 해결해 줍니다.
코드에서 값 다루기
값은 숫자나 날짜로 변환되지 않고, 인쇄된 그대로 읽은 텍스트로 저장됩니다. 영수증이 어디서 발행됐는지에 따라 날짜는 03/14/2026일 수도, 14.03.2026이나 2026-03-14일 수도 있고, 금액은 1,250.00일 수도 1.250,00일 수도 있습니다. 예상하는 형식으로 파싱하고, 어디에도 맞지 않는 값은 사람이 확인하도록 표시해 두세요.
모든 항목이 있다고 가정해서도 안 됩니다. 팁 줄이 없는 영수증에는 팁 항목이 없고, 흐려진 영수증에는 날짜가 빠져 있을 수 있습니다. 목록 안의 위치가 아니라 key로 항목을 찾으면 일부 항목이 없어도 코드가 계속 작동합니다. key는 merchant, date, total 같은 영문 식별자이고, 자동으로 찾은 항목의 label도 위 예시처럼 영어로 기록됩니다.
합계를 코드로 검증해 두는 것도 좋습니다. 품목 금액의 합은 소계와 같아야 하고, 소계에 세금을 더하고 할인을 뺀 값은 합계와 같아야 합니다. 맞지 않는다면 무언가 잘못 읽혔을 가능성이 높습니다.
API 없이 브라우저에서 처리
인식은 오픈소스 Tesseract 엔진을 사용해 내 기기의 브라우저 안에서 이루어집니다. 이미지는 업로드되지 않으며 JSON 파일도 내 기기에서 만들어집니다.
그래서 호출할 API도, 이미지를 보낼 서버 엔드포인트도 없습니다. 이미지 JSON 변환은 직접 하는 작업입니다. 이미지를 추가하고, 결과를 확인하고, 파일을 다운로드합니다. 어차피 사람이 데이터를 검토하는 작업에 잘 맞으며, 이미지를 백그라운드에서 자동으로 처리하는 용도는 아닙니다. 이미지가 텍스트가 되기까지 어떤 일이 일어나는지 궁금하다면 OCR의 원리를 읽어 보세요.