메인 콘텐츠로 건너뛰기

전자(세금)계산서 발행 API

INVALID_SUPPLIER_BUSINESS가 발생하면 현재 API 키가 속한 연동과 환경에 해당 사업자등록번호의 발급자가 있는지 확인하세요.

전자(세금)계산서 발행 웹훅

API가 국세청 결과 코드를 cause.code에 그대로 전달하기도 합니다. 표에 없는 코드를 받으면 cause.message를 확인하고, 다시 발행하기 전에 issuanceKey와 함께 볼타에 문의하세요.

발급자 등록 API

현금영수증 API

현금영수증 웹훅

현금영수증 발행이나 취소가 실패하면 API가 다음 코드를 웹훅 페이로드의 data.cause.code와 상태 조회 응답의 failure.code에 담습니다. ORIGINAL_ISSUANCE_FAILED와 CANCELLATION_TARGET_NOT_FOUND는 CASH_RECEIPT_CANCEL_FAILED에서만 반환됩니다.
  • ORIGINAL_ISSUANCE_FAILED: 원본 발행이 처리 중일 때 취소 요청을 접수했지만, 이후 원본 발행이 최종 실패한 경우
  • CANCELLATION_TARGET_NOT_FOUND: 취소 대상이 확인되지 않거나 이미 취소된 경우. 볼타 외부(예: 홈택스)에서 전액이나 일부가 먼저 취소된 경우, 같은 현금영수증의 취소 요청이 이미 접수된 경우도 해당합니다

세금계산서 발행 마감일 조회 API

세금계산서 발행 마감일 조회를 참고하세요.

사업자등록 상태 조회 API

일괄 조회에서 일부 번호만 확인하지 못하면 오류 대신 200으로 응답하고 해당 항목의 status를 null로 둡니다. 사업자등록 상태 조회를 참고하세요.

사업자등록증 인식과 진위확인 API

사업자등록증 인식과 진위확인을 참고하세요.

사업자 정보 조회 API

사업자 정보 조회를 참고하세요.

매출/매입 내역 조회 API

매출/매입 내역 조회를 참고하세요.

입출금 내역 조회 API

입출금 내역 조회를 참고하세요.

예금주 조회 API

예금주를 찾지 못하면 단건 조회는 HTTP 400으로 응답하고, 일괄 조회는 HTTP 200 응답의 results[].error에 오류를 담습니다. 예금주 조회를 참고하세요.

서류 발급 API

서류 발급을 참고하세요.

세금계산서 PDF 조회 API

세금계산서 PDF 조회를 참고하세요.

공통 에러