Coupang Developer Center

API 적용 가능한 구매자 사용자 지역: 한국, 대만

발주서 목록을 24시간 이내의 분단위 구간으로 조회합니다.

예) (2022-08-10T00:00~2022-08-10T23:59)

24시간 이상 조회 시 에러가 발생합니다.

Path Parameter 일부 제외, 발주서 목록 조회(일 단위 전체)와 전반적으로 구성이 같습니다.

반품완료건은 발주서 목록에서 조회 불가하기에 '반품 /취소 요청 목록 조회' API를 이용합니다.
결제완료 상태에서 고객이 배송지를 변경할 수 있기 때문에
상품준비중 처리 이후에 꼭! 발주서 단건 조회를 통해 배송지 정보("receiver")가 변경되었는지를 재확인해야 합니다.

출고 전, "sellerProductName + sellerProductItemName"과 "vendorItemName"의 정보가 일치하는지 반드시 확인해주시기 바랍니다.
구성, 수량, 용량 등이 다르게 노출되고 있는 경우, 출고를 보류해주시고 온라인 문의 접수해주시면 빠르게 도움 드리도록 하겠습니다. ( 상품 정보가 잘못 노출되고 있습니다. > '네' 선택하여 접수해주세요.)
오노출로 확인되는 경우, 반영된 판매자 점수는 원복됩니다.

Path

GET

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/ordersheets?createdAtFrom=2025-07-29T00:01%2B09:00&createdAtTo=2025-07-29T23:59%2B09:00&searchType=timeFrame&status=DEPARTURE

Request Parameters

Path Segment Parameter

Name					Required	Type	Description
vendorId					O	String	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345

Query String Parameter

Name

Required

Type

Description

createdAtFrom

String

검색 시작일시（ISO-8601표준을 준수해야 합니다.）

yyyy-mm-ddT00:00%2B09:00 형태로 조회하기 원하는 시작 날짜 및 시각 기입
ex) 2025-07-29T01:23%2B09:00

createdAtTo

String

검색 종료일시（ISO-8601표준을 준수해야 합니다.）

yyyy-mm-ddT00:00 형태로 조회하기 원하는 종료 날짜 및 시각 기입
ex) 2025-07-29T15:50%2B09:00

해당 일자 내 24시간이내로 조회 가능합니다.

status

String

발주서 상태

Parameter Name	Status
ACCEPT	결제완료
INSTRUCT	상품준비중
DEPARTURE	배송지시
DELIVERING	배송중
FINAL_DELIVERY	배송완료
NONE_TRACKING	업체 직접 배송(배송 연동 미적용), 추적불가

searchType

String

search type for order sheets results

searchType=timeFrame이면 발주서 목록 조회(분단위 전체)로 수행되며, 그외에는 발주서 목록 조회(일단위 페이징)으로 수행됩니다.

Request Example

not require body

Response Message

Name Type Description

code

Number

서버 응답 코드

message

String

서버 응답 메세지

data

Array

결과리스트

결과가 없을 때는 빈 리스트가 리턴

shipmentBoxId

Number

배송번호(묶음배송번호)

orderId

Number

주문번호

orderedAt

String

주문일시（ISO-8601표준을 준수해야 합니다.）

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

orderer

Object

주문자

name

String

주문자 이름

String

주문자 email

미사용(빈값)

safeNumber

String

수취인 연락처(안심번호)（E.164표준을 준수해야 합니다.）

ordererNumber

String

주문자 연락처(실전화번호)（E.164표준을 준수해야 합니다.）

null

paidAt

String

결제일시（ISO-8601표준을 준수해야 합니다.）

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

status

String

발주서 상태

Parameter Name	Status
ACCEPT	결제완료
INSTRUCT	상품준비중
DEPARTURE	배송지시
DELIVERING	배송중
FINAL_DELIVERY	배송완료
NONE_TRACKING	업체 직접 배송(배송 연동 미적용), 추적불가

shippingPrice

Object

배송비

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

remotePrice

Object

도서산간배송비

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

remoteArea

Boolean

도서산간여부

parcelPrintMessage

String

배송메세지

optional

splitShipping

Boolean

분리배송여부

ableSplitShipping

Boolean

분리배송가능여부

receiver

Object

name

String

수취인 이름

safeNumber

String

수취인 연락처(안심번호)

receiverNumber

String

수취인 연락처(실전화번호)

null

addr1

String

수취인 배송지1

addr2

String

수취인 배송지2

postCode

String

수취인 우편번호

orderItems

Array

Items to deliver

vendorItemPackageId

Number

vendorItemPackageId

미사용 / 없는 경우 0으로 리턴

vendorItemPackageName

String

vendorItemPackageName

미사용

productId

Number

productId

optional / 없는 경우 0으로 리턴

vendorItemId

Number

옵션ID

vendorItemName

String

노출상품명

shippingCount

Number

shippingCount = 주문시 item의 구매 수량
holdCountForCancel = 취소가 되어 환불 예정이 수량
cancelCount = 취소가 확정된 수량
발주 가능 수량 = shippingCount - (holdCountForCancel + cancelCount )

salesPrice

Object

개당 상품 가격(price of one item)

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

orderPrice

Object

결제 가격 : salesPrice*shippingCount

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

discountPrice

Object

총 할인 가격,
discountPrice(총 할인 금액) =
instantCouponDiscount(즉시할인 쿠폰) +
downloadableCoupon(다운로드 쿠폰) +
coupangDiscount(쿠팡 지원 할인)

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

instantCouponDiscount

Object

즉시할인 쿠폰

즉시할인 쿠폰 할인 금액

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

downloadableCouponDiscount

Object

다운로드 쿠폰

다운로드 쿠폰 할인 금액

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

coupangDiscount

Object

쿠팡 지원 할인

쿠팡 지원 장바구니 / 카테고리 쿠폰 등의 금액

currencyCode

String

통화 코드 (ISO-4217 표준 준수), 대문자 3개

units

Number

통화 정수 부분, 64 bit

nanos

Number

통화 소수점 부분, 32 bit, 값 범위 [-9999999999, 999999999]

externalVendorSkuCode

String

external code

optional

etcInfoHeader

String

상품별 개별 입력 항목

optional

etcInfoValue

String

상품별 개별 입력 항목에 대한 사용자의 입력값

optional

필드는 존재하나 값이 없는 상태입니다. 필요시에는 아래의 etcInfoValues를 사용하시기 바랍니다.

etcInfoValues

Array

상품별 개별 입력 항목에 대한 사용자의 입력값 리스트

optional

sellerProductId

Number

등록상품ID

sellerProductName

String

등록상품명

sellerProductItemName

String

등록옵션명

firstSellerProductItemName

String

최초등록옵션명

cancelCount

Number

취소수량

holdCountForCancel

Number

환불대기수량

estimatedShippingDate

String

주문시 출고예정일
(불리배송 출고예정일)（ISO-8601표준을 준수해야 합니다.）

optional / yyyy-mm-dd

plannedShippingDate

String

실제 출고예정일 (분리배송 시)（ISO-8601표준을 준수해야 합니다.）

optional / yyyy-mm-dd

invoiceNumberUploadDate

String

운송장번호 업로드 일시（ISO-8601표준을 준수해야 합니다.）

optional /YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

extraProperties

Object

업체상품옵션 추가 정보

optional / key:value 형태

pricingBadge

Boolean

최저가 상품 여부

true/false

usedProduct

Boolean

중고 상품 여부

true/false

confirmDate

String

구매확정일자（ISO-8601표준을 준수해야 합니다.）

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

deliveryChargeTypeName

String

배송비구분

유료, 무료

upBundleVendorItemId

Number

자동생성옵션 ID

upBundleVendorItemName

String

자동생성옵션 노출상품명

upBundleSize

Number

자동생성옵션 개수

upBundleItem

Boolean

자동생성옵션 아이템 여부
true/false

canceled

Boolean

주문 취소 여부

true/false

overseaShippingInfoDto

Object

해외배송정보

optional

personalCustomsClearanceCode

String

개인통관 고유부호

optional

orderersSsn

String

미사용

optional

ordererPhoneNumber

String

통관용 수신자 전화번호（E.164표준을 준수해야 합니다.）

deliveryCompanyName

String

택배사

CJ 대한통운,한진택배

invoiceNumber

String

운송장번호

inTrasitDateTime

String

출고일(발송일)（ISO-8601표준을 준수해야 합니다.）

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

deliveredDate

String

배송완료일（ISO-8601표준을 준수해야 합니다.）

YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

refer

String

결제위치

아이폰앱,안드로이드앱,PC웹,모바일웹

shipmentType

String

배송유형

THIRD_PARTY, CGF, CGF LITE

isCod

Boolean

주문이 현금결제(착불/COD) 방식입니까

true/false

extraProperties

Object

주문 속성의 기타 정보

key:value 형식

세금 계산서(인보이스) 발행을 지원하는 마켓에서 다음 정보가 표시됩니다:

receiptOption (영수증 옵션):

"PAPER": 종이 영수증 (Paper Invoice)
"E-GUI": 전자 영수증 (Electronic Invoice)

appliedType (적용된 유형): 세금 계산서 유형 (가능한 값):

"PERSONAL_COUPANG_MEMBER_CARRIER": 쿠팡 회원 매개체 (Coupang Member Carrier)
"PERSONAL_MOBILE_BARCODE_CARRIER": 휴대폰 바코드 매개체 (Mobile Barcode Carrier)
"DONATION": 영수증 기부 (Invoice Donation)
"BUSINESS": 사업자 영수증 (Company Invoice)

appliedValue (적용 값): 통합 영수증 번호/정보 (가능한 값):

appliedType이 PERSONAL_COUPANG_MEMBER_CARRIER일 때: null
appliedType이 PERSONAL_MOBILE_BARCODE_CARRIER일 때: 휴대폰 바코드 (Mobile Barcode)
appliedType이 DONATION일 때: 영수증 기부 번호 (Invoice Donation Number)
appliedType이 BUSINESS일 때: 사업자등록번호 (Company Uniform Serial Number)

sameDayShipping: 주문 당일 배송 여부 (가능한 값):

“true”: 당일 배송 활성화
“false”: 당일 배송 비활성화

cutOffTimeHour: sameDayShipping이 적용되지 않는 시간 (가능한 값):

10~23, 0

nextToken

String

다음 페이지 요청 전송시 필요한 token 값

마지막 페이지인 경우 빈 값으로 리턴

Response Example

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "shipmentBoxId": 64253897***6401429,
      "orderId": 22000009546234,
      "orderedAt": "2025-01-15T14:17:13.973885-08:00",
      "orderer": {
        "name": "신*희",
        "email": "",
        "safeNumber": "+1(555)444-1234",
        "ordererNumber": null
      },
      "paidAt": "2025-01-15T14:17:13.973885-08:00",
      "status": "FINAL_DELIVERY",
      "shippingPrice": {
        "currencyCode": "KRW",
        "units": 2500,
        "nanos": 0
      },
      "remotePrice": null,
      "remoteArea": false,
      "parcelPrintMessage": "문 앞",
      "splitShipping": false,
      "ableSplitShipping": false,
      "receiver": {
        "name": "신*희",
        "safeNumber": "+1(555)444-1234",
        "receiverNumber": null,
        "addr1": "경기 광명시 하안1동 두산트레지움아파트",
        "addr2": "107동701호",
        "postCode": "423-747"
      },
      "orderItems": [
        {
          "vendorItemPackageId": 0,
          "vendorItemPackageName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1",
          "productId": 31846051,
          "vendorItemId": 3242596358,
          "vendorItemName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1, 07 DARK GREY, 160호",
          "shippingCount": 1,
          "salesPrice": {
            "currencyCode": "KRW",
            "units": 19900,
            "nanos": 0
          },
          "orderPrice": {
            "currencyCode": "KRW",
            "units": 19900,
            "nanos": 0
          },
          "discountPrice": null,
          "externalVendorSkuCode": "170816368810",
          "etcInfoHeader": null,
          "etcInfoValue": null,
          "etcInfoValues": [
            "추가메시지1",
            "추가메시지2"
          ],
          "sellerProductId": 80240831,
          "sellerProductName": "인디고뱅크키즈 A5 기모 배색츄키니 IKTM17WG1",
          "sellerProductItemName": "07 DARK GREY 160호",
          "firstSellerProductItemName": "07 DARK GREY/160호",
          "cancelCount": 0,
          "holdCountForCancel": 0,
          "estimatedShippingDate": "2017-10-16",
          "plannedShippingDate": "",
          "invoiceNumberUploadDate": "",
          "extraProperties": {},
          "pricingBadge": false,
          "usedProduct": false,
          "confirmDate": "2025-01-15T14:17:13.973885-08:00",
          "deliveryChargeTypeName": "유료",
          "canceled": false
        }
      ],
      "overseaShippingInfoDto": {
        "personalCustomsClearanceCode": "",
        "ordererSsn": "",
        "ordererPhoneNumber": ""
      },
      "deliveryCompanyName": "CJ 대한통운",
      "invoiceNumber": "340010913442",
      "inTrasitDateTime": "2025-01-15T14:17:13.973885-08:00",
      "deliveredDate": "2025-01-15T14:17:13.973885-08:00",
      "refer": "안드로이드앱"
      "shipmentType": "THIRD_PARTY",
      "isCod": false,
      "extraProperties":{
                "sameDayShipping": "false",
                "cutOffTimeHour": "0"}
    },
    {
      "shipmentBoxId": 6425389776401428,
      "orderId": 22000009546630,
      "orderedAt": "2025-01-15T14:17:13.973885-08:00",
      "orderer": {
        "name": "김*숙",
        "email": "hs*****@na",
        "safeNumber": "+1(555)444-1234",
        "ordererNumber": null
      },
      "paidAt": "2025-01-15T14:17:13.973885-08:00",
      "status": "FINAL_DELIVERY",
      "shippingPrice": {
        "currencyCode": "KRW",
        "units": 0,
        "nanos": 0
      },
      "remotePrice": null,
      "remoteArea": false,
      "parcelPrintMessage": "직접 받고 부재 시 문 앞",
      "splitShipping": false,
      "ableSplitShipping": false,
      "receiver": {
        "name": "김*숙",
        "safeNumber": "+1(555)444-1234",
        "receiverNumber": null,
        "addr1": "경기도 고양시 일산동구 백석동 **아파트",
        "addr2": "303-*",
        "postCode": "104-48"
      },
      "orderItems": [
        {
          "vendorItemPackageId": 0,
          "vendorItemPackageName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5",
          "productId": 34047877,
          "vendorItemId": 3261300431,
          "vendorItemName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5, 04 MIDDLE MELANGE GR, 170호",
          "shippingCount": 1,
          "salesPrice": {
            "currencyCode": "KRW",
            "units": 49900,
            "nanos": 0
          },
          "orderPrice": {
            "currencyCode": "KRW",
            "units": 49900,
            "nanos": 0
          },
          "discountPrice": {
            "currencyCode": "KRW",
            "units": 500,
            "nanos": 0
          },
          "instantCouponDiscount": {
            "currencyCode": "KRW",
            "units": 0,
            "nanos": 0
          },
          "downloadableCouponDiscount": {
            "currencyCode": "KRW",
            "units": 500,
            "nanos": 0
          },
          "coupangDiscount": {
            "currencyCode": "KRW",
            "units": 0,
            "nanos": 0
          },
          "externalVendorSkuCode": "170824416510",
          "etcInfoHeader": null,
          "etcInfoValue": null,
          "etcInfoValues": [
            "추가메시지1",
            "추가메시지2"
          ],
          "sellerProductId": 87037167,
          "sellerProductName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5",
          "sellerProductItemName": "04 MIDDLE MELANGE GR 170호",
          "firstSellerProductItemName": "04 MIDDLE MELANGE GR/170호",
          "cancelCount": 0,
          "holdCountForCancel": 0,
          "estimatedShippingDate": "2017-10-16",
          "plannedShippingDate": "",
          "invoiceNumberUploadDate": "",
          "extraProperties": {},
          "pricingBadge": false,
          "usedProduct": false,
          "confirmDate": "2025-01-15T14:17:13.973885-08:00",
          "deliveryChargeTypeName": "무료",
          "canceled": false
        }
      ],
      "overseaShippingInfoDto": {
        "personalCustomsClearanceCode": "",
        "ordererSsn": "",
        "ordererPhoneNumber": ""
      },
      "deliveryCompanyName": "CJ 대한통운",
      "invoiceNumber": "340010912565",
      "inTrasitDateTime": "2025-01-15T14:17:13.973885-08:00",
      "deliveredDate": "2025-01-15T14:17:13.973885-08:00",
      "refer": "안드로이드앱",
      "shipmentType": "CGF LITE",
      "isCod": false,
      "extraProperties": {
        "taxReceiptInfo": {
          "appliedValue": null,
          "receiptOption": "PAPER",
          "appliedType": "PERSONAL_COUPANG_MEMBER_CARRIER"
        },
        "sameDayShipping": "true",
        "cutOffTimeHour": "18"
      }
    }
  ],
  "nextToken": "448537989"
}

Error Spec

HTTP 상태 코드(오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	Invalid vendor ID	올바른 판매자 ID(vendorId)를 입력했는지 확인합니다. 예) A00012345
400 (요청변수확인)	endTime-startTime range should less than 0 day	조회기간이 24시간 이내 인지 확인합니다.

발주서 목록 조회(분단위 전체)

요약

상세

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Query String Parameter

Request Example

Response Message

Response Example

Error Spec