Bifrost API 개발 시 업체에서 자주하는 질문을 정리한 문서입니다. 프로젝트 진행 시 먼저 참고하시고, FAQ를 통해 해결이 되지 않을 경우 쿠팡 담당자에게 문의 부탁드립니다.
Bifrost API 공통사항
Q. 쿠팡의 서버 환경은 어떻게 구성되어 있나요?
A. 쿠팡은 개발 환경(Dev)과 운영 환경(Prod) 2개로 구성되어 있습니다.
Q. HMAC Signature를 발급받는 절차를 알 수 있을까요?
A. 메일로 HMAC 설정을 위한 방법을 안내해드릴 예정입니다. 사전에 수신이 필요한 담당자 메일을 공유 부탁드립니다.
Q. VendorId, vendorPartnerId, productPartnerId에 대해 설명 부탁드립니다.
A. VendorId는 Header의 messageOrigin 또는 messageDestination에 사용하는 값입니다. vendorPartnerId는
API 호출 시 사용되지 않고, 쿠팡에서 VendorId와 매핑을 위해 사용하는 값입니다. productPartenrId는 쿠팡에서
제조사 구분을 위해 사용하는 값으로 업체에서는 관리하지 않으셔도 됩니다.
Q. API 요청에 대한 응답은 얼마나 빨리 해야하나요?
A. API 응답은 100ms 이하를 권장드립니다.
발주 API
Q. 쿠팡의 발주 상태 취소(CANCELED) / 마감(CLOSED) 의 기준은 어떻게 되나요? 만약 입고가 진행 중이거나 완료되지 않은 경우에도 발주 취소나 마감이 가능한가요?
A. 발주 취소와 마감은 업체의 상태와 상관없이 전송하셔도 됩니다. 발주 API 하단의 유의사항을 참고 부탁드립니다.
Q. receivingPlannedAt 속성의 의미는 무엇일까요?
A. 입고예정일 입니다.
Q. expiredAt, manufacturedEndAt, manufacturedStartAt, producedAt 날짜 용도에 대한 세부 설명 부탁드립니다.
A. producedAt은 생성년도에 대한 값(yyyy)입니다. 그 외 항목은 모두 전송하지 않으셔도 됩니다.
입고 API
Q. 입고 전 위치(originLocation) 속성의 용도가 무엇이며 해당 코드/항목 관리는 어떻게 되나요?
A. 업체의 센터 이름을 넣거나 비워주셔도 됩니다.
Q. originReferenceId 속성을 업체에서는 2개 이상의 ID로 관리하고 있습니다. ID 사이에 특정 문자를 추가해서 전달해도 괜찮을까요?
A. 네, 가능합니다. 다만 하나의 API 요청에 중복된 값은 허용되지 않습니다.
Q. 작업자 정보(worker) 속성은 입고 담당자 이름으로 전송하면 될까요?
A. 네, 맞습니다.
Q. 입고 예약 번호(bookingNumber) 속성의 용도가 무엇이며, 해당 항목 관리는 어떻게 되나요? 입고 진행 상태와 관계가 있나요?
A. 전송하지 않으셔도 무방합니다.
Q. 쿠팡에서 전달한 발주ID(purchaseOrderId)는 partnerId의 고유한 값인가요? 아니면 partnerId에 따라 중복이 가능한가요?
A. 고유한 값입니다.
재고 스냅샷 조회 API
Q. 재고 스냅샷 조회 API를 호출하는 주기가 어떻게 되나요?
A. 재고 스냅샷 조회 API는 현재 1시간 주기로 호출합니다. 단, 필요 시에 협의 가능합니다.
주문/주문응답 API
Q. 주문 API의 vendorItemId는 String 타입이고, 주문응답 API의 vendorItemId는 Long 타입입니다. 타입이 다른 이유가 있나요?
A. 데이터 타입은 Long이 맞습니다. 최초 설계 시 타입이 맞지 않았고, 이미 연동중인 상태라 스펙 변경은 어려운 점
양해 부탁드립니다.
Q. 주문 API 요청에 대해 에러를 응답할 경우, 쿠팡 주문이 취소되나요?
A. 에러로 응답할 경우 반복해서 주문을 요청합니다. 계속해서 에러가 발생할 경우 업체 측으로 확인 요청을 드립니다.
따라서 쿠팡의 주문은 취소되지 않습니다.
Q. 주문 API와 주문응답 API 처리에 대한 시간 제한이 있나요?
A. 별도로 시간 제한은 없습니다. 다만 약 30분 단위로 주문응답 API를 받지 않을 경우 주문이 재발행되거나 주문 시
예약재고가 취소될 수 있습니다. 이러한 경우가 발생할 수 있다면 사전에 쿠팡 개발팀에 공유 부탁드립니다.
반출/반출취소 요청 API
Q. 반출과 반품의 차이는 무엇인가요?
A. 반품은 출고된 상품이 고객의 요청이나 제품의 문제로 센터로 돌아오는 과정을 의미합니다. 반출은 제품 폐기나
오입고등의 사유로 센터에서 제조사로 상품을 되돌려보내는 과정입니다.