CLI

npm install -g @bolta-io/cli

# 방법 1: 환경변수 (권장)
export BOLTA_API_KEY="test_your_key"

# 방법 2: CLI 명령 (영구 저장 - ~/.bolta/config.json)
bolta config set api-key test_your_key

# 연결 테스트
bolta config test

# 발급자 등록
bolta issuer create --data '{
  "identificationNumber": "1234567890",
  "organizationName": "주식회사 테스트",
  "representativeName": "홍길동"
}'

# 발급자 조회
bolta issuer get <issuerId>

# 인증서 등록 URL 조회
bolta certificate url <issuerId>

# 인증서 등록 상태 조회
bolta certificate status <issuerId>

# 인증서 해제
bolta certificate deregister <issuerId>

# 세금계산서 정발행
bolta invoice issue --data '{
  "date": "YYYY-MM-DD",
  "purpose": "CLAIM",
  "taxType": "TAXABLE",
  "supplier": {
    "identificationNumber": "1234567890",
    "organizationName": "공급자 주식회사",
    "representativeName": "김공급",
    "manager": { "email": "supplier@example.com" }
  },
  "supplied": {
    "identificationNumber": "0987654321",
    "organizationName": "공급받는자 주식회사",
    "representativeName": "이고객",
    "managers": [{ "email": "buyer@example.com" }]
  },
  "items": [{
    "date": "YYYY-MM-DD",
    "name": "소프트웨어 개발 용역",
    "supplyCost": 1000000,
    "tax": 100000
  }]
}'

# 외국인등록번호 공급받는자 정발행 샘플 조회
# CLI는 식별번호의 하이픈과 공백을 제거해 처리합니다.
# 최상위 description은 빼거나 null로 두고, 여권번호는 사용할 수 없습니다.
bolta examples invoice-issue-foreign-supplied

# 세금계산서 역발행 요청 (공급받는자는 사업자등록번호만 허용)
bolta invoice issue-request --data '{...}'

# 세금계산서 조회
bolta invoice get <issuanceKey>

# Client-Reference-Id로 상태 조회
bolta invoice status --reference-id <id>

# 수정발행: 계약 해제
bolta invoice amend termination <issuanceKey> --date YYYY-MM-DD

# 수정발행: 공급가액 변동
bolta invoice amend change-supply-cost <issuanceKey> --data '{
  "date": "YYYY-MM-DD",
  "taxType": "TAXABLE",
  "items": [{
    "date": "YYYY-MM-DD",
    "name": "가격 조정",
    "supplyCost": -200000,
    "tax": -20000
  }]
}'

# 수정발행: 착오에 의한 이중발급
bolta invoice amend double-issuance <issuanceKey>

bolta config set <key> <value>   # api-key, base-url
bolta config show                # 현재 설정 확인
bolta config test                # API 연결 테스트

# 인라인 JSON (AI 에이전트 권장)
bolta invoice issue --data '{"date":"YYYY-MM-DD", ...}'

# 파일 참조
bolta invoice issue --file invoice.json

# 파이프 입력
cat invoice.json | bolta invoice issue --stdin

// 성공 (exit code 0)
{ "success": true, "data": { ... } }

// 실패 (exit code 1)
{ "success": false, "error": { "code": "...", "message": "...", "suggestion": "..." } }

# 사용 가능한 예제 목록
bolta examples

# 정발행 샘플 JSON 조회
bolta examples invoice-issue

# 외국인등록번호 공급받는자 정발행 샘플 JSON 조회
bolta examples invoice-issue-foreign-supplied

# 정발행 입력 스키마 조회
bolta schema invoice-issue