> ## Documentation Index
> Fetch the complete documentation index at: https://developers-partners.delivered.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 라벨 발행 (단건)

> DK 입고 송장번호 **한 건**으로 라벨 PDF를 반환합니다. 응답은 `application/pdf` 바이너리입니다.

라벨이 아직 없는 배송 건은 이 호출에서 발행하고, 이미 발행된 건은 저장된 라벨을 그대로 사용합니다. 동작은 [라벨 발행 (다건)](/reference/global-ship/api/create-shipment-labels) API와 같고 **건수만 다릅니다**.

<Warning>존재하지 않는 송장번호이거나 다른 고객사의 배송 건이면 PDF가 반환되지 않고 404 · 403으로 거부됩니다.</Warning>

여러 건을 한 번에 받으려면 라벨 발행 (다건) API를 사용하세요. 이 API는 **재출력**이나 **다건 발행 중 일부 실패 건을 개별 복구**할 때 사용합니다.

자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.



## OpenAPI

````yaml api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/label
openapi: 3.0.1
info:
  title: Global Ship Open API
  description: '-'
  version: 1.0.0
servers:
  - url: https://gw-staging.delivered.co.kr/global-ship
    description: 테스트 환경
  - url: https://gw.delivered.co.kr/global-ship
    description: 운영 환경
security:
  - accessToken: []
  - Authorization: []
tags:
  - name: 주문
    description: 주문
paths:
  /open-api/v1/shipments/{masterNumber}/label:
    get:
      tags:
        - 배송
      summary: DK 입고 송장 라벨 발행 (단건)
      description: >-
        DK 입고 송장번호 **한 건**으로 라벨 PDF를 반환합니다. 응답은 `application/pdf` 바이너리입니다.


        라벨이 아직 없는 배송 건은 이 호출에서 발행하고, 이미 발행된 건은 저장된 라벨을 그대로 사용합니다. 동작은 [라벨 발행
        (다건)](/reference/global-ship/api/create-shipment-labels) API와 같고 **건수만
        다릅니다**.


        <Warning>존재하지 않는 송장번호이거나 다른 고객사의 배송 건이면 PDF가 반환되지 않고 404 · 403으로
        거부됩니다.</Warning>


        여러 건을 한 번에 받으려면 라벨 발행 (다건) API를 사용하세요. 이 API는 **재출력**이나 **다건 발행 중 일부 실패
        건을 개별 복구**할 때 사용합니다.


        자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를
        참고하세요. 인증은 [API 키](/reference/using-api/api-keys) ·
        [환경](/reference/using-api/environment) 문서를 따릅니다.
      operationId: getDkLabel
      parameters:
        - name: masterNumber
          in: path
          required: true
          description: DK 입고 송장번호. 배송 신청 API 응답의 `masterNumber` 값입니다.
          schema:
            type: string
          example: D04510082600064
      responses:
        '200':
          description: OK — 라벨 PDF
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '401':
          description: 인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiErrorResponse'
              example:
                httpStatus: 401
                message: 인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.
                errorCode: AUTHENTICATION_FAILED
        '403':
          description: 다른 고객사의 배송 건입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiErrorResponse'
              example:
                httpStatus: 403
                message: 다른 고객사의 배송 건입니다.
                errorCode: SHIPMENT_ACCESS_DENIED
        '404':
          description: 존재하지 않는 DK 입고 송장번호입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiErrorResponse'
              example:
                httpStatus: 404
                message: 존재하지 않는 DK 입고 송장번호입니다.
                errorCode: SHIPMENT_NOT_FOUND
                masterNumbers:
                  - D04510082600099
        '500':
          description: 라벨 발행에 실패했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiErrorResponse'
              example:
                httpStatus: 500
                message: 라벨 발행에 실패했습니다.
                errorCode: DK_LABEL_CREATION_FAILED
components:
  schemas:
    OpenApiErrorResponse:
      type: object
      description: 오픈 API 오류 응답
      required:
        - httpStatus
        - message
      properties:
        httpStatus:
          type: integer
          description: HTTP 상태 코드
          example: 404
        message:
          type: string
          description: 오류 메시지
        errorCode:
          type: string
          description: >-
            실패 유형을 구분하는 코드. `AUTHENTICATION_FAILED` · `SHIPMENT_ACCESS_DENIED` ·
            `SHIPMENT_NOT_FOUND` · `MASTER_NUMBERS_EMPTY` ·
            `MASTER_NUMBERS_LIMIT_EXCEEDED` · `INVALID_REQUEST` ·
            `DK_LABEL_CREATION_FAILED` · `INTERNAL_SERVER_ERROR`
          example: SHIPMENT_NOT_FOUND
        masterNumbers:
          type: array
          description: '`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.'
          items:
            type: string
          example:
            - D04510082600099
  securitySchemes:
    accessToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
    Authorization:
      type: apiKey
      description: 발급받은 시크릿 키
      name: Authorization
      in: header

````