세금계산서 발행 관련 API

세금계산서 발행 관련 API 기능을 제공합니다.

등록된 일괄 세금계산서를 일괄 세금계산서 아이디로 조회합니다.

S3 파일 업로드를 위한 URL을 생성합니다.

세금계산서를 엑셀 파일(csv)로 다운로드합니다.

임시 저장된 세금계산서를 수정합니다.

세금계산서 임시 저장을 요청합니다.

세금계산서를 즉시 정발행합니다. 임시저장 API와 정발행 API 기능을 한 번의 프로세스로 처리합니다.

공급자에게 세금계산서 역발행을 즉시 요청합니다. 임시저장 API와 역발행 요청 API 기능을 한 번의 프로세스로 처리합니다.

세금계산서에 첨부된 파일 목록을 조회합니다.

발행 완료된 세금계산서를 공급자가 국세청 전송 전에 취소합니다.

공급자가 세금계산서 발행을 승인하기 전에 공급받는자가 해당 역발행 요청을 취소합니다.

역발행의 경우 역발행요청(REQUESTED) 상태, 정발행의 경우 임시저장(DRAFTED) 상태의 세금계산서에 대해 발행을 승인합니다.

등록된 세금 계산서 PDF 다운로드 URL을 공급자 혹은 공급받는자 문서번호로 조회합니다.

등록된 세금 계산서 팝업 URL을 공급자 혹은 공급받는자 문서번호로 조회합니다.

등록된 세금 계산서 프린트 URL을 공급자 혹은 공급받는자 문서번호로 조회합니다.

공급자가 공급받는자로부터 요청받은 세금계산서 역발행 건을 거부합니다.

임시저장(REGISTERED) 상태의 역발행 세금계산서를 공급자에게 발행 요청합니다. 요청이 완료되면 (역)발행대기 상태로 전환됩니다.

발행이 완료된 세금계산서를 국세청에 즉시 전송합니다.

등록된 세금 계산서를 세금계산서 아이디로 조회합니다.

조회 기간 내 등록된 세금 계산서를 다건 조회합니다.

타입 정의

API 요청/응답의 각 필드에서 사용되는 타입 정의들을 확인할 수 있습니다
AttachB2bTaxInvoiceFileBody: { fileId }
세금계산서 파일 첨부 정보
AttachB2bTaxInvoiceFileError: B2bExternalServiceError | B2bFileNotFoundError | B2bNotEnabledError | ...
B2BCannotChangeTaxTypeError: { type, message }
세금계산서 과세 유형을 수정할 수 없는 경우
B2BTaxInvoiceStatusNotSendingCompletedError: { type, message }
원본 세금계산서가 전송완료 상태가 아닌 경우
B2bBulkTaxInvoice: { id, graphqlId, name, ... }
B2bBulkTaxInvoiceNotFoundError: { type, message }
일괄 세금계산서가 존재하지 않은 경우
B2bBulkTaxInvoiceSourceType: "SHEET" | "PLATFORM"
그룹 생성 방식
B2bBulkTaxInvoiceStat: { count, amountSum }
세금계산서 상태별 집계 정보
B2bBulkTaxInvoiceStatus: "DRAFT_PENDING" | "DRAFTED" | "REQUEST_PENDING" | ...
일괄 세금계산서 상태
B2bCompanyStateBusinessStatus: "IN_BUSINESS" | "CLOSED" | "SUSPENDED"
영업 상태
B2bCounterpartyNotFoundError: { type, message, counterpartyId }
거래처가 존재하지 않는 경우
B2bCounterpartyNtsNotConnectedError: { type, message, brn, ... }
국세청에 연동되어 있지 않은 경우
B2bDocumentKeyCannotBeChangedError: { type, message }
문서번호 수정이 요청된 경우
B2bExternalServiceError: { type, message }
외부 서비스에서 에러가 발생한 경우
B2bFileNotFoundError: { type, message }
업로드한 파일을 찾을 수 없는 경우
B2bIdAlreadyExistsError: { type, message }
ID가 이미 사용중인 경우
B2bIssuanceTypeMismatchError: { type, message }
세금계산서 발행 유형이 올바르지 않은 경우
B2bModificationNotProvidedError: { type, message }
세금계산서 수정 입력 정보를 찾을 수 없는 경우
B2bNotEnabledError: { type, message }
B2B 기능이 활성화되지 않은 경우
B2bOriginalTaxInvoiceNotFoundError: { type, message }
원본 세금계산서가 존재하지 않은 경우
B2bRecipientNotFoundError: { type, message, brn, ... }
공급받는자가 존재하지 않은 경우
B2bSearchDateType: "REGISTER" | "WRITE" | "ISSUE"
조회 기준
B2bSupplierNotFoundError: { type, message, brn, ... }
공급자가 존재하지 않은 경우
B2bTaxInvoice: { id, status, taxationType, ... }
세금계산서
B2bTaxInvoiceAdditionalContact: { name, email, phoneNumber }
추가 담당자
B2bTaxInvoiceAttachment: { id, name, attachedAt }
세금계산서 첨부파일
B2bTaxInvoiceAttachmentNotFoundError: { type, message }
세금계산서의 첨부파일을 찾을 수 없는 경우
B2bTaxInvoiceCompany: { brn, counterpartyId, taxRegistrationId, ... }
B2bTaxInvoiceContact: { name, department, phoneNumber, ... }
세금계산서 담당자
B2bTaxInvoiceDocumentModificationType: "NORMAL" | "MODIFICATION"
세금계산서 문서 수정 발행 유형
B2bTaxInvoiceInput: { taxationType, issuanceType, serialNumber, ... }
세금계산서 생성 요청 정보
B2bTaxInvoiceIssuanceType: "NORMAL" | "REVERSE"
발행 유형
B2bTaxInvoiceItem: { purchaseDate, name, spec, ... }
품목
B2bTaxInvoiceKeyType: "SUPPLIER" | "RECIPIENT" | "TAX_INVOICE_ID"
세금계산서 식별자 유형
B2bTaxInvoiceModification: { type, originalNtsApprovalNumber, originalTaxInvoiceId, ... }
세금 계산서 수정
B2bTaxInvoiceModificationCreateBody: { type, brn, taxInvoiceKey, ... }
수정 세금계산서 생성 입력 정보
B2bTaxInvoiceModificationType: "CORRECTION_OF_ENTRY_ERRORS" | "CHANGE_IN_SUPPLY_COST" | "RETURN" | ...
수정 사유
B2bTaxInvoiceNoRecipientDocumentKeyError: { type, message }
세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
B2bTaxInvoiceNoSupplierDocumentKeyError: { type, message }
세금계산서에 공급자 문서 번호가 기입되지 않은 경우
B2bTaxInvoiceNonDeletableStatusError: { type, message }
세금계산서가 삭제 가능한 상태가 아닌 경우

삭제 가능한 상태는 DRAFTED, ISSUE_REFUSED, REQUEST_CANCELLED_BY_RECIPIENT, ISSUE_CANCELLED_BY_SUPPLIER, SENDING_FAILED 입니다.

B2bTaxInvoiceNotDraftedStatusError: { type, message }
세금계산서가 임시저장 완료 상태가 아닌 경우
B2bTaxInvoiceNotFoundError: { type, message }
세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotIssuedStatusError: { type, message }
세금계산서가 발행된(ISSUED) 상태가 아닌 경우
B2bTaxInvoiceNotRequestedStatusError: { type, message }
세금계산서가 역발행 대기 상태가 아닌 경우
B2bTaxInvoicePurposeType: "RECEIPT" | "INVOICE" | "NONE"
영수/청구
B2bTaxInvoiceRecipientDocumentKeyAlreadyUsedError: { type, message }
세금계산서에 공급 받는자 문서 번호가 이미 사용 중인 경우
B2bTaxInvoiceSortBy: "WRITE_DATE" | "ISSUANCE_DUE_DATE" | "TOTAL_AMOUNT" | ...
세금계산서 정렬 기준
B2bTaxInvoiceSortInput: { by, order }
세금계산서 다건 조회 시 정렬 조건
B2bTaxInvoiceStatus: "DRAFTED" | "DRAFT_PENDING" | "DRAFT_FAILED" | ...
B2bTaxInvoiceSummary: { id, taxationType, documentModificationType, ... }
세금계산서 요약
B2bTaxInvoiceSupplierDocumentKeyAlreadyUsedError: { type, message }
세금계산서에 공급자 문서 번호가 이미 사용 중인 경우
B2bTaxInvoiceTaxationType: "TAXABLE" | "ZERO_RATED" | "FREE"
과세 유형
CancelB2bTaxInvoiceIssuanceBody: { memo }
세금계산서 취소 정보
CancelB2bTaxInvoiceIssuanceError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
CancelB2bTaxInvoiceIssuanceResponse: { taxInvoice }
세금계산서 취소 응답
CancelB2bTaxInvoiceRequestBody: { memo }
세금계산서 역발행 요청 취소 정보
CancelB2bTaxInvoiceRequestError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
CancelB2bTaxInvoiceRequestResponse: { taxInvoice }
세금계산서 역발행 요청 취소 응답
CreateB2bFileUploadUrlBody: { fileName }
파일 업로드 URL 생성 요청 정보
CreateB2bFileUploadUrlError: B2bExternalServiceError | B2bNotEnabledError | ForbiddenError | ...
CreateB2bFileUploadUrlPayload: { fileId, url }
파일 업로드 URL 생성 성공 응답
DateRangeOption: { from, until }
Decimal: { value, scale }
BigDecimal 타입
DeleteB2bTaxInvoiceResponse: { }
DownloadB2bTaxInvoicesSheetBody: { filter, fields, test, ... }
DownloadB2bTaxInvoicesSheetError: InvalidRequestError | UnauthorizedError
DraftB2bTaxInvoiceBody: { taxInvoice, modification, memo, ... }
세금계산서 임시 저장 정보
DraftB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 임시 저장 응답
ForbiddenError: { type, message }
요청이 거절된 경우
GetB2bTaxInvoiceAttachmentsError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoiceAttachmentsResponse: { attachments }
세금계산서 첨부파일 목록 조회 성공 응답
GetB2bTaxInvoicePdfDownloadUrlError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoicePdfDownloadUrlResponse: { url }
세금계산서 PDF 다운로드 URL 성공 응답
GetB2bTaxInvoicePopupUrlResponse: { url }
세금계산서 팝업 URL 성공 응답
GetB2bTaxInvoicePrintUrlResponse: { url }
세금계산서 프린트 URL 성공 응답
GetB2bTaxInvoicesBody: { test, pageNumber, pageSize, ... }
세금 계산서 다건 조회를 위한 입력 정보
GetB2bTaxInvoicesBodyDateFilter: { dateType, dateRange }
조회 기간 필터
GetB2bTaxInvoicesBodyFilter: { primaryFilter, supplierBrn, partnerBrn, ... }
세금계산서 다건 조회 필터
GetB2bTaxInvoicesBodyPrimaryFilter: { dateFilter, taxInvoiceId, bulkTaxInvoiceId, ... }
상위 필터

주어진 필드 중 한 개의 필드만 입력합니다.

GetB2bTaxInvoicesResponse: { items, page }
세금계산서 다건 조회 성공 응답
InvalidRequestError: { type, message }
요청된 입력 정보가 유효하지 않은 경우

허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.

IssueB2bTaxInvoiceBody: { memo, emailSubject }
세금계산서 발행 승인 정보
IssueB2bTaxInvoiceImmediatelyBody: { taxInvoice, memo, modification, ... }
세금계산서 즉시 정발행 요청 정보
IssueB2bTaxInvoiceImmediatelyResponse: { taxInvoice }
세금계산서 즉시 정발행 응답
IssueB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 발행 승인 응답
Map_Stat: { [key: string]: B2bBulkTaxInvoiceStat }
PageInfo: { number, size, totalCount }
반환된 페이지 결과 정보
RefuseB2bTaxInvoiceRequestBody: { memo }
세금계산서 역발행 요청 거부 정보
RefuseB2bTaxInvoiceRequestError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
RefuseB2bTaxInvoiceRequestResponse: { taxInvoice }
세금계산서 역발행 요청 거부 응답
RequestB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 역발행 요청 응답
RequestB2bTaxInvoiceReverseIssuanceBody: { taxInvoice, memo, modification }
세금계산서 역발행 즉시 요청 정보
RequestB2bTaxInvoiceReverseIssuanceResponse: { taxInvoice }
세금계산서 역발행 즉시 요청 응답
SendToNtsB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 국세청 즉시 전송 응답
SortOrder: "DESC" | "ASC"
정렬 방식
TaxInvoicesSheetField: "STATUS" | "CANCEL_REASON" | "ISSUANCE_TYPE" | ...
다운로드 할 시트 컬럼
UnauthorizedError: { type, message }
인증 정보가 올바르지 않은 경우
UpdateB2bTaxInvoiceDraftBody: { brn, taxInvoiceKey, taxInvoiceKeyType, ... }
세금계산서 임시저장 수정 정보
UpdateB2bTaxInvoiceDraftResponse: { taxInvoice }
세금계산서 임시저장 수정 응답