Cash Position 자동 업데이트

3개 법인(한국/미국/베트남) 은행 잔액·입출금을 조회하여 Google Sheets Cash Position Summary를 업데이트하는 스킬.

데이터 소스별 자동화 현황

법인	은행	소스	자동화	옵션
US	Chase (checking ...6797)	Plaid API	자동 (CSV 불필요)	`--plaid`
US	Hanmi (checking ...3389)	Plaid API	자동 (CSV 불필요)	`--plaid`
KR	농협/우리/신한 등	Clobe.ai 엑셀	수동 다운로드 필요	`--clobe`
VN	우리은행 베트남	우리은행 xls	수동 다운로드 필요	`--vietnam`
VN	Techcombank	CSV	수동 다운로드 필요	`--techcombank`

핵심 스크립트

scripts/parse_cash_position.py

실행 환경: /Users/ash/Documents/eoash/.venv/bin/python (plaid, pandas, dotenv 설치됨)

사용법

1. 미국만 (Plaid API — 파일 다운로드 불필요)

/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
  --plaid --month {YYYY.MM} [--dry-run] [--skip-revenue]

사용자가 "미국 잔액", "US cash" 등 미국만 언급하면 이 모드 사용.

2. 전체 3개 법인 (미국 자동 + 한국/베트남 파일)

/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
  --plaid \
  --clobe ~/Downloads/주식회사*.xlsx \
  --vietnam ~/Downloads/ExcelSheet*.xls \
  --month {YYYY.MM}

사용자가 "캐시 포지션 업데이트", "전체 잔액" 등 전체를 요청하면:

미국: --plaid로 자동 조회
한국: Clobe.ai에서 엑셀 다운로드했는지 확인 → 파일 경로 요청
베트남: 우리은행에서 xls 다운로드했는지 확인 → 파일 경로 요청

3. CSV 방식 (레거시 — Plaid 장애 시 fallback)

/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
  --chase ~/Downloads/Chase*.CSV \
  --hanmi ~/Downloads/AccountHistory.csv \
  --clobe ~/Downloads/주식회사*.xlsx \
  --month {YYYY.MM}

Plaid API 장애 시에만 사용. Chase/Hanmi 웹뱅킹에서 CSV 직접 다운로드 필요.

실행 흐름

사용자가 월을 지정하지 않으면 현재 월(YYYY.MM)을 자동 사용
먼저 --dry-run으로 실행하여 결과 확인 (사용자에게 보여주기)
사용자가 확인하면 --dry-run 없이 재실행하여 Google Sheets 실제 업데이트
결과 요약: 각 법인 잔액, 입출금, US 합산, 환율

주요 옵션

옵션	설명
`--plaid`	Chase/Hanmi를 Plaid API로 조회 (CSV 불필요)
`--clobe`	한국 Clobe.ai 엑셀 파일 경로 (수동 다운로드)
`--vietnam`	우리은행 베트남 xls 경로 (수동 다운로드)
`--techcombank`	Techcombank 베트남 CSV 경로 (수동 다운로드)
`--month`	대상 월 (예: 2026.03) — 필수
`--skip-revenue`	미국 매출/한국 미수금 업데이트 건너뜀
`--dry-run`	시트 업데이트 없이 결과만 출력
`--extra-kr-balance`	클로브에 없는 한국 계좌 잔액 수동 추가

환경변수 (.env)

스크립트가 자동으로 프로젝트 루트 .env를 로드함:

PLAID_CLIENT_ID / PLAID_SECRET / PLAID_ENV=production
PLAID_ACCESS_TOKEN_CHASE — Chase PLAT BUS CHECKING ...6797
PLAID_ACCESS_TOKEN_HANMI — Hanmi Business Regular Checking ...3389
Google Sheets SA: finance-dashboard/.env.local

주의사항

--dry-run 없이 실행하면 Google Sheets가 직접 수정됨 — 반드시 먼저 dry-run
Plaid access_token은 영구 토큰이지만, 은행 비밀번호 변경 시 재연결 필요
한국/베트남은 Plaid 미지원 → 파일 다운로드 필수 (자동화 불가)
은행 재연결 필요 시: python scripts/plaid_link_connect.py → localhost:8484

my-cash-position