Feature Package PK-07 — Procurement & Group Purchasing
Status: Package Specification
Domain: Procurement / Corporate / Multi-Property
Maps to: Playbook H-9 + Process 7 (Cross-Org B2B Joint Procurement)
External integration: ERPNext (fiscal), Record Federation (s184), BBS+ selective disclosure
1. What This Package Does
For hotel groups and corporate accounts, this package aggregates F&B, amenities, and linen demand across properties for volume pricing, with federated escrow release on multi-property delivery verification — replacing individual property orders, inconsistent vendor terms, and manual reconciliation.
2. Features & Functionality
| Feature | What it does | Who uses it | What stands behind it |
|---|---|---|---|
| Federated requisition | Group-level requisition (is_federated: true) bound to peer property scopes | Group procurement lead, property procurement officers | cns://federation/procurement; record_federation_binding (s184) |
| Per-property quota signing | Each property signs its allocation quota with its BBS+ key; selective disclosure hides internal margins | Property GM, finance controller | BBS+ signature; X-Sovereign-DID-Proof header |
| Authority verdict | A named authority must approve the award before any commitment | Regional director, group procurement | fn::authority::verify_chain; governance rules (s165) |
| Federated escrow | Shared PoCE escrow session; supplier payment released only on multi-property delivery verification | Finance, supplier | fn::poce::finalize_session; federated PoCE |
| Cross-property visibility | Group-wide spend and vendor performance visible without merging property databases | Regional office, group finance | record_federation_event audit ledger; scope boundaries |
| ERPNext fiscal sync | Each property's PO mirrors to its own ERPNext instance for fiscal compliance | Property accounts payable | integration_entity (system: erpnext) per property |
3. Workflow (Group Procurement)
- Group aggregates F&B demand across properties → federated requisition claim
- Bound to peer property scopes via
record_federation_binding - Each property signs its quota with BBS+ key (selective disclosure — no margin leakage)
- Authority verdict required before award (verdict = gate; missing verdict blocks)
- Shared PoCE escrow session created
- Supplier delivers; each property verifies delivery
- PoCE escrow released; supplier paid; ERPNext POs mirrored per property
4. Guard Rails
- Authority verdict required before award; missing verdict blocks award
- No autonomous escrow release
- Selective disclosure: no internal margin leakage between properties
- No synthetic vendor or property IDs
5. Evidence & Audit
- Federated claim, federation bindings, BBS+ quota signatures, authority verdict, escrow lock/release receipt