Skip to content

What the assistant can read

A connected assistant can read data across most of Logistified. With a read-only connection it cannot change anything — see Read-only by default; with write access it can additionally operate purchase orders, transfer orders, stock takes, supplier returns, reorder rules, suppliers, reports, notifications, and forecast views — see the operating pages in this section. This page lists the read surface so you know what you can ask about.

  • The data it can reach
  • How it explores the API
  • Reading the documentation
  • What’s not included yet

The assistant can read across these areas, scoped to your single store:

AreaWhat it can see
Purchase ordersOrders and their line items, receiving schedule, payments, documents, shipment, addresses, activity log, and applied supplier credits.
Transfer ordersOrders, line items, shipment, documents, addresses, and activity log — including the from/to locations.
Return ordersOrders, line items, and shipment detail. Addresses, activity log, return codes (reason / condition / disposition), and credit history on the Elevate plan.
Stock takesStock takes, their line items, value totals, and the count-reason list.
SuppliersThe supplier directory, per-supplier detail, supplier–variant mapping (cost / MOQ / lead time), stock held at the supplier, consignment stock, and the supplier credit balance and ledger.
LocationsYour locations and any name overrides.
Variant constantsPer-variant, per-location min / max / reorder / target values.
ProductsYour product catalogue and per-product detail.
VariantsThe variant catalogue — SKU, barcode, product, vendor — and lookups by id.
Inventory levelsOn-hand quantities by variant and location, across all eight quantity buckets.
Forecast views & projectionsYour saved forecast views — name, filters, columns, model settings — and the full per-product forecast rows behind any of them: predicted demand, reorder point, days of stock, and suggested reorder quantities.
DashboardsShop-wide KPI summary — inventory health, stock-out counts, restock-timing buckets, and supply-order activity roll-up.
Notification rulesYour out-of-stock notification rule and its current trigger settings. Enhanced plan.
ReportsYour scheduled report definitions and their configurations. Enhanced plan.
OrdersSales orders and their line items (as current as the latest Shopify webhook).
FulfillmentsFulfillment detail for an order, including the fulfilling location.

The assistant doesn’t have to guess what’s available. Alongside run, it can call describe_api, which returns the live, typed definition of everything it can read — every area above, the inputs each accepts, and the shape of what comes back. This is how a capable assistant figures out, on its own, how to answer a question like “which suppliers have stock waiting for me?”

The assistant can also read this documentation site through two tools:

  • list_docs — the index of every documentation page.
  • get_doc — the full text of one page.

This lets it ground its answers in how Logistified actually works — what DOHDays on HandHow many days of demand your current stock covers, at the current sales rate. Lower DOH means stock is moving quickly; higher DOH means you may be over-stocked. Computed as `Average Inventory / COGS × 365`. Read more → means, how a purchase order’s lifecycle runs, what a forecast model does — instead of guessing.

  • Writing (beyond the operated surfaces). With a write-scope connection the assistant can operate purchase orders, transfer orders, stock takes, supplier returns, reorder rules, suppliers, reports, notification rules, email recipients, and forecast views — see the operating pages in this section. Products, locations, and sales orders remain read-only.
  • Sales history. Historical sales aren’t part of this surface yet — they’re planned separately.