Order
주문 내역을 쿠팡에서 Vendor로 전송하는 API 입니다.
- API 호출 방향 : Coupang -> Vendor
- URL : /v1/3pfl/order
- Interface Style : Restful API
- HTTP Protocol : HTTPS
- Method : POST
Request Body
| Property Name | Parent Object | Data Type | Size | Mandatory | Description |
| orderId | Root | String | 20 | Y | 쿠팡 내부 관리용 주문번호 |
| orderNumber | Root | Long | 20 | Y | 쿠팡 고객 실제 주문번호 |
| orderType | Root | Enum | 40 | Y | ORDER, EXCHANGE, SUPPLEMENT |
| orderedAt | Root | String | Y | 주문 일자 | |
| targetDate | Root | String | Y | ||
| reservedAt | Root | String | Y | ||
| shipmentId | Root | String | 20 | Y | Shipment Unique ID (쿠팡 송장 번호) |
| shippingInfo | Root | Object | Y | ||
| customerName | shippingInfo | String | 255 | Y | 수령인 고객명 |
| zipcode | shippingInfo | String | 6 | Y | 수령인 우편번호 |
| addr1 | shippingInfo | String | 255 | Y | 수령인 주소 1 |
| addr2 | shippingInfo | String | 255 | Y | 수령인 주소 2 |
| phoneNumber | shippingInfo | String | 20 | Y | 수령인 전화번호 |
| orderCustomerPhoneNumber | shippingInfo | String | 20 | N | 주문자 전화번호 |
| paymentAmount | shippingInfo | Int | 20 | 배송비 포함 결제금액 | |
| shipmentAmount | shippingInfo | Int | 20 | 사용되지 않는 필드입니다. 빈 값으로 전송 됩니다. | |
| shipmentNote | shippingInfo | String | 255 | Y | 배송시 요구 사항 |
| orderVendorItem | Root | Array | Y | ||
| vendorItemId | orderVendorItem | String | 20 | Y | 쿠팡에서 생성하는 벤더아이템 번호 |
| vendorItemName | orderVendorItem | String | 255 | Y | 쿠팡에서 생성하는 벤더아이템명 |
| orderQuantity | orderVendorItem | Int | 20 | Y | 벤더아이템의 주문 수량 |
| price | orderVendorItem | Int | 20 | Y | 판매 가격 |
| promiseDeliveryDate | orderVendorItem | Int | Y | ||
| parcelType | orderVendorItem | String | 40 | Y |
NORMAL, PREMINUM
|
| orderItem | orderVendorItem | Array | Y |
|
|
| skuId | orderItem | String | 20 | Y |
External SKU ID |
| orderQuantity | orderItem | Int | 20 | Y |
주문 수량 |
| centerCode | orderItem | String | 20 | Y |
센터 코드 |
Request Example
{
"orderId": "9900000001",
"orderNumber": "10012345678",
"orderType": "ORDER",
"orderedAt": "2019-12-02 06:01:29",
"targetDate": "",
"reservedAt": "",
"shipmentId": "150000000001",
"shippingInfo": {
"customerName": "홍길동",
"zipcode": "01010",
"addr1": "테스트 주소1",
"addr2": "테스트 주소2",
"phoneNumber": "010-1111-2222",
"orderCustomerPhoneNumber": null,
"paymentAmount": 500090,
"shipmentAmount": 0,
"shipmentNote": ""
},
"orderVendorItem": [
{
"vendorItemId": "88000001",
"vendorItemName": "벤더아이템 이름",
"orderQuantity": 1,
"price": 500090,
"promiseDeliveryDate": "2019-12-16 23:59:59",
"parcelType": "NORMAL",
"orderItem": [
{
"skuId": "10001234",
"orderQuantity": 1,
"centerCode": "CENTER001"
},
{
"skuId": "10004321",
"orderQuantity": 1,
"centerCode": "CENTER001"
}
]
}
]
}
Response
| Property Name | Data Type | Size | Mandatory | Description |
| errorCode | String | 20 | N |
결과값
|
| errorReason | String | 100 | N | 에러 사유 |
Response Example
{
"errorCode": "0",
"errorReason": null
}
유의사항
- orderType: ORDER, EXCHANGE, SUPPLEMENT
- 위의 세 가지 값 중 (각각 주문, 교환, 추가주문 타입을 의미합니다), 기본적으로 "ORDER"로 설정됩니다. 현재까지 협의된 내용 기준으로 주문은 교환, 추가주문이 없기 때문입니다.
- parcelType: NORMAL, PREMIUM
- 위의 두 가지 값 중 (각각 일반 배송, 프리미엄 배송 타입을 의미합니다), 기본적으로 "NORMAL"로 설정됩니다. 현재까지 협의된 내용 기준으로 주문은 프리미엄 배송이 없기 때문입니다.