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

# 공급자 등록

> 공급자(발행자) 정보를 등록하고 `supplierKey`를 발급받습니다. 대리 정발행, 역발행 시 필수입니다.

활용 예시: [대리 정발행](/docs/api-introduction/usecase-delegated) | [역발행](/docs/api-introduction/usecase-reverse-email)




## OpenAPI

````yaml /openapi.yaml post /v1/suppliers
openapi: 3.1.0
info:
  title: 볼타 API
  description: >
    볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증
    가이드](/docs/api-introduction/authentication) | [사용
    사례](/docs/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: 볼타 API 서버
security:
  - basicAuth: []
tags:
  - name: 세금계산서
    description: >
      전자(세금)계산서 발행 및 관리. [발행 금액 계산](/docs/api-introduction/issuance-guide) |
      [수정발행 유형](/docs/api-introduction/amendment-guide)
  - name: 세금계산서 역발행
    description: >
      전자(세금)계산서 역발행 요청 및 관리. [이메일 승인
      역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인
      역발행](/docs/api-introduction/usecase-reverse-simple)
  - name: 현금영수증
    description: >
      현금영수증을 발행·취소하고 처리 상태를 조회합니다. 발행·취소의 최종 결과는 웹훅이나 상태 조회 API로 확인하세요. [현금영수증
      발행 가이드](/docs/api-introduction/cash-receipt-guide) | [웹훅
      이벤트](/docs/api-introduction/webhook-events)
  - name: 공급자
    description: >
      세금계산서를 발행하는 공급자(발행자)를 등록·관리합니다. [용어 정리](/docs/api-introduction/glossary) |
      [대리 정발행](/docs/api-introduction/usecase-delegated)
  - name: 인증서
    description: |
      공급자 공동인증서 등록 및 관리. [인증 가이드](/docs/api-introduction/authentication)
paths:
  /v1/suppliers:
    post:
      tags:
        - 공급자
      summary: 공급자 등록
      description: >
        공급자(발행자) 정보를 등록하고 `supplierKey`를 발급받습니다. 대리 정발행, 역발행 시 필수입니다.


        활용 예시: [대리 정발행](/docs/api-introduction/usecase-delegated) |
        [역발행](/docs/api-introduction/usecase-reverse-email)
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Supplier'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  supplierKey:
                    $ref: '#/components/schemas/ClientKey'
                    description: 공급자(발행자) 식별 키
                  identificationNumber:
                    $ref: '#/components/schemas/BusinessRegistrationNumber'
                    description: 사업자등록번호
                  taxRegistrationId:
                    $ref: '#/components/schemas/TaxRegistrationId'
                    description: 종사업장번호
                  organizationName:
                    $ref: '#/components/schemas/OrganizationName'
                    description: 상호명
                  representativeName:
                    $ref: '#/components/schemas/RepresentativeName'
                    description: 대표자명
                  certificate:
                    type: object
                    properties:
                      issuedAt:
                        type: string
                        description: 인증서 발행일시 (ISO 8601)
                      expiresAt:
                        type: string
                        description: 인증서 만료일시 (ISO 8601)
                    required:
                      - issuedAt
                      - expiresAt
                required:
                  - supplierKey
                  - identificationNumber
                  - organizationName
                  - representativeName
          headers: {}
        '400':
          description: 잘못된 요청
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  schemas:
    Supplier:
      type: object
      description: 세금계산서를 발행하는 공급자(발행자) 정보. 공급자 등록 API(POST /v1/suppliers)의 요청 본문입니다.
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          description: 사업자등록번호
        taxRegistrationId:
          $ref: '#/components/schemas/TaxRegistrationId'
          description: 종사업장번호
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          description: 상호명
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          description: 대표자명
      required:
        - identificationNumber
        - representativeName
        - organizationName
    ClientKey:
      type: string
      title: 공급자(발행자) 식별 키
      description: 공급자(발행자) 식별 키
    BusinessRegistrationNumber:
      type: string
      title: 사업자등록번호
      description: '하이픈(-) 없는 10자리 숫자. 패턴: `^\d{10}$`'
      pattern: ^\d{10}$
      examples:
        - '1234567890'
    TaxRegistrationId:
      type: string
      title: 종사업장번호
      description: '4자리 숫자, `0000` 제외. 패턴: `^(?!0{4})\d{4}$`'
      pattern: ^(?!0{4})\d{4}$
      examples:
        - '0001'
        - '0002'
      minLength: 4
      maxLength: 4
    OrganizationName:
      type: string
      title: 상호명
      description: 상호명
      maxLength: 70
      minLength: 1
    RepresentativeName:
      type: string
      title: 대표자명
      description: 대표자명
      minLength: 1
      maxLength: 30
    ErrorResponse:
      type: object
      description: API 요청 실패 시 반환되는 에러 응답
      properties:
        code:
          type: string
          description: 에러 타입 식별자
        message:
          type: string
          description: 에러 설명
      required:
        - code
        - message
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

````