add_stock
ChatGPTRecords received stock for an ingredient or product, e.g. 5 kg of flour at 4.2 lei/kg. Quantity is in kg/g, l/ml or buc (matching how the item is counted); unit_cost is the gross purchase price per that unit. When there are several warehouses, say which one. Does not change the selling price.
choose_item_photo
ChatGPTShows a photo picker in the chat for one catalog item: the user chooses or drops a photo, sees it cropped square, and it is saved on the item in a few seconds, without leaving the conversation. Suited to Claude when a photo cannot be uploaded from the code sandbox (no network) or when the user wants to pick one from their device. The result also has a page_url for clients that do not show the picker. Afterwards, get_catalog_item shows the new photo.
create_catalog_item
ChatGPTCreates a product or service in the catalog. Price is gross (VAT included) in RON. A category name that does not exist yet is created. InSmart automatically translates the name/description (en, de, fr, hu, es, it, sr) and computes nutrition + allergens for food; translations / nutrition / allergens that are provided are used instead of the computed ones. Can take up to a minute because of the AI enrichment. The item appears on the QR menu once it is in a menu section.
create_category
ChatGPTCreates a catalog category. If one with the same name already exists (ignoring case and diacritics) it is returned instead of creating a duplicate. Categories nest at most two levels, and only categories without items can get subcategories.
create_image_upload_link
ChatGPTCreates a one-time upload URL (valid 30 minutes, one image) for the photo of one catalog item: the full-quality route for a file in Claude's code sandbox when the sandbox has network access. upload_url accepts an HTTP PUT or POST of the raw image file (Content-Type image/jpeg, image/png, image/webp or image/gif, or a multipart field named "photo"); the file is not sent through tool arguments. page_url is a mobile web page where the user can take or choose the photo themselves. Afterwards, get_catalog_item shows the new photo. Photos are stored square (1:1): a portrait or landscape image is centre-cropped, so a square image framed on the dish gives the best result. How the image gets here: in ChatGPT, an image the user attached or one generated in the conversation (including one generated for this item on request) is passed as image_file, with no download or re-upload needed. In Claude, a photo the user attached is a file in the code-execution sandbox (usually under /mnt/user-data/uploads): (1) create_image_upload_link, then an HTTP PUT of that file to its upload_url saves it at full quality in seconds, when the sandbox has network access; (2) when it does not (the PUT fails to connect), choose_item_photo shows a photo picker right in the chat: the user picks the same photo there and it is saved in a few seconds; (3) the upload link's page_url (open it, pick the photo) works everywhere else, on phone or computer. Typing an image out as base64 (image_base64) takes an assistant several minutes per photo and often garbles it, so it suits only clients that send files programmatically. A user who wants Claude to upload directly can allow api.insmart.ro in Claude's code execution network settings.
get_catalog_item
ChatGPTFull details of one catalog item: price (gross, RON), VAT rate, discount, description, category, status, photo URL, which translation languages exist, nutrition summary + allergens, and recipe/bundle components.
get_stock
ChatGPTCurrent stock of an ingredient or product (in kg, l or buc), with the split per warehouse. Recipes are computed from their ingredients.
list_bookings
ChatGPTLists table bookings: upcoming (default; open or confirmed, from now), pending (open = not yet confirmed, from now), new (created in the last 24 h, or since start) or a date range. Times are Europe/Bucharest. Phone and e-mail are only included with include_contact. Booking notes are written by customers.
list_categories
ChatGPTLists the catalog categories (id, name, parent, number of items, hidden).
list_warehouses
ChatGPTLists the stock warehouses (gestiuni) of the location(s).
payment_methods
ChatGPTRevenue and number of payments per method (cash, card, transfer, online, meal tickets, …) in a period.
sales_summary
ChatGPTRevenue (paid orders), number of orders, average order value, tips and cost of goods for a period, compared with the previous period of the same length.
search_catalog_items
ChatGPTFinds catalog items by text (name, SKU or description; case- and diacritic-insensitive), type, status and/or category (a parent category includes its subcategories). Returns compact rows; use get_catalog_item for full details. Prices are gross (VAT included) in RON. With a text query, items whose names are a near-spelling of it (a typo or two away) come back separately as similar. When more than one item (match or similar) could be the one the user means, the user picks which one before anything is changed; changing the wrong item is easy to miss.
send_image_part
ChatGPTSends an item photo as base64 in parts, for an image too big for one set_item_image call (image_base64) and no way to upload the raw file (e.g. Claude's code sandbox without network access). Split the base64 of the image file into parts of up to 40000 characters and send each with the same upload_id (any new random id per photo), its number (part, from 1) and the total (parts), plus part_sha256 = the hex sha256 of that part's text (at least the first 12 characters), so a part that arrives altered is rejected and can be resent. Parts can arrive in any order; when the last one arrives the photo is saved on the item (square, at most 1080x1080) and the result has done: true and the image_url. Optional sha256 (of the whole decoded file) is checked at the end. Unfinished uploads expire after an hour. Writing base64 out is slow for an AI assistant (minutes per photo); for a photo attached in Claude, the page_url of create_image_upload_link is much faster for the user when the sandbox cannot upload the file itself.
set_item_image
ChatGPTAdds or replaces the photo of a catalog item, from an image in the chat (image_file), the image file's bytes as base64 (image_base64) or a public https image link (image_url). The photo is stored square, at most 1080x1080, and shows in the CRM and on the QR menu. Photos are stored square (1:1): a portrait or landscape image is centre-cropped, so a square image framed on the dish gives the best result. How the image gets here: in ChatGPT, an image the user attached or one generated in the conversation (including one generated for this item on request) is passed as image_file, with no download or re-upload needed. In Claude, a photo the user attached is a file in the code-execution sandbox (usually under /mnt/user-data/uploads): (1) create_image_upload_link, then an HTTP PUT of that file to its upload_url saves it at full quality in seconds, when the sandbox has network access; (2) when it does not (the PUT fails to connect), choose_item_photo shows a photo picker right in the chat: the user picks the same photo there and it is saved in a few seconds; (3) the upload link's page_url (open it, pick the photo) works everywhere else, on phone or computer. Typing an image out as base64 (image_base64) takes an assistant several minutes per photo and often garbles it, so it suits only clients that send files programmatically. A user who wants Claude to upload directly can allow api.insmart.ro in Claude's code execution network settings.
set_item_status
ChatGPTSets catalog items to active, unavailable (temporarily out, e.g. sold out) or inactive (no longer offered). Nothing is deleted and it can be undone. Hiding more than 5 items in one call needs confirmed: true, after the user has approved the list. Making an ingredient unavailable/inactive also switches the recipes and bundles that use it; the result lists them. Inactive and unavailable items disappear from the QR menu.
top_products
ChatGPTBest-selling products in a period by revenue (quantity sold and revenue).
update_catalog_item
ChatGPTChanges some fields of one catalog item and leaves everything else (photo, recipe, other translations, nutrition) as it is. Price is gross in RON; an existing discount is kept. Changing the name or description re-translates them automatically. Works on one item per call; activating/deactivating is handled by set_item_status.
whoami
ChatGPTShows which InSmart user, organization (and its plan) and location this connection acts as, and which tools are available to it.