# API 레퍼런스 · v1.4.0

EverAU 도매 채널 API: 재고, 주문, 드롭쉬핑, Webhook. 하나의 인증·속도 제한·오류 코드 체계. 기본 주소 https://connect.everugg.net.au.

## 인증

- [액세스 토큰 교환: client_credentials(client_id = 채널 코드, client_secret = 시크릿) 또는 password(username = OMS 로그인 계정, password = OMS 비밀번호) → Bearer access_token](https://connect.everugg.net.au/reference/post-api-v1-auth-token.md?lang=ko): `POST /api/v1/auth/token`
- [이 토큰이 누구인지: 계정, 채널, 사용 가능한 창고, 권한, 업무 스위치(OMS 로그인은 OMS 프로필, 채널 시크릿 토큰은 창고 허용 목록과 게이트웨이 scope)](https://connect.everugg.net.au/reference/get-api-v1-me.md?lang=ko): `GET /api/v1/me`

## 창고와 재고

- [창고 목록: 코드, 이름, 국가, 회사, 합계/실물, 출고 가능, 통화](https://connect.everugg.net.au/reference/get-api-v1-warehouses.md?lang=ko): `GET /api/v1/warehouses`
- [한 창고의 재고: 필터 없음 = 창고 전체(page / page_size; 증분 동기화용 X-Stock-Version 헤더); sku= 단일 변형; product_code= 스타일의 모든 변형](https://connect.everugg.net.au/reference/get-api-v1-warehouses-warehouse-code-stock.md?lang=ko): `GET /api/v1/warehouses/{warehouse_code}/stock`
- [재고 변경(증분)](https://connect.everugg.net.au/reference/get-api-v1-warehouses-warehouse-code-stock-changes.md?lang=ko): `GET /api/v1/warehouses/{warehouse_code}/stock/changes`

## 상품

- [한 창고의 상품 목록(스타일 코드 기준 중복 제거, 가격 포함)](https://connect.everugg.net.au/reference/get-api-v1-products.md?lang=ko): `GET /api/v1/products`
- [스타일 코드로 상품 상세(이미지/설명/가격 + 모든 변형; 중국어명/중량/소재는 아직 상위 시스템 미연동, 값이 있을 때만 표시)](https://connect.everugg.net.au/reference/get-api-v1-products-product-code.md?lang=ko): `GET /api/v1/products/{product_code}`
- [SKU 로 변형 상세(객체 하나)](https://connect.everugg.net.au/reference/get-api-v1-skus-sku.md?lang=ko): `GET /api/v1/skus/{sku}`
- [드롭쉬핑 시스템 판매 중 상품 목록(페이지)](https://connect.everugg.net.au/reference/get-api-v1-dropship-products.md?lang=ko): `GET /api/v1/dropship-products`

## 가격

- [내 채널의 상품 가격(페이지; product_code 는 쉼표로 여러 개 가능)](https://connect.everugg.net.au/reference/get-api-v1-prices.md?lang=ko): `GET /api/v1/prices`

## 도매 주문

- [계정에서 사용할 수 있는 배송 방식](https://connect.everugg.net.au/reference/get-api-v1-shipping-methods.md?lang=ko): `GET /api/v1/shipping-methods`
- [계정에서 선택 가능한 물류사](https://connect.everugg.net.au/reference/get-api-v1-carriers.md?lang=ko): `GET /api/v1/carriers`
- [OMS 배송지 주소록](https://connect.everugg.net.au/reference/get-api-v1-addresses.md?lang=ko): `GET /api/v1/addresses`
- [도매 주문 생성(기본은 초안; auto_confirm=true 면 승인 제출)](https://connect.everugg.net.au/reference/post-api-v1-orders.md?lang=ko): `POST /api/v1/orders`
- [기간 내 내 채널의 도매 주문](https://connect.everugg.net.au/reference/get-api-v1-orders.md?lang=ko): `GET /api/v1/orders`
- [도매 주문 상세(소유권 확인)](https://connect.everugg.net.au/reference/get-api-v1-orders-order-id.md?lang=ko): `GET /api/v1/orders/{order_id}`
- [도매 주문을 취소하고 잡고 있던 재고를 해제합니다](https://connect.everugg.net.au/reference/delete-api-v1-orders-order-id.md?lang=ko): `DELETE /api/v1/orders/{order_id}`
- [배정 미리보기: 행별 배정 가능 수량·부족 수량·예약 재고 입고일·결제 금액·잔액 충분 여부](https://connect.everugg.net.au/reference/post-api-v1-orders-order-id-allocation-preview.md?lang=ko): `POST /api/v1/orders/{order_id}/allocation-preview`
- [도매 주문 제출(이후 명세 변경 불가)](https://connect.everugg.net.au/reference/post-api-v1-orders-order-id-submit.md?lang=ko): `POST /api/v1/orders/{order_id}/submit`

## 드롭쉬핑 주문

- [드롭쉬핑 주문 생성(수취인 + 명세)](https://connect.everugg.net.au/reference/post-api-v1-dropship-orders.md?lang=ko): `POST /api/v1/dropship-orders`
- [드롭쉬핑 주문 목록: 창고 + 기간, 또는 client_order_number / serial_number 로 한 건 찾기](https://connect.everugg.net.au/reference/get-api-v1-dropship-orders.md?lang=ko): `GET /api/v1/dropship-orders`
- [드롭쉬핑 주문 요약 목록(페이지)](https://connect.everugg.net.au/reference/get-api-v1-dropship-orders-summary.md?lang=ko): `GET /api/v1/dropship-orders/summary`
- [드롭쉬핑 주문 상세(소유권 확인)](https://connect.everugg.net.au/reference/get-api-v1-dropship-orders-dropship-order-id.md?lang=ko): `GET /api/v1/dropship-orders/{dropship_order_id}`
- [대행 건을 취소하고 잡고 있던 재고를 해제합니다](https://connect.everugg.net.au/reference/delete-api-v1-dropship-orders-dropship-order-id.md?lang=ko): `DELETE /api/v1/dropship-orders/{dropship_order_id}`
- [대행 사전배정: 건별 배정 가능 여부·부족 수량·예약 재고 입고일·결제 금액](https://connect.everugg.net.au/reference/post-api-v1-dropship-orders-allocation-preview.md?lang=ko): `POST /api/v1/dropship-orders/allocation-preview`
- [대행 건 제출(이후 변경 불가)](https://connect.everugg.net.au/reference/post-api-v1-dropship-orders-submit.md?lang=ko): `POST /api/v1/dropship-orders/submit`
- [제출하지 않기로 한 사전배정이 잡고 있는 재고를 해제합니다](https://connect.everugg.net.au/reference/delete-api-v1-dropship-orders-dropship-order-id-allocation.md?lang=ko): `DELETE /api/v1/dropship-orders/{dropship_order_id}/allocation`

## 출고와 물류

- [내 채널의 출고 목록](https://connect.everugg.net.au/reference/get-api-v1-shipments.md?lang=ko): `GET /api/v1/shipments`
- [수취인 신분증 이미지 업로드 ⚠️ 최종 소비자 신분증 앞뒤(개인정보)](https://connect.everugg.net.au/reference/post-api-v1-shipments-identity-documents.md?lang=ko): `POST /api/v1/shipments/identity-documents`
- [출고 상세(소유권 확인)](https://connect.everugg.net.au/reference/get-api-v1-shipments-shipment-id.md?lang=ko): `GET /api/v1/shipments/{shipment_id}`
- [배송 추적(Auexpress; 기본 비활성, 신청 후 사용)](https://connect.everugg.net.au/reference/get-api-v1-shipments-shipment-id-tracking.md?lang=ko): `GET /api/v1/shipments/{shipment_id}/tracking`

## 재고 예약

- [내 채널의 재고 예약 목록](https://connect.everugg.net.au/reference/get-api-v1-reservations.md?lang=ko): `GET /api/v1/reservations`
- [예약 상세(소유권 확인)](https://connect.everugg.net.au/reference/get-api-v1-reservations-reservation-id.md?lang=ko): `GET /api/v1/reservations/{reservation_id}`
- [예약 명세 조정(쓰기; 소유권 확인)](https://connect.everugg.net.au/reference/patch-api-v1-reservations-reservation-id.md?lang=ko): `PATCH /api/v1/reservations/{reservation_id}`

## Finance

- [계정 잔액(호주 / 중국 / 뉴질랜드 중 보유한 계정)](https://connect.everugg.net.au/reference/get-api-v1-balances.md?lang=ko): `GET /api/v1/balances`
- [거래 내역(충전 / 결제 / 환불)과 각 거래 후 잔액; amount_total 은 페이지 합계](https://connect.everugg.net.au/reference/get-api-v1-transactions.md?lang=ko): `GET /api/v1/transactions`
- [창고·월별 월간 청구서(결제 여부 포함)](https://connect.everugg.net.au/reference/get-api-v1-bills.md?lang=ko): `GET /api/v1/bills`
- [환불 전표(도매 / 대행)와 심사 상태·사유](https://connect.everugg.net.au/reference/get-api-v1-refunds.md?lang=ko): `GET /api/v1/refunds`
- [운임 전표(물류사, 운송장 번호, 박스 수, 금액)](https://connect.everugg.net.au/reference/get-api-v1-freight-bills.md?lang=ko): `GET /api/v1/freight-bills`

## 장바구니

- [계정의 장바구니](https://connect.everugg.net.au/reference/get-api-v1-carts-account.md?lang=ko): `GET /api/v1/carts/{account}`
- [장바구니 항목 추가/수정(멱등)](https://connect.everugg.net.au/reference/put-api-v1-carts-account-lines.md?lang=ko): `PUT /api/v1/carts/{account}/lines`
- [장바구니에서 SKU 하나 제거](https://connect.everugg.net.au/reference/delete-api-v1-carts-account-lines-sku.md?lang=ko): `DELETE /api/v1/carts/{account}/lines/{sku}`
- [한 스타일의 모든 SKU 를 장바구니에서 제거](https://connect.everugg.net.au/reference/delete-api-v1-carts-account-products-product-code.md?lang=ko): `DELETE /api/v1/carts/{account}/products/{product_code}`

## Me

- [연동 진행 상태: 토큰 발급 / 상품 조회 가능 / 주문 생성 가능 / 부족 수량 확인 가능 / 제출 가능](https://connect.everugg.net.au/reference/get-api-v1-me-readiness.md?lang=ko): `GET /api/v1/me/readiness`

## Feeds

- [상품 피드 생성(Google Merchant 규격 — 대량 내보내기도 겸함): csv / xml / json 세 가지를 한 번에 만들어 예약 수집용으로 저장합니다](https://connect.everugg.net.au/reference/get-api-v1-feeds-products.md?lang=ko): `GET /api/v1/feeds/products`
- [상품 피드 생성 진행 상태 확인: 생성 중 / 완료 / 실패(실패 사유 포함), 그리고 최신 결과물의 행 수, 생성 시각, 지적 사항](https://connect.everugg.net.au/reference/get-api-v1-feeds-products-status.md?lang=ko): `GET /api/v1/feeds/products/status`

## 참고 자료

- [오류 코드 목록](https://connect.everugg.net.au/reference/errors.md?lang=ko)
- [데이터 모델](https://connect.everugg.net.au/reference/ontology.md?lang=ko)
- [AI 연결(MCP)](https://connect.everugg.net.au/reference/mcp.md?lang=ko)
- [변경 이력](https://connect.everugg.net.au/changelog.md?lang=ko)