portone_server_sdk.b2b.tax_invoice

Classes

AttachB2bTaxInvoiceFileBody	세금계산서 파일 첨부 정보
B2bBulkTaxInvoice
B2bBulkTaxInvoiceStat	세금계산서 상태별 집계 정보
B2bTaxInvoice	세금계산서
B2bTaxInvoiceAdditionalContact	추가 담당자
B2bTaxInvoiceAttachment	세금계산서 첨부파일
B2bTaxInvoiceCompany
B2bTaxInvoiceContact	세금계산서 담당자
B2bTaxInvoiceInput	세금계산서 생성 요청 정보
B2bTaxInvoiceItem	품목
B2bTaxInvoiceModification	세금 계산서 수정
B2bTaxInvoiceModificationCreateBody	수정 세금계산서 생성 입력 정보
B2bTaxInvoiceSummary	세금계산서 요약
CancelB2bTaxInvoiceIssuanceBody	세금계산서 취소 정보
CancelB2bTaxInvoiceIssuanceResponse	세금계산서 취소 응답
CancelB2bTaxInvoiceRequestBody	세금계산서 역발행 요청 취소 정보
CancelB2bTaxInvoiceRequestResponse	세금계산서 역발행 요청 취소 응답
CreateB2bFileUploadUrlBody	파일 업로드 URL 생성 요청 정보
CreateB2bFileUploadUrlPayload	파일 업로드 URL 생성 성공 응답
DateRangeOption
Decimal	BigDecimal 타입
DeleteB2bTaxInvoiceResponse
DownloadB2bTaxInvoicesSheetBody
DraftB2bTaxInvoiceBody	세금계산서 임시 저장 정보
DraftB2bTaxInvoiceResponse	세금계산서 임시 저장 응답
GetB2bTaxInvoiceAttachmentsResponse	세금계산서 첨부파일 목록 조회 성공 응답
GetB2bTaxInvoicePdfDownloadUrlResponse	세금계산서 PDF 다운로드 URL 성공 응답
GetB2bTaxInvoicePopupUrlResponse	세금계산서 팝업 URL 성공 응답
GetB2bTaxInvoicePrintUrlResponse	세금계산서 프린트 URL 성공 응답
GetB2bTaxInvoicesBody	세금 계산서 다건 조회를 위한 입력 정보
GetB2bTaxInvoicesBodyDateFilter	조회 기간 필터
GetB2bTaxInvoicesBodyFilter	세금계산서 다건 조회 필터
GetB2bTaxInvoicesBodyPrimaryFilter	상위 필터
GetB2bTaxInvoicesResponse	세금계산서 다건 조회 성공 응답
IssueB2bTaxInvoiceBody	세금계산서 발행 승인 정보
IssueB2bTaxInvoiceImmediatelyBody	세금계산서 즉시 정발행 요청 정보
IssueB2bTaxInvoiceImmediatelyResponse	세금계산서 즉시 정발행 응답
IssueB2bTaxInvoiceResponse	세금계산서 발행 승인 응답
Map_Stat
RefuseB2bTaxInvoiceRequestBody	세금계산서 역발행 요청 거부 정보
RefuseB2bTaxInvoiceRequestResponse	세금계산서 역발행 요청 거부 응답
RequestB2bTaxInvoiceResponse	세금계산서 역발행 요청 응답
RequestB2bTaxInvoiceReverseIssuanceBody	세금계산서 역발행 즉시 요청 정보
RequestB2bTaxInvoiceReverseIssuanceResponse	세금계산서 역발행 즉시 요청 응답
SendToNtsB2bTaxInvoiceResponse	세금계산서 국세청 즉시 전송 응답
UpdateB2bTaxInvoiceDraftBody	세금계산서 임시저장 수정 정보
UpdateB2bTaxInvoiceDraftResponse	세금계산서 임시저장 수정 응답
TaxInvoiceClient

Exceptions

AttachB2bTaxInvoiceFileError
CancelB2bTaxInvoiceIssuanceError
CancelB2bTaxInvoiceRequestError
CreateB2bFileUploadUrlError
DeleteB2bTaxInvoiceAttachmentError
DeleteB2bTaxInvoiceError
DownloadB2bTaxInvoicesSheetError
DraftB2bTaxInvoiceError
GetB2bBulkTaxInvoiceError
GetB2bTaxInvoiceAttachmentsError
GetB2bTaxInvoiceError
GetB2bTaxInvoicePdfDownloadUrlError
GetB2bTaxInvoicePopupUrlError
GetB2bTaxInvoicePrintUrlError
GetB2bTaxInvoicesError
IssueB2bTaxInvoiceError
IssueB2bTaxInvoiceImmediatelyError
RefuseB2bTaxInvoiceRequestError
RequestB2bTaxInvoiceReverseIssuanceError
SendToNtsB2bTaxInvoiceError
UpdateB2bTaxInvoiceDraftError
requestB2bTaxInvoiceError

exception portone_server_sdk.b2b.tax_invoice.AttachB2bTaxInvoiceFileError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceIssuanceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceRequestError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.CreateB2bFileUploadUrlError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.DeleteB2bTaxInvoiceAttachmentError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.DeleteB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.DownloadB2bTaxInvoicesSheetError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.DraftB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bBulkTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoiceAttachmentsError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePdfDownloadUrlError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePopupUrlError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePrintUrlError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceImmediatelyError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.RefuseB2bTaxInvoiceRequestError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.RequestB2bTaxInvoiceReverseIssuanceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.SendToNtsB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.UpdateB2bTaxInvoiceDraftError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

exception portone_server_sdk.b2b.tax_invoice.requestB2bTaxInvoiceError

Bases: PortOneError

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

message: str | None

class portone_server_sdk.b2b.tax_invoice.AttachB2bTaxInvoiceFileBody

Bases: object

세금계산서 파일 첨부 정보

file_id: str

파일 아이디

class portone_server_sdk.b2b.tax_invoice.B2bBulkTaxInvoice

Bases: object

id: str

일괄 세금계산서 고유 아이디

graphql_id: str

status: Literal['DRAFT_PENDING', 'DRAFTED', 'REQUEST_PENDING', 'ISSUE_PENDING', 'IN_PROGRESS', 'COMPLETED', 'FAILED', 'CANCELLED'] | str

total_invoice_count: int

(int32)

total_amount: int

(int64)

stats: Map_Stat

created_at: str

(RFC 3339 date-time)

status_updated_at: str

(RFC 3339 date-time)

source_type: Literal['SHEET', 'PLATFORM'] | str

issuance_type: Literal['NORMAL', 'REVERSE'] | str

name: str | None

scheduled_at: str | None

(RFC 3339 date-time)

requested_at: str | None

(RFC 3339 date-time)

class portone_server_sdk.b2b.tax_invoice.B2bBulkTaxInvoiceStat

Bases: object

세금계산서 상태별 집계 정보

count: int

(int32)

amount_sum: int

(int64)

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoice

Bases: object

세금계산서

id: str

세금계산서 아이디

status: Literal['DRAFTED', 'DRAFT_PENDING', 'DRAFT_FAILED', 'REQUESTED', 'REQUEST_PENDING', 'REQUEST_FAILED', 'REQUEST_CANCELLED', 'ISSUED', 'ISSUE_PENDING', 'ISSUE_FAILED', 'BEFORE_SENDING', 'WAITING_SENDING', 'SENDING', 'SENDING_COMPLETED', 'SENDING_FAILED', 'REQUEST_REFUSED', 'ISSUANCE_CANCELLED'] | str

상태

taxation_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE'] | str

과세 유형

document_modification_type: Literal['NORMAL', 'MODIFICATION'] | str

문서 유형

issuance_type: Literal['NORMAL', 'REVERSE'] | str

발행 유형

write_date: str

작성일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

issuance_due_date: str

발행 마감일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE'] | str

영수/청구

total_supply_amount: int

공급가액 합계 (int64)

total_tax_amount: int

세액 합계 (int64)

total_amount: int

합계 금액 (int64)

remarks: list[str]

비고

최대 3개

supplier: B2bTaxInvoiceCompany

공급자

recipient: B2bTaxInvoiceCompany

공급받는자

items: list[B2bTaxInvoiceItem]

품목

최대 99개

additional_contacts: list[B2bTaxInvoiceAdditionalContact]

추가 담당자

최대 3개

is_delayed: bool | None

지연 발행 여부

bulk_tax_invoice_id: str | None

일괄 발행 아이디

serial_number: str | None

일련번호

book_volume: int | None

책번호 - 권

입력 범위(4자리) : 0 ~ 9999 (int32)

book_issue: int | None

책번호 - 호

입력 범위(4자리) : 0 ~ 9999 (int32)

cash_amount: int | None

현금 (int64)

check_amount: int | None

수표 (int64)

credit_amount: int | None

외상 (int64)

note_amount: int | None

어음 (int64)

supplier_document_key: str | None

공급자 문서번호

recipient_document_key: str | None

공급받는자 문서번호

send_sms: bool | None

문자 전송 여부

modification: B2bTaxInvoiceModification | None

수정 사유 기재

memo: str | None

메모

drafted_at: str | None

임시 저장 일시 (RFC 3339 date-time)

requested_at: str | None

발행 요청 일시 (RFC 3339 date-time)

issued_at: str | None

발행 일시 (RFC 3339 date-time)

status_updated_at: str | None

상태 변경 일시 (RFC 3339 date-time)

nts_sent_at: str | None

국세청 전송 일시 (RFC 3339 date-time)

nts_approval_number: str | None

국세청 승인번호

세금계산서 발행(전자서명) 시점에 자동으로 부여

nts_result: str | None

국세청 전송 결과

nts_result_code: str | None

국세청 결과 코드

국세청 발급 결과 코드로 영문 3자리 + 숫자 3자리로 구성됨

nts_result_received_at: str | None

국세청 결과 수신 일시 (RFC 3339 date-time)

deleted_at: str | None

삭제 일시 (RFC 3339 date-time)

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceAdditionalContact

Bases: object

추가 담당자

email: str

이메일

name: str | None

성명

최대 100자

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceAttachment

Bases: object

세금계산서 첨부파일

id: str

첨부 파일 아이디

name: str

첨부 파일명

attached_at: str

첨부 일시 (RFC 3339 date-time)

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceCompany

Bases: object

brn: str

사업자등록번호

`-`를 제외한 10자리

name: str

상호명

최대 200자

representative_name: str

대표자 성명

최대 100자

contact: B2bTaxInvoiceContact

담당자

tax_registration_id: str | None

종사업자 식별 번호

4자리 고정

address: str | None

주소

최대 300자

business_type: str | None

업태

최대 100자

business_class: str | None

종목

최대 100자

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceContact

Bases: object

세금계산서 담당자

email: str

이메일

name: str | None

성명

department: str | None

부서

phone_number: str | None

전화번호

mobile_phone_number: str | None

휴대전화번호

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceInput

Bases: object

세금계산서 생성 요청 정보

taxation_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE'] | str

과세 유형

write_date: str

작성일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE'] | str

영수/청구

total_supply_amount: int

공급가액 합계 (int64)

total_tax_amount: int

세액 합계 (int64)

total_amount: int

합계 금액 (int64)

supplier: B2bTaxInvoiceCompany

공급자

recipient: B2bTaxInvoiceCompany

공급받는자

issuance_type: Literal['NORMAL', 'REVERSE'] | str | None

발행 유형

기본값은 역발행(REVERSE)입니다.

serial_number: str | None

일련번호

book_volume: int | None

권 (int32)

book_issue: int | None

호 (int32)

cash_amount: int | None

현금 (int64)

check_amount: int | None

수표 (int64)

credit_amount: int | None

외상 (int64)

note_amount: int | None

어음 (int64)

remarks: list[str] | None

비고

최대 3개

supplier_document_key: str | None

공급자 문서번호

영문 대소문자, 숫자, 특수문자(‘-‘,’_’)만 이용 가능

recipient_document_key: str | None

공급받는자 문서번호

영문 대소문자, 숫자, 특수문자(‘-‘,’_’)만 이용 가능

send_sms: bool | None

문자 전송 여부

공급자 담당자 휴대폰번호 {supplier.contact.mobile_phone_number} 값으로 문자 전송 전송시 포인트 차감되며, 실패시 환불 처리 기본값은 false

items: list[B2bTaxInvoiceItem] | None

품목

최대 99개

additional_contacts: list[B2bTaxInvoiceAdditionalContact] | None

추가 담당자

최대 3개

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceItem

Bases: object

품목

purchase_date: str | None

결제일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

name: str | None

품명

최대 100자

spec: str | None

규격

최대 100자

quantity: Decimal | None

수량

입력 범위 : -99999999.99 ~ 999999999.99 quantity.scale`의 입력 범위 : 0 ~ 2 `quantity.value * 10^-quantity.scale 단위로 치환됩니다.

unit_cost_amount: Decimal | None

단가

입력 범위 : -99999999999999.99 ~ 999999999999999.99 unitCostAmount.scale`의 입력 범위 : 0 ~ 2 `unitCostAmount.value * 10^-unitCostAmount.scale 단위로 치환됩니다.

supply_cost_amount: int | None

공급가액 (int64)

tax_amount: int | None

세액 (int64)

remark: str | None

비고

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceModification

Bases: object

세금 계산서 수정

type: Literal['CORRECTION_OF_ENTRY_ERRORS', 'CHANGE_IN_SUPPLY_COST', 'RETURN', 'CANCELLATION_OF_CONTRACT', 'DUPLICATE_ISSUANCE_DUE_TO_ERROR'] | str

수정 사유

original_nts_approval_number: str

수정 대상 원본 세금계산서 국세청 승인 번호

original_tax_invoice_id: str

원본 세금계산서 아이디

root_tax_invoice_id: str

최초 원본 세금계산서 아이디

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceModificationCreateBody

Bases: object

수정 세금계산서 생성 입력 정보

type: Literal['CORRECTION_OF_ENTRY_ERRORS', 'CHANGE_IN_SUPPLY_COST', 'RETURN', 'CANCELLATION_OF_CONTRACT', 'DUPLICATE_ISSUANCE_DUE_TO_ERROR'] | str

수정 사유

tax_invoice_key: str

세금계산서 문서 번호

brn: str | None

사업자등록번호

taxInvoiceKeyType이 TAX_INVOICE_ID가 아닌 경우 필수 값입니다.

tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None

문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.

class portone_server_sdk.b2b.tax_invoice.B2bTaxInvoiceSummary

Bases: object

세금계산서 요약

id: str

세금계산서 아이디

taxation_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE'] | str

과세 유형

document_modification_type: Literal['NORMAL', 'MODIFICATION'] | str

문서 유형

issuance_type: Literal['NORMAL', 'REVERSE'] | str

발행 유형

total_supply_amount: int

공급가액 합계 (int64)

total_tax_amount: int

세액 합계 (int64)

total_amount: int

합계 금액 (int64)

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE'] | str

영수/청구

supplier_brn: str

공급자 사업자등록번호

supplier_name: str

공급자 상호

supplier_representative_name: str

공급자 대표자 성명

recipient_brn: str

공급받는자 사업자등록번호

recipient_name: str

공급받는자 상호

recipient_representative_name: str

공급받는자 대표자 성명

write_date: str

작성일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

issuance_due_date: str

발행 마감일

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

status: Literal['DRAFTED', 'DRAFT_PENDING', 'DRAFT_FAILED', 'REQUESTED', 'REQUEST_PENDING', 'REQUEST_FAILED', 'REQUEST_CANCELLED', 'ISSUED', 'ISSUE_PENDING', 'ISSUE_FAILED', 'BEFORE_SENDING', 'WAITING_SENDING', 'SENDING', 'SENDING_COMPLETED', 'SENDING_FAILED', 'REQUEST_REFUSED', 'ISSUANCE_CANCELLED'] | str

상태

status_updated_at: str

상태 변경 일시 (RFC 3339 date-time)

items: list[B2bTaxInvoiceItem]

품목

최대 99개

is_delayed: bool | None

지연 발행 여부

bulk_tax_invoice_id: str | None

일괄 발행 아이디

payout_id: str | None

지급 아이디

supplier_document_key: str | None

공급자 문서번호

recipient_document_key: str | None

공급받는자 문서번호

recipient_business_status: Literal['IN_BUSINESS', 'CLOSED', 'SUSPENDED'] | str | None

공급받는자 영업 상태

recipient_closed_suspended_date: str | None

공급받는자 휴폐업일자

상태가 CLOSED, SUSPENDED 상태인 경우에만 결과값 반환 (yyyy-MM-dd)

drafted_at: str | None

임시 저장 일시 (RFC 3339 date-time)

requested_at: str | None

발행 요청 일시 (RFC 3339 date-time)

issued_at: str | None

발행 일시 (RFC 3339 date-time)

opened_at: str | None

개봉 일시 (RFC 3339 date-time)

nts_sent_at: str | None

국세청 전송 일시 (RFC 3339 date-time)

nts_approval_number: str | None

국세청 승인번호

세금계산서 발행(전자서명) 시점에 자동으로 부여

nts_result: str | None

국세청 전송 결과

nts_result_received_at: str | None

국세청 결과 수신 일시 (RFC 3339 date-time)

nts_result_code: str | None

국세청 결과 코드

국세청 발급 결과 코드로 영문 3자리 + 숫자 3자리로 구성됨

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceIssuanceBody

Bases: object

세금계산서 취소 정보

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceIssuanceResponse

Bases: object

세금계산서 취소 응답

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceRequestBody

Bases: object

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

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.CancelB2bTaxInvoiceRequestResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.CreateB2bFileUploadUrlBody

Bases: object

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

file_name: str

파일 이름

class portone_server_sdk.b2b.tax_invoice.CreateB2bFileUploadUrlPayload

Bases: object

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

file_id: str

파일 아이디

url: str

파일 업로드 URL

class portone_server_sdk.b2b.tax_invoice.DateRangeOption

Bases: object

from_: str | None

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

until: str | None

날짜를 나타내는 문자열로, yyyy-MM-dd 형식을 따릅니다. (yyyy-MM-dd)

class portone_server_sdk.b2b.tax_invoice.Decimal

Bases: object

BigDecimal 타입

value: int

비정규화된 값

소수점 숫자의 비정규화된(unscaled) 값을 정수로 저장합니다. 예를 들어, 123.45의 경우 12345가 저장됩니다. (int64)

scale: int | None

소수점 이하 자릿수

소수점 숫자의 소수점 이하 자릿수를 저장합니다. 기본값은 0입니다. 예를 들어, 123.45의 경우 2가 저장됩니다. (int32)

class portone_server_sdk.b2b.tax_invoice.DeleteB2bTaxInvoiceResponse

Bases: object

class portone_server_sdk.b2b.tax_invoice.DownloadB2bTaxInvoicesSheetBody

Bases: object

filter: GetB2bTaxInvoicesBodyFilter | None

fields: list[Literal['STATUS', 'CANCEL_REASON', 'ISSUANCE_TYPE', 'DOCUMENT_MODIFICATION_TYPE', 'IS_DELAYED', 'WRITE_DATE', 'ISSUANCE_DUE_DATE', 'TAXATION_TYPE', 'PURPOSE_TYPE', 'PARTNER_NAME', 'PARTNER_BRN', 'TOTAL_AMOUNT', 'TOTAL_SUPPLY_AMOUNT', 'TOTAL_TAX_AMOUNT', 'MEMO', 'REQUESTED_AT', 'ISSUED_AT', 'NTS_SENT_AT', 'STATUS_UPDATED_AT', 'BULK_TAX_INVOICE_ID', 'PLAIN_ID', 'SUPPLIER_DOCUMENT_KEY', 'RECIPIENT_DOCUMENT_KEY', 'PAYOUT_ID', 'ITEMS'] | str] | None

다운로드 할 시트 컬럼

test: bool | None

class portone_server_sdk.b2b.tax_invoice.DraftB2bTaxInvoiceBody

Bases: object

세금계산서 임시 저장 정보

tax_invoice: B2bTaxInvoiceInput

세금계산서 생성 요청 정보

modification: B2bTaxInvoiceModificationCreateBody | None

수정 세금계산서 입력 정보

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.DraftB2bTaxInvoiceResponse

Bases: object

세금계산서 임시 저장 응답

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoiceAttachmentsResponse

Bases: object

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

attachments: list[B2bTaxInvoiceAttachment]

첨부파일 목록

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePdfDownloadUrlResponse

Bases: object

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

url: str

세금계산서 PDF 다운로드 URL

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePopupUrlResponse

Bases: object

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

url: str

세금계산서 팝업 URL

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicePrintUrlResponse

Bases: object

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

url: str

세금계산서 프린트 URL

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesBody

Bases: object

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

test: bool | None

테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

page_number: int | None

페이지 번호

0부터 시작하는 페이지 번호. 기본 값은 0. (int32)

page_size: int | None

페이지 크기

각 페이지 당 포함할 객체 수. 기본 값은 500이며 최대 1000까지 요청가능합니다. (int32)

filter: GetB2bTaxInvoicesBodyFilter | None

필터

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesBodyDateFilter

Bases: object

조회 기간 필터

date_type: Literal['REGISTER', 'WRITE', 'ISSUE'] | str | None

조회 기간 기준

미입력시 기본값은 등록일(REGISTER)로 설정됩니다.

date_range: list[DateRangeOption] | None

조회 기간

미입력시 `dateRange.from`의 기본값은 한 달 이전, `dateRange.until`의 기본값은 현재 일자로 설정됩니다.

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesBodyFilter

Bases: object

세금계산서 다건 조회 필터

primary_filter: GetB2bTaxInvoicesBodyPrimaryFilter | None

상위 필터

가장 주요 항목을 설정하는 상위 필터이며 사용할 때는 주어진 필드 중 한 개의 필드만 입력합니다.

supplier_brn: str | None

공급자 사업자등록번호

partner_brn: str | None

거래처 사업자등록번호

역발행의 경우 공급자 사업자등록번호, 정발행의 경우 공급받는자 사업자등록번호에 대해 조회합니다.

statuses: list[Literal['DRAFTED', 'DRAFT_PENDING', 'DRAFT_FAILED', 'REQUESTED', 'REQUEST_PENDING', 'REQUEST_FAILED', 'REQUEST_CANCELLED', 'ISSUED', 'ISSUE_PENDING', 'ISSUE_FAILED', 'BEFORE_SENDING', 'WAITING_SENDING', 'SENDING', 'SENDING_COMPLETED', 'SENDING_FAILED', 'REQUEST_REFUSED', 'ISSUANCE_CANCELLED'] | str] | None

세금계산서 상태

미입력시 모든 상태를 조회합니다.

taxation_types: list[Literal['TAXABLE', 'ZERO_RATED', 'FREE'] | str] | None

과세 유형

document_modification_types: list[Literal['NORMAL', 'MODIFICATION'] | str] | None

문서 유형

is_delayed: bool | None

지연 발행 여부

issuance_types: list[Literal['NORMAL', 'REVERSE'] | str] | None

발행 유형

purpose_types: list[Literal['RECEIPT', 'INVOICE', 'NONE'] | str] | None

영수/청구

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesBodyPrimaryFilter

Bases: object

상위 필터

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

date_filter: GetB2bTaxInvoicesBodyDateFilter | None

조회 기간

tax_invoice_id: str | None

세금계산서 아이디

bulk_tax_invoice_id: str | None

일괄발행 아이디

nts_approval_number: str | None

국세청 승인번호

supplier_document_key: str | None

공급자 문서번호

recipient_document_key: str | None

공급받는자 승인번호

tax_invoice_ids: list[str] | None

세금계산서 아이디 리스트

payout_id: str | None

지급 아이디

class portone_server_sdk.b2b.tax_invoice.GetB2bTaxInvoicesResponse

Bases: object

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

items: list[B2bTaxInvoiceSummary]

조회된 세금계산서 목록

page: PageInfo

조회된 페이지 정보

class portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceBody

Bases: object

세금계산서 발행 승인 정보

memo: str | None

메모

email_subject: str | None

이메일 제목

class portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceImmediatelyBody

Bases: object

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

tax_invoice: B2bTaxInvoiceInput

세금계산서 생성 요청 정보

memo: str | None

메모

modification: B2bTaxInvoiceModificationCreateBody | None

수정 세금계산서 입력 정보

class portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceImmediatelyResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.IssueB2bTaxInvoiceResponse

Bases: object

세금계산서 발행 승인 응답

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.Map_Stat

Bases: object

additional_properties: dict[str, B2bBulkTaxInvoiceStat]

추가 데이터

class portone_server_sdk.b2b.tax_invoice.RefuseB2bTaxInvoiceRequestBody

Bases: object

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

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.RefuseB2bTaxInvoiceRequestResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.RequestB2bTaxInvoiceResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.RequestB2bTaxInvoiceReverseIssuanceBody

Bases: object

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

tax_invoice: B2bTaxInvoiceInput

세금계산서 생성 요청 정보

memo: str | None

메모

modification: B2bTaxInvoiceModificationCreateBody | None

수정 세금계산서 입력 정보

class portone_server_sdk.b2b.tax_invoice.RequestB2bTaxInvoiceReverseIssuanceResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.SendToNtsB2bTaxInvoiceResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.UpdateB2bTaxInvoiceDraftBody

Bases: object

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

tax_invoice_key: str

세금계산서 문서 번호

tax_invoice: B2bTaxInvoiceInput

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

brn: str | None

사업자등록번호

taxInvoiceKeyType이 TAX_INVOICE_ID가 아닌 경우 필수 값입니다.

tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None

문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.

memo: str | None

메모

class portone_server_sdk.b2b.tax_invoice.UpdateB2bTaxInvoiceDraftResponse

Bases: object

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

tax_invoice: B2bTaxInvoice

class portone_server_sdk.b2b.tax_invoice.TaxInvoiceClient

Bases: object

get_b2b_bulk_tax_invoice(*, bulk_tax_invoice_id: str, test: bool | None = None) → B2bBulkTaxInvoice

일괄 세금계산서 조회

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

Parameters:

• bulk_tax_invoice_id (str) – 일괄 세금계산서 아이디

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bBulkTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_bulk_tax_invoice_async(*, bulk_tax_invoice_id: str, test: bool | None = None) → B2bBulkTaxInvoice

일괄 세금계산서 조회

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

Parameters:

• bulk_tax_invoice_id (str) – 일괄 세금계산서 아이디

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bBulkTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

create_b2b_file_upload_url(*, test: bool | None = None, file_name: str) → CreateB2bFileUploadUrlPayload

파일 업로드 URL 생성

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• file_name (str) – 파일 이름

Raises:

• CreateB2bFileUploadUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async create_b2b_file_upload_url_async(*, test: bool | None = None, file_name: str) → CreateB2bFileUploadUrlPayload

파일 업로드 URL 생성

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• file_name (str) – 파일 이름

Raises:

• CreateB2bFileUploadUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

download_b2b_tax_invoices_sheet(*, filter: GetB2bTaxInvoicesBodyFilter | None = None, fields: list[Literal['STATUS', 'CANCEL_REASON', 'ISSUANCE_TYPE', 'DOCUMENT_MODIFICATION_TYPE', 'IS_DELAYED', 'WRITE_DATE', 'ISSUANCE_DUE_DATE', 'TAXATION_TYPE', 'PURPOSE_TYPE', 'PARTNER_NAME', 'PARTNER_BRN', 'TOTAL_AMOUNT', 'TOTAL_SUPPLY_AMOUNT', 'TOTAL_TAX_AMOUNT', 'MEMO', 'REQUESTED_AT', 'ISSUED_AT', 'NTS_SENT_AT', 'STATUS_UPDATED_AT', 'BULK_TAX_INVOICE_ID', 'PLAIN_ID', 'SUPPLIER_DOCUMENT_KEY', 'RECIPIENT_DOCUMENT_KEY', 'PAYOUT_ID', 'ITEMS'] | str] | None = None, test: bool | None = None) → str

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

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

Parameters:

• filter (GetB2bTaxInvoicesBodyFilter, optional)

• fields (list[TaxInvoicesSheetField], optional) – 다운로드 할 시트 컬럼

• test (bool, optional)

Raises:

• DownloadB2bTaxInvoicesSheetError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async download_b2b_tax_invoices_sheet_async(*, filter: GetB2bTaxInvoicesBodyFilter | None = None, fields: list[Literal['STATUS', 'CANCEL_REASON', 'ISSUANCE_TYPE', 'DOCUMENT_MODIFICATION_TYPE', 'IS_DELAYED', 'WRITE_DATE', 'ISSUANCE_DUE_DATE', 'TAXATION_TYPE', 'PURPOSE_TYPE', 'PARTNER_NAME', 'PARTNER_BRN', 'TOTAL_AMOUNT', 'TOTAL_SUPPLY_AMOUNT', 'TOTAL_TAX_AMOUNT', 'MEMO', 'REQUESTED_AT', 'ISSUED_AT', 'NTS_SENT_AT', 'STATUS_UPDATED_AT', 'BULK_TAX_INVOICE_ID', 'PLAIN_ID', 'SUPPLIER_DOCUMENT_KEY', 'RECIPIENT_DOCUMENT_KEY', 'PAYOUT_ID', 'ITEMS'] | str] | None = None, test: bool | None = None) → str

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

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

Parameters:

• filter (GetB2bTaxInvoicesBodyFilter, optional)

• fields (list[TaxInvoicesSheetField], optional) – 다운로드 할 시트 컬럼

• test (bool, optional)

Raises:

• DownloadB2bTaxInvoicesSheetError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

update_b2b_tax_invoice_draft(*, test: bool | None = None, brn: str | None = None, tax_invoice_key: str, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None) → UpdateB2bTaxInvoiceDraftResponse

세금계산서 임시저장 수정

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• brn (str, optional) –

  사업자등록번호

  taxInvoiceKeyType이 TAX_INVOICE_ID가 아닌 경우 필수 값입니다.

• tax_invoice_key (str) – 세금계산서 문서 번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 임시저장 수정 정보

• memo (str, optional) – 메모

Raises:

• UpdateB2bTaxInvoiceDraftError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async update_b2b_tax_invoice_draft_async(*, test: bool | None = None, brn: str | None = None, tax_invoice_key: str, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None) → UpdateB2bTaxInvoiceDraftResponse

세금계산서 임시저장 수정

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• brn (str, optional) –

  사업자등록번호

  taxInvoiceKeyType이 TAX_INVOICE_ID가 아닌 경우 필수 값입니다.

• tax_invoice_key (str) – 세금계산서 문서 번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 임시저장 수정 정보

• memo (str, optional) – 메모

Raises:

• UpdateB2bTaxInvoiceDraftError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

draft_b2b_tax_invoice(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, modification: B2bTaxInvoiceModificationCreateBody | None = None, memo: str | None = None) → DraftB2bTaxInvoiceResponse

세금계산서 임시 저장

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

• memo (str, optional) – 메모

Raises:

• DraftB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async draft_b2b_tax_invoice_async(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, modification: B2bTaxInvoiceModificationCreateBody | None = None, memo: str | None = None) → DraftB2bTaxInvoiceResponse

세금계산서 임시 저장

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

• memo (str, optional) – 메모

Raises:

• DraftB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

issue_b2b_tax_invoice_immediately(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None, modification: B2bTaxInvoiceModificationCreateBody | None = None) → IssueB2bTaxInvoiceImmediatelyResponse

세금계산서 즉시 정발행

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• memo (str, optional) – 메모

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

Raises:

• IssueB2bTaxInvoiceImmediatelyError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async issue_b2b_tax_invoice_immediately_async(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None, modification: B2bTaxInvoiceModificationCreateBody | None = None) → IssueB2bTaxInvoiceImmediatelyResponse

세금계산서 즉시 정발행

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• memo (str, optional) – 메모

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

Raises:

• IssueB2bTaxInvoiceImmediatelyError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

request_b2b_tax_invoice_reverse_issuance(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None, modification: B2bTaxInvoiceModificationCreateBody | None = None) → RequestB2bTaxInvoiceReverseIssuanceResponse

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

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• memo (str, optional) – 메모

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

Raises:

• RequestB2bTaxInvoiceReverseIssuanceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async request_b2b_tax_invoice_reverse_issuance_async(*, test: bool | None = None, tax_invoice: B2bTaxInvoiceInput, memo: str | None = None, modification: B2bTaxInvoiceModificationCreateBody | None = None) → RequestB2bTaxInvoiceReverseIssuanceResponse

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

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

• memo (str, optional) – 메모

• modification (B2bTaxInvoiceModificationCreateBody, optional) – 수정 세금계산서 입력 정보

Raises:

• RequestB2bTaxInvoiceReverseIssuanceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

attach_b2b_tax_invoice_file(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, file_id: str) → None

세금계산서 파일 첨부

세금계산서에 파일을 첨부합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• file_id (str) – 파일 아이디

Raises:

• AttachB2bTaxInvoiceFileError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async attach_b2b_tax_invoice_file_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, file_id: str) → None

세금계산서 파일 첨부

세금계산서에 파일을 첨부합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• file_id (str) – 파일 아이디

Raises:

• AttachB2bTaxInvoiceFileError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

delete_b2b_tax_invoice_attachment(*, tax_invoice_key: str, attachment_id: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → None

세금계산서 첨부파일 삭제

세금계산서 첨부파일을 삭제합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• attachment_id (str) – 첨부파일 아이디

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• DeleteB2bTaxInvoiceAttachmentError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async delete_b2b_tax_invoice_attachment_async(*, tax_invoice_key: str, attachment_id: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → None

세금계산서 첨부파일 삭제

세금계산서 첨부파일을 삭제합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• attachment_id (str) – 첨부파일 아이디

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• DeleteB2bTaxInvoiceAttachmentError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoice_attachments(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoiceAttachmentsResponse

세금계산서 첨부파일 목록 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoiceAttachmentsError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoice_attachments_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoiceAttachmentsResponse

세금계산서 첨부파일 목록 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoiceAttachmentsError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

cancel_b2b_tax_invoice_issuance(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → CancelB2bTaxInvoiceIssuanceResponse

세금계산서 취소 (공급자에 의한 취소)

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• CancelB2bTaxInvoiceIssuanceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async cancel_b2b_tax_invoice_issuance_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → CancelB2bTaxInvoiceIssuanceResponse

세금계산서 취소 (공급자에 의한 취소)

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• CancelB2bTaxInvoiceIssuanceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

cancel_b2b_tax_invoice_request(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → CancelB2bTaxInvoiceRequestResponse

세금계산서 역발행 요청 취소 (공급받는자에 의한 취소)

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• CancelB2bTaxInvoiceRequestError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async cancel_b2b_tax_invoice_request_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → CancelB2bTaxInvoiceRequestResponse

세금계산서 역발행 요청 취소 (공급받는자에 의한 취소)

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• CancelB2bTaxInvoiceRequestError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

issue_b2b_tax_invoice(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None, email_subject: str | None = None) → IssueB2bTaxInvoiceResponse

세금계산서 발행 승인

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

• email_subject (str, optional) – 이메일 제목

Raises:

• IssueB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async issue_b2b_tax_invoice_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None, email_subject: str | None = None) → IssueB2bTaxInvoiceResponse

세금계산서 발행 승인

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

• email_subject (str, optional) – 이메일 제목

Raises:

• IssueB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoice_pdf_download_url(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoicePdfDownloadUrlResponse

세금 계산서 PDF 다운로드 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePdfDownloadUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoice_pdf_download_url_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoicePdfDownloadUrlResponse

세금 계산서 PDF 다운로드 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePdfDownloadUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoice_popup_url(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, include_menu: bool | None = None, test: bool | None = None) → GetB2bTaxInvoicePopupUrlResponse

세금 계산서 팝업 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• include_menu (bool, optional) –

  메뉴 포함 여부

  팝업 URL에 메뉴 레이아웃을 포함 여부를 결정합니다. 기본 값은 true입니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePopupUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoice_popup_url_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, include_menu: bool | None = None, test: bool | None = None) → GetB2bTaxInvoicePopupUrlResponse

세금 계산서 팝업 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• include_menu (bool, optional) –

  메뉴 포함 여부

  팝업 URL에 메뉴 레이아웃을 포함 여부를 결정합니다. 기본 값은 true입니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePopupUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoice_print_url(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoicePrintUrlResponse

세금 계산서 프린트 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePrintUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoice_print_url_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → GetB2bTaxInvoicePrintUrlResponse

세금 계산서 프린트 URL 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoicePrintUrlError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

refuse_b2b_tax_invoice_request(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → RefuseB2bTaxInvoiceRequestResponse

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

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• RefuseB2bTaxInvoiceRequestError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async refuse_b2b_tax_invoice_request_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None, memo: str | None = None) → RefuseB2bTaxInvoiceRequestResponse

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

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• memo (str, optional) – 메모

Raises:

• RefuseB2bTaxInvoiceRequestError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

request_b2b_tax_invoice(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → RequestB2bTaxInvoiceResponse

세금계산서 역발행 요청

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• requestB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async request_b2b_tax_invoice_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → RequestB2bTaxInvoiceResponse

세금계산서 역발행 요청

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• requestB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

send_to_nts_b2b_tax_invoice(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → SendToNtsB2bTaxInvoiceResponse

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

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• SendToNtsB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async send_to_nts_b2b_tax_invoice_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → SendToNtsB2bTaxInvoiceResponse

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

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• SendToNtsB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoice(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → B2bTaxInvoice

세금 계산서 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoice_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → B2bTaxInvoice

세금 계산서 조회

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

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• GetB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

delete_b2b_tax_invoice(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → DeleteB2bTaxInvoiceResponse

세금계산서 삭제

세금계산서를 삭제합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• DeleteB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async delete_b2b_tax_invoice_async(*, tax_invoice_key: str, brn: str | None = None, tax_invoice_key_type: Literal['SUPPLIER', 'RECIPIENT', 'TAX_INVOICE_ID'] | str | None = None, test: bool | None = None) → DeleteB2bTaxInvoiceResponse

세금계산서 삭제

세금계산서를 삭제합니다.

Parameters:

• tax_invoice_key (str) – 세금계산서 문서 번호

• brn (str, optional) – 사업자등록번호

• tax_invoice_key_type (B2bTaxInvoiceKeyType, optional) –

  문서 번호 유형

  query 파라미터로 전달된 문서번호 유형. 기본 값은 TAX_INVOICE_ID이며 SUPPLIER, RECIPIENT, TAX_INVOICE_ID을 지원합니다.

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

Raises:

• DeleteB2bTaxInvoiceError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

get_b2b_tax_invoices(*, test: bool | None = None, page_number: int | None = None, page_size: int | None = None, filter: GetB2bTaxInvoicesBodyFilter | None = None) → GetB2bTaxInvoicesResponse

세금 계산서 다건조회

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• page_number (int, optional) –

  페이지 번호

  0부터 시작하는 페이지 번호. 기본 값은 0. (int32)

• page_size (int, optional) –

  페이지 크기

  각 페이지 당 포함할 객체 수. 기본 값은 500이며 최대 1000까지 요청가능합니다. (int32)

• filter (GetB2bTaxInvoicesBodyFilter, optional) – 필터

Raises:

• GetB2bTaxInvoicesError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우

async get_b2b_tax_invoices_async(*, test: bool | None = None, page_number: int | None = None, page_size: int | None = None, filter: GetB2bTaxInvoicesBodyFilter | None = None) → GetB2bTaxInvoicesResponse

세금 계산서 다건조회

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

Parameters:

• test (bool, optional) –

  테스트 모드 여부

  true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.

• page_number (int, optional) –

  페이지 번호

  0부터 시작하는 페이지 번호. 기본 값은 0. (int32)

• page_size (int, optional) –

  페이지 크기

  각 페이지 당 포함할 객체 수. 기본 값은 500이며 최대 1000까지 요청가능합니다. (int32)

• filter (GetB2bTaxInvoicesBodyFilter, optional) – 필터

Raises:

• GetB2bTaxInvoicesError – API 호출이 실패한 경우

• ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우