PortOne B2b API
The B2b API from PortOne — 26 operation(s) for b2b.
PortOne B2b API is one of 20 APIs that PortOne publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include B2B. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 31 operations across 26 paths, and defines 165 schemas. It is described by OpenAPI 3.2.0, at version 1.16.0.
Requests are made against a single base URL, https://api.portone.io.
31 operations
26 paths
165 schemas
3 DELETE12 GET1 PATCH14 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
PortOne B2b API declares
2 security schemes
for authenticating requests.
It accepts HTTP bearer tokens (bearerJwt).
It uses HTTP portone authentication (portOne).
bearerJwt— Authorization: Bearer 엑세스 토큰portOne— Authorization: PortOne 발급된 API 시크릿
Paths & Operations 31
Across 26 paths, the API surfaces 31 operations — 3 DELETE, 12 GET, 1 PATCH, 14 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
B2b 31
GET
/b2b/bulk-tax-invoices/{bulkTaxInvoiceId}
일괄 세금계산서 조회
POST
/b2b/companies/business-info
사업자등록 정보 조회
GET
/b2b/counterparties/{brn}/certificate/registration-url
사업자 인증서 등록 URL 조회
POST
/b2b/counterparties/{brn}/certificate/validate
사업자 인증서 유효성 검증
GET
/b2b/counterparties/{brn}/certificate
인증서 조회
GET
/b2b/counterparties/{counterpartyId}
거래처 조회
DELETE
/b2b/counterparties/{counterpartyId}
거래처 삭제
PATCH
/b2b/counterparties/{counterpartyId}
거래처 정보 수정
GET
/b2b/counterparties
거래처 검색
POST
/b2b/counterparties
거래처 생성
POST
/b2b/file-upload-url
파일 업로드 URL 생성
GET
/b2b/tax-invoices-sheet
세금계산서 엑셀 파일(csv) 다운로드
PUT
/b2b/tax-invoices/draft
세금계산서 임시저장 수정
POST
/b2b/tax-invoices/draft
세금계산서 임시 저장
POST
/b2b/tax-invoices/issue-immediately
세금계산서 즉시 정발행
POST
/b2b/tax-invoices/request-reverse-issuance
세금계산서 역발행 즉시 요청
POST
/b2b/tax-invoices/{taxInvoiceKey}/attach-file
세금계산서 파일 첨부
DELETE
/b2b/tax-invoices/{taxInvoiceKey}/attachments/{attachmentId}
세금계산서 첨부파일 삭제
GET
/b2b/tax-invoices/{taxInvoiceKey}/attachments
세금계산서 첨부파일 목록 조회
POST
/b2b/tax-invoices/{taxInvoiceKey}/cancel-issuance
세금계산서 취소 (공급자에 의한 취소)
POST
/b2b/tax-invoices/{taxInvoiceKey}/cancel-request
세금계산서 역발행 요청 취소 (공급받는자에 의한 취소)
POST
/b2b/tax-invoices/{taxInvoiceKey}/issue
세금계산서 발행 승인
GET
/b2b/tax-invoices/{taxInvoiceKey}/pdf-download-url
세금 계산서 PDF 다운로드 URL 조회
GET
/b2b/tax-invoices/{taxInvoiceKey}/popup-url
세금 계산서 팝업 URL 조회
GET
/b2b/tax-invoices/{taxInvoiceKey}/print-url
세금 계산서 프린트 URL 조회
POST
/b2b/tax-invoices/{taxInvoiceKey}/refuse-request
세금계산서 역발행 요청 거부
POST
/b2b/tax-invoices/{taxInvoiceKey}/request
세금계산서 역발행 요청
POST
/b2b/tax-invoices/{taxInvoiceKey}/send-to-nts
세금계산서 국세청 즉시 전송
GET
/b2b/tax-invoices/{taxInvoiceKey}
세금 계산서 조회
DELETE
/b2b/tax-invoices/{taxInvoiceKey}
세금계산서 삭제
GET
/b2b/tax-invoices
세금 계산서 다건조회
Schemas 165
The contract defines 165 schemas that model the data the API accepts and returns. The most detailed are B2bTaxInvoice (40 properties), B2bTaxInvoiceSummary (38 properties), B2bTaxInvoiceInput (23 properties), B2bCounterparty (21 properties). Each schema is shown below with its type and property counts.
B2bTaxInvoiceSupplierDocumentKeyAlreadyUsedError
object
세금계산서에 공급자 문서 번호가 이미 사용 중인 경우
2 properties
1 required
GetB2bTaxInvoicesBody
object
세금 계산서 다건 조회를 위한 입력 정보
5 properties
GetB2bCounterpartyCertificateRegistrationUrlError
IssueB2bTaxInvoiceResponse
object
세금계산서 발행 승인 응답
1 property
1 required
GetB2bCounterpartyError
RefuseB2bTaxInvoiceRequestResponse
object
세금계산서 역발행 요청 거부 응답
1 property
1 required
B2bBulkTaxInvoice
object
13 properties
10 required
GetB2bBusinessInfosBody
object
사업자등록 정보 조회를 위한 입력 정보
1 property
1 required
PageInput
object
다건 조회 API 에 사용되는 페이지 입력 정보
2 properties
RequestB2bTaxInvoiceReverseIssuanceError
B2bTaxInvoicePurposeType
string
영수/청구
GetB2bTaxInvoicePdfDownloadUrlError
DraftB2bTaxInvoiceError
B2bTaxInvoiceKeyType
string
세금계산서 식별자 유형
B2bTaxInvoiceStatus
string
B2bTaxInvoiceContact
object
세금계산서 담당자
5 properties
1 required
B2bCertificateType
string
인증서 타입
B2bCounterpartyPartnerNotDeletableError
object
파트너 연동 거래처는 삭제할 수 없는 경우 파트너와 연동된 거래처는 직접 삭제할 수 없습니다.
2 properties
1 required
GetB2bTaxInvoicesError
UpdateB2bTaxInvoiceDraftBody
object
세금계산서 임시저장 수정 정보
5 properties
2 required
B2bTaxInvoiceModificationCreateBody
object
수정 세금계산서 생성 입력 정보
4 properties
2 required
RequestB2bTaxInvoiceResponse
object
세금계산서 역발행 요청 응답
1 property
1 required
DownloadB2bTaxInvoicesSheetError
AttachB2bTaxInvoiceFileBody
object
세금계산서 파일 첨부 정보
1 property
1 required
B2bTaxInvoiceTaxationType
string
과세 유형
B2bCounterpartyBrnModificationNotAllowedError
object
사업자등록번호 수정이 허용되지 않는 경우 거래처의 사업자등록번호는 수정할 수 없습니다.
2 properties
1 required
B2bCounterpartySelfOriginBrnMismatchError
object
자사 사업자등록번호와 동일한 거래처를 생성할 수 없는 경우
2 properties
1 required
B2bCounterpartyInput
object
거래처 입력 정보
9 properties
1 required
B2bCounterpartyPartnerNotConnectableError
object
파트너 연동 거래처는 국세청 연동이 허용되지 않는 경우 파트너와 연동된 거래처는 국세청 연동을 직접 수행할 수 없습니다.
2 properties
1 required
requestB2bTaxInvoiceError
GetB2bTaxInvoicePopupUrlError
SendToNtsB2bTaxInvoiceResponse
object
세금계산서 국세청 즉시 전송 응답
1 property
1 required
GetB2bTaxInvoiceAttachmentsResponse
object
세금계산서 첨부파일 목록 조회 성공 응답
1 property
1 required
IssueB2bTaxInvoiceImmediatelyBody
object
세금계산서 즉시 정발행 요청 정보
4 properties
1 required
CreateB2bCounterpartyBody
object
거래처 생성 요청 정보
3 properties
1 required
GetB2bTaxInvoiceAttachmentsError
B2bOriginalTaxInvoiceNotFoundError
object
원본 세금계산서가 존재하지 않은 경우
2 properties
1 required
ValidateB2bCounterpartyCertificateError
DeleteB2bCounterpartyError
UpdateB2bCounterpartyBody
object
거래처 정보 수정 요청
2 properties
1 required
B2bSearchDateType
string
조회 기준
B2bSupplierNotFoundError
object
공급자가 존재하지 않은 경우
4 properties
1 required
GetB2bTaxInvoicesBodyDateFilter
object
조회 기간 필터
2 properties
GetB2bTaxInvoicePdfDownloadUrlResponse
object
세금계산서 PDF 다운로드 URL 성공 응답
1 property
1 required
B2bTaxInvoiceSummary
object
세금계산서 요약
38 properties
19 required
UnauthorizedError
object
인증 정보가 올바르지 않은 경우
2 properties
1 required
B2bCounterpartyVerificationTypeMismatchError
object
검증 유형이 일치하지 않는 경우
2 properties
1 required
GetB2bTaxInvoicesResponse
object
세금계산서 다건 조회 성공 응답
2 properties
2 required
DeleteB2bTaxInvoiceError
UpdateB2bTaxInvoiceDraftError
B2bIssuanceTypeMismatchError
object
세금계산서 발행 유형이 올바르지 않은 경우
2 properties
1 required
B2BCannotChangeTaxTypeError
object
세금계산서 과세 유형을 수정할 수 없는 경우
2 properties
1 required
B2bCounterpartyCreateOptions
object
거래처 생성 옵션
4 properties
B2bCounterpartyNotFoundError
object
거래처가 존재하지 않는 경우
3 properties
1 required
B2bCertificateUnregisteredError
object
인증서가 등록되어 있지 않은 경우
2 properties
1 required
B2bCounterpartyIdAlreadyExistsByPartnerError
object
파트너 연동으로 생성된 거래처 ID가 이미 사용중인 경우 파트너 연동으로 생성된 거래처 ID는 재사용할 수 없습니다.
2 properties
1 required
InvalidRequestError
object
요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
2 properties
1 required
B2bTaxInvoiceDocumentModificationType
string
세금계산서 문서 수정 발행 유형
B2bCounterpartyIdAlreadyExistsError
object
거래처 ID가 이미 사용중인 경우
2 properties
1 required
CancelB2bTaxInvoiceRequestBody
object
세금계산서 역발행 요청 취소 정보
1 property
GetB2bCounterpartyCertificateRegistrationUrlResponse
object
인증서 등록 URL 조회 응답 정보
1 property
1 required
B2bBulkTaxInvoiceSourceType
string
그룹 생성 방식
B2bTaxInvoiceCompany
object
9 properties
B2bTaxInvoiceNotDraftedStatusError
object
세금계산서가 임시저장 완료 상태가 아닌 경우
2 properties
1 required
DeleteB2bCounterpartyResponse
object
거래처 삭제 응답
B2bTaxInvoiceNonDeletableStatusError
object
세금계산서가 삭제 가능한 상태가 아닌 경우 삭제 가능한 상태는 DRAFTED, ISSUEREFUSED, REQUESTCANCELLEDBYRECIPIENT, ISSUECANCELLEDBYSUPPLIER, SENDINGFAILED 입니다.
2 properties
1 required
PageInfo
object
반환된 페이지 결과 정보
3 properties
3 required
DeleteB2bTaxInvoiceAttachmentError
B2bCounterpartyNtsConnectionFailedError
object
국세청 연동에 실패한 경우
2 properties
1 required
B2bTaxInvoice
object
세금계산서
40 properties
16 required
B2bTaxInvoiceSortInput
object
세금계산서 다건 조회 시 정렬 조건
2 properties
CancelB2bTaxInvoiceRequestResponse
object
세금계산서 역발행 요청 취소 응답
1 property
1 required
DraftB2bTaxInvoiceBody
object
세금계산서 임시 저장 정보
4 properties
1 required
CreateB2bFileUploadUrlError
UpdateB2bTaxInvoiceDraftResponse
object
세금계산서 임시저장 수정 응답
1 property
1 required
GetB2bTaxInvoicePopupUrlResponse
object
세금계산서 팝업 URL 성공 응답
1 property
1 required
DeleteB2bTaxInvoiceResponse
object
B2bTaxInvoiceNotIssuedStatusError
object
세금계산서가 발행된(ISSUED) 상태가 아닌 경우
2 properties
1 required
B2bTaxInvoiceModification
object
세금 계산서 수정
4 properties
4 required
B2bTaxInvoiceAttachment
object
세금계산서 첨부파일
3 properties
3 required
B2bTaxInvoiceAdditionalContact
object
추가 담당자
3 properties
1 required
CreateB2bCounterpartyError
IssueB2bTaxInvoiceBody
object
세금계산서 발행 승인 정보
2 properties
B2bTaxInvoiceInput
object
세금계산서 생성 요청 정보
23 properties
7 required
B2bFileNotFoundError
object
업로드한 파일을 찾을 수 없는 경우
2 properties
1 required
SendToNtsB2bTaxInvoiceError
IssueB2bTaxInvoiceImmediatelyResponse
object
세금계산서 즉시 정발행 응답
1 property
1 required
RefuseB2bTaxInvoiceRequestError
B2bTaxInvoiceRecipientDocumentKeyAlreadyUsedError
object
세금계산서에 공급 받는자 문서 번호가 이미 사용 중인 경우
2 properties
1 required
GetB2bBulkTaxInvoiceError
B2bBusinessInfo
object
사업자등록 정보
18 properties
12 required
UpdateB2bCounterpartyError
GetB2bTaxInvoiceError
GetB2bCounterpartiesBody
object
거래처 검색 요청 정보
2 properties
B2bIdAlreadyExistsError
object
ID가 이미 사용중인 경우
2 properties
1 required
B2bTaxInvoiceItem
object
품목
8 properties
Decimal
object
BigDecimal 타입
2 properties
1 required
B2bNotEnabledError
object
B2B 기능이 활성화되지 않은 경우
2 properties
1 required
B2bTaxInvoiceModificationType
string
수정 사유
CancelB2bTaxInvoiceIssuanceError
B2bBulkTaxInvoiceStat
object
세금계산서 상태별 집계 정보
2 properties
2 required
B2bBulkTaxInvoiceStatus
string
일괄 세금계산서 상태
ValidateB2bCounterpartyCertificateResponse
object
인증서 유효성 검증 응답 정보
1 property
1 required
TaxInvoicesSheetField
string
다운로드 할 시트 컬럼
B2bTaxInvoiceAttachmentNotFoundError
object
세금계산서의 첨부파일을 찾을 수 없는 경우
2 properties
1 required
B2bBusinessInfoResult
object
사업자등록 정보조회 결과
4 properties
1 required
IssueB2bTaxInvoiceError
CreateB2bCounterpartyResponse
object
거래처 생성 응답 정보
1 property
1 required
IssueB2bTaxInvoiceImmediatelyError
B2bTaxInvoiceNotRequestedStatusError
object
세금계산서가 역발행 대기 상태가 아닌 경우
2 properties
1 required
B2bCounterpartyBusinessStatus
string
거래처 휴폐업 상태
DraftB2bTaxInvoiceResponse
object
세금계산서 임시 저장 응답
1 property
1 required
B2bCompanyStateBusinessStatus
string
영업 상태
GetB2bCounterpartiesResponse
object
거래처 검색 성공 응답
2 properties
2 required
B2bCounterpartyOngoingTaxInvoiceExistsError
object
진행 중인 세금계산서가 존재하여 거래처를 삭제할 수 없는 경우
2 properties
1 required
DownloadB2bTaxInvoicesSheetBody
object
4 properties
B2bCounterpartyBrnInvalidError
object
사업자등록번호가 유효하지 않은 경우
2 properties
1 required
B2bCounterpartyContactInput
object
거래처 담당자 입력 정보
4 properties
2 required
RequestB2bTaxInvoiceReverseIssuanceResponse
object
세금계산서 역발행 즉시 요청 응답
1 property
1 required
B2bTaxInvoiceNotFoundError
object
세금계산서가 존재하지 않은 경우
2 properties
1 required
B2bBulkTaxInvoiceNotFoundError
object
일괄 세금계산서가 존재하지 않은 경우
2 properties
1 required
B2bCounterpartyMissingRequiredFieldsError
object
필수 입력 항목이 누락된 경우 거래처 생성/수정 시 필수 입력 항목이 누락되었습니다.
2 properties
1 required
GetB2bTaxInvoicesBodyFilter
object
세금계산서 다건 조회 필터
11 properties
B2bTaxInvoiceNoSupplierDocumentKeyError
object
세금계산서에 공급자 문서 번호가 기입되지 않은 경우
2 properties
1 required
B2bCertificate
object
8 properties
8 required
GetB2bBusinessInfosError
CreateB2bFileUploadUrlBody
object
파일 업로드 URL 생성 요청 정보
1 property
1 required
B2bCounterpartyVerificationNotFoundError
object
검증 결과를 찾을 수 없는 경우 사업자 정보 검증 결과를 찾을 수 없습니다.
2 properties
1 required
B2bCounterpartyTooManyAdditionalContactsError
object
추가 담당자가 너무 많은 경우 추가 담당자는 최대 5명까지 등록할 수 있습니다.
2 properties
1 required
CancelB2bTaxInvoiceIssuanceBody
object
세금계산서 취소 정보
1 property
B2bCounterpartyPartnerNotUpdatableError
object
파트너 연동 거래처는 수정할 수 없는 경우 파트너와 연동된 거래처는 직접 수정할 수 없습니다.
2 properties
1 required
DateRangeOption
object
2 properties
B2bDocumentKeyCannotBeChangedError
object
문서번호 수정이 요청된 경우
2 properties
1 required
B2bNtsConnectionStatus
string
국세청 연동 상태
Map_Stat
object
AttachB2bTaxInvoiceFileError
B2bTaxInvoiceSortBy
string
세금계산서 정렬 기준
CancelB2bTaxInvoiceIssuanceResponse
object
세금계산서 취소 응답
1 property
1 required
ForbiddenError
object
요청이 거절된 경우
2 properties
1 required
GetB2bCounterpartyCertificateError
GetB2bTaxInvoicesBodyPrimaryFilter
object
상위 필터 주어진 필드 중 한 개의 필드만 입력합니다.
8 properties
RefuseB2bTaxInvoiceRequestBody
object
세금계산서 역발행 요청 거부 정보
1 property
SortOrder
string
정렬 방식
B2bCounterpartyVerification
object
거래처 검증 정보
2 properties
2 required
B2bCounterparty
object
거래처 B2B 거래처 정보입니다.
21 properties
9 required
CancelB2bTaxInvoiceRequestError
B2bTaxInvoiceNoRecipientDocumentKeyError
object
세금계산서에 공급받는자 문서 번호가 기입되지 않은 경우
2 properties
1 required
GetB2bTaxInvoicePrintUrlError
GetB2bCounterpartiesError
CreateB2bFileUploadUrlPayload
object
파일 업로드 URL 생성 성공 응답
2 properties
2 required
B2bTaxInvoiceIssuanceType
string
발행 유형
GetB2bTaxInvoicePrintUrlResponse
object
세금계산서 프린트 URL 성공 응답
1 property
1 required
B2bCounterpartyContact
object
거래처 담당자 정보
4 properties
2 required
GetB2bBusinessInfosResponse
object
사업자등록 정보 조회 성공 응답
1 property
1 required
B2bRecipientNotFoundError
object
공급받는자가 존재하지 않은 경우
4 properties
1 required
B2bCounterpartyVerificationBrnMismatchError
object
검증 결과의 사업자등록번호가 일치하지 않는 경우
2 properties
1 required
B2bCounterpartyNtsNotConnectedError
object
국세청에 연동되어 있지 않은 경우
4 properties
1 required
B2BTaxInvoiceStatusNotSendingCompletedError
object
원본 세금계산서가 전송완료 상태가 아닌 경우
2 properties
1 required
B2bCounterpartyVerificationInvalidError
object
검증 결과가 유효하지 않은 경우
2 properties
1 required
UpdateB2bCounterpartyResponse
object
거래처 정보 수정 응답
1 property
1 required
RequestB2bTaxInvoiceReverseIssuanceBody
object
세금계산서 역발행 즉시 요청 정보
3 properties
1 required
DeleteB2bCounterpartyBody
object
거래처 삭제 요청
B2bModificationNotProvidedError
object
세금계산서 수정 입력 정보를 찾을 수 없는 경우
2 properties
1 required
B2bCounterpartyFilter
object
거래처 검색 필터
10 properties
B2bExternalServiceError
object
외부 서비스에서 에러가 발생한 경우
2 properties
1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from PortOne 12
Other APIs PortOne publishes across the network.
PortOne REST API (V1, legacy Iamport)
PortOne Banks API
PortOne Billing Keys API
PortOne Cash Receipts API
PortOne Checkout Profiles API
PortOne Identity Verifications API
PortOne Kakaopay API
PortOne Login API
PortOne Payment Events By Cursor API
PortOne Payment Gateways API
PortOne Payment Reconciliations API
PortOne Payment Schedules API
#B2B
Where this information came from
This is an independent, third-party profile of PortOne B2b API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.