발주서 조회 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" } ] } |