🔄 Folio Updated
Topic: FOLIO_UPDATED
What It Does
One or more fields on the folio were modified, such as balance changes, payment additions, debitor updates, or status changes.
Key Info
- Object: Folio
- Actors: System (automated)
- Source: PMS
When It Fires
- Payment added or posted to folio
- Charge or allowance posted
- Balance amount changes
- Bill payer (debitor) information updated
- Folio closed or reopened
- Payment moved between folios
- Refund or payment cancellation processed
Context Data
{
"type": "payment-added",
"pmsReservationId": "RES-12345"
}
Types
⚠️ Only available for PMS Apaleo
| Type | Description |
|---|---|
| allowance-moved-to-folio | Allowance transferred from another folio |
| allowance-posted | Discount or allowance applied to balance |
| balance-changed | Outstanding balance amount changed |
| charge-posted | Charge posted to folio |
| closed | Folio closed and finalized |
| created | Folio creation synchronized from PMS |
| debitor-changed | Bill payer information updated (name, address, company details) |
| payment-added | New payment added to folio |
| payment-canceled | Payment canceled and reversed |
| payment-failed | Payment processing failed |
| payment-moved-from-folio | Payment transferred to another folio |
| payment-moved-to-folio | Payment transferred from another folio |
| payment-posted | Payment posted and processed |
| refund-added | Refund added to folio |
| reopened | Previously closed folio reopened for corrections |
What To Do With It
- Log financial changes - Track all balance and payment modifications
- Update payment status - Reflect current payment state
- Sync accounting - Update external accounting systems
- Monitor outstanding balance - Track amounts owed
- Alert on failures - Notify staff of payment failures
- Trigger workflows - Execute follow-up actions (receipts, reminders)