> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 용어 정리

> 공급자, 공급받는자 등 볼타 API에서 자주 헷갈리는 용어를 정리합니다.

세금계산서에는 보내는 쪽과 받는 쪽이 있습니다. 두 당사자를 헷갈리면 엉뚱한 사업자에게 발행되므로, 호출 전에 용어를 한 번 맞춰두는 편이 좋습니다.

## 거래 당사자

| 용어             | 뜻                       | API에서 표현되는 위치                                                      |
| -------------- | ----------------------- | ------------------------------------------------------------------ |
| **공급자(발행자)**   | 세금계산서를 **발행하는** 쪽. 판매자. | `Supplier-Key` 헤더, `POST /v1/suppliers`(공급자 등록), 응답의 `supplierKey` |
| **공급받는자(거래처)** | 세금계산서를 **받는** 쪽. 구매자.   | 요청 본문의 `supplied` 필드                                               |

<Warning>
  **`Supplier-Key`는 받는 쪽이 아니라 보내는 쪽(공급자) 키입니다.**

  `Supplier-Key`에는 세금계산서를 **발행하는 공급자 본인**의 `supplierKey`를 넣습니다. 받는 쪽(공급받는자) 정보는 요청 본문의 `supplied` 필드에 담습니다. 두 값을 바꿔 넣으면 의도와 다른 사업자에게 발행됩니다.
</Warning>

## 공급자는 누구인가

볼타 API는 보통 플랫폼이 자신의 회원을 대신해 세금계산서를 발행하는 구조로 쓰입니다. 대리 정발행이나 역발행이 그렇습니다. 이때 세금계산서를 실제로 발행하는 주체가 **공급자**이고, 플랫폼은 [공급자 등록 API](/api-reference/공급자/공급자-등록)로 공급자를 먼저 등록한 뒤 발급받은 `supplierKey`를 `Supplier-Key` 헤더에 실어 발행합니다.

## 서비스 화면의 "고객"과는 다릅니다

볼타 웹 서비스의 \[고객 관리] 메뉴에서 말하는 "고객"은 거래처, 즉 세금계산서를 **받는** 공급받는자입니다. 반면 API에서 키로 식별하는 **공급자**는 세금계산서를 **보내는** 쪽입니다. 가리키는 당사자가 반대이니, 서비스 화면과 API를 함께 쓸 때 주의하세요.

| 맥락                                           | 가리키는 당사자         |
| -------------------------------------------- | ---------------- |
| 볼타 웹 서비스 \[고객 관리]의 "고객"                      | 공급받는자(거래처, 받는 쪽) |
| 볼타 API의 공급자(`Supplier-Key`, `/v1/suppliers`) | 공급자(발행자, 보내는 쪽)  |

## 현금영수증 용어

현금영수증 API에서 자주 쓰는 용어입니다. 발행 주체는 세금계산서와 마찬가지로 `Supplier-Key`로 식별합니다.

| 용어                                  | 뜻                                                     | API에서 표현되는 위치                         |
| ----------------------------------- | ----------------------------------------------------- | ------------------------------------- |
| **공급자(issuer)**                     | 현금영수증을 발행하는 사업자입니다. `Supplier-Key`에 연결된 사업자와 같아야 합니다. | `Supplier-Key` 헤더, 요청 본문의 `issuer` 필드 |
| **수취인(recipient)**                  | 현금영수증을 받는 대상입니다.                                      | 요청 본문의 `recipient` 필드                 |
| **자진발급(SELF)**                      | 수취인 정보 없이 발행하는 방식입니다.                                 | `recipient.type = SELF`               |
| **발급수단(`recipient.value`)**         | 수취인 식별 수단입니다. 휴대폰번호 또는 사업자등록번호를 사용하며 `SELF`이면 생략합니다.  | `recipient.value`                     |
| **발행 식별 키(issuanceKey)**            | 발행 요청을 식별하는 키입니다. 취소 요청에 사용합니다.                       | 발행 응답의 `issuanceKey`                  |
| **승인번호(cashReceiptApprovalNumber)** | API가 발행 성공 시 부여하는 현금영수증 승인번호입니다.                      | 상태 조회·웹훅 응답                           |

<Info>
  현금영수증의 **`Supplier-Key`에는 발행하는 쪽(공급자)의 키**를 입력하세요. 받는 쪽 정보는 `recipient` 필드에 입력하세요.
</Info>

## 관련 문서

* [인증 가이드](/docs/api-introduction/authentication) - `Supplier-Key` 사용법
* [현금영수증 발행](/docs/api-introduction/cash-receipt-guide) - 현금영수증 발행·취소 흐름
* [대리 정발행](/docs/api-introduction/usecase-delegated) - 플랫폼이 공급자를 대신해 발행하는 흐름
* [공급받는자 식별번호](/docs/api-introduction/recipient-identification-number) - 받는 쪽 식별번호 작성법