볼타 | Suits Docs

개요

항목	내용
카테고리	국내 비즈니스
연동 필요	볼타 API 키 + 공동인증서
지원 기능	세금계산서 발행/조회

작업 종류

세금계산서

작업	설명
정발행	공급자 → 공급받는자 발행
역발행	역발행 요청
조회	발행된 계산서 상세 확인

고객

작업	설명
목록 조회	등록된 고객 목록
고객 생성	새 고객 등록
고객 조회	특정 고객 정보

인증서

작업	설명
등록	공동인증서 등록
삭제	공동인증서 삭제

설정 옵션

세금계산서 발행

옵션	설명	필수
공급자	공급자 사업자 정보	✅
공급받는자	공급받는자 사업자 정보	✅
작성일자	세금계산서 작성일	✅
품목	품목 목록	✅
비고	추가 메모

품목 형식

[
  {
    "name": "컨설팅 서비스",
    "unitPrice": 1000000,
    "quantity": 1,
    "supplyCost": 1000000,
    "tax": 100000
  },
  {
    "name": "월정액 이용료",
    "unitPrice": 500000,
    "quantity": 2,
    "supplyCost": 1000000,
    "tax": 100000
  }
]

출력 데이터

{{actions.bolta.invoiceId}}        // 발행된 세금계산서 ID
{{actions.bolta.ntsConfirmNum}}    // 국세청 승인번호
{{actions.bolta.success}}          // 성공 여부

활용 예시

월 정기 세금계산서 발행

트리거: 매월 1일 (일정)
조건: 청구서 상태 = "발행대기"
액션: 볼타 - 세금계산서 발행
├── 공급자:
│   ├── 사업자번호: {{workspace.사업자번호}}
│   ├── 상호: {{workspace.상호}}
│   └── 대표자: {{workspace.대표자}}
├── 공급받는자:
│   ├── 사업자번호: {{trigger.row.고객사업자번호}}
│   ├── 상호: {{trigger.row.고객상호}}
│   └── 담당자이메일: {{trigger.row.담당자이메일}}
├── 작성일자: {{today}}
└── 품목: {{trigger.row.청구품목}}

주문 확정 시 세금계산서 발행

트리거: 주문 상태 = "확정"
조건: 결제방식 = "세금계산서"
액션 1: 볼타 - 세금계산서 발행
├── 공급받는자: {{trigger.row.사업자정보}}
└── 품목:
    └── name: {{trigger.row.상품명}}
        unitPrice: {{trigger.row.공급가액}}
        quantity: 1
        supplyCost: {{trigger.row.공급가액}}
        tax: {{trigger.row.세액}}
액션 2: 행 수정
├── 세금계산서ID: {{actions.bolta.invoiceId}}
└── 세금계산서상태: "발행완료"

발행 결과 알림

트리거: 세금계산서 발행 워크플로우 완료
액션: 슬랙 메시지
└── 메시지: |
    📄 세금계산서 발행 완료
    • 고객: {{trigger.row.고객상호}}
    • 금액: {{trigger.row.공급가액 + trigger.row.세액}}원
    • 승인번호: {{actions.bolta.ntsConfirmNum}}

모범 사례

세금계산서 발행은 법적 효력이 있습니다. 발행 전 정보를 꼼꼼히 확인하세요.

테스트 환경

실제 발행 전 테스트 환경에서 충분히 검증하세요.

발행 기한

세금계산서는 재화/용역 공급일이 속하는 달의 다음 달 10일까지 발행해야 합니다.

수정 세금계산서

발행 후 수정이 필요하면 수정 세금계산서를 발행해야 합니다.

볼타

On this page