crackerscity-storefront

Showing 25 of 42 from the live probe.

• Search Products

  Search/list the storefront catalog. Returns a SHORT ranked list — each item: id, name, sku, slug, price (final selling price), originalPrice (MRP), discount %, stock, inStock, packageType, categoryName, brandName — plus total/page/limit/totalPages for pagination. Default 10 per page (max 25); ask for page 2+ when you need more. For full detail (description, images) call get_product(id). Use category/brand SLUGS (from list_categories/list_brands).

• Get Product

  Fetch a single product by slug, id, or sku (provide exactly one).

• List Categories

  List product categories (id, name, slug, parentId). Use get_category_tree for hierarchy.

• Get Category Tree

  Get the hierarchical category tree (active categories).

• List Brands

  List active brands (id, name, slug).

• Get Store Info

  Public company profile: name, contact numbers/WhatsApp/email, address, business hours, active pickup locations, and payment settings (enabled methods, COD limits, UPI accounts for display).

• Get Store Settings

  Public store settings: currency, minimum order amount, COD availability, stock display mode, maintenance flag, and enabled login methods.

• Get Pickup Locations

  List active pickup / lorry-godown locations (this store ships via lorry to the nearest godown for customer collection). Optionally filter by city/state/search.

• List Coupons

  List active public coupons the customer can use.

• Validate Coupon

  Preview whether a coupon code applies to an order total (anonymous / general validation), returning the discount. Per-customer eligibility (usage limits, first-time) is enforced authoritatively at place_order using the signed-in customer — this preview never takes a customerId.

• Request Whatsapp Otp

  Start sign-in: send a one-time password (OTP) to the customer over WhatsApp. Call this ONLY when the customer is not yet signed in and must sign in to place an order or view their account. Ask the customer for their phone number first. Then call verify_whatsapp_otp with the code they receive. If the customer is already signed in this returns alreadyAuthenticated=true and sends NO code — just proceed with the action.

• Verify Whatsapp Otp

  Verify the WhatsApp OTP and sign the customer in. On success for an EXISTING customer the conversation becomes authenticated and the order/account tools unlock — then retry the action (e.g. place_order). If the result has requiresRegistration=true, this is a NEW customer: ask for their name (email optional) and call complete_registration, passing back the exact otpSessionToken returned here. You may pass a name here up front if the customer already gave one.

• Complete Registration

  Finish sign-up for a NEW customer after verify_whatsapp_otp returned requiresRegistration=true. Pass the customer name (required), an optional email, and the exact otpSessionToken from verify_whatsapp_otp. On success the conversation becomes authenticated and the order/account tools unlock — then retry the action (e.g. place_order).

• Get My Profile

  Get the signed-in customer profile (requires the customer token).

• Update My Profile

  Update the signed-in customer profile fields (name, email, etc.).

• List My Addresses

  List the customer’s saved shipping addresses.

• Add Address

  Add a shipping address for the customer.

• Update Address

  Update a saved shipping address by addressId.

• Remove Address

  Remove a saved shipping address by addressId.

• Place Order

  Place a REAL order/enquiry for the signed-in customer. Provide ONLY productId + quantity per line — the server looks up the authoritative price/MRP/discount from the catalog (client-supplied prices are never trusted). Provide a shippingAddress (or a pickupLocation) and paymentMethod. customerPhone is required (from the token or provided here). Returns the created order incl. orderNumber; fails with INSUFFICIENT_STOCK if any item exceeds available stock.

• Add To Cart

  Add a product to the signed-in customer’s cart (the SAME cart as the website). Provide productId (from search_products/get_product) + quantity; the quantity is ADDED to any existing quantity for that product. Returns the updated cart summary. Use this for the conversational "add to cart → checkout" flow (an alternative to the Excel order form).

• View Cart

  Show the signed-in customer’s current cart (items, quantities, prices, subtotal).

• Update Cart Item

  Set the exact quantity of a product in the cart (quantity 0 removes it). Returns the updated cart summary.

• Remove From Cart

  Remove a product from the cart. Returns the updated cart summary.

• Clear Cart

  Empty the signed-in customer’s cart.