coupang
공지2024-03-18active

발주서 조회 API 내 자동생성옵션 주문 건 주문 수량 표기 방식 변경 (2024년 4월 12일)

자동생성옵션 상품 주문 발생 시, 해당 옵션의 주문 수량 및 배송해야 하는 총 수량 파악에 대한 혼선을 개선하기 위해  발주서 API 에서 표기되는 등록/노출상품명, 주문 수량 정보를 변경하여 제공합니다. 

기존에는 자동생성옵션에 주문건이 들어왔을 경우, 판매자가 생성하지 않은 옵션임에 따라 총 배송해야하는 '수량' 이해에 혼선이 있었습니다. 

이에 따라 패키징 방식, 박스 수량을 결정할 때 활용되는 아래 발주서 API 내에서는 자동생성옵션에 대한 주문 수량이 아닌 기존에 판매자가 등록하신 '원천옵션'을 기준으로 몇 개 수량이 주문으로 인입되었는지 수정 표기하여 제공합니다.

또한 추가 파라메터를 통해 자동생성옵션에 대한 아이템 여부와 자동생성 옵션ID, 자동생성옵션 노출상품명, 자동생성옵션 개수를 병행 표기합니다.

  • 변경 대상 API : 

발주서 목록 조회(일단위 페이징) API
발주서 목록 조회(분단위 전체) API 
발주서 단건 조회(shipmentBoxId) API
발주서 단건 조회(orderId) API

  • 시행일: 2024년 4월 12일 오후 5시 
  • 추가 파라메터 
orderItems Array 주문 상품 정보
  upBundleItem Boolean 자동생성옵션 아이템 여부
true/false
  upBundleVendorItemId Number 자동생성옵션ID
  upBundleVendorItemName String 자동생성옵션 노출상품명
  upBundleSize Number 자동생성옵션 개수
  • Response Example
발주서 조회 API Response : AS-IS 발주서 조회 API Response : TO-BE 
{
   "code": 200,
  "message": "OK",
  "data": [
    {
       "shipmentBoxId": 62***54513,
      "orderId": 291***35653980,
      "orderedAt": "2024-03-01T17:03:26",
      "orderer": {
         "name": "박**",
        "email": "kk*****@da",
        "safeNumber": "010***",
        "ordererNumber": null
      },
      "paidAt": "2024-03-01T17:03:28",
      "status": "FINAL_DELIVERY",
      "shippingPrice": 0,
      "remotePrice": 0,
      "remoteArea": false,
      "parcelPrintMessage": "직접 받고 부재 시문 앞",
      "splitShipping": false,
      "ableSplitShipping": false,
      "receiver": {
         "name": "박**",
        "safeNumber": "",
        "receiverNumber": null,
        "addr1": "경상남도 ***",
        "addr2": "1층 ***",
        "postCode": "***77"
      },
      "orderItems": [
        {
           "vendorItemPackageId": 0,
          "vendorItemPackageName": "커클랜드시그니춰 대용량 카놀라유 오일",
          "productId": 2***10747,
          "vendorItemId": 8***3022331,
          "vendorItemName": "코스트코 커클랜드카놀라유, 2.83L, 4개",
          "shippingCount": 1,
          "salesPrice": 51080,
          "orderPrice": 51080,
          "discountPrice": 0,
          "instantCouponDiscount": 0,
          "downloadableCouponDiscount": 0,
          "coupangDiscount": 0,
          "externalVendorSkuCode": "",
          "etcInfoHeader": null,
          "etcInfoValue": null,
          "etcInfoValues": null,
          "sellerProductId": 13***193879,
          "sellerProductName": "커클랜드시그니춰대용량 카놀라유 오일",
          "sellerProductItemName": "4개 2.83L",
          "firstSellerProductItemName": "4개2.83L",
          "cancelCount": 0,
          "holdCountForCancel": 0,
          "estimatedShippingDate": "2024-03-05",
          "plannedShippingDate": "",
          "invoiceNumberUploadDate": "2024-03-04T14:25:53",
          "extraProperties": {},
          "pricingBadge": false,
          "usedProduct": false,
          "confirmDate": "2024-03-12 18:10:39",
          "deliveryChargeTypeName": "무료",
          "canceled": false
        }
      ],
      "overseaShippingInfoDto": {
         "personalCustomsClearanceCode": "",
        "ordererSsn": "",
        "ordererPhoneNumber": ""
      },
      "deliveryCompanyName": "롯데택배",
      "invoiceNumber": "***",
      "inTrasitDateTime": "2024-03-04 20:00:00",
      "deliveredDate": "2024-03-05 17:10:00",
      "refer": "안드로이드앱",
      "shipmentType": "THIRD_PARTY"
    }
  ]
}
 
{
   "code": 200,
  "message": "OK",
  "data": [
    {
       "shipmentBoxId": 62***54513,
      "orderId": 291***35653980,
      "orderedAt": "2024-03-01T17:03:26",
      "orderer": {
         "name": "박**",
        "email": "kk*****@da",
        "safeNumber": "010***",
        "ordererNumber": null
      },
      "paidAt": "2024-03-01T17:03:28",
      "status": "FINAL_DELIVERY",
      "shippingPrice": 0,
      "remotePrice": 0,
      "remoteArea": false,
      "parcelPrintMessage": "직접 받고 부재 시문 앞",
      "splitShipping": false,
      "ableSplitShipping": false,
      "receiver": {
         "name": "박**",
        "safeNumber": "",
        "receiverNumber": null,
        "addr1": "경상남도 ***",
        "addr2": "1층 ***",
        "postCode": "***77"
      },
      "orderItems": [
        {
           "vendorItemPackageId": 0,
          "vendorItemPackageName": "커클랜드시그니춰 대용량 카놀라유 오일",
          "productId": 2***10747,
          "vendorItemId": 83937085213,
          "vendorItemName": "커클랜드시그니춰대용량 카놀라유 오일, 2.83L, 2개",
          "shippingCount": 2,
          "salesPrice": 51080,
          "orderPrice": 51080,
          "discountPrice": 0,
          "instantCouponDiscount": 0,
          "downloadableCouponDiscount": 0,
          "coupangDiscount": 0,
          "externalVendorSkuCode": "",
          "etcInfoHeader": null,
          "etcInfoValue": null,
          "etcInfoValues": null,
          "sellerProductId": 13***193879,
          "sellerProductName": "커클랜드시그니춰대용량 카놀라유 오일",
          "sellerProductItemName": "2개 2.83L",
          "firstSellerProductItemName": "2개2.83L",
          "cancelCount": 0,
          "holdCountForCancel": 0,
          "estimatedShippingDate": "2024-03-05",
          "plannedShippingDate": "",
          "invoiceNumberUploadDate": "2024-03-04T14:25:53",
          "extraProperties": {},
          "pricingBadge": false,
          "usedProduct": false,
          "confirmDate": "2024-03-12 18:10:39",
          "deliveryChargeTypeName": "무료",
          "upBundleVendorItemId": 8***3022331,
          "upBundleVendorItemName": "코스트코커클랜드 카놀라유, 2.83L, 4개",
          "upBundleSize": 2,
          "upBundleItem": true,
          "canceled": false
        }
      ],
      "overseaShippingInfoDto": {
         "personalCustomsClearanceCode": "",
        "ordererSsn": "",
        "ordererPhoneNumber": ""
      },
      "deliveryCompanyName": "롯데택배",
      "invoiceNumber": "***",
      "inTrasitDateTime": "2024-03-04 20:00:00",
      "deliveredDate": "2024-03-05 17:10:00",
      "refer": "안드로이드앱",
      "shipmentType": "THIRD_PARTY"
    }
  ]
}
영향 범위All
Slugchanged-the-order-quantity-display-method-for-automatic-generation-option-orders
Source ID30049331688089
관련

관련 공지