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

# 빠른 시작

> 5분 안에 첫 번째 전자세금계산서를 발행해보세요.

## 사전 준비

<Steps>
  <Step title="회원가입 및 워크스페이스 생성">
    [볼타 회원가입](/docs/onboarding/getting-started-google) 후 워크스페이스를 생성합니다.
  </Step>

  <Step title="테스트 API 키 발급">
    [개발자센터 > API 키](/docs/developer-center/api-key) 메뉴에서 **테스트 키**를 생성합니다.

    테스트 키는 `test_`로 시작하며, 모든 발행 요청이 가상으로 처리됩니다.
  </Step>

  <Step title="공동인증서 등록">
    [볼타 설정 > 공동인증서](/docs/setting/general/certificate-registration)에서 공동인증서를 등록합니다.

    <Info>
      테스트 환경에서는 **테스트 인증서**를 사용할 수 있어 실제 공동인증서가 없어도 연동 테스트가 가능합니다.
    </Info>
  </Step>

  <Step title="포인트 충전 (라이브 키 사용 시)">
    라이브 키로 API를 호출하려면 사전에 포인트를 충전해야 합니다. [개발자센터](https://developers.bolta.io)에서 포인트를 충전할 수 있으며, 포인트 잔액이 부족하면 API 호출이 실패합니다.

    <Info>
      테스트 키(`test_`)로 호출하는 경우에는 포인트 충전 없이 무료로 테스트할 수 있습니다. 상세 요금은 [요금 안내](/docs/api-introduction/pricing)를 참고하세요.
    </Info>
  </Step>
</Steps>

## 첫 번째 API 호출

테스트 API 키와 공급자의 `customerKey`를 준비했다면, 아래 curl 명령으로 세금계산서를 발행해보세요.

```bash theme={"dark"}
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  -H "Authorization: Basic $(echo -n 'test_YOUR_API_KEY:' | base64)" \
  -H "Customer-Key: YOUR_CUSTOMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2025-01-15",
    "purpose": "RECEIPT",
    "supplier": {
      "identificationNumber": "1234567890",
      "organizationName": "공급자 상호",
      "representativeName": "홍길동",
      "manager": {
        "email": "supplier@example.com"
      }
    },
    "supplied": {
      "identificationNumber": "0987654321",
      "organizationName": "공급받는자 상호",
      "representativeName": "김철수",
      "managers": [
        {
          "email": "recipient@example.com"
        }
      ]
    },
    "items": [
      {
        "date": "2025-01-15",
        "name": "테스트 품목",
        "unitPrice": 10000,
        "quantity": 1,
        "supplyCost": 10000,
        "tax": 1000
      }
    ]
  }'
```

<Warning>
  `test_YOUR_API_KEY`와 `YOUR_CUSTOMER_KEY`를 실제 값으로 교체하세요. `Customer-Key`에는 세금계산서를 발행하는 **공급자 본인**의 `customerKey`를 넣습니다. 거래처(공급받는자) 정보는 요청 본문의 `supplied` 필드에 포함됩니다. `date` 필드는 발행 마감일 이내의 날짜로 설정해야 하며, 잘 모르겠다면 오늘 날짜를 사용해보세요.
</Warning>

## 응답 확인

발행 요청이 성공하면 `issuanceKey`가 반환됩니다.

```json theme={"dark"}
{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}
```

이후 [웹훅](/docs/api-introduction/webhook-events)으로 발행 완료 알림이 전송되며, [세금계산서 조회 API](/api-reference/세금계산서/전자세금계산서-내용-조회)로 결과를 확인할 수 있습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="인증 가이드" href="/docs/api-introduction/authentication">
    API 키 인증 방식과 요청 헤더를 자세히 알아보세요.
  </Card>

  <Card title="발행 금액 계산" href="/docs/api-introduction/issuance-guide">
    품목별 금액 계산 방식과 예시를 확인하세요.
  </Card>

  <Card title="사용 사례" href="/docs/api-introduction/usecase-b2b">
    B2B 거래, 정기 결제, 역발행 등 다양한 시나리오를 확인하세요.
  </Card>

  <Card title="API Reference" href="/api-reference">
    전체 API 엔드포인트 레퍼런스를 확인하세요.
  </Card>
</CardGroup>