@barobill-sdk/ti

바로빌 전자세금계산서 API TypeScript SDK (비공식)

이 패키지는 바로빌의 공식 SDK가 아닌, 비공식 SDK입니다. 바로빌 API의 공식 문서는 바로빌 API 레퍼런스를 참고해 주세요.

설치

npm i @barobill-sdk/ti

사용법

import { TiClient } from '@barobill-sdk/ti';

const client = await TiClient.create({
  certKey: 'your-cert-key',
  corpNum: '1234567890', // 기본 사업자등록번호 (선택)
  test: true,            // true: 테스트 환경 (기본값: false)
});

const result = await client.registAndIssueTaxInvoice({
  Invoice: {
    InvoicerParty: {
      MgtNum: '20240101-001',
      CorpNum: '1234567890',
      CorpName: '테스트회사',
      // ...
    },
    InvoiceeParty: {
      CorpNum: '0987654321',
      CorpName: '거래처',
      // ...
    },
    // ...
  },
});

• certKey: 바로빌 인증키
• corpNum (선택): 기본 사업자등록번호. 설정하면 API 호출 시 자동 주입됩니다.
• test: true이면 테스트 환경, false이면 운영 환경

주요 메서드

| 분류 | 메서드 | |------|--------| | 등록/발행 | registTaxInvoice, issueTaxInvoice, registAndIssueTaxInvoice 등 | | 수정 | registModifyTaxInvoice, updateTaxInvoice 등 | | 삭제 | deleteTaxInvoice, deleteTaxInvoiceIk | | 조회 | getTaxInvoice, getTaxInvoiceState, getTaxInvoiceStates, getTaxInvoiceLog 등 | | 첨부파일 | attachFileByFTP, attachFilesByFTP, deleteAttachFile, getAttachedFileList | | 전송 | sendEmail, sendSMS, sendFax 등 | | URL | getTaxInvoicePrintURL, getTaxInvoiceMailURL, getBaroBillURL | | 유틸 | getErrString, ping |

관련 링크

• 전체 패키지 목록 (모노레포)

License

ISC