# 数据口径与对象

所有经营快照含 `property:{id,name}`、`account_id`、`backend_type`、`observed_at`、`source:{type,reference}`。source.type为LIVE、EXPORT、MANUAL、DEMO或ENVIRONMENT。导入接口拒绝自称LIVE的文件；真实读取只能由适配器产生。没有的模块设null，空数组仅表示已取得范围内没有记录。金额均为整数分。

## 基本模块

| 模块 | 关键字段 |
|---|---|
| facts | id、text、verified、source_reference、可选valid_until |
| rooms | room_id、name、description、cancellation |
| rates | room_id、rate_plan_id、date、price_fen、settlement_terms |
| inventory | room_id、date、available、scope、authority_verified、observed_at |
| orders | order_id、paid_at、status、settlement；接单需room_id、stay_date、confirm_by、room_count |
| order_lines | order_line_id、stay_date、room_count、cancelled_room_count、status、mode |
| stays | record_id、stay_date、room_count、verified、mode |
| vouchers | voucher_id、售券／预约／实际入住／核销／退款各自时间和状态 |
| reviews | review_id、text、rating、reply_text，按实际数据可含room_id、stay_date |
| promotions | id、name与下述费用规则 |
| ads | campaign_id、tool、attribution_window、spend_fen、attributed_sales_fen、settlement |
| competitors | property_id、入住离店、人数房数、room_class、breakfast、cancellation、membership、promotion、tax_included、currency、status、price_fen、observed_at、source_reference |
| events | name、location、start_date、end_date、source_url、verified_at、valid_until、verified、impact_confirmed |
| funnel | impressions、clicks、visits、payments各含value/unit/from/to/channel/attribution_window/cohort；比较阈值由酒店提供 |
| search | context、position（前N未见为null）、depth、placement_type、observed_at、source_reference |
| assets | digest、房型归属、场景、事实和权利证据 |

同一订单ID重复记录不重复计数；相同ID状态冲突拒绝导入，先解决来源版本。有效间夜以订单行×入住日期为粒度扣除部分取消。实际履约依据独立真实入住记录，钟点房不混入住宿间夜。未预约的券不算房晚。

## 费用

净结算：`basis:net`、`net_settlement_fen`、`deductions_included`（已扣费用ID）、`outstanding_fees:[{id,amount_fen}]`。同项已扣费用再次出现在尚未扣费用中会输出UNKNOWN。

毛价推算：`basis:gross`、`list_price_fen`、有顺序的 `discounts`、`commission_basis`（list／guest_payment／merchant_receivable）、`commission_bps`、`other_fees_fen`。固定优惠含type=fixed、amount_fen、payer=merchant/platform；比例优惠含type=percent、bps、basis=original或remaining、payer。

贡献还需要 `variable_cost_fen`、`allocated_ad_cost_fen`。缺成本时净回款可显示，贡献保持null。stage分estimated和realized。历史净结算不能直接外推新挂牌价，自动调价要求当前完整gross规则。

全店OCC／ADR／RevPAR只有all_channel提供已验证权威来源、同日期全渠道可售间夜、已出租间夜与客房收入才计算。美团库存不能充当全店库存。公开或共享报告脱敏，原始数据保存在私密工作区。

## 搜索条件

context记录city、location_condition、query、checkin、checkout、adults、sort、filters、account_state、device、page_type。placement_type分organic、ad、list、unclassified。无法分类不并入自然位置；前20未见不能写成21名。固定场景hash用于比较，采样本身不计成增长。
