요금·재고 전송

요금재고 전송은 요금·영업일과 재고로 분리돼 있습니다. 전체 진행 순서는 최초 판매 준비 개요를 참고하세요.

메서드	경로	설명
`POST`	`.../ari`	요금·영업일 (요금제 `vendor_rateplan_id` 단위)
`POST`	`.../ari/avails`	재고 `vacancy` (객실타입 단위 통합 재고 · 항목당 최대 730일)

두 엔드포인트 모두 전 채널 공통 값과 채널별 값(channels[] 배열)을 1회 호출에 함께 담아 전송합니다. channels[]는 채널별 설정 전체 선언이므로, 배열에 없는 채널 설정은 항목 구간(from-to) 내에서 삭제됩니다.

요금·영업일 — 숙박(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 }
    ]
  }
]

요금·영업일 — 대실(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, "sale_price": 10000, "use_from": "14:00", "use_to": "20:00", "use_time": 240 }
    ]
  }
]

재고 — 객실타입 단위 통합 재고

[
  {
    "vendor_roomtype_id": "VRT-001",
    "from": "2026-01-01",
    "to": "2026-01-31",
    "vacancy": 5,
    "channels": [
      { "channel_id": 1, "vacancy": 3 },
      { "channel_id": 2, "vacancy": 5 }
    ]
  }
]

전송 규칙

POST .../ari — 요금·영업일만 요금제 단위로 전송합니다. channels에 없는 채널 설정은 항목 구간 내에서 삭제되며(생략·빈 배열 = 전 채널 설정 삭제), 채널 오브젝트는 값 필드가 하나 이상 있어야 합니다(channel_id만 있으면 400). 생략한 필드는 기존값이 유지됩니다. use_from·use_to·use_time(분)은 대실 항목에만 전송할 수 있습니다.
POST .../ari/avails — 재고를 객실타입 단위 통합 재고로 반영합니다. channels[]는 채널별 재고 전체 선언이며, 배열에 없는 채널 재고는 구간 내에서 삭제됩니다. 기간(from-to)은 항목당 최대 730일입니다.

type 구분 (숙박 / 대실)

ari와 예약(/bookings)은 type으로 상품 유형을 구분합니다.

채널 유형	사용하는 `type`
플러스 채널	`overnight`
직연동 채널	`overnight` (대실을 지원하는 채널은 `dayuse` 추가)

ARI는 필요한 항목만 부분 전송할 수 있습니다

부분 전송: 변경하고 싶은 항목만 요청에 포함하면 됩니다
항목별 필드: 영업일 = is_business_day / 요금 = basic_price·sale_price·net_price / 재고 = vacancy(ari/avails)
대실 전용: use_from·use_to·use_time는 대실인 경우에만 전송 가능
채널별 통합 전송: 공통 값은 최상위 필드, 채널별 값은 channels[] 배열에 담아 1회 호출로 전송

재고 운영 기준 — 룸온리(객실타입) 재고에 맞춤

채널마다 재고 기준이 다릅니다.

룸온리(객실타입) 기준: 부킹닷컴 · 아고다 · 트립닷컴
요금제 기준: 익스피디아 · 플러스 채널 (일부 선택 경우 존재)

ONDA는 객실타입 기준 재고를 사용하므로 룸온리 재고에 맞추어 전송하고, package 재고는 standalone 재고와 동일하게 전송하세요.