> ## 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/get-shipment-label) API를 사용하세요.

<Warning>한 번에 요청할 수 있는 배송 건은 최대 **100건**입니다. 초과하면 400(`MASTER_NUMBERS_LIMIT_EXCEEDED`)으로 거부됩니다. 존재하지 않는 송장번호가 하나라도 섞이면 404(`SHIPMENT_NOT_FOUND`)로 **전체가 거부**되고, 응답 본문 `masterNumbers`에 해당 번호가 담깁니다. 이 경우 PDF는 반환되지 않으며 라벨 발행도 일어나지 않습니다.</Warning>

처리 도중 실패하면 전체가 실패하지만, 그 전에 발행된 라벨은 저장되어 다시 발행되지 않습니다. 여러 건 중 일부만 실패했을 때는 라벨 발행 (단건) 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 POST /open-api/v1/shipments/labels
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/labels:
    post:
      tags:
        - 배송
      summary: DK 입고 송장 라벨 발행 (다건)
      description: >-
        DK 입고 송장번호 **여러 건**을 받아 라벨 PDF를 하나로 병합해 반환합니다. 응답은 `application/pdf`
        바이너리이며, **요청한 송장번호 순서대로** 병합됩니다. 중복된 송장번호는 한 번만 포함됩니다.


        라벨이 아직 없는 배송 건은 이 호출에서 발행하고, 이미 발행된 건은 저장된 라벨을 그대로 사용합니다. 한 건만 필요할 때는
        [라벨 발행 (단건)](/reference/global-ship/api/get-shipment-label) API를 사용하세요.


        <Warning>한 번에 요청할 수 있는 배송 건은 최대 **100건**입니다. 초과하면
        400(`MASTER_NUMBERS_LIMIT_EXCEEDED`)으로 거부됩니다. 존재하지 않는 송장번호가 하나라도 섞이면
        404(`SHIPMENT_NOT_FOUND`)로 **전체가 거부**되고, 응답 본문 `masterNumbers`에 해당 번호가
        담깁니다. 이 경우 PDF는 반환되지 않으며 라벨 발행도 일어나지 않습니다.</Warning>


        처리 도중 실패하면 전체가 실패하지만, 그 전에 발행된 라벨은 저장되어 다시 발행되지 않습니다. 여러 건 중 일부만 실패했을 때는
        라벨 발행 (단건) API로 개별 복구할 수 있습니다.


        자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를
        참고하세요. 인증은 [API 키](/reference/using-api/api-keys) ·
        [환경](/reference/using-api/environment) 문서를 따릅니다.
      operationId: createDkLabels
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenApiDkLabelRequest'
        required: true
      responses:
        '200':
          description: OK — 라벨 PDF
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '400':
          description: >-
            DK 입고 송장번호 목록이 비어 있거나(`MASTER_NUMBERS_EMPTY`), 상한 100건을
            초과했거나(`MASTER_NUMBERS_LIMIT_EXCEEDED`), 요청 형식이 올바르지
            않습니다(`INVALID_REQUEST`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiErrorResponse'
              example:
                httpStatus: 400
                message: DK 입고 송장번호 목록이 비어 있습니다.
                errorCode: MASTER_NUMBERS_EMPTY
        '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:
    OpenApiDkLabelRequest:
      required:
        - masterNumbers
      type: object
      properties:
        masterNumbers:
          type: array
          description: 라벨을 발행할 DK 입고 송장번호 목록. 한 번에 최대 100건까지 요청할 수 있습니다.
          maxItems: 100
          example:
            - D04510082600064
            - D04510082600065
          items:
            type: string
    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

````