요금·재고 전송
요금제별 요금과 영업일은 ari로 보내고, 객실타입별 재고는 ari/avails로 보냅니다. 전체 순서는 최초 판매 준비 개요를 참고하세요.
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | .../ari | 요금·영업일 (요금제 vendor_rateplan_id 단위) |
POST | .../ari/avails | 재고 vacancy (객실타입 단위 통합 재고 · 항목당 최대 730일) |
두 엔드포인트 모두 공통값과 채널별 값(channels[])을 한 요청에 담습니다. 각 항목의 시작일부터 종료일까지 유지할 채널 설정은 모두 배열에 넣으세요. ONDA는 배열에서 빠진 채널의 설정을 해당 기간에 한해 삭제합니다.
요금·영업일 — 숙박(overnight)
[
{
"vendor_roomtype_id": "VRT-001",
"vendor_rateplan_id": "VRP-001",
"type": "overnight",
"from": "2026-01-01",
"to": "2026-01-31",
"basic_price": 0,
"net_price": 0,
"sale_price": 12000,
"is_business_day": 0,
"channels": [
{ "channel_id": 1, "basic_price": 0, "net_price": 0, "sale_price": 10000, "is_business_day": 0 },
{ "channel_id": 2, "basic_price": 0, "net_price": 0, "sale_price": 11000, "is_business_day": 0 }
]
}
]
요금·영업일 — 대실(dayuse)
[
{
"vendor_roomtype_id": "VRT-001",
"vendor_rateplan_id": "VRP-001",
"type": "dayuse",
"from": "2026-01-01",
"to": "2026-01-31",
"basic_price": 0,
"net_price": 0,
"sale_price": 12000,
"is_business_day": 0,
"use_from": "14:00",
"use_to": "20:00",
"use_time": 240,
"channels": [
{ "channel_id": 1, "basic_price": 0, "net_price": 0, "sale_price": 10000, "is_business_day": 0, "use_from": "14:00", "use_to": "20:00", "use_time": 240 }
]
}
]
재고 — 객실타입 단위 통합 재고
[
{
"vendor_roomtype_id": "VRT-001",
"type": "overnight",
"from": "2026-01-01",
"to": "2026-01-31",
"vacancy": 5,
"channels": [
{ "channel_id": 1, "vacancy": 3 },
{ "channel_id": 2, "vacancy": 5 }
]
}
]
:::info 전송 규칙
POST .../ari는 요금제별 요금과 영업일을 갱신합니다. 각 항목에는is_business_day와 함께net_price또는sale_price를 넣으세요.channels[]의 각 채널에도is_business_day와 항목에 보낸 요금 필드를 모두 넣으세요. 항목과 채널의 요금 필드 구성이 다르면 API가400을 반환합니다.channels를 생략하거나 빈 배열을 보내면 해당 기간의 채널별 설정이 모두 삭제됩니다. 항목에서 생략한 요금 필드는 기존값을 유지합니다.use_from,use_to,use_time(분)은 대실 항목에만 보낼 수 있습니다.POST .../ari/avails는 객실타입별 재고를 갱신합니다. 해당 기간에 유지할 채널별 재고는 모두channels[]에 넣으세요. ONDA는 배열에서 빠진 채널의 재고를 해당 기간에 한해 삭제합니다. 항목 하나에 담을 수 있는 기간은 최대 730일입니다. :::
:::info 숙박 요금의 통화
숙박(overnight) 항목과 channels[]의 요금에는 숙소에 등록된 통화가 적용됩니다. 숙소 통화가 없으면 KRW를 사용합니다.
숙소 생성 또는 숙소 수정에서 currency를 설정하세요. 예를 들어 숙소 통화가 USD이면 요금 전송 요청의 sale_price: 100은 100달러입니다. ONDA는 금액을 환산하지 않습니다.
:::
:::info type 구분 (숙박 / 대실)
ari와 예약(/bookings)은 type으로 상품 유형을 구분합니다.
| 채널 유형 | 사용하는 type |
|---|---|
| 플러스 채널 | overnight |
| 직연동 채널 | overnight (대실을 지원하는 채널은 dayuse 추가) |
| ::: |
:::tip ARI는 필요한 항목만 부분 전송할 수 있습니다
- 부분 전송: 변경하고 싶은 항목만 요청에 포함하면 됩니다
- 항목별 필드: 영업일 =
is_business_day/ 요금 =basic_price·sale_price·net_price/ 재고 =vacancy(ari/avails) - 대실 전용:
use_from·use_to·use_time는 대실인 경우에만 전송 가능 - 채널별 통합 전송: 공통 값은 최상위 필드, 채널별 값은
channels[]배열에 담아 1회 호출로 전송 :::
:::warning 재고 운영 기준 — 룸온리(객실타입) 재고에 맞춤 채널마다 재고 기준이 다릅니다.
- 룸온리(객실타입) 기준: 부킹닷컴 · 아고다 · 트립닷컴
- 요금제 기준: 익스피디아 · 플러스 채널 (일부 선택 경우 존재)
ONDA는 객실타입 기준 재고를 사용하므로 룸온리 재고에 맞추어 전송하고, package 재고는 standalone 재고와 동일하게 전송하세요.
:::