@connextable/popbill

Popbill API를 TypeScript에서 사용하기 위한 modern SDK입니다.

신규 프로젝트에서는 이 패키지를 기본 선택지로 사용합니다. createPopbillClient로 클라이언트를 만들고, 객체 기반 입력과 타입이 지정된 응답으로 API를 호출합니다.

요구사항

• Node.js 20+
• ESM 호환 TypeScript 도구

설치

npm install @connextable/popbill

빠른 시작

import { createPopbillClient } from '@connextable/popbill'

const client = createPopbillClient({
  linkId: process.env.POPBILL_LINK_ID!,
  secretKey: process.env.POPBILL_SECRET_KEY!,
  userId: process.env.POPBILL_USER_ID!,
  isTest: true,
})

const expiration = await client.services.taxInvoice.getTaxCertificateExpirationDate({
  businessNumber: process.env.POPBILL_CORP_NUM!,
})

console.log(expiration)

클라이언트 설정

필수 필드:

• linkId
• secretKey
• userId

주요 옵션:

• isTest: Popbill 테스트 환경 사용 여부입니다. 기본값은 false입니다.
• useLocalTime: 인증 시 로컬 UTC 시간을 사용할지 결정합니다. 기본값은 true입니다.
• requestTimeoutMs: 요청 제한시간(ms)입니다. 기본값은 180000입니다.
• acceptEncoding: 요청 Accept-Encoding 헤더입니다. 기본값은 gzip입니다.
• acceptLanguage: 요청 Accept-Language 헤더입니다.
• onError: SDK 에러 콜백입니다.

서비스

현재 공개 서비스 그룹:

• client.services.taxInvoice: 전자세금계산서 등록, 발행, 검색, 문서 URL, 첨부파일, 국세청 전송, 인증서, 설정 관련 메서드를 제공합니다.

관련 문서

• 저장소 가이드: ../../README.md
• 예제: ../../examples/README.md
• 생성 SDK 문서: ../../docs/sdk/README.md