Place an order. Two modes: (A) Guest retail: provide customerName, phone, items array, and a delivery address — shippingAddress, shippingProvince and email are all required, and an order missing any of them is rejected. Guest orders are priced at tier-linked retail rates (server-calculated) and the total is final at this point; a confirmation email with a PromptPay QR follows. Without customerKey or a personal token URL connection, every order creates a new customer with a new customerKey, even when the email was used before (orders are never linked to an existing customer by email); the new key is returned in the response and the confirmation email — tell the user to save it. Inventory is NOT deducted — orders go to the pick queue for staff fulfillment. Delivery is available within Thailand only, so the province must be a Thai one. International addresses are not accepted. (B) LINE VIP customer connected through a personal token URL (get_catalog says ordering is available in this chat): send vipItems only — one entry per item, with fishName, status and tier exactly as get_catalog shows them and the quantity in the form get_catalog gives for that item (bands, packs or kg). The server calculates prices, shipping and the total; the total is an estimate, billing is by invoice after picking, and no payment is taken now. Call with dryRun: true first, show the user the lines and the estimate, and place the order only after the user confirms.
View input schema
{
"type": "object",
"properties": {
"customerKey": {
"type": "string",
"description": "(Guest mode) Registered customer key (from register_customer). Resolves name/phone/shipping automatically. If you are connected through a personal token URL the customer is already resolved: send items[] alone and omit this, customerName and phone."
},
"customerName": {
"type": "string",
"description": "(Guest mode) Customer name"
},
"phone": {
"type": "string",
"description": "(Guest mode) Contact phone number"
},
"items": {
"type": "array",
"description": "(Guest mode) Order items",
"items": {
"type": "object",
"properties": {
"fishName": {
"type": "string"
},
"status": {
"type": "string",
"description": "Cut / preparation of the fish (e.g. \"sashimi fillet\"). Pass the status shown for this fish in get_catalog, verbatim. Optional: when omitted the server fills it in from stock, and asks which one if more than one cut is available."
},
"tier": {
"type": "string",
"enum": [
"Fresh",
"Tier1",
"Tier2"
]
},
"band": {
"type": "string",
"description": "Weight band (e.g. \"140-180g\")"
},
"qty": {
"type": "number",
"description": "Number of packs"
}
},
"required": [
"fishName",
"tier",
"band",
"qty"
]
}
},
"shippingAddress": {
"type": "string",
"description": "(Guest mode) Street address and building name — required for guest orders"
},
"shippingProvince": {
"type": "string",
"description": "(Guest mode) Thai province name, used for shipping cost — required for guest orders. Thailand only."
},
"shippingDistrict": {
"type": "string",
"description": "(Guest mode) Hua Hin / Pranburi 等の地元配達判定に必須。住所に含まれていれば自動判定するが、明示推奨 / District name. Required to detect local (free) delivery for Hua Hin / Pranburi. Auto-detected from shippingAddress when present, but explicit value recommended."
},
"email": {
"type": "string",
"description": "(Guest mode) Email address for the order confirmation — required for guest orders"
},
"lang": {
"type": "string",
"enum": [
"ja",
"en",
"th"
],
"description": "(Guest mode, optional) Language of the confirmation email. Defaults to en."
},
"referrerId": {
"type": "string",
"description": "(Optional) Referrer ID for tracking"
},
"memo": {
"type": "string",
"description": "(Optional) Order notes"
},
"vipItems": {
"type": "array",
"description": "(LINE VIP mode only) Order lines for a LINE VIP customer connected through a personal token URL. Ignored in other modes.",
"items": {
"type": "object",
"properties": {
"fishName": {
"type": "string"
},
"status": {
"type": "string",
"description": "As shown in get_catalog for this item"
},
"tier": {
"type": "string",
"enum": [
"Fresh",
"Tier1",
"Tier2",
"All"
],
"description": "As shown in get_catalog (All for cooking, prepared and whole cooking items)"
},
"bands": {
"type": "object",
"description": "Packs per weight band, e.g. {\"140-180g\": 3} — only for items get_catalog marks as ordered by bands",
"additionalProperties": {
"type": "number"
}
},
"packs": {
"type": "number",
"description": "Total packs — only for items ordered by packs"
},
"kg": {
"type": "number",
"description": "Kilograms in steps of 0.5, or exactly the stock shown — only for items ordered by kg"
}
},
"required": [
"fishName",
"status",
"tier"
]
}
},
"dryRun": {
"type": "boolean",
"description": "(LINE VIP mode only) true = return the lines and the estimated total without placing the order"
}
}
}