에러 코드 - 볼타 사용 가이드

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

상태 코드	에러 코드	에러 메시지
`400`	`NOT_FOUND_CERTIFICATE`	공동인증서가 등록되지 않았습니다.
`400`	`INVALID_TRUSTEE_BUSINESS`	유효하지 않은 수탁자 사업자등록번호입니다.

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

에러 코드	에러 메시지
`INVALID_SUPPLIER_BUSINESS`	공급자 사업자등록번호가 유효하지 않습니다. (미등록, 폐업)
`INVALID_SUPPLIED_BUSINESS`	공급받는자 사업자등록번호가 유효하지 않습니다.
`INVALID_TRUSTEE_BUSINESS`	수탁자 사업자등록번호가 유효하지 않습니다. (미등록, 폐업)
`INTERNAL_SERVER_ERROR`	볼타 서버에서 에러가 발생했습니다.
`INVALID_CERTIFICATE`	등록된 공동인증서가 유효하지 않습니다.(만료/폐기)

발급자 등록 API

상태 코드	에러 코드	에러 메시지
`400`	`INVALID_SUPPLIER_BUSINESS`	유효하지 않은 사업자등록번호입니다.

현금영수증 API

상태 코드	에러 코드	발생 조건
`400`	`INVALID_REQUEST`	요청 검증 또는 취소 가능 상태 검증 실패
`401`	-	API 키 인증 실패. 응답 본문 없음
`403`	`FORBIDDEN`	발급자 접근 권한 없음
`409`	`IDEMPOTENCY_CONFLICT`	멱등성 충돌, 발행 요청 처리가 시작되기 전 취소 또는 활성 취소 요청 중복
`500`	`INTERNAL_SERVER_ERROR`	서버 내부 오류
`503`	`SERVICE_UNAVAILABLE`	발행·취소 중 내부 API 통신 오류

현금영수증 웹훅

다음 코드는 현금영수증 발행·취소가 실패했을 때 웹훅 페이로드의 data.cause.code와 상태 조회 응답의 failure.code에 담깁니다.

에러 코드	에러 메시지
`INVALID_ISSUER`	공급자 정보 또는 현금영수증 발행 등록 상태를 확인해주세요.
`INVALID_RECIPIENT_IDENTIFIER`	현금영수증 발급 수단 정보를 확인해주세요.
`ORIGINAL_ISSUANCE_FAILED`	원본 현금영수증 발행이 실패해 취소 요청을 처리할 수 없습니다.
`CANCELLATION_TARGET_NOT_FOUND`	이미 취소되었거나 취소할 수 없는 거래입니다.
`UNKNOWN`	현금영수증 처리에 실패했습니다. 문제가 계속되면 고객센터로 문의해주세요.

ORIGINAL_ISSUANCE_FAILED와 CANCELLATION_TARGET_NOT_FOUND는 CASH_RECEIPT_CANCEL_FAILED에서만 반환됩니다.

ORIGINAL_ISSUANCE_FAILED: 원본 발행이 처리 중일 때 취소 요청을 접수했지만, 이후 원본 발행이 최종 실패한 경우
CANCELLATION_TARGET_NOT_FOUND: 취소 대상이 확인되지 않거나 이미 취소되었거나, 같은 현금영수증의 취소 요청이 이미 접수된 경우

공통 에러

상태 코드	에러 코드	에러 메시지
`400`	`INVALID_REQUEST`	요청을 처리할 수 없습니다. 필수 파라미터를 보내지 않았거나, 파라미터 포맷이 잘못되었을 때 돌아오는 응답입니다. 요청 파라미터를 확인해주세요.
`404`	`NOT_FOUND`	요청한 리소스가 존재하지 않습니다. 요청한 API 주소를 다시 한 번 확인해주세요.
`500`	`INTERNAL_SERVER_ERROR`	볼타 서버에서 에러가 발생했습니다.