- 모든 API의 Body 전문은 application/json 형태로 구성합니다.
- HMAC Authorization 정보를 "Authorization" Key에 담아서 보내야 합니다.
>> HMAC Signature 생성 안내 - 날짜는 사람이 쉽게 읽을 수 있도록 "YYYY-MM-DD HH24:MI:SS" 포맷의 String 으로 전달합니다.
- 모든 API는 아래 표에 나열한 항목을 Json String 으로 HTTP Header 의 "Coupang-3PFL-MESSAGE-HEADER" Key에 담아서 보내야 합니다.
| Property Name | Mandatory | Description |
| messageId | Y | 각 호출마다 고유한 UUID를 생성하여 호출한다. 이 ID는 Deadletter 메시지에서 사용됩니다. |
| eventTime | Y | API 호출 시각 |
| messageOrigin | Y |
메시지 송신자 정보. Coupang에서 호출하는 경우 "Coupang", Vendor에서 호출하는 경우 해당하는 VendorID를 넣어서 보냅니다. ** VendorID는 연동 초기에 쿠팡에서 전달드립니다. |
| messageDestination | Y | 메시지 수신자 정보. messageOrigin과 같은 방식으로 API 수신자 정보를 넣습니다. |
HTTP Header Example
VendorID = "NEWVENDOR"
Coupang -> Vendor
Key : Coupang-3PFL-MESSAGE-HEADER
Value : {
"messageOrigin": "COUPANG",
"messageDestination": "NEWVENDOR",
"eventTime": "2020-12-14 10:35:07",
"messageId": "2a049261-2275-4dc4-88cd-0dbd259e557a"
}
Vendor -> Coupang
Key : Coupang-3PFL-MESSAGE-HEADER
Value : {
"messageOrigin": "NEWVENDOR",
"messageDestination": "COUPANG",
"eventTime": "2020-12-14 10:35:07",
"messageId": "2a049261-2275-4dc4-88cd-0dbd259e557a"
}
Host Address 정보
- 개발존 : https://api-gateway-dev.coupang.com/v2/providers/bifrost/apis
- 운영존 : https://api-gateway.coupang.com/v2/providers/bifrost/apis
Partner ID 발급
쿠팡 전문설치(3PF&L) Vendor는 처음에 쿠팡으로부터 Partner ID를 발급받아야 합니다. Partner ID는 "messageOrigin", "messageDestination" 필드에 들어가는 VendorID와 다릅니다.
- Partner ID는 다음과 같은 채번 규칙을 가집니다: A********
- Ex) A00124365
- Partner ID는 두 가지 종류가 있습니다.
- vendorPartnerId
- 3PF&L Vendor가 처음에 쿠팡으로부터 발급받는 Partner ID 입니다.
- vendorPartnerId는 연동테스트 초기에 쿠팡에서 전달드립니다.
- productPartnerId
- 발주/입고에서 발주된 공급업체 Vendor의 Partner ID 입니다.
- 발주/입고에서의 partnerId 필드는 3PF&L Vendor의 PartnerId가 아닌, 공급업체 Vendor의 PartnerId가 들어가야 합니다.
- vendorPartnerId