# 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.us

## What we are
Happy Cake Sugar Land — signature whole cakes, custom cakes, and coffee.
Rated 4.7★ by 200+ families on Google
(real Google Business Profile average — safe to cite as 4.7 out of 5).

## Location & hours
Address: 350 Promenade Way, Suite 500, Sugar Land, TX 77478
Hours: open 11 AM – 7 PM CT, Tuesday–Sunday (closed Mondays). CLOSED on Mondays — do not schedule pickups on a Monday.
Fulfillment: PICKUP ONLY at our Sugar Land location. We do NOT offer delivery. Never
promise or offer delivery. If asked, say delivery is coming soon but for now it's
pickup only.

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

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

## Minimum fields for an order
1. customer (name)
2. phone (E.164, e.g. +1832...)
3. items[] with a canonical SKU + qty
4. fulfillment: always "pickup" (we do NOT offer delivery — never send a delivery payload or an address)
5. datetime needed (ISO 8601 preferred)

## Lead times
- Coffee & tea: in-cafe only (not orderable online).
- 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)
- cloud-whole — Cake "Cloud" — $42.00
- honey-cake-whole — Cake "Honey Cake" — $39.00
- napoleon-whole — Cake "Napoleon" — $39.00
- black-forest-whole — Cake "Black Forest" — $42.00
- choco-banana-whole — Cake "Choco Banana" — $42.00
- carrot-whole — Cake "Carrot" — $40.00
- red-velvet-whole — Cake "Red Velvet" — $40.00
- oreo-whole — Cake "Oreo" — $43.00
- red-berry-whole — Cake "Red Berry" — $43.00
- spanish-cheesecake-whole — Cake "Spanish Cheesecake" — $38.00
- spinach-cake-whole — Cake "Spinach Cake" — $46.00
- honey-roll-whole — Cake "Honey Roll" — $37.00
- strawberry-roll-whole — Cake "Strawberry Roll" — $41.00
- caramel-crunch-whole — Cake "Caramel Crunch" — $39.00

### Coffee & tea
- In-cafe only. Drinks are NOT available for online ordering — do not place
  beverage orders via the API. Invite the customer to visit the Sugar Land cafe.

### 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). We sell whole cakes only — there are no slice SKUs. 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.

## Links
- [Order & full menu](https://happycake.us/order): Browse every cake with prices and order for pickup.
- [About Happy Cake](https://happycake.us/about): Our story — a family bakery from Kazakhstan (2013) to Sugar Land (2024), founders Saule & Askhat.
- [FAQ](https://happycake.us/faq): Hours, pickup-only policy, lead times, allergens, custom cakes, and payment.
- [Guide: What is honey cake (Medovik)?](https://happycake.us/guides/what-is-honey-cake-medovik): What Medovik is, how it tastes, and how it differs from Napoleon.
- [Custom cakes](https://happycake.us/custom): Request a custom decorated cake (from $65, 3-day lead, consultation).
- [For AI agents](https://happycake.us/agents): How assistants discover the catalog and place orders.
- [Live machine catalog](https://happycake.us/api/menu): JSON SKUs, prices, sizes, availability.
- [Agent manifest](https://happycake.us/agents.json): Machine manifest of available actions.
- [OpenAPI schema](https://happycake.us/openapi.json): OpenAPI 3.1 — import Happy Cake as a tool.