본문으로 건너뛰기

요금·재고 전송

요금제별 요금과 영업일은 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 재고와 동일하게 전송하세요. :::