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 and stock adjustments, supplier returns, reorder rules, suppliers, reports, notifications, email recipients, 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
  • See also

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, additional costs & discounts, documents, shipments (an order can have more than one, each with the line items and quantities it carries), addresses, activity log, and supplier credits — both those already applied to the order and those still available from that supplier.
Transfer ordersOrders, line items, shipment, documents, addresses, and activity log — including the from/to locations.
Return ordersOrders and their line items — including return quantities and credit totals. 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.
Stock adjustmentsThe delta-only siblings of stock takes (SA-…) — headers with operator, value and quantity totals, per-line deltas and how much of each reached Shopify, the shared reason list, and the links between an adjustment and its reversal.
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, ABC grades and seasonal trends — plus the open supply-order roll-up. The KPI figures come from the nightly inventory snapshot, so they’re typically a day behind the live forecast and reporting reads.
Notification rulesYour out-of-stock notification rule and its current trigger settings. Readable on any plan; changing the rule needs the Enhanced plan.
ReportsYour scheduled report definitions and their configurations. Enhanced plan.
Reporting (interactive)The reporting engine behind Reporting — the report catalogue, your canonical and saved views, and any report’s rows, totals and scorecard tiles, including a full export of up to 50,000 rows. Any plan. Not the same thing as the scheduled Reports above.
Label printing & scanningPrinting Studio print runs with their line items and generated documents, and Cloud Platform label-checking sessions with their per-day and per-run scan statistics.
Settings & reference dataPurchase tax rates, carriers, email templates and each order’s email send-history, accounting connections and sync state, multi-store settings, custom data-modeling fields, and the data-exclusion / order-exclusion settings.
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. Logistified reads it off the most recent nightly snapshot: that day's inventory quantity divided by that day's units sold, then scaled by a fixed annualisation factor — see the KPI reference for the exact formula. 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, stock adjustments, supplier returns, reorder rules, suppliers, reports, notification rules, email recipients, and forecast views — see the operating pages in this section — plus a few smaller surfaces those pages don’t cover, such as label print runs, saved reporting views, purchase tax rates and accounting settings. Locations and sales orders remain read-only, and your Shopify product catalogue itself can’t be edited — the assistant can only write Logistified’s own per-variant planning fields (forecast settings, unit costs).
  • A dedicated sales-history feed. There’s no separate per-variant sales-history series (the one behind the forecast models). Historical sales still reach the assistant — date-filtered sales orders, and the reporting engine’s Sales reports (best sellers, sale items) — just not as a dataset of their own.