portone_server_sdk.b2b

portone_server_sdk.b2b#

Classes

`AttachB2bTaxInvoiceFileBody`	세금계산서 파일 첨부 정보
`B2bCertificate`
`B2bCompanyContact`
`B2bCompanyContactInput`
`B2bCompanyState`	사업자 상태
`B2bMemberCompany`
`B2bModification`	세금 계산서 수정
`B2bTaxInvoiceAdditionalContact`	추가 담당자
`B2bTaxInvoiceAttachment`	세금계산서 첨부파일
`B2bTaxInvoiceBeforeSending`
`B2bTaxInvoiceCompany`
`B2bTaxInvoiceContact`	세금계산서 담당자
`B2bTaxInvoiceInput`	세금계산서 생성 요청 정보
`B2bTaxInvoiceIssuanceCancelled`
`B2bTaxInvoiceIssued`
`B2bTaxInvoiceItem`	품목
`B2bTaxInvoiceRegistered`
`B2bTaxInvoiceRequestCancelled`
`B2bTaxInvoiceRequestRefused`
`B2bTaxInvoiceRequested`
`B2bTaxInvoiceSending`
`B2bTaxInvoiceSendingCompleted`
`B2bTaxInvoiceSendingFailed`
`B2bTaxInvoiceSummary`	세금계산서 요약
`B2bTaxInvoiceWaitingSending`
`CancelB2bTaxInvoiceIssuanceBody`	세금계산서 역발행 취소 정보
`CancelB2bTaxInvoiceRequestBody`	세금계산서 역발행 요청 취소 정보
`CreateB2bTaxInvoiceFileUploadLinkBody`	세금계산서 파일 업로드 링크 생성
`CreateB2bTaxInvoiceFileUploadLinkResponse`	세금계산서 파일 업로드 링크 생성 성공 응답
`GetB2bBankAccountHolderResponse`	예금주 조회 응답 정보
`GetB2bCertificateRegistrationUrlResponse`	인증서 등록 URL 조회 응답 정보
`GetB2bContactIdExistenceResponse`	담당자 ID 존재 여부 응답 정보
`GetB2bTaxInvoiceAttachmentsResponse`	세금계산서 첨부파일 목록 조회 성공 응답
`GetB2bTaxInvoicePdfDownloadUrlResponse`	세금계산서 PDF 다운로드 URL 성공 응답
`GetB2bTaxInvoicePopupUrlResponse`	세금계산서 팝업 URL 성공 응답
`GetB2bTaxInvoicePrintUrlResponse`	세금계산서 프린트 URL 성공 응답
`GetB2bTaxInvoicesResponse`	세금계산서 다건 조회 성공 응답
`IssueB2bTaxInvoiceRequestBody`	세금계산서 발행 정보
`RefuseB2bTaxInvoiceRequestBody`	세금계산서 역발행 요청 거부 정보
`RegisterB2bMemberCompanyBody`	사업자 연동 요청 정보
`RegisterB2bMemberCompanyResponse`	사업자 연동 응답 정보
`RequestB2bTaxInvoiceRegisterBody`	세금계산서 임시 저장 정보
`RequestB2bTaxInvoiceRequestBody`	세금계산서 역발행 요청 정보
`RequestB2bTaxInvoiceReverseIssuanceRequestBody`	세금계산서 역발행 요청 정보
`UpdateB2bMemberCompanyBody`	연동 사업자 정보 수정 요청
`UpdateB2bMemberCompanyContactBody`	담당자 정보 수정 요청
`UpdateB2bMemberCompanyContactResponse`	담당자 정보 수정 응답
`UpdateB2bMemberCompanyResponse`	연동 사업자 정보 수정 응답
`B2BClient`

class portone_server_sdk.b2b.AttachB2bTaxInvoiceFileBody#

세금계산서 파일 첨부 정보

brn: str#

사업자등록번호

- 없이 숫자 10자리로 구성됩니다.

document_key: str#: 세금계산서 문서 번호

file_id: str#: 파일 아이디

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

class portone_server_sdk.b2b.B2bCertificate#

registered_at: str#: 등록일시 (RFC 3339 date-time)

expired_at: str#: 만료일시 (RFC 3339 date-time)

issuer_dn: str#: 발행자명

subject_dn: str#: 본인명

certificate_type: Literal['E_TAX', 'POP_BILL', 'ETC']#: 인증서 타입

oid: str#: OID

registrant_contact_name: str#: 등록 담당자 성명

registrant_contact_id: str#: 등록 담당자 ID

class portone_server_sdk.b2b.B2bCompanyContact#

id: str#

담당자 ID

팝빌 로그인 계정으로 사용됩니다.

name: str#: 담당자 성명

phone_number: str#: 담당자 핸드폰 번호

email: str#: 담당자 이메일

registered_at: str#: 등록 일시 (RFC 3339 date-time)

is_manager: bool#

관리자 여부

true일 경우 관리자, false일 경우 담당자입니다.

class portone_server_sdk.b2b.B2bCompanyContactInput#

id: str#

담당자 ID

팝빌 로그인 계정으로 사용됩니다.

password: str#: 비밀번호

name: str#: 담당자 성명

phone_number: str#: 담당자 핸드폰 번호

email: str#: 담당자 이메일

class portone_server_sdk.b2b.B2bCompanyState#

사업자 상태

taxation_type: Literal['NORMAL', 'TAX_FREE', 'SIMPLE', 'SIMPLE_TAX_INVOICE_ISSUER', 'ASSIGNED_ID_NUMBER']#: 사업자 과세 유형

business_status: Literal['IN_BUSINESS', 'CLOSED', 'SUSPENDED']#: 사업자 영업 상태

taxation_type_date: str | None#

과세 유형 변경 일자

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

closed_suspended_date: str | None#

휴폐업 일자

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

class portone_server_sdk.b2b.B2bMemberCompany#

brn: str#

사업자등록번호

- 없이 숫자로만 구성됩니다.

name: str#: 회사명

ceo_name: str#: 대표자 성명

address: str#: 회사 주소

business_type: str#: 업태

business_class: str#: 업종

class portone_server_sdk.b2b.B2bModification#

세금 계산서 수정

type: Literal['CORRECTION_OF_ENTRY_ERRORS', 'CHANGE_IN_SUPPLY_COST', 'RETURN', 'CANCELLATION_OF_CONTRACT', 'DUPLICATE_ISSUANCE_DUE_TO_ERROR', 'POST_ISSUANCE_LOCAL_LETTER_OF_CREDIT']#: 수정 사유

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

class portone_server_sdk.b2b.B2bTaxInvoiceAdditionalContact#

추가 담당자

email: str#: 이메일

name: str | None#

성명

최대 100자

class portone_server_sdk.b2b.B2bTaxInvoiceAttachment#

세금계산서 첨부파일

id: str#: 첨부 파일 아이디

name: str#: 첨부 파일명

attached_at: str#: 첨부 일시 (RFC 3339 date-time)

class portone_server_sdk.b2b.B2bTaxInvoiceBeforeSending#

status: Literal['BEFORE_SENDING']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceCompany#

brn: str#

사업자등록번호

`-`를 제외한 10자리

tax_registration_id: str | None#

종사업자 식별 번호

4자리 고정

name: str | None#

상호명

최대 200자

ceo_name: str | None#

대표자 성명

최대 100자

address: str | None#

주소

최대 300자

business_type: str | None#

업태

최대 100자

business_class: str | None#

종목

최대 100자

contact: B2bTaxInvoiceContact | None#: 담당자

class portone_server_sdk.b2b.B2bTaxInvoiceContact#

세금계산서 담당자

name: str | None#: 성명

department: str | None#: 부서

phone_number: str | None#: 전화번호

mobile_phone_number: str | None#: 휴대전화번호

email: str | None#: 이메일

class portone_server_sdk.b2b.B2bTaxInvoiceInput#

세금계산서 생성 요청 정보

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

serial_num: 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

modification: B2bModification | None#: 수정 사유 기재

items: list[B2bTaxInvoiceItem] | None#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact] | None#

추가 담당자

최대 3개

class portone_server_sdk.b2b.B2bTaxInvoiceIssuanceCancelled#

status: Literal['ISSUANCE_CANCELLED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

recipient_business_status: Literal['IN_BUSINESS', 'CLOSED', 'SUSPENDED'] | None#: 공급받는자 영업 상태

recipient_closed_suspended_date: str | None#

공급받는자 휴폐업일자

상태가 CLOSED, SUSPENDED 상태인 경우에만 결과값 반환

class portone_server_sdk.b2b.B2bTaxInvoiceIssued#

status: Literal['ISSUED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceItem#

품목

purchase_date: str | None#

결제일

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

name: str | None#

품명

최대 100자

spec: str | None#

규격

최대 100자

quantity: int | None#

수량

입력 범위 : -99999999.99 ~ 999999999.99, 10^-quantityScale 단위로 치환됨 (int64)

quantity_scale: int | None#

수량 단위

입력 범위 : 0 ~ 2, 기본값: 0 (int32)

unit_cost_amount: int | None#

단가

입력 범위 : -99999999999999.99 ~ 999999999999999.99 (int64)

unit_cost_amount_scale: int | None#

단가 단위

입력 범위 : 0 ~ 2, 기본값: 0 (int32)

supply_cost_amount: int | None#: 공급가액 (int64)

tax_amount: int | None#: 세액 (int64)

remark: str | None#: 비고

class portone_server_sdk.b2b.B2bTaxInvoiceRegistered#

status: Literal['REGISTERED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceRequestCancelled#

status: Literal['REQUEST_CANCELLED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceRequestRefused#

status: Literal['ISSUANCE_REFUSED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceRequested#

status: Literal['REQUESTED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceSending#

status: Literal['SENDING']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

nts_sent_at: str#: 국세청 전송 일시 (RFC 3339 date-time)

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.B2bTaxInvoiceSendingCompleted#

status: Literal['SENDING_COMPLETED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

nts_sent_at: str#: 국세청 전송 일시 (RFC 3339 date-time)

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

nts_result: str | None#: 국세청 전송 결과

nts_result_code: str | None#

국세청 결과 코드

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

class portone_server_sdk.b2b.B2bTaxInvoiceSendingFailed#

status: Literal['SENDING_FAILED']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

nts_sent_at: str#: 국세청 전송 일시 (RFC 3339 date-time)

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

nts_result: str | None#: 국세청 전송 결과

nts_result_code: str | None#

국세청 결과 코드

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

class portone_server_sdk.b2b.B2bTaxInvoiceSummary#

세금계산서 요약

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supplier_brn: str#: 공급자 사업자등록번호

supplier_name: str#: 공급자 상호

recipient_brn: str#: 공급받는자 사업자등록번호

recipient_name: str#: 공급받는자 상호

status: Literal['REGISTERED', 'REQUESTED', 'REQUEST_CANCELLED_BY_RECIPIENT', 'ISSUED', 'BEFORE_SENDING', 'WAITING_SENDING', 'SENDING', 'SENDING_COMPLETED', 'SENDING_FAILED', 'REQUEST_REFUSED', 'ISSUANCE_CANCELLED_BY_SUPPLIER']#: 상태

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

supplier_document_key: str | None#: 공급자 문서번호

recipient_document_key: str | None#: 공급받는자 문서번호

recipient_business_status: Literal['IN_BUSINESS', 'CLOSED', 'SUSPENDED'] | None#: 공급받는자 영업 상태

recipient_closed_suspended_date: str | None#

공급받는자 휴폐업일자

상태가 CLOSED, SUSPENDED 상태인 경우에만 결과값 반환

issued_at: str | None#: 발행 일시 (RFC 3339 date-time)

opened_at: str | None#: 개봉 일시 (RFC 3339 date-time)

nts_approve_number: str | None#

국세청 승인번호

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

nts_result: str | None#: 국세청 전송 결과

nts_sent_at: str | None#: 국세청 전송 일시 (RFC 3339 date-time)

nts_result_received_at: str | None#: 국세청 결과 수신 일시 (RFC 3339 date-time)

nts_result_code: str | None#

국세청 결과 코드

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

class portone_server_sdk.b2b.B2bTaxInvoiceWaitingSending#

status: Literal['WAITING_SENDING']#: 세금계산서 상태

tax_type: Literal['TAXABLE', 'ZERO_RATED', 'FREE']#: 과세 유형

write_date: str#

작성일

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

purpose_type: Literal['RECEIPT', 'INVOICE', 'NONE']#: 영수/청구

supply_cost_total_amount: int#: 공급가액 합계 (int64)

tax_total_amount: int#: 세액 합계 (int64)

total_amount: int#: 합계 금액 (int64)

remarks: list[str]#

비고

최대 3개

supplier: B2bTaxInvoiceCompany#: 공급자

recipient: B2bTaxInvoiceCompany#: 공급받는자

send_sms: bool#: 문자 전송 여부

items: list[B2bTaxInvoiceItem]#

품목

최대 99개

contacts: list[B2bTaxInvoiceAdditionalContact]#

추가 담당자

최대 3개

status_updated_at: str#: 상태 변경 일시 (RFC 3339 date-time)

issued_at: str#: 발행 일시 (RFC 3339 date-time)

nts_approve_number: str#

국세청 승인번호

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

serial_num: 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#: 공급받는자 문서번호

modification: B2bModification | None#: 수정 사유 기재

class portone_server_sdk.b2b.CancelB2bTaxInvoiceIssuanceBody#

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

brn: str#: 사업자등록번호

document_key: str#: 세금계산서 문서 번호

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

memo: str | None#: 메모

class portone_server_sdk.b2b.CancelB2bTaxInvoiceRequestBody#

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

brn: str#: 사업자등록번호

document_key: str#: 세금계산서 문서 번호

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

memo: str | None#: 메모

class portone_server_sdk.b2b.CreateB2bTaxInvoiceFileUploadLinkBody#

세금계산서 파일 업로드 링크 생성

file_name: str#: 파일 이름

class portone_server_sdk.b2b.CreateB2bTaxInvoiceFileUploadLinkResponse#

세금계산서 파일 업로드 링크 생성 성공 응답

file_id: str#: 파일 아이디

url: str#: 파일 업로드 링크

class portone_server_sdk.b2b.GetB2bBankAccountHolderResponse#

예금주 조회 응답 정보

account_holder: str#: 예금주

class portone_server_sdk.b2b.GetB2bCertificateRegistrationUrlResponse#

인증서 등록 URL 조회 응답 정보

url: str#: 인증서 등록 URL

class portone_server_sdk.b2b.GetB2bContactIdExistenceResponse#

담당자 ID 존재 여부 응답 정보

exists: bool#: 존재 여부

class portone_server_sdk.b2b.GetB2bTaxInvoiceAttachmentsResponse#

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

attachments: list[B2bTaxInvoiceAttachment]#: 첨부파일 목록

class portone_server_sdk.b2b.GetB2bTaxInvoicePdfDownloadUrlResponse#

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

url: str#: 세금계산서 PDF 다운로드 URL

class portone_server_sdk.b2b.GetB2bTaxInvoicePopupUrlResponse#

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

url: str#: 세금계산서 팝업 URL

class portone_server_sdk.b2b.GetB2bTaxInvoicePrintUrlResponse#

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

url: str#: 세금계산서 프린트 URL

class portone_server_sdk.b2b.GetB2bTaxInvoicesResponse#

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

items: list[B2bTaxInvoiceSummary]#: 조회된 세금계산서 목록

page: PageInfo#: 조회된 페이지 정보

class portone_server_sdk.b2b.IssueB2bTaxInvoiceRequestBody#

세금계산서 발행 정보

brn: str#: 사업자등록번호

document_key: str#: 세금계산서 문서 번호

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

memo: str | None#: 메모

email_subject: str | None#: 이메일 제목

class portone_server_sdk.b2b.RefuseB2bTaxInvoiceRequestBody#

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

brn: str#: 사업자등록번호

document_key: str#: 세금계산서 문서 번호

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

memo: str | None#: 메모

class portone_server_sdk.b2b.RegisterB2bMemberCompanyBody#

사업자 연동 요청 정보

company: B2bMemberCompany#: 사업자 정보

contact: B2bCompanyContactInput#: 담당자 정보

class portone_server_sdk.b2b.RegisterB2bMemberCompanyResponse#

사업자 연동 응답 정보

company: B2bMemberCompany#: 사업자 정보

contact: B2bCompanyContact#: 담당자 정보

class portone_server_sdk.b2b.RequestB2bTaxInvoiceRegisterBody#

세금계산서 임시 저장 정보

tax_invoice: B2bTaxInvoiceInput#: 세금계산서 생성 요청 정보

class portone_server_sdk.b2b.RequestB2bTaxInvoiceRequestBody#

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

brn: str#: 사업자등록번호

document_key: str#: 세금계산서 문서 번호

document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None#

문서 번호 유형

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

memo: str | None#: 메모

class portone_server_sdk.b2b.RequestB2bTaxInvoiceReverseIssuanceRequestBody#

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

tax_invoice: B2bTaxInvoiceInput#: 세금계산서 생성 요청 정보

memo: str | None#: 메모

class portone_server_sdk.b2b.UpdateB2bMemberCompanyBody#

연동 사업자 정보 수정 요청

name: str | None#: 회사명

ceo_name: str | None#: 대표자 성명

address: str | None#: 회사 주소

business_type: str | None#: 업태

business_class: str | None#: 업종

class portone_server_sdk.b2b.UpdateB2bMemberCompanyContactBody#

담당자 정보 수정 요청

password: str | None#: 비밀번호

name: str | None#: 담당자 성명

phone_number: str | None#: 담당자 핸드폰 번호

email: str | None#: 담당자 이메일

class portone_server_sdk.b2b.UpdateB2bMemberCompanyContactResponse#

담당자 정보 수정 응답

contact: B2bCompanyContact#: 담당자 정보

class portone_server_sdk.b2b.UpdateB2bMemberCompanyResponse#

연동 사업자 정보 수정 응답

member_company: B2bMemberCompany#: 연동 사업자 정보

class portone_server_sdk.b2b.B2BClient#

get_b2b_member_company(*, brn: str, test: bool | None = None) → B2bMemberCompany#

연동 사업자 조회

포트원 B2B 서비스에 연동된 사업자를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_member_company_async(*, brn: str, test: bool | None = None) → B2bMemberCompany#

연동 사업자 조회

포트원 B2B 서비스에 연동된 사업자를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

연동 사업자 정보 수정

연동 사업자 정보를 수정합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
name (str, optional) – 회사명
ceo_name (str, optional) – 대표자 성명
address (str, optional) – 회사 주소
business_type (str, optional) – 업태
business_class (str, optional) – 업종

Raises:

B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

연동 사업자 정보 수정

연동 사업자 정보를 수정합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
name (str, optional) – 회사명
ceo_name (str, optional) – 대표자 성명
address (str, optional) – 회사 주소
business_type (str, optional) – 업태
business_class (str, optional) – 업종

Raises:

B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

register_b2b_member_company(*, test: bool | None = None, company: B2bMemberCompany, contact: B2bCompanyContactInput) → RegisterB2bMemberCompanyResponse#

사업자 연동

포트원 B2B 서비스에 사업자를 연동합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
company (B2bMemberCompany) – 사업자 정보
contact (B2bCompanyContactInput) – 담당자 정보

Raises:

B2bCompanyAlreadyRegisteredError – 사업자가 이미 연동되어 있는 경우 사업자가 이미 연동되어 있는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bIdAlreadyExistsError – ID가 이미 사용중인 경우 ID가 이미 사용중인 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async register_b2b_member_company_async(*, test: bool | None = None, company: B2bMemberCompany, contact: B2bCompanyContactInput) → RegisterB2bMemberCompanyResponse#

사업자 연동

포트원 B2B 서비스에 사업자를 연동합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
company (B2bMemberCompany) – 사업자 정보
contact (B2bCompanyContactInput) – 담당자 정보

Raises:

B2bCompanyAlreadyRegisteredError – 사업자가 이미 연동되어 있는 경우 사업자가 이미 연동되어 있는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bIdAlreadyExistsError – ID가 이미 사용중인 경우 ID가 이미 사용중인 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_member_company_contact(*, brn: str, contact_id: str, test: bool | None = None) → B2bCompanyContact#

담당자 조회

연동 사업자에 등록된 담당자를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bContactNotFoundError – 담당자가 존재하지 않는 경우 담당자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_member_company_contact_async(*, brn: str, contact_id: str, test: bool | None = None) → B2bCompanyContact#

담당자 조회

연동 사업자에 등록된 담당자를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bContactNotFoundError – 담당자가 존재하지 않는 경우 담당자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

update_b2b_member_company_contact(*, brn: str, contact_id: str, test: bool | None = None, password: str | None = None, name: str | None = None, phone_number: str | None = None, email: str | None = None) → UpdateB2bMemberCompanyContactResponse#

담당자 정보 수정

담당자 정보를 수정합니다.

Parameters:

brn (str) – 사업자등록번호
contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
password (str, optional) – 비밀번호
name (str, optional) – 담당자 성명
phone_number (str, optional) – 담당자 핸드폰 번호
email (str, optional) – 담당자 이메일

Raises:

B2bContactNotFoundError – 담당자가 존재하지 않는 경우 담당자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async update_b2b_member_company_contact_async(*, brn: str, contact_id: str, test: bool | None = None, password: str | None = None, name: str | None = None, phone_number: str | None = None, email: str | None = None) → UpdateB2bMemberCompanyContactResponse#

담당자 정보 수정

담당자 정보를 수정합니다.

Parameters:

brn (str) – 사업자등록번호
contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
password (str, optional) – 비밀번호
name (str, optional) – 담당자 성명
phone_number (str, optional) – 담당자 핸드폰 번호
email (str, optional) – 담당자 이메일

Raises:

B2bContactNotFoundError – 담당자가 존재하지 않는 경우 담당자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_certificate_registration_url(*, brn: str, test: bool | None = None) → GetB2bCertificateRegistrationUrlResponse#

사업자 인증서 등록 URL 조회

연동 사업자의 인증서를 등록하기 위한 URL을 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_certificate_registration_url_async(*, brn: str, test: bool | None = None) → GetB2bCertificateRegistrationUrlResponse#

사업자 인증서 등록 URL 조회

연동 사업자의 인증서를 등록하기 위한 URL을 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_certificate(*, brn: str, test: bool | None = None) → B2bCertificate#

인증서 조회

연동 사업자의 인증서를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bCertificateUnregisteredError – 인증서가 등록되어 있지 않은 경우 인증서가 등록되어 있지 않은 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_certificate_async(*, brn: str, test: bool | None = None) → B2bCertificate#

인증서 조회

연동 사업자의 인증서를 조회합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bCertificateUnregisteredError – 인증서가 등록되어 있지 않은 경우 인증서가 등록되어 있지 않은 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bMemberCompanyNotFoundError – 연동 사업자가 존재하지 않는 경우 연동 사업자가 존재하지 않는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_contact_id_existence(*, contact_id: str, test: bool | None = None) → GetB2bContactIdExistenceResponse#

담당자 ID 존재 여부 확인

담당자 ID가 이미 사용중인지 확인합니다.

Parameters:

contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_contact_id_existence_async(*, contact_id: str, test: bool | None = None) → GetB2bContactIdExistenceResponse#

담당자 ID 존재 여부 확인

담당자 ID가 이미 사용중인지 확인합니다.

Parameters:

contact_id (str) – 담당자 ID
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_bank_account_holder(*, bank: Literal['BANK_OF_KOREA', 'KDB', 'IBK', 'KOOKMIN', 'SUHYUP', 'KEXIM', 'NONGHYUP', 'LOCAL_NONGHYUP', 'WOORI', 'STANDARD_CHARTERED', 'CITI', 'DAEGU', 'BUSAN', 'KWANGJU', 'JEJU', 'JEONBUK', 'KYONGNAM', 'KFCC', 'SHINHYUP', 'SAVINGS_BANK', 'MORGAN_STANLEY', 'HSBC', 'DEUTSCHE', 'JPMC', 'MIZUHO', 'MUFG', 'BANK_OF_AMERICA', 'BNP_PARIBAS', 'ICBC', 'BANK_OF_CHINA', 'NFCF', 'UOB', 'BOCOM', 'CCB', 'POST', 'KODIT', 'KIBO', 'HANA', 'SHINHAN', 'K_BANK', 'KAKAO', 'TOSS', 'MISC_FOREIGN', 'SGI', 'KCIS', 'YUANTA_SECURITIES', 'KB_SECURITIES', 'SANGSANGIN_SECURITIES', 'HANYANG_SECURITIES', 'LEADING_SECURITIES', 'BNK_SECURITIES', 'IBK_SECURITIES', 'DAOL_SECURITIES', 'MIRAE_ASSET_SECURITIES', 'SAMSUNG_SECURITIES', 'KOREA_SECURITIES', 'NH_SECURITIES', 'KYOBO_SECURITIES', 'HI_SECURITIES', 'HYUNDAI_MOTOR_SECURITIES', 'KIWOOM_SECURITIES', 'EBEST_SECURITIES', 'SK_SECURITIES', 'DAISHIN_SECURITIES', 'HANHWA_SECURITIES', 'HANA_SECURITIES', 'TOSS_SECURITIES', 'SHINHAN_SECURITIES', 'DB_SECURITIES', 'EUGENE_SECURITIES', 'MERITZ_SECURITIES', 'KAKAO_PAY_SECURITIES', 'BOOKOOK_SECURITIES', 'SHINYOUNG_SECURITIES', 'CAPE_SECURITIES', 'KOREA_SECURITIES_FINANCE', 'KOREA_FOSS_SECURITIES', 'WOORI_INVESTMENT_BANK'], account_number: str, test: bool | None = None) → GetB2bBankAccountHolderResponse#

예금주 조회

원하는 계좌의 예금주를 조회합니다.

Parameters:

bank (Bank) – 은행
account_number (str) – ‘-‘를 제외한 계좌 번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bBankAccountNotFoundError – 계좌가 존재하지 않는 경우 계좌가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bFinancialSystemCommunicationError – 금융기관과의 통신에 실패한 경우 금융기관과의 통신에 실패한 경우
B2bFinancialSystemFailureError – 금융기관 장애 금융기관 장애
B2bFinancialSystemUnderMaintenanceError – 금융기관 시스템이 점검 중인 경우 금융기관 시스템이 점검 중인 경우
B2bForeignExchangeAccountError – 계좌 정보 조회가 불가능한 외화 계좌인 경우 계좌 정보 조회가 불가능한 외화 계좌인 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRegularMaintenanceTimeError – 금융기관 시스템이 정기 점검 중인 경우 금융기관 시스템이 정기 점검 중인 경우
B2bSuspendedAccountError – 정지 계좌인 경우 정지 계좌인 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_bank_account_holder_async(*, bank: Literal['BANK_OF_KOREA', 'KDB', 'IBK', 'KOOKMIN', 'SUHYUP', 'KEXIM', 'NONGHYUP', 'LOCAL_NONGHYUP', 'WOORI', 'STANDARD_CHARTERED', 'CITI', 'DAEGU', 'BUSAN', 'KWANGJU', 'JEJU', 'JEONBUK', 'KYONGNAM', 'KFCC', 'SHINHYUP', 'SAVINGS_BANK', 'MORGAN_STANLEY', 'HSBC', 'DEUTSCHE', 'JPMC', 'MIZUHO', 'MUFG', 'BANK_OF_AMERICA', 'BNP_PARIBAS', 'ICBC', 'BANK_OF_CHINA', 'NFCF', 'UOB', 'BOCOM', 'CCB', 'POST', 'KODIT', 'KIBO', 'HANA', 'SHINHAN', 'K_BANK', 'KAKAO', 'TOSS', 'MISC_FOREIGN', 'SGI', 'KCIS', 'YUANTA_SECURITIES', 'KB_SECURITIES', 'SANGSANGIN_SECURITIES', 'HANYANG_SECURITIES', 'LEADING_SECURITIES', 'BNK_SECURITIES', 'IBK_SECURITIES', 'DAOL_SECURITIES', 'MIRAE_ASSET_SECURITIES', 'SAMSUNG_SECURITIES', 'KOREA_SECURITIES', 'NH_SECURITIES', 'KYOBO_SECURITIES', 'HI_SECURITIES', 'HYUNDAI_MOTOR_SECURITIES', 'KIWOOM_SECURITIES', 'EBEST_SECURITIES', 'SK_SECURITIES', 'DAISHIN_SECURITIES', 'HANHWA_SECURITIES', 'HANA_SECURITIES', 'TOSS_SECURITIES', 'SHINHAN_SECURITIES', 'DB_SECURITIES', 'EUGENE_SECURITIES', 'MERITZ_SECURITIES', 'KAKAO_PAY_SECURITIES', 'BOOKOOK_SECURITIES', 'SHINYOUNG_SECURITIES', 'CAPE_SECURITIES', 'KOREA_SECURITIES_FINANCE', 'KOREA_FOSS_SECURITIES', 'WOORI_INVESTMENT_BANK'], account_number: str, test: bool | None = None) → GetB2bBankAccountHolderResponse#

예금주 조회

원하는 계좌의 예금주를 조회합니다.

Parameters:

bank (Bank) – 은행
account_number (str) – ‘-‘를 제외한 계좌 번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bBankAccountNotFoundError – 계좌가 존재하지 않는 경우 계좌가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bFinancialSystemCommunicationError – 금융기관과의 통신에 실패한 경우 금융기관과의 통신에 실패한 경우
B2bFinancialSystemFailureError – 금융기관 장애 금융기관 장애
B2bFinancialSystemUnderMaintenanceError – 금융기관 시스템이 점검 중인 경우 금융기관 시스템이 점검 중인 경우
B2bForeignExchangeAccountError – 계좌 정보 조회가 불가능한 외화 계좌인 경우 계좌 정보 조회가 불가능한 외화 계좌인 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRegularMaintenanceTimeError – 금융기관 시스템이 정기 점검 중인 경우 금융기관 시스템이 정기 점검 중인 경우
B2bSuspendedAccountError – 정지 계좌인 경우 정지 계좌인 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_company_state(*, brn: str, test: bool | None = None) → B2bCompanyState#

사업자 상태 조회

원하는 사업자의 상태를 조회합니다. 포트원 B2B 서비스에 연동 및 등록되지 않은 사업자도 조회 가능합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bCompanyNotFoundError – 사업자가 존재하지 않는 경우 사업자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bHometaxUnderMaintenanceError – 홈택스가 점검중이거나 순단이 발생한 경우 홈택스가 점검중이거나 순단이 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_company_state_async(*, brn: str, test: bool | None = None) → B2bCompanyState#

사업자 상태 조회

원하는 사업자의 상태를 조회합니다. 포트원 B2B 서비스에 연동 및 등록되지 않은 사업자도 조회 가능합니다.

Parameters:

brn (str) – 사업자등록번호
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bCompanyNotFoundError – 사업자가 존재하지 않는 경우 사업자가 존재하지 않는 경우
B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bHometaxUnderMaintenanceError – 홈택스가 점검중이거나 순단이 발생한 경우 홈택스가 점검중이거나 순단이 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 요청

공급자에게 세금계산서 역발행을 요청합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRecipientNotFoundError – 공급받는자가 존재하지 않은 경우 공급받는자가 존재하지 않은 경우
B2bSupplierNotFoundError – 공급자가 존재하지 않은 경우 공급자가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 요청

공급자에게 세금계산서 역발행을 요청합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRecipientNotFoundError – 공급받는자가 존재하지 않은 경우 공급받는자가 존재하지 않은 경우
B2bSupplierNotFoundError – 공급자가 존재하지 않은 경우 공급자가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금 계산서 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금 계산서 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

delete_b2b_tax_invoice(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → None#

세금계산서 삭제

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNonDeletableStatusError – 세금계산서가 삭제 가능한 상태가 아닌 경우 세금계산서가 삭제 가능한 상태가 아닌 경우 삭제 가능한 상태는 REGISTERED, ISSUE_REFUSED, REQUEST_CANCELLED_BY_RECIPIENT, ISSUE_CANCELLED_BY_SUPPLIER, SENDING_FAILED 입니다.
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async delete_b2b_tax_invoice_async(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → None#

세금계산서 삭제

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNonDeletableStatusError – 세금계산서가 삭제 가능한 상태가 아닌 경우 세금계산서가 삭제 가능한 상태가 아닌 경우 삭제 가능한 상태는 REGISTERED, ISSUE_REFUSED, REQUEST_CANCELLED_BY_RECIPIENT, ISSUE_CANCELLED_BY_SUPPLIER, SENDING_FAILED 입니다.
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 발행

역발행의 경우 역발행요청(REQUESTED) 상태, 정발행의 경우 임시저장(REGISTERED) 상태의 세금계산서를 발행합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모
email_subject (str, optional) – 이메일 제목

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 발행

역발행의 경우 역발행요청(REQUESTED) 상태, 정발행의 경우 임시저장(REGISTERED) 상태의 세금계산서를 발행합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모
email_subject (str, optional) – 이메일 제목

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

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

공급받는자가 공급자에게 세금계산서 역발행 요청한 것을 취소합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
B2bTaxInvoiceNoRecipientDocumentKeyError – 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

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

공급받는자가 공급자에게 세금계산서 역발행 요청한 것을 취소합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
B2bTaxInvoiceNoRecipientDocumentKeyError – 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 취소

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotIssuedStatusError – 세금계산서가 발행된(ISSUED) 상태가 아닌 경우 세금계산서가 발행된(ISSUED) 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 취소

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotIssuedStatusError – 세금계산서가 발행된(ISSUED) 상태가 아닌 경우 세금계산서가 발행된(ISSUED) 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

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

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
B2bTaxInvoiceNoSupplierDocumentKeyError – 세금계산서에 공급자 문서 번호가 기입되지 않은 경우 세금계산서에 공급자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

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

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRequestedStatusError – 세금계산서가 역발행 대기 상태가 아닌 경우 세금계산서가 역발행 대기 상태가 아닌 경우
B2bTaxInvoiceNoSupplierDocumentKeyError – 세금계산서에 공급자 문서 번호가 기입되지 않은 경우 세금계산서에 공급자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_tax_invoices(*, brn: str, page_number: int | None = None, page_size: int | None = None, from_: str, until: str, date_type: Literal['REGISTER', 'WRITE', 'ISSUE'], document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicesResponse#

세금 계산서 다건조회

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

Parameters:

brn (str) – 사업자등록번호
page_number (int, optional) –
페이지 번호

0부터 시작하는 페이지 번호. 기본 값은 0.
page_size (int, optional) –
페이지 크기

각 페이지 당 포함할 객체 수. 기본 값은 500이며 최대 1000까지 요청가능합니다.
from (str) – 조회 시작일
until (str) – 조회 종료일
date_type (B2bSearchDateType) – 조회 기간 기준
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_tax_invoices_async(*, brn: str, page_number: int | None = None, page_size: int | None = None, from_: str, until: str, date_type: Literal['REGISTER', 'WRITE', 'ISSUE'], document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicesResponse#

세금 계산서 다건조회

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

Parameters:

brn (str) – 사업자등록번호
page_number (int, optional) –
페이지 번호

0부터 시작하는 페이지 번호. 기본 값은 0.
page_size (int, optional) –
페이지 크기

각 페이지 당 포함할 객체 수. 기본 값은 500이며 최대 1000까지 요청가능합니다.
from (str) – 조회 시작일
until (str) – 조회 종료일
date_type (B2bSearchDateType) – 조회 기간 기준
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_tax_invoice_popup_url(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, include_menu: bool | None = None, test: bool | None = None) → GetB2bTaxInvoicePopupUrlResponse#

세금 계산서 팝업 URL 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
include_menu (bool, optional) –
메뉴 포함 여부

팝업 URL에 메뉴 레이아웃을 포함 여부를 결정합니다. 기본 값은 true입니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_tax_invoice_popup_url_async(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, include_menu: bool | None = None, test: bool | None = None) → GetB2bTaxInvoicePopupUrlResponse#

세금 계산서 팝업 URL 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
include_menu (bool, optional) –
메뉴 포함 여부

팝업 URL에 메뉴 레이아웃을 포함 여부를 결정합니다. 기본 값은 true입니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_tax_invoice_print_url(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicePrintUrlResponse#

세금 계산서 프린트 URL 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_tax_invoice_print_url_async(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicePrintUrlResponse#

세금 계산서 프린트 URL 조회

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_tax_invoice_pdf_download_url(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicePdfDownloadUrlResponse#

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

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_tax_invoice_pdf_download_url_async(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoicePdfDownloadUrlResponse#

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

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 임시 저장

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRecipientNotFoundError – 공급받는자가 존재하지 않은 경우 공급받는자가 존재하지 않은 경우
B2bSupplierNotFoundError – 공급자가 존재하지 않은 경우 공급자가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 임시 저장

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
tax_invoice (B2bTaxInvoiceInput) – 세금계산서 생성 요청 정보

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bRecipientNotFoundError – 공급받는자가 존재하지 않은 경우 공급받는자가 존재하지 않은 경우
B2bSupplierNotFoundError – 공급자가 존재하지 않은 경우 공급자가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 요청

임시저장(REGISTERED) 상태의 역발행 세금계산서를 공급자에게 발행 요청합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
B2bTaxInvoiceNoRecipientDocumentKeyError – 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

세금계산서 역발행 요청

임시저장(REGISTERED) 상태의 역발행 세금계산서를 공급자에게 발행 요청합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) – 사업자등록번호
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
memo (str, optional) – 메모

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
B2bTaxInvoiceNoRecipientDocumentKeyError – 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우 세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

create_b2b_tax_invoice_file_upload_link(*, test: bool | None = None, file_name: str) → CreateB2bTaxInvoiceFileUploadLinkResponse#

세금계산서 파일 업로드 링크 생성

세금계산서의 첨부파일를 업로드할 링크를 생성합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async create_b2b_tax_invoice_file_upload_link_async(*, test: bool | None = None, file_name: str) → CreateB2bTaxInvoiceFileUploadLinkResponse#

세금계산서 파일 업로드 링크 생성

세금계산서의 첨부파일를 업로드할 링크를 생성합니다.

Parameters:

test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

attach_b2b_tax_invoice_file(*, test: bool | None = None, brn: str, document_key: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, file_id: str) → None#

세금계산서 파일 첨부

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) –
사업자등록번호

- 없이 숫자 10자리로 구성됩니다.
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
file_id (str) – 파일 아이디

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bFileNotFoundError – 업로드한 파일을 찾을 수 없는 경우 업로드한 파일을 찾을 수 없는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async attach_b2b_tax_invoice_file_async(*, test: bool | None = None, brn: str, document_key: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, file_id: str) → None#

세금계산서 파일 첨부

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

Parameters:

test (bool, optional) –
테스트 모드 여부

true 이면 테스트 모드로 실행되며, false 이거나 주어지지 않은 경우 테스트 모드를 사용하지 않습니다.
brn (str) –
사업자등록번호

- 없이 숫자 10자리로 구성됩니다.
document_key (str) – 세금계산서 문서 번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
file_id (str) – 파일 아이디

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bFileNotFoundError – 업로드한 파일을 찾을 수 없는 경우 업로드한 파일을 찾을 수 없는 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

get_b2b_tax_invoice_attachments(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoiceAttachmentsResponse#

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

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async get_b2b_tax_invoice_attachments_async(*, document_key: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → GetB2bTaxInvoiceAttachmentsResponse#

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

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

Parameters:

document_key (str) – 세금계산서 문서 번호
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

delete_b2b_tax_invoice_attachment(*, document_key: str, attachment_id: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → None#

세금계산서 첨부파일 삭제

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

Parameters:

document_key (str) – 세금계산서 문서 번호
attachment_id (str) – 첨부파일 아이디
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceAttachmentNotFoundError – 세금계산서의 첨부파일을 찾을 수 없는 경우 세금계산서의 첨부파일을 찾을 수 없는 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

async delete_b2b_tax_invoice_attachment_async(*, document_key: str, attachment_id: str, brn: str, document_key_type: Literal['SUPPLIER', 'RECIPIENT'] | None = None, test: bool | None = None) → None#

세금계산서 첨부파일 삭제

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

Parameters:

document_key (str) – 세금계산서 문서 번호
attachment_id (str) – 첨부파일 아이디
brn (str) – 사업자등록번호
document_key_type (B2bTaxInvoiceDocumentKeyType, optional) –
문서 번호 유형

path 파라미터로 전달된 문서번호 유형. 기본 값은 RECIPIENT이며 SUPPLIER, RECIPIENT을 지원합니다.
test (bool, optional) –
테스트 모드 여부

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

Raises:

B2bExternalServiceError – 외부 서비스에서 에러가 발생한 경우 외부 서비스에서 에러가 발생한 경우
B2bNotEnabledError – B2B 기능이 활성화되지 않은 경우 B2B 기능이 활성화되지 않은 경우
B2bTaxInvoiceAttachmentNotFoundError – 세금계산서의 첨부파일을 찾을 수 없는 경우 세금계산서의 첨부파일을 찾을 수 없는 경우
B2bTaxInvoiceNotFoundError – 세금계산서가 존재하지 않은 경우 세금계산서가 존재하지 않은 경우
B2bTaxInvoiceNotRegisteredStatusError – 세금계산서가 임시저장 상태가 아닌 경우 세금계산서가 임시저장 상태가 아닌 경우
InvalidRequestError – 요청된 입력 정보가 유효하지 않은 경우 요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
UnauthorizedError – 인증 정보가 올바르지 않은 경우 인증 정보가 올바르지 않은 경우
UnknownError – API 응답이 알 수 없는 형식인 경우

portone_server_sdk.b2b

Contents

portone_server_sdk.b2b#