> ## 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.

# 위수탁 발행

> 수탁자가 위탁자를 대신해 전자(세금)계산서를 정발행하는 절차를 안내합니다.

위수탁 발행에서는 공급자와 공급받는자 외에 수탁자 정보를 함께 보냅니다.

## 발행 흐름

<Steps>
  <Step title="수탁자를 발급자로 등록" icon="code">
    [발급자 등록 API](/api-reference/발급자/발급자-등록)에 수탁자 정보를 보냅니다. 응답의 `issuerId`를 저장하세요.

    ```bash theme={"dark"}
    curl -X POST https://xapi.bolta.io/v1/issuers \
      -H "Authorization: Basic {apiKey}" \
      -H "Content-Type: application/json" \
      -d '{
        "identificationNumber": "5648102684",
        "taxRegistrationId": null,
        "organizationName": "수탁자 상호",
        "representativeName": "수탁자대표"
      }'
    ```
  </Step>

  <Step title="수탁자 공동인증서 등록" icon="shield-check">
    `GET /v1/issuers/{issuerId}/certificates/url`로 등록 URL을 발급합니다. 수탁자가 URL에 접속해 공동인증서를 등록한 뒤, [인증서 등록 내역 조회 API](/api-reference/인증서/발급자-공동인증서-등록-내역-조회)로 결과를 확인하세요.
  </Step>

  <Step title="위수탁 정발행 요청" icon="code">
    [정발행 API](/api-reference/세금계산서/전자세금계산서-정발행)에 `supplier`, `supplied`, `trustee`를 함께 보냅니다.
  </Step>

  <Step title="발행 결과 확인" icon="circle-check">
    웹훅으로 완료 이벤트를 받거나 [세금계산서 조회 API](/api-reference/세금계산서/전자세금계산서-내용-조회)를 호출하세요. 수탁자 정보는 `invoice.trustee`, 담당자 정보는 `invoice.trustee.manager`에서 확인할 수 있습니다.
  </Step>
</Steps>

## 정발행 요청

```bash theme={"dark"}
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  -H "Authorization: Basic {apiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "YYYY-MM-DD",
    "purpose": "CLAIM",
    "taxType": "TAXABLE",
    "supplier": {
      "identificationNumber": "1234567891",
      "organizationName": "위탁자 상호",
      "representativeName": "위탁자대표",
      "manager": {
        "email": "supplier@example.com",
        "name": "위탁자담당자"
      }
    },
    "supplied": {
      "identificationNumber": "0987654323",
      "organizationName": "공급받는자 상호",
      "representativeName": "공급받는자대표",
      "managers": [
        {
          "email": "recipient@example.com",
          "name": "공급받는자담당자"
        }
      ]
    },
    "trustee": {
      "identificationNumber": "5648102684",
      "organizationName": "수탁자 상호",
      "representativeName": "수탁자대표",
      "manager": {
        "email": "trustee@example.com",
        "name": "수탁자담당자",
        "telephone": "010-1234-5678"
      }
    },
    "items": [
      {
        "date": "YYYY-MM-DD",
        "name": "위수탁 과세 품목",
        "supplyCost": 100000,
        "tax": 10000
      }
    ]
  }'
```

### 수탁자 입력값

| 필드                     | 필수 | 설명          |
| ---------------------- | -- | ----------- |
| `identificationNumber` | O  | 수탁자 사업자등록번호 |
| `organizationName`     | O  | 수탁자 상호      |
| `representativeName`   | O  | 수탁자 대표자명    |
| `taxRegistrationId`    | X  | 수탁자 종사업장번호  |
| `address`              | X  | 수탁자 주소      |
| `businessItem`         | X  | 수탁자 종목      |
| `businessType`         | X  | 수탁자 업태      |
| `manager`              | X  | 수탁자 담당자     |

`manager`에는 `email`, `name`, `telephone`을 입력할 수 있습니다. `manager`를 보낼 때는 세 필드 중 하나 이상에 값을 넣으세요.

### 과세유형별 세액

위수탁 발행도 일반 정발행과 같은 세액 규칙을 사용합니다.

| 과세유형(`taxType`) | 품목 세액(`items[].tax`) | 예시                        |
| --------------- | -------------------- | ------------------------- |
| `TAXABLE`       | `null`이 아닌 세액        | 공급가액 `100000`, 세액 `10000` |
| `ZERO_RATE`     | `0`                  | 공급가액 `100000`, 세액 `0`     |
| `TAX_FREE`      | `null` 또는 필드 생략      | 공급가액 `100000`, 세액 `null`  |

전체 요청은 [정발행 API](/api-reference/세금계산서/전자세금계산서-정발행)의 코드 예시 패널 상단 메뉴에서 `위수탁 과세`, `위수탁 영세율`, `위수탁 면세`를 선택해 확인하세요. 화면 폭이 좁으면 코드 예시 패널이 본문 아래에 표시됩니다.

## 관련 문서

* [발급자 등록 API](/api-reference/발급자/발급자-등록)
* [인증서 등록 연동](/docs/api-introduction/certificate-registration)
* [발행 금액 계산](/docs/api-introduction/issuance-guide)
* [세금계산서 웹훅](/docs/api-introduction/webhook-tax-invoice)