개발가이드

오픈 API 소개

주문 수집부터 발송·클레임 처리까지, 쓰던 시스템에서 그대로 자동화할 수 있어요.

뷰리티 오픈 API는 셀러의 주문·클레임·문의 데이터를 외부 시스템(OMS·ERP)에서 직접 다루기 위한 API예요. 파트너센터에 매번 로그인하지 않아도 주문을 자동으로 받아오고, 송장을 올리고, 취소·반품·교환을 처리할 수 있어요.

셀러가 파트너센터에서 API Key를 발급해 전달하면, 그 키 하나로 키를 발급한 셀러의 데이터만 조회하고 상태를 바꿔요.

연동하는 두 가지 방법

방법	이런 경우에 좋아요
통합 솔루션에 키 등록	셀메이트·이지어드민처럼 이미 쓰고 있는 통합 관리 솔루션이 있다면, 발급받은 키를 그 솔루션에 등록하기만 하면 돼요. 개발이 필요 없어요.
직접 연동 개발	자체 OMS·ERP가 있다면 이 문서와 API 레퍼런스를 보고 직접 붙일 수 있어요. 개발 리소스가 필요해요.

키는 셀러가 발급해요

어느 방법이든 시작은 같아요. 셀러 대표 계정이 파트너센터에서 키를 발급해 연동 담당자에게 전달하면 돼요. 절차는 시작하기에서 안내해요.

환불 — 별도의 환불 실행 호출은 필요 없어요. 다만 환불이 시작되는 시점은 클레임 종류마다 달라요. 진행 상황은 클레임 상세의 status로 확인하면 돼요.
구매확정 — 고객이 직접 하거나 배송완료 14일 후 자동으로 확정돼요. 조회로 관측만 해요.

타입	환불이 시작되는 시점	비고
취소 (`cancel`)	`approve` 승인 즉시	수거·검수 단계가 없어요. 승인하면 곧바로 환불이 걸려요
반품 (`return`)	`inspect` 검수 통과 시(`result=pass`)	`approve`는 `requested` → `approved`까지만 옮겨요 — 환불도, 수거도 시작되지 않아요. 수거는 `pickup`(수거 송장 등록)을 따로 호출해야 시작되니 승인 뒤에는 반드시 `pickup`을 이어서 호출해 주세요. 수거완료 후 일정 기간 검수가 없으면 뷰리티가 검수 통과로 간주해 환불하기도 해요
교환 (`exchange`)	원칙적으로 환불이 없어요. 검수 통과 시 재출고(`reshipping`)로 가고, 돌려줄 차액이 있을 때만 그 시점에 차액 환불이 걸려요	차액은 `price_difference`로 확인해요

자세한 내용은 클레임·문의 처리하기의 환불 진행 절에 있어요.