@bolta-io/cli 0.3.0 → 0.4.1

package/llms.txt

@@ -31,7 +31,7 @@ Bolta API는 사전 충전 포인트 차감 방식 유료 서비스입니다.
 - 포인트 충전: https://developers.bolta.io 개발자센터
 
 ### 개념 안내 커맨드
-bolta guide                 주요 개념 안내 (issuer, payment, workflow, cash-receipt, glossary)
+bolta guide                 주요 개념 안내 (issuer, payment, workflow, cash-receipt, business-registration-status, glossary)
 
 ## Commands
 
@@ -63,12 +63,12 @@ bolta invoice issue --data '<json>' [--reference-id <id>]
   - taxType (TAXABLE | ZERO_RATE | TAX_FREE)
   - supplier: {identificationNumber, organizationName, representativeName, manager: {email}}
   - supplied: {identificationNumber, organizationName, representativeName, managers: [{email}]}
-  - items: [{date, name, supplyCost}] (1~5개)
+  - items: [{date, name, supplyCost}] (1~16개)
   - supplied.identificationNumber: 사업자등록번호 10자리, 주민등록번호 규칙 13자리, 외국인등록번호 규칙 13자리 허용
   선택 필드:
   - supplier/supplied: address, businessType, businessItem, taxRegistrationId
   - items: unitPrice, quantity, tax, specification, description
-  - description (최대 200자)
+  - description (최대 150자)
   taxType별 tax 규칙: TAXABLE은 tax가 null/누락이면 안 됨, ZERO_RATE은 모든 tax가 0, TAX_FREE는 모든 tax가 null.
   외국인등록번호 공급받는자는 정발행만 지원. 이 경우 supplied.taxRegistrationId와 최상위 description은 null/미입력이어야 함. 여권번호는 미지원.
 
@@ -115,10 +115,33 @@ bolta cash-receipt status --reference-id <id>
 bolta cash-receipt cancel <issuanceKey> --reference-id <새 id>
   발행 완료 건을 전액 취소. 발행 요청과 다른 reference-id를 사용하며 부분 취소는 지원하지 않음.
 
+### Business Registration Status
+
+(deprecated) bolta business-status check|check-bulk 는 같은 동작의 alias. 실행 시 stderr 경고. 새 명령 사용 권장.
+
+bolta business-registration-status check <businessRegistrationNumber>
+  사업자등록번호 한 건의 등록 상태와 과세유형 조회. 발급자 등록과 인증서 불필요. 하이픈 허용.
+  응답: {businessRegistrationNumber, registration: {status, closedOn}, taxType}
+  - registration.status: ACTIVE | SUSPENDED | CLOSED | NOT_REGISTERED | UNKNOWN
+  - registration.closedOn: 폐업자만 YYYY-MM-DD, 나머지 null
+  - taxType: 계속사업자만 GENERAL | SIMPLIFIED | TAX_FREE | NONPROFIT | OTHER_CORPORATION, 나머지 null
+  taxType은 사업자의 과세유형이며 세금계산서 요청의 taxType과 뜻이 다름.
+  통신 실패는 UNKNOWN으로 돌려주지 않음. 사업자등록 상태를 확인할 수 없으면 503 LOOKUP_UNAVAILABLE. 체크섬 불일치는 400 INVALID_BUSINESS_REGISTRATION_NUMBER.
+  호출 한도는 API 키 모드별 24시간 10,000건(429 RATE_LIMITED, 대기 시간은 error.details.retryAfterSeconds). 볼타 서비스 전체 일일 조회 한도에 도달해도 429. CLI는 이 조회를 자동 재시도하지 않음.
+  라이브 키는 정상 조회 결과마다 포인트 차감. 테스트 키는 고정 번호 9개만 조회 가능(bolta guide business-registration-status).
+
+bolta business-registration-status check-bulk <businessRegistrationNumber...>
+bolta business-registration-status check-bulk --data '{"businessRegistrationNumbers":["1000000014","100-00-00028"]}'
+  최대 100건 일괄 조회. --data/--file/--stdin도 가능하며 번호 인자와 섞을 수 없음. 하이픈 표기가 달라도 중복은 하나로 줄이고, 줄인 뒤 100개까지 허용.
+  응답: {results: [{businessRegistrationNumber, status: <check 응답> | null}]}. results는 요청 순서.
+  status null은 이번에 확인하지 못한 번호이며 차감하지 않음. 그 번호만 나중에 다시 조회.
+  한 건도 확인하지 못하면 503 LOOKUP_UNAVAILABLE 또는 429 RATE_LIMITED. 테스트 키는 고정 번호 밖이 하나라도 섞이면 요청 전체 400.
+  호출 한도 10,000은 요청 수가 아니라 조회한 번호 수 기준(단건, 일괄 공통).
+
 ### Configuration
 
 bolta config set <key> <value>
-  설정 저장. key: api-key, base-url
+  설정 저장. key: api-key, base-url, update-check
 
 bolta config show
   현재 설정 확인.
@@ -133,7 +156,7 @@ bolta examples [command]
   사용 가능: issuer-create, invoice-issue, invoice-issue-foreign-supplied, invoice-issue-request, cash-receipt-issue, cash-receipt-issue-business, cash-receipt-issue-self, amend-termination, amend-change-supply-cost
 
 bolta schema [command]
-  입력 JSON 스키마 출력. command 없이 실행하면 목록 표시.
+  입력 JSON 스키마 출력. command 없이 실행하면 목록 표시. 사업자등록 상태 일괄 조회 입력은 business-registration-status-check-bulk.
 
 ## Global Options
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolta-io/cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Bolta API CLI for Korean electronic tax invoices and cash receipts (전자세금계산서·현금영수증)",
   "type": "module",
   "bin": {