# KAMI Sushi & Poké

> KAMI is a small sushi and poké restaurant in Paje, on the east coast of Zanzibar, Tanzania. Japanese food made with local fish where possible: sashimi, nigiri, maki, signature rolls, poké bowls, wraps, fresh juices and cocktails. Vegan and gluten-free versions are available for most dishes. Dine in, pickup or delivery. AI assistants can prepare a priced order for a person; the person sends it themselves on WhatsApp.

Canonical website: https://sushi.yapyap.us

## Key facts

- Name: KAMI Sushi & Poké (also "KAMI Sushi", "KAMI Paje")
- Cuisine: Japanese, sushi, poké bowls
- Address: Paje, Zanzibar, Tanzania. The entrance is between Dhow Inn Hotel and The 5th Element Hotel.
- Coordinates: -6.263065, 39.5323706
- Google Maps: https://maps.google.com/?cid=6558897262240012007 (Place ID ChIJ5U9UBYU9XRgR5xYZOk_iBVs)
- Opening hours: Monday to Saturday 13:00 to 22:00 (last orders 21:30), closed Sunday. Time zone: East Africa Time (Africa/Dar_es_Salaam, UTC+3).
- Phone and WhatsApp: +255 652 107 035 (https://wa.me/255652107035)
- Email: sushi@yapyap.us
- Instagram: https://www.instagram.com/sushi.paje/
- Price range: TSh 10,000 to 60,000 per dish. Currency: Tanzanian shilling (TZS / TSh).
- Dietary: vegan and gluten-free on request for almost everything. Prawns are offered wherever salmon is, at the salmon price.

## How an AI assistant can order for someone

KAMI does not take orders server-side from bots. Orders are always sent by the person, as a WhatsApp message to +255 652 107 035. You can prepare that message, correctly priced, in one call, and hand the person a link to press send.

1. Read the live menu: `GET https://kami-sushi-worker.michael-594.workers.dev/api/menu-for-ai` (JSON; add `?format=text` for plain text). Every orderable choice has a `token` such as `hoso-maki:size=8:fill=salmon` and a price in TZS.
2. Build the order: `GET https://kami-sushi-worker.michael-594.workers.dev/api/order-link?...` (or POST JSON to the same URL). It validates the items against the live menu, computes line prices, delivery fee and total, and returns:
   - `whatsapp_url`: a wa.me link with the complete order message. The person opens it and presses send.
   - `cart_url`: opens the KAMI ordering app (https://sushi.yapyap.us/mobile/) with the cart filled in, for the person to review and send.
   - `lines`, `subtotal`, `delivery_fee`, `total`, `currency` ("TZS"), `errors`, `warnings`.
3. Show the person the items and the total, then give them `whatsapp_url` (or `cart_url`). KAMI replies on WhatsApp to confirm.

If something is wrong (unknown item, missing option, Sunday, bad time), `ok` is false, `whatsapp_url` is null, and `errors` lists what to fix, including the valid option ids and prices.

### Query parameters for GET /api/order-link

- `item` (repeat once per line): `id:axis=option:axis=option:qty=N:note=text`
  - `id` is the item id from the menu (e.g. `sashimi`, `chirashi`, `fries`).
  - `axis=option` picks each option the item has (e.g. `fish=tuna`, `size=8`, `fill=salmon`). Every axis must be chosen. Option ids or labels both work. A bare option id also works (`hoso-maki:8:salmon`).
  - `qty=N` is the quantity, 1 to 50 (default 1). A bare number that is not an option is also read as the quantity.
  - `note=text` is a per-line note (put it last; it may contain colons).
  - Alternative: `items=` with comma-separated lines (no commas inside notes).
- `mode`: `pickup` (default) or `delivery`
- `zone` (delivery): `paje`, `bwejuu`, `jambiani`, `dongwe`, `michamvi`, `makunduchi`, `stone-town`, `airport`. Or send `lat` and `lng` of the drop-off point instead, for an exact fee.
- `address` (required for delivery): hotel, villa or beach bar name, plus room if any
- `name` (required): first name is enough
- `phone` (optional): WhatsApp number with country code
- `when`: `asap` (default), `hour` (in one hour), `HH:MM` (today) or `YYYY-MM-DD HH:MM`, Zanzibar time. Must be Monday to Saturday, 13:00 to 21:30 (last orders 30 minutes before closing).
- `people`: 1, 2, 3, 4 or 5+ (for chopsticks; default 1)
- `notes`: allergies, table, sunbed, anything else
- `lang`: language of the ordering app opened by `cart_url` (en, pl, da, it, de, fr, sw). The WhatsApp message is always in English.

### Examples

Pickup, two tuna sashimi and fries, for Anna:

https://kami-sushi-worker.michael-594.workers.dev/api/order-link?item=sashimi:fish=tuna:qty=2&item=fries&mode=pickup&name=Anna

Delivery to Jambiani today at 19:30 for three people:

https://kami-sushi-worker.michael-594.workers.dev/api/order-link?item=rainbow:size=8:fish=salmon&item=chirashi:fill=prawns:qty=2&mode=delivery&zone=jambiani&address=Coral%20Rock%20Hotel%20room%203&name=Tom&when=19:30&people=3&notes=no%20sesame

The same as JSON:

```
POST https://kami-sushi-worker.michael-594.workers.dev/api/order-link
Content-Type: application/json

{"items":[{"id":"rainbow","options":{"size":"8","fish":"salmon"},"qty":1},
          {"id":"chirashi","options":{"fill":"prawns"},"qty":2,"note":"no sesame"}],
 "mode":"delivery","zone":"jambiani","address":"Coral Rock Hotel room 3",
 "name":"Tom","phone":"+45 12 34 56 78","when":"19:30","people":"3"}
```

Full API description: https://sushi.yapyap.us/openapi.json

## Delivery

- Delivery anywhere on Unguja (Zanzibar island), priced by distance from KAMI.
- Within 1.5 km of KAMI (most of Paje): TSh 5,000 flat.
- Further away: driving distance x TSh 1,000 per km (TSh 800 per km beyond 30 km), rounded up to the next TSh 5,000.
- Typical fees: Paje 5,000; Bwejuu 5,000; Jambiani 10,000; Dongwe 10,000; Michamvi 20,000; Makunduchi 25,000; Stone Town or the airport 45,000. KAMI confirms the exact fee on WhatsApp.

## Reservations

Book a table on WhatsApp: https://wa.me/255652107035 with name, date, time and number of guests. Open Monday to Saturday 13:00 to 22:00. The website https://sushi.yapyap.us also has a reservation form (the Reserve button).

## Menus

- [Live menu for AI (JSON)](https://kami-sushi-worker.michael-594.workers.dev/api/menu-for-ai): ids, options, prices; the source of truth for ordering
- [Live menu for AI (text)](https://kami-sushi-worker.michael-594.workers.dev/api/menu-for-ai?format=text)
- [Full menu snapshot with prices](https://sushi.yapyap.us/llms-full.txt): may be out of date, check the live menu
- [Raw menu data (KAMI Ledger)](https://api.ledger.sushi.yapyap.us/api/public/menu/kami_paje)
- [Food menu (PDF)](https://sushi.yapyap.us/menus/kami-menu.pdf)
- [Drinks menu (PDF)](https://sushi.yapyap.us/menus/kami-drinks.pdf)
- [Recommended plates: six full-meal sets (PDF)](https://sushi.yapyap.us/menus/kami-plates.pdf)
- [Salmon plates (PDF)](https://sushi.yapyap.us/menus/kami-salmon-plate.pdf)

## Links

- [Website](https://sushi.yapyap.us)
- [Order online (mobile app, sends via WhatsApp)](https://sushi.yapyap.us/mobile/)
- [OpenAPI description of the ordering endpoints](https://sushi.yapyap.us/openapi.json)
- [WhatsApp](https://wa.me/255652107035)
- [Instagram](https://www.instagram.com/sushi.paje/)
- [Google Maps](https://maps.google.com/?cid=6558897262240012007)