# Happy Cake Sugar Land — guide for AI agents

> Family sweets. A family cake bakery & cafe in Sugar Land, TX (Houston metro).
> This file helps AI agents order on behalf of a human. Be warm, accurate, and
> never invent products, prices, or allergen claims. https://happycake.io

## What we are
Happy Cake Sugar Land — signature whole cakes, cake slices, custom cakes, and coffee.
Loved by 130+ families on Google. (We do not publish a
numeric star average — do not state one.)

## Location & hours
Address: 350 Promenade Way, Suite 500, Sugar Land, TX 77479
Hours: typically 8 AM – 8 PM CT, 7 days (may vary on holidays — confirm if critical).
Fulfillment: pickup at our Sugar Land location. Delivery options depend on the
area and are confirmed by our team — do not promise a delivery time.

## How to order (agent → API)
POST https://api.happycake.io/api/order  (also reachable at https://happycake.io/api/order)
Content-Type: application/json
Optional header: Idempotency-Key: <stable-uuid>   (safe to retry)

Discovery:
- Machine catalog:   https://happycake.io/api/menu
- Action manifest:   https://happycake.io/agents.json
- OpenAPI schema:    https://happycake.io/openapi.json

## Minimum fields for an order
1. customer (name)
2. phone (E.164, e.g. +1832...)
3. items[] with a canonical SKU + qty (size only for beverages: regular/large)
4. fulfillment: "pickup" or "delivery" (+ address if delivery)
5. datetime needed (ISO 8601 preferred)

## Lead times
- Slices & beverages: same-day in store.
- Whole signature cakes: ~24 hours' notice.
- Custom cakes: 3 days (72h) + consultation + owner approval.

## Example order payload
{
  "customer": "Amira Khan",
  "phone": "+18325551234",
  "items": [
    { "sku": "honey-cake-whole", "qty": 1, "notes": "name 'Amira' on top" }
  ],
  "fulfillment": "pickup",
  "datetime": "2026-06-14T14:00:00-05:00",
  "allergy_notes": null,
  "channel": "web",
  "estimated_total_usd": 39.00
}

Server response includes order_id, status, estimated_total_usd, and a
confirmation_text. ALWAYS relay the confirmation_text to the human verbatim —
it carries the mandatory allergen disclaimer:
"Please inform us of any allergies. All cakes are made in a facility that processes nuts, dairy, eggs, wheat, and soy."

Order status meanings:
- confirmed       — standard SKU, total <= $200, daytime (8AM–8PM CT).
- needs_approval  — custom cake, total > $200, or an allergy note: our team confirms.
- held_overnight  — placed 8PM–8AM CT; we confirm at 8AM CT.
- duplicate       — identical order within 2 minutes (dedup).
- rejected        — see the "error" field.

## Menu (canonical SKUs)
### Whole cakes (lead time ~24h)
- almond-whole — Cake "Almond" — $38.00
- black-forest-whole — Cake "Black Forest" — $42.00
- caramel-crunch-whole — Cake "Caramel Crunch" — $39.00
- carrot-whole — Cake "Carrot" — $40.00
- choco-banana-whole — Cake "Choco Banana" — $42.00
- cloud-whole — Cake "Cloud" — $42.00
- honey-cake-whole — Cake "Honey Cake" — $39.00
- honey-roll-whole — Cake "Honey Roll" — $37.00
- napoleon-whole — Cake "Napoleon" — $39.00
- oreo-whole — Cake "Oreo" — $43.00
- red-berry-whole — Cake "Red Berry" — $43.00
- red-velvet-whole — Cake "Red Velvet" — $40.00
- snickers-cheesecake-whole — Cake "Snickers Cheesecake" — $43.00
- spanish-cheesecake-whole — Cake "Spanish Cheesecake" — $38.00
- spinach-cake-whole — Cake "Spinach Cake" — $46.00
- strawberry-roll-whole — Cake "Strawberry Roll" — $41.00

### Cake slices (same-day)
- almond-slice — Slice of "Almond" — $8.00
- black-forest-slice — Slice of "Black Forest" — $10.00
- caramel-crunch-slice — Slice of "Caramel Crunch" — $3.00
- carrot-slice — Slice of "Carrot" — $8.00
- choco-balls-slice — Slice of "Choco Balls" — $3.00
- choco-banana-slice — Slice of "Choco Banana" — $9.00
- cloud-slice — Slice of "Cloud" — $9.00
- honey-cake-slice — Slice of "Honey Cake" — $8.00
- honey-roll-slice — Slice of "Honey Roll" — $8.00
- napoleon-slice — Slice of "Napoleon" — $8.00
- oreo-slice — Slice of "Oreo" — $10.00
- red-berry-slice — Slice of "Red Berry" — $10.00
- red-velvet-slice — Slice of "Red Velvet" — $8.00
- snickers-slice — Slice of "Snickers" — $6.00
- snickers-cheesecake-slice — Slice of "Snickers Cheesecake" — $12.00
- spanish-cheesecake-slice — Slice of "Spanish Cheesecake" — $8.00
- spinach-cake-slice — Slice of "Spinach Cake" — $11.00
- strawberry-roll-slice — Slice of "Strawberry Roll" — $10.00

### Beverages (same-day)
- americano — Americano — $4.00 (regular) / $5.00 (large)
- latte — Latte — $5.00 (regular) / $6.00 (large) [allergens: dairy]
- cappuccino — Cappuccino — $5.00 (regular) / $6.00 (large) [allergens: dairy]
- tea — Tea — $3.50

### Custom cakes
- sku "custom" — starting at $65.00, 3-day lead time,
  requires consultation + owner approval. Use /custom or POST with items[].sku = "custom".

## Rules for agents
- Use canonical SKUs from /api/menu. Map loose names (e.g. "honey cake" →
  honey-cake-whole; "slice of honey" → honey-cake-slice). Whole cakes are a
  single size. If it doesn't map, ask one clarifying question.
- Never guarantee allergen-free. If the human mentions an allergy, set
  allergy_notes — the order will escalate to our team for confirmation.
- Never fabricate ratings, delivery promises, or hours.
- Prices are recomputed server-side; estimated_total_usd is advisory.