Kurly 배송운영 정책 API

openapi: 3.1.0
info:
  title: Kurly Logistics Services (KLS) Open API Authentication 배송운영 정책 API
  version: 1.3.12
  description: Kurly Logistics Services (KLS) Open API lets contracted shipper clients (화주사) integrate their systems with Kurly's fulfillment (물류대행) and delivery-agency (배송대행) services. This document was reconstructed by API Evangelist from Kurly's own published API reference at https://developers.kurly.com — every path, method, summary and response status below is taken from that reference. Request/response schemas are rendered client-side on the provider's site and are NOT reproduced here; treat the referenced page (externalDocs) as authoritative for payloads.
  contact:
    email: logistics-dev@kurlycorp.com
    url: https://developers.kurly.com/docs/faq
  x-generated-by: api-evangelist enrichment pipeline
  x-generated: '2026-07-19'
  x-source: https://developers.kurly.com/docs/api
servers:
- url: https://{host}
  description: KLS Open API base host. Kurly does not publish the base host publicly; it is issued to contracted shippers together with clientId/secretKey after IP allowlisting.
  variables:
    host:
      default: kls.kurly.com
      description: Kurly Logistics Services host referenced in the KLS FAQ.
security: []
tags:
- name: 배송운영 정책
paths:
  /api/delivery-agency/v1/delivery-policies:
    post:
      operationId: findDeliveryPolicies
      summary: 배송서비스 목록 조회 API
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EB%B0%B0%EC%86%A1%EC%9A%B4%EC%98%81%20%EC%A0%95%EC%B1%85/%EB%B0%B0%EC%86%A1%EC%9A%B4%EC%98%81%20%EC%A0%95%EC%B1%85%20%EC%A1%B0%ED%9A%8C/%EB%B0%B0%EC%86%A1%EC%84%9C%EB%B9%84%EC%8A%A4-%EB%AA%A9%EB%A1%9D-%EC%A1%B0%ED%9A%8C-api/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 주소만 입력하면 화주사의 배송대행 정책에 매칭되는 가용 운영정책을 가장 빠른 배송 가능일 기준으로 조회합니다. deliveryDate는 입력하지 않습니다. oms-order-operation 이 가장 빠른 배송 예정일을 자동 결정하여 응답합니다. 응답은 화주사의 배송대행 정책(샛별/하루)에 매칭되는 권역·택배사 옵션만 반환합니다. operation의 night 와 관련된 서비스는 현재 준비중입니다. 서비스 이용 가능 시기에 따로 안내가 있을 예정이니 참고 부탁드립니다.
      security:
      - bearerAuth: []
  /v1/invoices/print-data:
    post:
      operationId: findInvoicePrintData
      summary: 운송장 출력 정보 다건 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%9A%B4%EC%86%A1%EC%9E%A5/%EC%9A%B4%EC%86%A1%EC%9E%A5%20%EC%B6%9C%EB%A0%A5%20%EC%A0%95%EB%B3%B4%20%EC%A1%B0%ED%9A%8C/%EC%9A%B4%EC%86%A1%EC%9E%A5-%EC%B6%9C%EB%A0%A5-%EC%A0%95%EB%B3%B4-%EB%8B%A4%EA%B1%B4-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 송장 번호 목록으로 송장 출력에 필요한 정보를 조회합니다. 택배사(courier) 값에 따라 invoice 객체의 스키마가 달라집니다. 요청한 화주사 본인의 송장만 반환됩니다. 미존재하거나 다른 화주사 소유인 번호는 응답에서 제외됩니다.
      security:
      - bearerAuth: []
  /v1/orders:
    post:
      operationId: createDeliveryOrder
      summary: 주문 등록
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EB%93%B1%EB%A1%9D/%EC%A3%BC%EB%AC%B8-%EB%93%B1%EB%A1%9D/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 배송대행 주문을 등록합니다. 한 번에 최대 20건까지 등록할 수 있으며, 각 주문의 성공/실패 결과를 개별적으로 반환합니다.
      security:
      - bearerAuth: []
    get:
      operationId: findDeliveryOrdersByClientOrderCode
      summary: 주문 다건 조회 - 판매처 주문번호
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EC%A1%B0%ED%9A%8C/%EC%A3%BC%EB%AC%B8-%EB%8B%A4%EA%B1%B4-%EC%A1%B0%ED%9A%8C-%ED%8C%90%EB%A7%A4%EC%B2%98-%EC%A3%BC%EB%AC%B8%EB%B2%88%ED%98%B8/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 판매처 주문번호 목록으로 주문 정보를 조회합니다. 요청한 화주사 본인의 주문만 반환됩니다. 미존재하거나 다른 화주사 소유인 주문번호는 응답에서 제외됩니다.
      security:
      - bearerAuth: []
  /v1/orders/by-request-keys:
    get:
      operationId: findDeliveryOrdersByRequestKeys
      summary: 주문 다건 조회 - 요청 식별 키
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EC%A1%B0%ED%9A%8C/%EC%A3%BC%EB%AC%B8-%EB%8B%A4%EA%B1%B4-%EC%A1%B0%ED%9A%8C-%EC%9A%94%EC%B2%AD-%EC%8B%9D%EB%B3%84-%ED%82%A4/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 요청 식별 키 목록으로 주문 정보를 조회합니다. 요청한 화주사 본인의 주문만 반환됩니다. 미존재하거나 다른 화주사 소유인 요청 식별 키는 응답에서 제외됩니다.
      security:
      - bearerAuth: []
  /v1/orders/cancel/by-request-key:
    post:
      operationId: cancelDeliveryOrderByRequestKey
      summary: 주문 취소 - 요청 식별 키
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EC%B7%A8%EC%86%8C/%EC%A3%BC%EB%AC%B8-%EC%B7%A8%EC%86%8C-%EC%9A%94%EC%B2%AD-%EC%8B%9D%EB%B3%84-%ED%82%A4/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입력한 요청 식별 키에 해당하는 주문을 단건 취소합니다. 취소할 수 없는 상태(출고·배송 진행 등)면 취소되지 않습니다. 이미 취소된 주문은 성공으로 간주(멱등)합니다.
      security:
      - bearerAuth: []
  /v1/orders/cancel:
    post:
      operationId: cancelDeliveryOrderByClientOrderCode
      summary: 주문 취소 - 판매처 주문번호
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%B0%B0%EC%86%A1%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EC%B7%A8%EC%86%8C/%EC%A3%BC%EB%AC%B8-%EC%B7%A8%EC%86%8C-%ED%8C%90%EB%A7%A4%EC%B2%98-%EC%A3%BC%EB%AC%B8%EB%B2%88%ED%98%B8/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입력한 판매처 주문번호에 해당하는 배송대행 주문을 취소합니다. 동일 판매처 주문번호의 건이 여러 개면 함께 처리되며, 하나라도 취소할 수 없는 주문(출고·배송 진행 등)이 있으면 전체가 취소되지 않습니다. 이미 취소된 주문은 성공으로 간주(멱등)합니다.
      security:
      - bearerAuth: []
  /v1/goods/skus:
    post:
      operationId: saveSku
      summary: 상품 등록
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%EC%83%81%ED%92%88%20%EB%93%B1%EB%A1%9D/save-sku/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 상품을 등록하는 API입니다. (부분 성공 시에도 200 OK와 내역 반환)
      security:
      - bearerAuth: []
    put:
      operationId: updateSku
      summary: 상품 수정
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%EC%83%81%ED%92%88%20%EC%88%98%EC%A0%95/update-sku/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 상품을 수정하는 API입니다. (부분 성공 시에도 200 OK와 내역 반환)
      security:
      - bearerAuth: []
    get:
      operationId: findSkuList
      summary: 상품 목록 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%EC%83%81%ED%92%88%20%EC%A1%B0%ED%9A%8C/find-sku-list/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 상품 목록을 조회하는 API입니다.
      security:
      - bearerAuth: []
  /v1/goods/sales-channel-mapping:
    get:
      operationId: findSalesChannelMappingList
      summary: 판매 채널 상품 매핑 리스트 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%ED%8C%90%EB%A7%A4%20%EC%B1%84%EB%84%90%20%EC%83%81%ED%92%88%20%EB%A7%A4%ED%95%91/find-sales-channel-mapping-list/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 판매 채널 상품 매핑 리스트를 조회하는 API입니다.
      security:
      - bearerAuth: []
    post:
      operationId: saveSalesChannelMapping
      summary: 판매 채널 상품 매핑 등록
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%ED%8C%90%EB%A7%A4%20%EC%B1%84%EB%84%90%20%EC%83%81%ED%92%88%20%EB%A7%A4%ED%95%91/save-sales-channel-mapping/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 판매 채널 상품 매핑을 등록하는 API입니다.
      security:
      - bearerAuth: []
    put:
      operationId: updateSalesChannelMapping
      summary: 판매 채널 상품 매핑 수정
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%83%81%ED%92%88/%ED%8C%90%EB%A7%A4%20%EC%B1%84%EB%84%90%20%EC%83%81%ED%92%88%20%EB%A7%A4%ED%95%91/update-sales-channel-mapping/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 판매 채널 상품 매핑을 수정하는 API입니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/specification:
    get:
      operationId: downloadReceivingSpecification
      summary: 거래명세서 다운로드
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EA%B1%B0%EB%9E%98%EB%AA%85%EC%84%B8%EC%84%9C/%EA%B1%B0%EB%9E%98%EB%AA%85%EC%84%B8%EC%84%9C-%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 요청 코드를 기반으로 거래명세서(PDF)를 다운로드합니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request:
    post:
      operationId: createReceivingRequest
      summary: 입고 요청 등록
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%EC%9A%94%EC%B2%AD/%EC%9E%85%EA%B3%A0-%EC%9A%94%EC%B2%AD-%EB%93%B1%EB%A1%9D/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 요청을 등록하는 API입니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/cancel:
    patch:
      operationId: cancelReceivingRequest
      summary: 입고 요청 취소
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%EC%9A%94%EC%B2%AD/%EC%9E%85%EA%B3%A0-%EC%9A%94%EC%B2%AD-%EC%B7%A8%EC%86%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 등록된 입고 요청을 취소하는 API입니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/plans/search:
    post:
      operationId: searchReceivingPlans
      summary: 입고 플랜 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%EC%9A%94%EC%B2%AD/%EC%9E%85%EA%B3%A0-%ED%94%8C%EB%9E%9C-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 요청할 상품 및 수량 정보를 바탕으로 입고 플랜 목록을 조회하는 API입니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/reports/search:
    post:
      operationId: searchReceivingReports
      summary: 리포트 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%ED%98%84%ED%99%A9/%EB%A6%AC%ED%8F%AC%ED%8A%B8-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 리포트 목록을 조회합니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/items/status/search:
    post:
      operationId: searchReceivingItemStatus
      summary: 상품 입고 현황 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%ED%98%84%ED%99%A9/%EC%83%81%ED%92%88-%EC%9E%85%EA%B3%A0-%ED%98%84%ED%99%A9-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 다양한 조건을 통해 상품별 입고 현황을 조회합니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/search:
    post:
      operationId: searchReceivingRequests
      summary: 입고 요청 목록 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%EA%B3%A0%20%ED%98%84%ED%99%A9/%EC%9E%85%EA%B3%A0-%EC%9A%94%EC%B2%AD-%EB%AA%A9%EB%A1%9D-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 요청 목록을 조회하는 API입니다.
      security:
      - bearerAuth: []
  /openapi/v1/receiving-request/receiving-label/print:
    get:
      operationId: printReceivingLabel
      summary: 입하라벨지 다운로드
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%85%EA%B3%A0/%EC%9E%85%ED%95%98%EB%9D%BC%EB%B2%A8%EC%A7%80/%EC%9E%85%ED%95%98%EB%9D%BC%EB%B2%A8%EC%A7%80-%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 입고 요청 코드를 기반으로 입하라벨지(PDF)를 다운로드합니다. 상품코드를 지정하지 않으면 해당 입고 요청의 전체 상품 라벨을 대상으로 합니다. 다운로드 가능 상태(확인대기/입고대기/입고중)에서만 다운로드할 수 있습니다.
      security:
      - bearerAuth: []
  /v1/lot-ledgers:
    get:
      operationId: findLotLedgers
      summary: 로트별 수불부 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%AC%EA%B3%A0/%EC%88%98%EB%B6%88%EB%B6%80/%EB%A1%9C%ED%8A%B8%EB%B3%84-%EC%88%98%EB%B6%88%EB%B6%80-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 날짜 범위 내 로트별 수불부를 조회합니다. goodsCode 가 존재하는 경우 최대 조회가능 날짜 31일, 존재하지 않는 경우 최대 7일
      security:
      - bearerAuth: []
  /v1/ledgers:
    get:
      operationId: findLedgers
      summary: 상품별 수불부 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%AC%EA%B3%A0/%EC%88%98%EB%B6%88%EB%B6%80/%EC%83%81%ED%92%88%EB%B3%84-%EC%88%98%EB%B6%88%EB%B6%80-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 날짜 범위 내 상품별 수불부를 조회합니다. goodsCode 가 존재하는 경우 최대 조회가능 날짜 31일, 존재하지 않는 경우 최대 7일
      security:
      - bearerAuth: []
  /v1/inventories:
    get:
      operationId: findInventories
      summary: 재고 조회
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%9E%AC%EA%B3%A0/%EC%9E%AC%EA%B3%A0%20%EC%A1%B0%ED%9A%8C/%EC%9E%AC%EA%B3%A0-%EC%A1%B0%ED%9A%8C/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: 재고 조회 API 입니다.
      security:
      - bearerAuth: []
  /api/fulfillment/v2/orders/bulk:
    post:
      operationId: createOrdersBulkV2
      summary: 주문 다건 등록 V2
      tags:
      - 배송운영 정책
      externalDocs:
        description: KLS API reference
        url: https://developers.kurly.com/docs/api/%EB%AC%BC%EB%A5%98%EB%8C%80%ED%96%89/%EC%A3%BC%EB%AC%B8/%EC%A3%BC%EB%AC%B8%20%EB%93%B1%EB%A1%9D/%EC%A3%BC%EB%AC%B8-%EB%8B%A4%EA%B1%B4-%EB%93%B1%EB%A1%9D-v-2/
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (added to all APIs in KLS docs v1.3.5)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      descrip

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kurly/refs/heads/main/openapi/kurly-default-api-openapi.yml