주문번호 단위의 상세 정보를 복수 개 제공합니다.
클레임(취소,교환,반품) 정보는 조회시점에 클레임 진행중/완료 상태인 경우에만 조회되며 최종 클레임 정보만 연동됩니다.
1회 조회시 10건의 주문정보를 한번에 조회 가능하며, 조회 결과 응답 가능합니다.
- 단, 일부 요청된 주문번호가 유효하지 않거나 조회 실패된 경우 응답결과 내 fail 항목으로 응답 됩니다.
요청
GET /v1/shopping/orders/bulk?order_ids={order_ids} HTTP/1.1
Content-type: application/json| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| order_ids | Long | 필수 | 주문번호 |
응답
<응답바디>
| 필드명 | 타입 | 설명 | ||||||||||||||||||||||||
| content | Array[] |
|
||||||||||||||||||||||||
| fail | Array[Long] | 조회 실패한 주문 목록 |
<응답성공>
예시 1. 발송 중 상태 주문 + 조회 불가능한 주문
{
"content": [
{
"id": 3000095223,
"orderBase": {
"id": 3000095223,
"paymentId": 3000073984,
"channelType": "STORE",
"talkDealOrder": "Y",
"groupDiscountRoomId": 1234567891,
"status": "ShippingWaiting",
"createdAt": "20230413170212",
"paidAt": "20230413170213",
"modifiedAt": "20230413170329"
},
"orderer": {
"phoneNumber": "+82 12345678"
},
"orderProduct": {
"id": 10028781,
"name": "일반상품",
"sellerItemNo": "",
"optionContent": "색상/빨강",
"quantity": 1,
"productPrice": 1000,
"optionPrice": 0,
"sellerDiscountPrice": 300.0,
"sellerCouponDiscountPrice": 0,
"adminDiscountPrice": 0,
"settlementBasicPrice": 700.0,
"baseFee": 70,
"displayFee": 0,
"discountFee": 0,
"refererCode": "",
"brandName": "",
"deliveryAmountOriginId": 1407461,
"deliveryAmountPayPointTime": "PayedToOrder",
"deliveryAmountType": "FREE",
"deliveryAmount": 0,
"areaAdditionalDeliveryAmount": 0
},
"orderDeliveryRequest": {
"receiverName": "이름",
"receiverAddress": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트) 20층",
"receiverAddress1": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트)",
"receiverAddress2": "20층",
"receiverPhoneNumber": "",
"receiverMobileNumber": "010-1234-4321",
"zipcode": "13529",
"roadZipCode": "13529",
"requirement": ""
},
"orderDelivery": {
"deliveryRequestAt": "20230413170214",
"confirmedAt": "20230413170329",
"shippingMethod": "SHIPPING"
}
}
],
"fail": [
3000083685
]
}
예시 2. 주문 반품 완료 상태
{
"content": [
{
"id": 3000095223,
"orderBase": {
"id": 3000095223,
"paymentId": 3000073984,
"channelType": "STORE",
"talkDealOrder": "Y",
"groupDiscountRoomId": 1234567891,
"status": "ReturnCancelComplete",
"createdAt": "20230413170212",
"paidAt": "20230413170213",
"canceledAt": "20230413170850",
"modifiedAt": "20230413170850"
},
"orderer": {
"phoneNumber": "+82 12345678"
},
"orderProduct": {
"id": 10028781,
"name": "일반상품",
"sellerItemNo": "",
"optionContent": "색상/빨강",
"quantity": 1,
"productPrice": 1000,
"optionPrice": 0,
"sellerDiscountPrice": 300.0,
"sellerCouponDiscountPrice": 0,
"adminDiscountPrice": 0,
"settlementBasicPrice": 700.0,
"baseFee": 70,
"displayFee": 0,
"discountFee": 0,
"refererCode": "",
"brandName": "",
"deliveryAmountOriginId": 1407461,
"deliveryAmountPayPointTime": "PayedToOrder",
"deliveryAmountType": "FREE",
"deliveryAmount": 0,
"areaAdditionalDeliveryAmount": 0
},
"orderDeliveryRequest": {
"receiverName": "1**",
"receiverAddress": "경기 성남시 분당구 ***로 166 ***",
"receiverAddress1": "경기 성남시 분당구 ***로 166",
"receiverAddress2": "***",
"receiverPhoneNumber": "",
"receiverMobileNumber": "010-12**-**21",
"zipcode": "13***",
"roadZipCode": "13***",
"requirement": ""
},
"orderDelivery": {
"deliveryRequestAt": "20230413170214",
"confirmedAt": "20230413170329",
"invoiceRegisteredAt": "20230413170748",
"shippingMethod": "SHIPPING",
"deliveryCompanyCode": "CJGLS",
"invoiceNumber": "1234567890"
},
"orderClaimReturn": {
"claimId": 56505,
"claimItemId": 75744,
"claimItemStatus": "RETURN_CANCEL_COMPLETE",
"reasonCodeId": 11,
"reasonCodeName": "상품 파손 또는 불량",
"reasonComment": "반품합니다.",
"referType": "FRONT",
"createdAt": "20230413170822",
"modifiedAt": "20230413170850",
"completedAt": "20230413170850",
"returnAddressId": 126524,
"returnMethod": "택배",
"returnDeliveryCompanyId": 13,
"returnDeliveryCompanyCode": "ILYANG",
"returnShippingFee": 0,
"returnShippingFeeMethod": "BySeller",
"returnShippingFeeMethodLabel": "판매자가 지불",
"collectType": "AUTO",
"pickupName": "1**",
"pickupZipCode": "13***",
"pickupRoadZipCode": "13***",
"pickupAddress1": "경기 성남시 분당구 ***로 166 (**동, 카카오 판교 아지트)",
"pickupAddress2": "***",
"pickupMobileNumber": "010-****-4321",
"pickupPhoneNumber": ""
}
}
],
"fail": []
}
예시 3. 조회 불가능한 주문
{
"fail": [
3000083685
]
}
예시 4. 해외배송 주문
{
"id": 0,
"orderBase": {
"id": 0,
... 생략...
"orderDeliveryRequest": {
"receiverName": "string",
"receiverAddress": "string",
"receiverAddress1": "string",
"receiverAddress2": "string",
"receiverPhoneNumber": "string",
"receiverMobileNumber": "string",
"zipcode": "string",
"roadZipCode": "string",
"requirement": "string",
"personalClearanceCode": "Strinag"
},
"orderDelivery": {
"deliveryRequestAt": "2024-11-01T04:50:31.235Z",
"confirmedAt": "2024-11-01T04:50:31.235Z",
"invoiceRegisteredAt": "2024-11-01T04:50:31.235Z",
"deliveredAt": "2024-11-01T04:50:31.235Z",
"shippingMethod": "SHIPPING",
"deliveryCompanyCode": "CJGLS",
"invoiceNumber": "string",
"isInternational":true
},
"orderClaimCancel": {
"claimId": 0,
... 생략...
}
<응답실패>
{
"msg": "KakaoStoreException",
"code": -800,
"extras": {
"error_message": "유효하지 않은 요청입니다.",
"error_code": -10001,
"validation": {
"order_ids": [
"order_ids 에 대한 데이터가 잘못되었습니다."
]
},
"error_category": "common"
}
}