PathokPoint

Search

Find books by title, author, category, publisher, or any combination. One tool handles everything: title lookup, browsing an author's catalog, category/publisher browsing, intersection (author × category), and pagination. ## What each parameter does **Title search** — `book_title` only (no author/category/publisher): - Full-text Meilisearch — typo tolerant, returns best matching books. - Response: `{"books": [...], "total": N}` **Author/category/publisher browsing

Get Book Details

Get complete details of a specific book by its ID. Use ONLY when a customer asks for details about a book already found in search results (description, ISBN, publisher, edition, all condition variants with prices). Do NOT use this to discover books — use `search`. Args: book_id: The public_id shown in search results and book URLs.

Get Shop Info

Get shop info: payment rules, live courier charges, coverage, return policy, response format guides. Call this when the customer asks about: - Payment methods (bKash, COD, advance payment) - Whether COD is available for their order - Shipping charges or delivery time to their city - Which courier serves their area - Coupon restrictions - Return policy Also call before place_order to determine the correct `payment` value based on the customer's cart contents

Get Checkout Summary

Calculate the full cost breakdown and show all available courier options. Always call this before place_order. Do NOT guess the payment method — use `recommended_payment` and `recommended_courier` from the response. Minimum order: sub_total (product total, excluding shipping/weight charge) must be at least ৳100. place_order rejects the order otherwise — tell the customer to add more items before checkout if sub_total is below that. Response structure: - sub_total,

Place Order

Place an order. Always call get_checkout_summary first. Rejects the order if product sub_total (excluding shipping/weight charge) is below ৳100 — the minimum applies to product total only, not the delivery-inclusive grand total. Use `recommended_courier` and `recommended_payment` from get_checkout_summary, or the customer's chosen courier_option values. Never decide payment from book condition or any assumption. Payment flows: - bkash_full / bkash_advance_cod →

Get Coupons

List public coupons currently available to apply at checkout. Call this when the customer asks about available discounts, promo codes, or coupons. Returns codes the customer can apply to their order. IMPORTANT: Do NOT calculate the discount yourself. Coupons have conditions (minimum spend, book condition, category, and courier restrictions) that only the server evaluates correctly. After showing the customer the available codes, always pass the chosen coupon_code to

Track Order

Check the status of an existing order. Args: invoice: Invoice number provided after the order was placed. phone: The 11-digit phone number used when placing the order (for verification).