订单列表查询 (按天分页)

API支持的买家用户地区：韩国、台湾

可通过按天分页的方式查询订单列表。例) (2022-02-01~2022-02-03) 。

注意：CGF 订单不会通过 Open API 返回给您。 请通过 Wing 查看。

可通过maxPerPage参数调整每页row的大小，下一页可通过[nextToken]获取。除部分Path Parameter外，整体配置与订单列表查询相同（以分钟为单位）。 

※ 顾客可在付款完成后修改收货地址，因此将商品状态处理为“商品准备中”后，请务必更新配送地信息("receiver")（使用单个订单查询API更便捷）。 

※ 订单数量较多时，订单列表查询可能会出现超时错误。请确认[如何解决超时错误]，延长超时时间。 

※ 订单列表中无法查看已完成退货的订单，请通过“退货/取消申请列表查询”API查看。

• 发货前，请一定要确认"sellerProductName + sellerProductItemName"和"vendorItemName"上的信息是否一致。
• 构成、数量、容量等有不同时，请先暂停发货，通过在线咨询申请的话我们会尽快给予帮助的。(商品信息显示错误。> 请选择“是”来申请。)
• 若确认为错误显示，扣除的卖家分数就会恢复。

路径

GET

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

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/ordersheets?createdAtFrom=2025-07-15%2B09:00&createdAtTo=2025-07-25%2B09:00&maxPerPage=50&status=INSTRUCT

请求参数

链接查询参数

请求体

无 

返回消息

返回訊息例子

{
    "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": 5000,
                "nanos": 0
            },
            "remotePrice": null,
            "remoteArea": false,
            "parcelPrintMessage": "문 앞",
            "splitShipping": false,
            "ableSplitShipping": false,
            "receiver": {
                "name": "신*희",
                "safeNumber": " +1(555)444-1234",
                "receiverNumber": null,
                "addr1": "경기 오산시 가수동 **아파트",
                "addr2": "109동 *호",
                "postCode": "447-700"
            },
            "orderItems": [
                {
                    "vendorItemPackageId": 0,
                    "vendorItemPackageName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1",
                    "productId": 31846051,
                    "vendorItemId": 3242596358,
                    "vendorItemName": "인디고뱅크키즈 기모 테잎배색 트레이닝 팬츠 IKTM17WG1, 07 DARK GREY, 160호",
                    "shippingCount": 1,
                    "salesPrice": {
                        "currencyCode": "KRW",
                        "units": 19000,
                        "nanos": 0
                    },
                    "orderPrice": {
                        "currencyCode": "KRW",
                        "units": 19000,
                        "nanos": 0
                    },
                    "discountPrice": {
                        "currencyCode": "KRW",
                        "units": 3000,
                        "nanos": 0
                    },
                    "instantCouponDiscount": {
                        "currencyCode": "KRW",
                        "units": 2000,
                        "nanos": 0
                    },
                    "downloadableCouponDiscount": {
                        "currencyCode": "KRW",
                        "units": 1000,
                        "nanos": 0
                    },
                    "coupangDiscount": {
                        "currencyCode": "KRW",
                        "units": 0,
                        "nanos": 0
                    },
                    "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": 64253897***6401428,
            "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": "경기 광명시 하안1동 두산트레지움아파트",
                "addr2": "107동701호",
                "postCode": "423-747"
            },
            "orderItems": [
                {
                    "vendorItemPackageId": 0,
                    "vendorItemPackageName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5",
                    "productId": 34047877,
                    "vendorItemId": 3261300431,
                    "vendorItemName": "리틀브렌 후드달이 구스 경량 점퍼 LBJD17WG5, 04 MIDDLE MELANGE GR, 170호",
                    "shippingCount": 1,
                    "salesPrice": {
                        "currencyCode": "KRW",
                        "units": 27800,
                        "nanos": 0
                    },
                    "orderPrice": {
                        "currencyCode": "KRW",
                        "units": 278000,
                        "nanos": 0
                    },
                    "discountPrice": {
                        "currencyCode": "KRW",
                        "units": 2470,
                        "nanos": 0
                    },
                    "instantCouponDiscount": {
                        "currencyCode": "KRW",
                        "units": 560,
                        "nanos": 0
                    },
                    "downloadableCouponDiscount": {
                        "currencyCode": "KRW",
                        "units": 1910,
                        "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"
}

错误代码

接口名称

GET_ORDERSHEET