위수탁 발행

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

발행 흐름

수탁자를 발급자로 등록

발급자 등록 API에 수탁자 정보를 보냅니다. 응답의 issuerId를 저장하세요.

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": "수탁자대표"
  }'

수탁자 공동인증서 등록

GET /v1/issuers/{issuerId}/certificates/url로 등록 URL을 발급합니다. 수탁자가 URL에 접속해 공동인증서를 등록한 뒤, 인증서 등록 내역 조회 API로 결과를 확인하세요.

위수탁 정발행 요청

정발행 API에 supplier, supplied, trustee를 함께 보냅니다.

발행 결과 확인

웹훅으로 완료 이벤트를 받거나 세금계산서 조회 API를 호출하세요. 수탁자 정보는 invoice.trustee, 담당자 정보는 invoice.trustee.manager에서 확인할 수 있습니다.

정발행 요청

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 소개

API 가이드

사용 사례

SDK/노코드 연동

발행 흐름

정발행 요청

수탁자 입력값

과세유형별 세액

관련 문서

​발행 흐름

​정발행 요청

​수탁자 입력값

​과세유형별 세액

​관련 문서

발행 흐름

정발행 요청

수탁자 입력값

과세유형별 세액

관련 문서