Skip to main content

Nova Docs

How Nova reads, refreshes and computes your Amazon data. Every page is checked against Nova's code, and every page has a markdown version for your AI assistant.

All docs

Getting started

  • How Nova worksHow Nova reads your Amazon data, rebuilds it into P&L, advertising and inventory models, and serves the same figures in the App, the MCP and Data Share.
  • Connect Seller CentralWho can connect a Seller Central account, which region to pick, what happens on Amazon's consent page, how long the first load takes and how to re-authorize.
  • Connect Amazon AdsHow to connect your Amazon Ads login, which login to use, what Nova reads, how DSP is found, and what happens when the Ads connection is missing or expires.
  • Connect Vendor CentralHow to connect a Vendor Central (1P) account, country by country, which Vendor Central permission it needs, what Nova loads, and how 1P differs in the app.
  • Workspaces and rolesHow organizations, workspaces and Amazon accounts fit together, what an Admin, a Member and a Workspace owner can do, and how agencies set up clients.

Your data

  • Data sourcesThe Amazon APIs and reports Nova reads for Seller Central, Amazon Ads and Vendor Central, and the inputs you add yourself.
  • Refresh timesWhen each Amazon data source reaches Nova, from live orders in seconds to monthly storage fees, and why recent days can still change.
  • History depthHow many months of each Amazon data source Nova loads on a trial and on a paid plan, and which limits come from Amazon.
  • Time zonesWhich time zone Nova uses to count a day for each Amazon marketplace, how ad days differ, and how your dashboard decides which day is today.
  • Currencies and exchange ratesHow Nova converts sales, fees and ad spend from each marketplace currency into your reporting currency, which rate it uses, and why past figures do not move.

Profit and costs

  • How the P&L is builtThe lines of Nova's P&L from sales to net profit, what each one takes off, which day each amount lands on, and how costs are grouped.
  • Amazon feesWhere Nova's Amazon fees come from, the four cost categories, how each fee reaches a product, and what happens when Amazon adds a new fee.
  • Cost of goods (COGS)How Nova turns the unit costs you enter into COGS by date and marketplace, how regions share costs, FIFO batches, and what happens to a SKU with no cost.
  • VATHow Nova finds the VAT in each order, when it uses Amazon's own tax figure, how your VAT categories apply, and the order of rules it follows.
  • FBM costsHow Nova prices the shipping, packing and picking of your FBM orders by delivery country, which rate wins, and what happens when a destination has no rate.

Advertising

  • PPC dataThe ad products and report cuts Nova reads, why totals never mix cuts, which attribution window each ad product uses, and how ad spend reaches the P&L.
  • Search terms and impression shareWhat the search term report contains and leaves out, how long Amazon keeps it, and the two impression share figures Nova captures for your keywords.
  • Amazon DSPHow Nova finds your DSP advertisers, links them to your seller account, which reports it reads, and where DSP cost lands in the P&L.
  • Search Query PerformanceWhich products Nova tracks in Amazon's Search Query Performance report, how far back it goes, how searches are grouped, and how it meets your PPC data.

Inventory and catalogue

  • Inventory glossaryEvery stock state on the Inventory page, the Amazon word behind it, how Nova counts it, and how days of supply and stock value are computed.
  • ReplenishmentThe inputs behind Units to order and Order by, the formula, the order in which Nova picks each lead time and target, and what your AI assistant can import.

Vendor Central (1P)

  • What Nova readsEvery Vendor Central source Nova reads, how often it refreshes and how far back it goes, plus what is not available for a 1P account.
  • The 1P P&LHow the 1P P&L starts from Amazon's net received, what it takes off down to net profit, how units are counted, and how Nova's names map to Vendor Central's.
  • Remittances and deductionsWhat a vendor remittance is, how Nova reads and classifies each line, and where co-op, chargebacks, claims and other deductions land in your 1P P&L.

Nova MCP

  • Overview and securityThe Nova MCP endpoint, how your assistant signs in, what it reads and writes, how access is scoped per member, how to revoke it, and what Nova logs.
  • Tool referenceEvery tool of the Nova MCP server, grouped by what it answers, with the tools that only appear for Vendor Central or Amazon listing writes.
  • Limits and behaviorAccess during and after the trial, rate limits, rows per call, grains and dates, currencies, errors, and the notices the server attaches to its answers.
  • Connect your AIThe assistants that connect to the Nova MCP server, the plan each one requires, who sets it up, and the step-by-step guide for each.

Data Share

  • Data Share overviewRead-only database access to your own Nova data, scoped to your organization: what it includes, how it relates to the app and the MCP, how fresh it is.
  • ConnectHost, ports and TLS for the three interfaces, how your login is delivered and revoked, BI tool setup, date columns and a first query.
  • TablesEvery Data Share table with its grain and use, grouped by question, which are on request, and the rules on days, currencies, cuts and restatements.

For AI assistants: the full index is at /docs/toc.json, and every page is available as markdown by adding .md to its address.