Par-Level & Reorder Generator

$35.00

a restaurant, café, bar, or light-retail stockroom that already runs on par levels and just wants the ordering math and the vendor split done for them.

Local-firstNo telemetry — nothing phones homeNo lock-inNo migration

Hand it today’s inventory count and it takes par minus on hand for every item, works out exactly what to order to refill the shelf, groups it into one clean list per supplier, and totals what the order will cost.

$35 a month, flat. No per-terminal fee and no contract. Cancel any day and the order guides you already ran stay on your disk.

The clipboard walk that turns into an hour of mental math

You already know your pars, the amount of each item you want on the shelf when the week starts. The count itself is the easy part: walk the stockroom, write down what’s there. The slog is everything after. Sitting down and, item by item, working out how much to order to get back to par, then splitting the list by which supplier you call for what, then adding up the cost before you commit.

Do that twice a week and it’s real time, and it’s exactly the arithmetic that goes wrong at the end of a long shift.

Today’s count in, an order guide out

  1. Keep an inventory CSV: item, on hand, par, supplier, and unit cost.
  2. For every line it takes par minus on hand, floored at zero, so anything already at or above par asks for nothing and anything below gets an order quantity.
  3. It groups everything you need into per-supplier lists, sorted by supplier, each with its own subtotal, and totals the whole order.

What you get back

  • ORDER_GUIDE.md: what to order, grouped by supplier, with quantities, line costs, per-supplier subtotals, and a grand total, so you call each vendor with a finished list.
  • order.csv, a flat supplier, item, quantity, cost export you can paste straight into an email or a vendor’s order form.
  • order.json for anything downstream.
  • A --validate step that checks your setup without reading the file or writing anything, handy right before a scheduled run.

Who it’s for, and who it isn’t

Built for a restaurant, café, bar, or light-retail stockroom that runs on par levels and counts by hand. The place where someone walks the shelves with a clipboard and wants the ordering and the vendor split handled.

Not for you if you’d rather the tool set your pars from sales history and lead times. This trusts the pars you’ve already decided. A tool that computes reorder points from usage is a different job. And it isn’t a live, register-linked count.

What it replaces, and what those do better

The clipboard-and-calculator routine, or the inventory add-on bundled with a POS. A POS-linked system is better at one thing: counts that tick down automatically as you sell, so the on-hand figure is always current.

What that costs is the POS contract and the setup behind it. This asks for one CSV and does the part that eats your evening, the order quantities, the supplier grouping, and the totals, for a flat monthly fee on your machine. If you’re counting by hand against pars anyway, this is the piece worth handing off.

Your data, and where it stays

Your items, suppliers, pars, and costs read from disk and write back to disk at 0600 permissions, with no network call. What you stock, who you buy it from, and what you pay is competitive information, and here it becomes an order guide without leaving the building.

$35 a month, and your first order guide

Set the inventory CSV and an output folder in a .env, then run. First order guide in a couple of minutes off a completed count. Update the on-hand numbers after each count and rerun, and the guide’s ready before you’ve refilled your coffee.

Flat monthly, cancel any day, and the order guides stay on your disk.

Security and privacy

Handles client operational data (inventory counts, supplier names, unit costs). Security is designed in.

Principles
Local-first. INVENTORY_CSV is read from disk and never transmitted anywhere; nothing in this tool touches the network. Nothing is uploaded, no telemetry, no cloud dependency.
Non-destructive. The source inventory CSV is only read, never modified or deleted.
Least privilege. Reads INVENTORY_CSV, writes only under OUTPUT_FOLDER.

Protections implemented (v0.1.0)
Path-traversal defense — every output filename is sanitized (safeSegment) and every write is checked with assertWithinRoot(), so the order guide can’t be written outside OUTPUT_FOLDER.
Fail-fast config validation — clear errors for missing/invalid INVENTORY_CSV/OUTPUT_FOLDER before any file is touched; --validate runs this check without reading or writing anything.
Restrictive permissions — the generated report (ORDER_GUIDE.md, order.csv, order.json) is written 0600.
Defensive parsing — the CSV parser and currency/number parser never throw on malformed input (missing fields default to empty string, unparseable quantities/costs default to 0); a bad row degrades the order guide rather than crashing it. Rows missing an item value are skipped.
Secrets discipline.env and generated Orders/ output are git-ignored; no secrets or client data in the repo.

Distribution / AV trust

Known limitations / roadmap
– Par levels are a flat unit count in v0.1.0 — no lead-time or seasonality adjustment. If a supplier has a long lead time, the raw par value in the CSV should already account for it.
– Suppliers are matched by exact string (e.g. Acme Supply vs Acme supply are treated as different vendors) — keep supplier names consistent in the source export. Blank supplier values are grouped under Unassigned rather than dropped, so nothing silently disappears from the order guide.
– No unit-of-measure conversion — on_hand/par/unit_cost are assumed to already be in the same unit per item (e.g. all in “cases” or all in “each”).

Reporting
Report suspected vulnerabilities privately to the maintainer before public disclosure.

Frequently asked questions about Par-Level & Reorder Generator

What does the par-level & reorder generator do, and how does it work?

The par-level & reorder generator turns your on-hand counts and your par levels into a ready-to-send order guide. A par level is the amount of an item you want to have on the shelf or in the walk-in before the next delivery. The tool subtracts what you counted from that target, so the order quantity for each item is simply par minus on-hand. It then groups every line by supplier, so instead of one messy list you get a clean guide for each vendor you buy from.

Using it follows three steps. First you import your on-hand counts and par levels, usually from a spreadsheet export or your POS inventory. Second you run the generator. Third you get the supplier order guide, already split by vendor and ready to send. Low-stock and overstock flags sit next to each item, so you can see at a glance where you are about to run out and where you are sitting on too much. Those flags are the fastest read in the whole guide. A low-stock flag tells you to act now, and an overstock flag tells you to hold off, so you are not ordering on autopilot.

For a restaurant this matters beyond convenience. Ordering the right amount of perishable stock keeps food moving and fresh, which is the whole point of the rotation and temperature rules that regulators enforce. The FDA Food Code is the model food-safety code that state and local health departments adopt for restaurants and retail food, and it centers on keeping food safe from receiving through service. Over-ordering perishables works against that. It leaves you with product that ages out before you can sell it. A par-level & reorder generator that flags overstock helps you buy closer to what you actually use, so less food spoils in the back. Freshness and cost pull in the same direction here. Buying to par instead of to a hunch means the cooler holds what the week actually needs, and stock rotates before it turns.

The tool does not try to be your accounting system or your POS. It does one job. It compares counts to targets, computes the quantity per item and per vendor, and hands you a guide you can act on before the truck arrives. That narrow focus is deliberate. Ordering by hand against par levels is where small operators lose time and money, and a single tool aimed straight at that problem beats a bloated platform you never fully set up.

Who is it for? Independent retailers and restaurants that order against par levels by hand, usually with a clipboard and a spreadsheet. If you have ever walked the line counting cases, then guessed at how much to order, then found out three days later you were short on one thing and drowning in another, this is built for you. You can read more about how it fits day-to-day operations on the small business operators page. The reorder generator will not order for you or place calls to vendors. It gives you an accurate, supplier-grouped guide so the person who does place the order is working from real numbers instead of a hunch. Set your par levels once to match how you actually sell, and each run reflects them without you rebuilding a formula by hand.

Does the par-level & reorder generator help me keep good inventory and ordering records?

Yes, and this is where the par-level & reorder generator quietly earns its keep. Every time you run it, you produce a dated order guide that shows what you had on hand, what your par levels were, and what you ordered from each supplier. That is a record of your purchasing decisions, not just a shopping list. For a small retailer or restaurant, those purchase records are part of the paper trail that backs up your cost of goods sold at tax time. Those numbers do not appear from nowhere. They are built up from the orders you place across the year, and each order guide is one more brick in that wall.

The IRS guidance on how long to keep records lays out the retention periods that apply to business records. The general rule is three years, with longer windows for certain situations and no limit at all if you never filed or filed a fraudulent return. Purchase and inventory records fall squarely inside what you are expected to hold onto, because they support the expense and inventory figures on your return. Guessing your orders on a scrap of paper leaves nothing behind. A generated order guide does.

The tool keeps each run as a concrete artifact you can save, export, and file with the rest of your books. Because it groups the order by supplier, you also end up with a per-vendor history over time. That is useful well beyond tax season. When a vendor invoice does not match what you ordered, you have your own guide to check it against. When you want to see how much you have been spending on one category month over month, the records are already sitting there in a consistent format. Disputes get shorter when you have your own dated guide sitting next to the vendor’s paperwork. You are not arguing from memory. You are pointing at exactly what you ordered and when.

None of this requires extra bookkeeping work from you. The recordkeeping is a byproduct of ordering the way you already order, just done through the tool instead of by hand. You import counts and par levels, run the reorder generator, and the guide it produces is both the thing you send to the vendor and the record you keep. There is no separate step to log what you did. That is the quiet advantage of generating the guide rather than scribbling it down. The act of ordering and the act of recording become the same step.

It helps to be clear about what the par-level & reorder generator is not. It is not a tax preparer and it is not a document retention vault. It will not tell you which records the IRS wants for your specific entity or how long to keep them in your state. For that you should talk to your accountant and read the primary guidance directly. What the tool does is make sure the ordering side of your business leaves a clean, dated trail instead of a pile of guesswork. You can see how that fits the wider workflow on the product overview page. Good records start with actually creating them, and this creates one every time you order.

Is my inventory data safe, and where does it live?

Your inventory counts, par levels, supplier list, and order history belong to your business, and keeping that information under control is the tool’s default posture. The par-level & reorder generator works from files you already have, your on-hand counts and your par levels, and produces an order guide from them. It is not a marketplace and it does not broadcast your buying to anyone. The data it handles is your operational information, and that is exactly the kind of information the FTC tells small businesses to take stock of and protect.

The FTC’s guide on protecting personal information lays out five plain principles for any business that holds sensitive data: take stock, scale down, lock it, pitch it, and plan ahead. Even if your order guides look mundane, they can carry supplier account numbers, pricing you negotiated, and patterns about how your business runs. Take stock means knowing what you hold. Scale down means not keeping more than you need. The reorder generator fits that thinking because it deals only with the counts and targets required to compute an order, and nothing more. Pitch it and plan ahead round out the list. Do not keep data you no longer need, and decide in advance how you would respond if something went wrong. A tool that holds little to begin with makes both of those easier.

Because the tool’s job is narrow, it does not ask for customer names, card numbers, or employee data. It has no reason to touch the personal information that carries the highest risk if it leaks. That keeps your exposure small by design. The less sensitive data any single tool holds, the less there is to lock down and the less there is to lose. A focused reorder generator is easier to reason about than one giant system that holds everything at once.

Where the data lives depends on how you run it, and the guiding rule is that your ordering information stays yours. The tool does not need to publish your supplier relationships or your margins to do its work. It reads your counts, applies your par levels, and writes back a guide. You decide who you send that guide to. Nothing about the workflow requires handing your buying history to a third party who has no part in the order. That matters for a small shop that switches vendors or renegotiates pricing. Your buying history is a competitive detail, and it should not leak just because you used a tool to do the arithmetic.

To be blunt, no software can promise your data is safe if the basics are ignored on your end. Weak passwords, shared logins, and a back-office computer left open to anyone undo any protection a vendor builds in. The FTC’s advice is aimed at you as much as at the tools you buy. What the par-level & reorder generator does is avoid becoming a new pile of risk. It sticks to inventory math and leaves the sensitive personal data alone. You can learn how the tool sits alongside the rest of a small operator’s stack on the small business operators page.

How is this different from ordering with spreadsheets or POS inventory?

Spreadsheets and POS inventory both touch ordering, but neither actually generates the order for you. A spreadsheet holds numbers and does whatever formula you built, until the day someone types over a cell or the file forks into three versions with different names. POS inventory knows what you sold, but it rarely computes a clean, supplier-grouped order guide from par levels. The par-level & reorder generator is built to do that one thing well. It takes on-hand counts and par levels, computes par minus on-hand per item, and groups the result by vendor. A spreadsheet can do the subtraction, but it will not group by supplier, flag overstock, or keep a dated copy unless you build and maintain all of that yourself.

The difference shows up in reliability and in the record you are left with. A spreadsheet gives you a formula that can silently break. The tool gives you a repeatable run that produces the same kind of dated guide every time, with low-stock and overstock flags built in. That consistency matters for a small operator who is already keeping other records under a deadline. Under the DOL recordkeeping requirements of the FLSA, employers have to preserve payroll records for at least three years, and wage-computation records for two. You already live with that kind of discipline for your staff. Moving ordering off a fragile spreadsheet brings the same steady, keep-what-you-did habit to purchasing.

POS inventory is worth keeping. The reorder generator is not trying to replace your register or your sales reporting. It sits next to them and handles the ordering math they were never really designed to do. You can still export counts from the POS and feed them in. The point is that the final order guide, grouped by supplier and ready to send, comes out of a tool aimed squarely at that job rather than out of a spreadsheet you maintain by hand. Think of the two as a handoff. The POS records the sale, the reorder generator decides what to buy back, and neither has to pretend to be the other. Each does the part it is good at.

There is also the plain matter of time. Ordering by hand against par levels means walking the shelves, counting, then sitting down to work out quantities vendor by vendor. That is slow and it is where mistakes creep in. The par-level & reorder generator collapses the math into a single run. You import counts and par levels, run it, and read the guide. The hours you used to spend reconciling a spreadsheet against what is actually on the shelf go back into running the floor.

What it will not do is pretend to be your whole back office. It does not run payroll, it does not keep your employment records, and it does not file anything. For those obligations you follow the DOL and your accountant. The tool stays in its lane, which is turning counts and par levels into an order guide you can trust. That restraint is the point, not a limitation, and it is why the guide comes out reliable. You can see where it fits among the other tools on the product page.

Can the reorder generator help at tax time and with the numbers I report?

The par-level & reorder generator sits on the purchasing side of your business, not the sales side, and understanding that split helps at tax time. When you sell to customers with cards or through a payment app, that income gets reported for you. When you buy stock from vendors, no one hands you a tidy summary. The tool fills that second gap by producing a dated, supplier-grouped order guide every time you order, which becomes part of the cost record behind your books. Income tends to track itself because someone else, your processor or your bank, is reporting it. Costs are the side you have to document, and ordering is a big part of your costs.

On the sales side, many small retailers and restaurants now receive a Form 1099-K. The IRS explanation of Form 1099-K describes it as a report of the payments you received for goods or services through payment cards and third-party networks during the year. That form covers money coming in. It says nothing about what you spent restocking the shelves. Your purchasing records are the other half of the picture, and the reorder generator is where a chunk of them gets created as a normal part of ordering.

Having clean, dated order guides helps when the income number and the expense number need to line up. If your 1099-K shows a busy year of sales, your cost of goods sold should reflect the buying that supported those sales. Order guides grouped by supplier give you a running view of what you purchased and from whom, in a format you can hand to whoever prepares your return. It is far easier than reconstructing a year of orders from memory or from a stack of vendor invoices. Your preparer would rather work from a clean list than piece the year together in April. The less reconstruction they do, the less you pay for their time and the fewer gaps end up in the return.

The par-level & reorder generator does not calculate your taxes and it does not generate any tax form. It will not produce your 1099-K, since that comes from your payment processor, and it will not tell you how to categorize an expense. Those are jobs for your accountant and for the IRS guidance itself. What the tool contributes is accurate, consistent purchasing records that make the expense side of your return easier to support.

So the honest answer is that this is an ordering tool that happens to leave good records behind, not a tax product. Buy it because it makes ordering faster and less error-prone. The clean paper trail it creates is a real bonus when tax season arrives and your income and expense numbers have to agree. You can read more about how it fits a small operator’s routine on the small business operators page. None of this turns an ordering tool into tax software, and it should not. It just means the records you need already exist when you need them, because you made them while doing the job you were going to do anyway.

Attributes Value
Deployment

Cloud

Platform

Web

License Type

Subscription

Billing Period

Monthly

Target Customer

Small Business & Retail

Free Trial

Yes

Reviews

Be the first to review “Par-Level & Reorder Generator”

Your email address will not be published. Required fields are marked *