portone_server_sdk.TaxInvoiceClient

class portone_server_sdk.TaxInvoiceClient

Bases: object

__init__(*, secret: str, base_url: str = 'https://api.portone.io', store_id: str | None = None)

API Secret을 사용해 포트원 API 클라이언트를 생성합니다.

Parameters:

• secret (str) – 포트원 API Secret입니다.

• base_url (str, optional) – 포트원 REST API 주소입니다. 기본값은 `”https://api.portone.io”`입니다.

• store_id – 하위 상점에 대해 기능을 사용할 때 필요한 하위 상점의 ID입니다.

Methods

__init__(*, secret[, base_url, store_id])	API Secret을 사용해 포트원 API 클라이언트를 생성합니다.
attach_b2b_tax_invoice_file(*, tax_invoice_key)	세금계산서 파일 첨부
attach_b2b_tax_invoice_file_async(*, ...[, ...])	세금계산서 파일 첨부
cancel_b2b_tax_invoice_issuance(*, ...[, ...])	세금계산서 취소 (공급자에 의한 취소)
cancel_b2b_tax_invoice_issuance_async(*, ...)	세금계산서 취소 (공급자에 의한 취소)
cancel_b2b_tax_invoice_request(*, ...[, ...])	세금계산서 역발행 요청 취소 (공급받는자에 의한 취소)
cancel_b2b_tax_invoice_request_async(*, ...)	세금계산서 역발행 요청 취소 (공급받는자에 의한 취소)
create_b2b_file_upload_url(*[, test])	파일 업로드 URL 생성
create_b2b_file_upload_url_async(*[, test])	파일 업로드 URL 생성
delete_b2b_tax_invoice(*, tax_invoice_key[, ...])	세금계산서 삭제
delete_b2b_tax_invoice_async(*, tax_invoice_key)	세금계산서 삭제
delete_b2b_tax_invoice_attachment(*, ...[, ...])	세금계산서 첨부파일 삭제
delete_b2b_tax_invoice_attachment_async(*, ...)	세금계산서 첨부파일 삭제
download_b2b_tax_invoices_sheet(*[, filter, ...])	세금계산서 엑셀 파일(csv) 다운로드
download_b2b_tax_invoices_sheet_async(*[, ...])	세금계산서 엑셀 파일(csv) 다운로드
draft_b2b_tax_invoice(*[, test, ...])	세금계산서 임시 저장
draft_b2b_tax_invoice_async(*[, test, ...])	세금계산서 임시 저장
get_b2b_bulk_tax_invoice(*, bulk_tax_invoice_id)	일괄 세금계산서 조회
get_b2b_bulk_tax_invoice_async(*, ...[, test])	일괄 세금계산서 조회
get_b2b_tax_invoice(*, tax_invoice_key[, ...])	세금 계산서 조회
get_b2b_tax_invoice_async(*, tax_invoice_key)	세금 계산서 조회
get_b2b_tax_invoice_attachments(*, ...[, ...])	세금계산서 첨부파일 목록 조회
get_b2b_tax_invoice_attachments_async(*, ...)	세금계산서 첨부파일 목록 조회
get_b2b_tax_invoice_pdf_download_url(*, ...)	세금 계산서 PDF 다운로드 URL 조회
get_b2b_tax_invoice_pdf_download_url_async(*, ...)	세금 계산서 PDF 다운로드 URL 조회
get_b2b_tax_invoice_popup_url(*, tax_invoice_key)	세금 계산서 팝업 URL 조회
get_b2b_tax_invoice_popup_url_async(*, ...)	세금 계산서 팝업 URL 조회
get_b2b_tax_invoice_print_url(*, tax_invoice_key)	세금 계산서 프린트 URL 조회
get_b2b_tax_invoice_print_url_async(*, ...)	세금 계산서 프린트 URL 조회
get_b2b_tax_invoices(*[, test, page_number, ...])	세금 계산서 다건조회
get_b2b_tax_invoices_async(*[, test, ...])	세금 계산서 다건조회
issue_b2b_tax_invoice(*, tax_invoice_key[, ...])	세금계산서 발행 승인
issue_b2b_tax_invoice_async(*, tax_invoice_key)	세금계산서 발행 승인
issue_b2b_tax_invoice_immediately(*[, test, ...])	세금계산서 즉시 정발행
issue_b2b_tax_invoice_immediately_async(*[, ...])	세금계산서 즉시 정발행
refuse_b2b_tax_invoice_request(*, ...[, ...])	세금계산서 역발행 요청 거부
refuse_b2b_tax_invoice_request_async(*, ...)	세금계산서 역발행 요청 거부
request_b2b_tax_invoice(*, tax_invoice_key)	세금계산서 역발행 요청
request_b2b_tax_invoice_async(*, tax_invoice_key)	세금계산서 역발행 요청
request_b2b_tax_invoice_reverse_issuance(*)	세금계산서 역발행 즉시 요청
request_b2b_tax_invoice_reverse_issuance_async(*)	세금계산서 역발행 즉시 요청
send_to_nts_b2b_tax_invoice(*, tax_invoice_key)	세금계산서 국세청 즉시 전송
send_to_nts_b2b_tax_invoice_async(*, ...[, ...])	세금계산서 국세청 즉시 전송
update_b2b_tax_invoice_draft(*[, test, brn, ...])	세금계산서 임시저장 수정
update_b2b_tax_invoice_draft_async(*[, ...])	세금계산서 임시저장 수정

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 응답을 받은 경우