Black Friday
Skip to documentation content

Channels & Calendar

Understand external inventory blocks

Core provides a provider-neutral external-block record type; Pro's iCal importer uses it for OTA occupancy. A block reserves inventory without pretending to be a complete website guest reservation or a payment transaction.

Core provides a provider-neutral external-block record type; Pro’s iCal importer uses it for OTA occupancy. A block reserves inventory without pretending to be a complete website guest reservation or a payment transaction.

Read its identity and dates

An external block is identified by source channel plus external reservation identity. It occupies a room type and quantity over the half-open interval from check-in to check-out. Active blocks participate in the same local availability accounting as blocking reservations.

Source labels can identify an OTA/feed, but the calendar normally does not supply complete guest contact, prices, consent or payment evidence. Do not infer those facts from an event summary or manually backfill a guest acknowledgement.

Respect read-only operations

Ordinary booking administration cannot edit the block into another record type, confirm/cancel it, mark no-show, record payments/refunds or expose it as a customer-owned booking. Changes belong to the originating integration’s authorized synchronization/release workflow.

Core continues to enforce stored blocks when Pro is disabled or its entitlement is unavailable. Stopping synchronization does not release known external occupancy. This protects dates while the operator repairs the provider or license state.

Resolve stale or unexpected occupancy

  1. Inspect the source label, mapped room quantity, occupied dates and last successful source snapshot.
  2. Compare with the actual external reservation/feed and determine whether it is current, duplicated under another source or outside the expected mapping.
  3. Repair the source or external reservation through its owner, then use supported reconciliation.
  4. Verify local availability afterward, preserving the financial and source audit trail.

A failed/partial import preserves previous occupancy. A valid complete snapshot can release missing/cancelled/transparent events only for that source. Do not delete block rows to simulate a provider cancellation.

API-imported reservations can remain ordinary booking records with additional details; they are not automatically iCal external_block records. See source labels and the developer write contract.

Was this article helpful?

Your feedback helps us improve the documentation.