개발자센터

세금계산서 발행 관련 API

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

타입 정의

API 요청/응답의 각 필드에서 사용되는 타입 정의들을 확인할 수 있습니다
AttachB2bTaxInvoiceFileBody: { fileId }
세금계산서 파일 첨부 정보

세금계산서 파일 첨부 정보

AttachB2bTaxInvoiceFileError: B2bExternalServiceError | B2bFileNotFoundError | B2bNotEnabledError | ...
AttachB2bTaxInvoiceFileError
B2BCannotChangeTaxTypeError: { type, message }
세금계산서 과세 유형을 수정할 수 없는 경우

세금계산서 과세 유형을 수정할 수 없는 경우

B2BTaxInvoiceStatusNotSendingCompletedError: { type, message }
원본 세금계산서가 전송완료 상태가 아닌 경우

원본 세금계산서가 전송완료 상태가 아닌 경우

B2bBulkTaxInvoice: { id, graphqlId, name, ... }
B2bBulkTaxInvoice
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가 이미 사용중인 경우

ID가 이미 사용중인 경우

B2bIssuanceTypeMismatchError: { type, message }
세금계산서 발행 유형이 올바르지 않은 경우

세금계산서 발행 유형이 올바르지 않은 경우

B2bModificationNotProvidedError: { type, message }
세금계산서 수정 입력 정보를 찾을 수 없는 경우

세금계산서 수정 입력 정보를 찾을 수 없는 경우

B2bNotEnabledError: { type, message }
B2B 기능이 활성화되지 않은 경우

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, ... }
B2bTaxInvoiceCompany
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) 상태가 아닌 경우

세금계산서가 발행된(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" | ...
B2bTaxInvoiceStatus
B2bTaxInvoiceSummary: { id, taxationType, documentModificationType, ... }
세금계산서 요약

세금계산서 요약

B2bTaxInvoiceSupplierDocumentKeyAlreadyUsedError: { type, message }
세금계산서에 공급자 문서 번호가 이미 사용 중인 경우

세금계산서에 공급자 문서 번호가 이미 사용 중인 경우

B2bTaxInvoiceTaxationType: "TAXABLE" | "ZERO_RATED" | "FREE"
과세 유형

과세 유형

CancelB2bTaxInvoiceIssuanceBody: { memo }
세금계산서 취소 정보

세금계산서 취소 정보

CancelB2bTaxInvoiceIssuanceError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
CancelB2bTaxInvoiceIssuanceError
CancelB2bTaxInvoiceIssuanceResponse: { taxInvoice }
세금계산서 취소 응답

세금계산서 취소 응답

CancelB2bTaxInvoiceRequestBody: { memo }
세금계산서 역발행 요청 취소 정보

세금계산서 역발행 요청 취소 정보

CancelB2bTaxInvoiceRequestError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
CancelB2bTaxInvoiceRequestError
CancelB2bTaxInvoiceRequestResponse: { taxInvoice }
세금계산서 역발행 요청 취소 응답

세금계산서 역발행 요청 취소 응답

CreateB2bFileUploadUrlBody: { fileName }
파일 업로드 URL 생성 요청 정보

파일 업로드 URL 생성 요청 정보

CreateB2bFileUploadUrlError: B2bExternalServiceError | B2bNotEnabledError | ForbiddenError | ...
CreateB2bFileUploadUrlError
CreateB2bFileUploadUrlPayload: { fileId, url }
파일 업로드 URL 생성 성공 응답

파일 업로드 URL 생성 성공 응답

DateRangeOption: { from, until }
DateRangeOption
Decimal: { value, scale }
BigDecimal 타입

BigDecimal 타입

DeleteB2bTaxInvoiceAttachmentError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceAttachmentNotFoundError | ...
DeleteB2bTaxInvoiceAttachmentError
DeleteB2bTaxInvoiceError: B2bBulkTaxInvoiceNotFoundError | B2bExternalServiceError | B2bNotEnabledError | ...
DeleteB2bTaxInvoiceError
DeleteB2bTaxInvoiceResponse: { }
DeleteB2bTaxInvoiceResponse
DownloadB2bTaxInvoicesSheetBody: { filter, fields, test, ... }
DownloadB2bTaxInvoicesSheetBody
DownloadB2bTaxInvoicesSheetError: InvalidRequestError | UnauthorizedError
DownloadB2bTaxInvoicesSheetError
DraftB2bTaxInvoiceBody: { taxInvoice, modification, memo, ... }
세금계산서 임시 저장 정보

세금계산서 임시 저장 정보

DraftB2bTaxInvoiceError: B2BCannotChangeTaxTypeError | B2bCounterpartyNotFoundError | B2bCounterpartyNtsNotConnectedError | ...
DraftB2bTaxInvoiceError
DraftB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 임시 저장 응답

세금계산서 임시 저장 응답

ForbiddenError: { type, message }
요청이 거절된 경우

요청이 거절된 경우

GetB2bBulkTaxInvoiceError: B2bBulkTaxInvoiceNotFoundError | B2bExternalServiceError | B2bNotEnabledError | ...
GetB2bBulkTaxInvoiceError
GetB2bTaxInvoiceAttachmentsError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoiceAttachmentsError
GetB2bTaxInvoiceAttachmentsResponse: { attachments }
세금계산서 첨부파일 목록 조회 성공 응답

세금계산서 첨부파일 목록 조회 성공 응답

GetB2bTaxInvoiceError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoiceError
GetB2bTaxInvoicePdfDownloadUrlError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoicePdfDownloadUrlError
GetB2bTaxInvoicePdfDownloadUrlResponse: { url }
세금계산서 PDF 다운로드 URL 성공 응답

세금계산서 PDF 다운로드 URL 성공 응답

GetB2bTaxInvoicePopupUrlError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoicePopupUrlError
GetB2bTaxInvoicePopupUrlResponse: { url }
세금계산서 팝업 URL 성공 응답

세금계산서 팝업 URL 성공 응답

GetB2bTaxInvoicePrintUrlError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoicePrintUrlError
GetB2bTaxInvoicePrintUrlResponse: { url }
세금계산서 프린트 URL 성공 응답

세금계산서 프린트 URL 성공 응답

GetB2bTaxInvoicesBody: { test, pageNumber, pageSize, ... }
세금 계산서 다건 조회를 위한 입력 정보

세금 계산서 다건 조회를 위한 입력 정보

GetB2bTaxInvoicesBodyDateFilter: { dateType, dateRange }
조회 기간 필터

조회 기간 필터

GetB2bTaxInvoicesBodyFilter: { primaryFilter, supplierBrn, partnerBrn, ... }
세금계산서 다건 조회 필터

세금계산서 다건 조회 필터

GetB2bTaxInvoicesBodyPrimaryFilter: { dateFilter, taxInvoiceId, bulkTaxInvoiceId, ... }
상위 필터

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

GetB2bTaxInvoicesError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
GetB2bTaxInvoicesError
GetB2bTaxInvoicesResponse: { items, page }
세금계산서 다건 조회 성공 응답

세금계산서 다건 조회 성공 응답

InvalidRequestError: { type, message }
요청된 입력 정보가 유효하지 않은 경우

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

IssueB2bTaxInvoiceBody: { memo, emailSubject }
세금계산서 발행 승인 정보

세금계산서 발행 승인 정보

IssueB2bTaxInvoiceError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotDraftedStatusError | ...
IssueB2bTaxInvoiceError
IssueB2bTaxInvoiceImmediatelyBody: { taxInvoice, memo, modification, ... }
세금계산서 즉시 정발행 요청 정보

세금계산서 즉시 정발행 요청 정보

IssueB2bTaxInvoiceImmediatelyError: B2BCannotChangeTaxTypeError | B2bCounterpartyNotFoundError | B2bCounterpartyNtsNotConnectedError | ...
IssueB2bTaxInvoiceImmediatelyError
IssueB2bTaxInvoiceImmediatelyResponse: { taxInvoice }
세금계산서 즉시 정발행 응답

세금계산서 즉시 정발행 응답

IssueB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 발행 승인 응답

세금계산서 발행 승인 응답

Map_Stat: { [key: string]: B2bBulkTaxInvoiceStat }
Map_Stat
PageInfo: { number, size, totalCount }
반환된 페이지 결과 정보

반환된 페이지 결과 정보

RefuseB2bTaxInvoiceRequestBody: { memo }
세금계산서 역발행 요청 거부 정보

세금계산서 역발행 요청 거부 정보

RefuseB2bTaxInvoiceRequestError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
RefuseB2bTaxInvoiceRequestError
RefuseB2bTaxInvoiceRequestResponse: { taxInvoice }
세금계산서 역발행 요청 거부 응답

세금계산서 역발행 요청 거부 응답

RequestB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 역발행 요청 응답

세금계산서 역발행 요청 응답

RequestB2bTaxInvoiceReverseIssuanceBody: { taxInvoice, memo, modification }
세금계산서 역발행 즉시 요청 정보

세금계산서 역발행 즉시 요청 정보

RequestB2bTaxInvoiceReverseIssuanceError: B2BCannotChangeTaxTypeError | B2bCounterpartyNotFoundError | B2bCounterpartyNtsNotConnectedError | ...
RequestB2bTaxInvoiceReverseIssuanceError
RequestB2bTaxInvoiceReverseIssuanceResponse: { taxInvoice }
세금계산서 역발행 즉시 요청 응답

세금계산서 역발행 즉시 요청 응답

SendToNtsB2bTaxInvoiceError: B2bExternalServiceError | B2bNotEnabledError | B2bTaxInvoiceNotFoundError | ...
SendToNtsB2bTaxInvoiceError
SendToNtsB2bTaxInvoiceResponse: { taxInvoice }
세금계산서 국세청 즉시 전송 응답

세금계산서 국세청 즉시 전송 응답

SortOrder: "DESC" | "ASC"
정렬 방식

정렬 방식

TaxInvoicesSheetField: "STATUS" | "CANCEL_REASON" | "ISSUANCE_TYPE" | ...
다운로드 할 시트 컬럼

다운로드 할 시트 컬럼

UnauthorizedError: { type, message }
인증 정보가 올바르지 않은 경우

인증 정보가 올바르지 않은 경우

UpdateB2bTaxInvoiceDraftBody: { brn, taxInvoiceKey, taxInvoiceKeyType, ... }
세금계산서 임시저장 수정 정보

세금계산서 임시저장 수정 정보

UpdateB2bTaxInvoiceDraftError: B2BCannotChangeTaxTypeError | B2bCounterpartyNotFoundError | B2bCounterpartyNtsNotConnectedError | ...
UpdateB2bTaxInvoiceDraftError
UpdateB2bTaxInvoiceDraftResponse: { taxInvoice }
세금계산서 임시저장 수정 응답

세금계산서 임시저장 수정 응답

requestB2bTaxInvoiceError: B2BCannotChangeTaxTypeError | B2bExternalServiceError | B2bIssuanceTypeMismatchError | ...
requestB2bTaxInvoiceError